Inquire Authority Records (Response)

The response to the Inquire Authority Records (MQCMD_INQUIRE_AUTH_RECS) command consists of the response header followed by the QMgrName, Options, ProfileName, and ObjectType structures and the requested combination of attribute parameter structures.

HP Integrity NonStop Server	IBM® i	UNIX and Linux®	Windows	z/OS®

One PCF message is returned for each authority record that is found the profile name of which matches the options specified in the Inquire Authority Records request.

Always returned:: ObjectType, Options, ProfileName, QMgrName
Returned if requested:: AuthorizationList, EntityName, EntityType

Response data

AuthorizationList (MQCFIL)

Authorization list (parameter identifier: MQIACF_AUTHORIZATION_LIST).

This list can contain zero or more authorization values. Each returned authorization value means that any user ID in the specified group or principal has the authority to perform the operation defined by that value. The value can be any of the following values:

MQAUTH_NONE: The entity has authority set to 'none'.
MQAUTH_ALT_USER_AUTHORITY: Specify an alternate user ID on an MQI call.
MQAUTH_BROWSE: Retrieve a message from a queue by issuing an MQGET call with the BROWSE option.
MQAUTH_CHANGE: Change the attributes of the specified object, using the appropriate command set.
MQAUTH_CLEAR: Clear a queue.
MQAUTH_CONNECT: Connect the application to the specified queue manager by issuing an MQCONN call.
MQAUTH_CREATE: Create objects of the specified type using the appropriate command set.
MQAUTH_DELETE: Delete the specified object using the appropriate command set.
MQAUTH_DISPLAY: Display the attributes of the specified object using the appropriate command set.
MQAUTH_INPUT: Retrieve a message from a queue by issuing an MQGET call.
MQAUTH_INQUIRE: Make an inquiry on a specific queue by issuing an MQINQ call.
MQAUTH_OUTPUT: Put a message on a specific queue by issuing an MQPUT call.
MQAUTH_PASS_ALL_CONTEXT: Pass all context.
MQAUTH_PASS_IDENTITY_CONTEXT: Pass the identity context.
MQAUTH_SET: Set attributes on a queue from the MQI by issuing an MQSET call.
MQAUTH_SET_ALL_CONTEXT: Set all context on a queue.
MQAUTH_SET_IDENTITY_CONTEXT: Set the identity context on a queue.
MQAUTH_CONTROL: For listeners and services, start and stop the specified channel, listener, or service.; For channels, start, stop, and ping the specified channel.; For topics, define, alter, or delete subscriptions.
MQAUTH_CONTROL_EXTENDED: Reset or resolve the specified channel.
MQAUTH_PUBLISH: Publish to the specified topic.
MQAUTH_SUBSCRIBE: Subscribe to the specified topic.
MQAUTH_RESUME: Resume a subscription to the specified topic.
MQAUTH_SYSTEM: Use queue manager for internal system operations.
MQAUTH_ALL: Use all operations applicable to the object.
MQAUTH_ALL_ADMIN: Use all operations applicable to the object.
MQAUTH_ALL_MQI: Use all MQI calls applicable to the object.

Use the Count field in the MQCFIL structure to determine how many values are returned.

EntityName (MQCFST)

Entity name (parameter identifier: MQCACF_ENTITY_NAME).

This parameter can either be a principal name or a group name.

The maximum length of the string is MQ_ENTITY_NAME_LENGTH.

EntityType (MQCFIN)

Entity type (parameter identifier: MQIACF_ENTITY_TYPE).

The value can be:

MQZAET_GROUP: The value of the EntityName parameter refers to a group name.
MQZAET_PRINCIPAL: The value of the EntityName parameter refers to a principal name.
MQZAET_UNKNOWN: On Windows, an authority record still exists from a previous queue manager which did not originally contain entity type information.

ObjectType (MQCFIN)

Object type (parameter identifier: MQIACF_OBJECT_TYPE).

The value can be:

MQOT_AUTH_INFO: Authentication information.
MQOT_CHANNEL: Channel object.
MQOT_CLNTCONN_CHANNEL: Client-connection channel object.
MQOT_COMM_INFO: Communication information object
MQOT_LISTENER: Listener object.
MQOT_NAMELIST: Namelist.
MQOT_PROCESS: Process.
MQOT_Q: Queue, or queues, that match the object name parameter.
MQOT_Q_MGR: Queue manager.
MQOT_REMOTE_Q_MGR_NAME: Remote queue manager.
MQOT_SERVICE: Service object.
MQOT_TOPIC: Topic object.

Options (MQCFIN): Options used to indicate the level of information that is returned (parameter identifier: MQIACF_AUTH_OPTIONS).

ProfileName (MQCFST): Profile name (parameter identifier: MQCACF_AUTH_PROFILE_NAME).
The maximum length of the string is MQ_AUTH_PROFILE_NAME_LENGTH.

QMgrName (MQCFST): Name of the queue manager on which the Inquire command is issued (parameter identifier: MQCA_Q_MGR_NAME).
The maximum length of the string is MQ_Q_MGR_NAME_LENGTH.