Home

 

Required parameters

 

EntityName (MQCFST)

Entity name (parameter identifier: MQCACF_ENTITY_NAME).

Depending on the value of EntityType, this is either:

• A principal name. This is the name of a user for whom to retrieve authorizations to the specified object. On WebSphere MQ for Windows, the name of the principal can optionally include a domain name, specified in this format: user@domain.

• A group name. This is the name of the user group on which to make the inquiry. We can specify one name only and this must be the name of an existing user group. On WebSphere MQ for Windows, we can only use local groups.

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.

ObjectName (MQCFST)

Object name (parameter identifier: MQCACF_OBJECT_NAME).

The name of the queue manager, queue, process definition or generic profile on which to make the inquiry.

You must include this parameter unless the ObjectType is MQOT_Q_MGR, in which case, omit it. If you do not include this parameter, it is assumed that you are making an inquiry on the queue manager.

You cannot specify a generic object name although we can specify the name of a generic profile.

The maximum length of the string is MQ_OBJECT_NAME_LENGTH.

ObjectType (MQCFIN)

The type of object referred to by the profile (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_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_SERVICE

Service object.

Options (MQCFIN)

Options to control the set of authority records that is returned (parameter identifier: MQIACF_AUTH_OPTIONS).

This parameter is required and you should set it to the value MQAUTHOPT_CUMULATIVE. It returns a set of authorities representing the cumulative authority that an entity has to a specified object.

If a user ID is a member of more than one group, this command displays the combined authorizations of all groups.

 

Parent topic:

Inquire Entity Authority

pc12610_

 

Home