Inquire Security (Response) on z/OS
The response to the Inquire Security (MQCMD_INQUIRE_SECURITY) command consists of the response header followed by the requested combination of attribute parameter structures.
One message is returned if either SecurityTimeout or SecurityInterval is specified on the command. If SecuritySwitch is specified, one message per security switch found is returned. This message includes the SecuritySwitch, SecuritySwitchSetting, and SecuritySwitchProfile parameter structures.
- Returned if requested:
- SecurityInterval, SecuritySwitch, SecuritySwitchProfile, SecuritySwitchSetting, SecurityTimeout
Response data
- SecurityInterval (MQCFIN)
- Time interval between checks (parameter identifier: MQIACF_SECURITY_INTERVAL).
The interval, in minutes, between checks for user IDs and their associated resources to determine whether SecurityTimeout has expired.
- SecuritySwitch (MQCFIN)
- Security switch profile (parameter identifier: MQIA_CF_LEVEL). The value can be any of the
following values:
- MQSECSW_SUBSYSTEM
- Subsystem security switch.
- MQSECSW_Q_MGR
- Queue manager security switch.
- MQSECSW_QSG
- Queue sharing group security switch.
- MQSECSW_CONNECTION
- Connection security switch.
- MQSECSW_COMMAND
- Command security switch.
- MQSECSW_CONTEXT
- Context security switch.
- MQSECSW_ALTERNATE_USER
- Alternate user security switch.
- MQSECSW_PROCESS
- Process security switch.
- MQSECSW_NAMELIST
- Namelist security switch.
- MQSECSW_TOPIC
- Topic security switch.
- MQSECSW_Q
- Queue security switch.
- MQSECSW_COMMAND_RESOURCES
- Command resource security switch.
- SecuritySwitchProfile (MQCFST)
- Security switch profile (parameter identifier: MQCACF_SECURITY_PROFILE).
The maximum length of the string is MQ_SECURITY_PROFILE_LENGTH.
- SecuritySwitchSetting (MQCFIN)
- Set of the security switch (parameter identifier: MQIACF_SECURITY_SETTING).
The value can be:
- MQSECSW_ON_FOUND
- Switch ON, profile found.
- MQSECSW_OFF_FOUND
- Switch OFF, profile found.
- MQSECSW_ON_NOT_FOUND
- Switch ON, profile not found.
- MQSECSW_OFF_NOT_FOUND
- Switch OFF, profile not found.
- MQSECSW_OFF_ERROR
- Switch OFF, profile error.
- MQSECSW_ON_OVERRIDDEN
- Switch ON, profile overridden.
- SecurityTimeout (MQCFIN)
- Timeout value (parameter identifier: MQIACF_SECURITY_TIMEOUT).
How long, in minutes, security information about an unused user ID and associated resources is retained.
Parent topic: Definitions of the Programmable Command Formats