Inquire Authority Records (Response) on Multiplatforms

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.

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.

Parent topic: Definitions of the Programmable Command Formats