Inquire Entity Authority (Response)
Each response to the Inquire Entity Authority (MQCMD_INQUIRE_AUTH_RECS)
command consists of the response header followed by the QMgrName
, Options
,
and ObjectName
structures
and the requested combination of attribute parameter structures.
HP Integrity NonStop Server | UNIX and Linux® | Windows |
---|---|---|
X | X |
- Always returned:
ObjectName
,Options
,QMgrName
- Returned if requested:
AuthorizationList
,EntityName
,EntityType
,ObjectType
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:
- 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.
- 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 administration 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.
ObjectName
(MQCFST)- Object name (parameter identifier: MQCACF_OBJECT_NAME).
The name of the queue manager, queue, process definition, or generic profile on which the inquiry is made.
The maximum length of the string is MQ_OBJECT_NAME_LENGTH.
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.
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.