Inquire Authority Service on Multiplatforms
The Inquire Authority Service (MQCMD_INQUIRE_AUTH_SERVICE) command retrieves information about the level of function supported by installed authority managers.
Required parameters
- AuthServiceAttrs (MQCFIL)
- Authority service attributes (parameter identifier: MQIACF_AUTH_SERVICE_ATTRS).
The attribute list might specify the following value on its own - default value if the parameter
is not specified:
- MQIACF_ALL
- All attributes.
or a combination of the following:
- MQIACF_INTERFACE_VERSION
- Current interface version of the authority service.
- MQIACF_USER_ID_SUPPORT
- Whether the authority service supports user IDs.
Optional parameters
- ServiceComponent (MQCFST)
- Name of authorization service (parameter identifier: MQCACF_SERVICE_COMPONENT).
The name of the authorization service which is to handle the Inquire Authority Service command.
If this parameter is omitted, or specified as a blank or null string, the inquire function is called in each installed authorization service in reverse order to the order in which the services have been installed, until all authorization services have been called or until one returns a value of MQZCI_STOP in the Continuation field.
The maximum length of the string is MQ_SERVICE_COMPONENT_LENGTH.
Error codes
This command might return the following error codes in the response format header, in addition to the values shown in Error codes applicable to all commands.
- Reason (MQLONG)
- The value can be any of the following values:
- MQRC_SELECTOR_ERROR
- Attribute selector not valid.
- MQRC_UNKNOWN_COMPONENT_NAME
- Unknown service component name.
Parent topic: Definitions of the Programmable Command Formats