Home
Required parameters
- 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 include one of the following two values:
and one of the following two values:
- MQAUTHOPT_NAME_ALL_MATCHING
- Return all profiles the names of which match the specified ProfileName. This means that a ProfileName of ABCD results in the profiles ABCD, ABC*, and AB* being returned (if ABC* and AB* have been defined as profiles).
- MQAUTHOPT_NAME_EXPLICIT
- Return only those profiles the names of which exactly match the ProfileName. No matching generic profiles are returned unless the ProfileName is, itself, a generic profile. We cannot specify this and MQAUTHOPT_ENTITY_SET.
- MQAUTHOPT_ENTITY_EXPLICIT
- Return all profiles the entity fields of which match the specified EntityName. No profiles are returned for any group in which EntityName is a member; only the profile defined for the specified EntityName.
- MQAUTHOPT_ENTITY_SET
- Return the profile the entity field of which matches the specified EntityName and the profiles pertaining to any groups in which EntityName is a member that contribute to the cumulative authority for the specified entity. . We cannot specify this and MQAUTHOPT_NAME_EXPLICIT.
We can also optionally specify:
- MQAUTHOPT_NAME_AS_WILDCARD
- Interpret ProfileName as a filter on the profile name of the authority records. If you do not specify this attribute and ProfileName contains wildcard characters, it is interpreted as a generic profile and only those authority records where the generic profile names match the value of ProfileName are returned.
We cannot specify MQAUTHOPT_NAME_AS_WILDCARD if you also specify MQAUTHOPT_ENTITY_SET.
- ProfileName (MQCFST)
- Profile name (parameter identifier: MQCACF_AUTH_PROFILE_NAME).
This is the name of the profile for which to retrieve authorizations. Generic profile names are supported. A generic name is a character string followed by an asterisk (*), for example ABC*, and it selects all profiles having names that start with the selected character string. An asterisk on its own matches all possible names.
If you have defined a generic profile, we can return information about it by not setting MQAUTHOPT_NAME_AS_WILDCARD in Options.
If you set Options to MQAUTHOPT_NAME_AS_WILDCARD, the only valid value for ProfileName is a single asterisk (*). This means that all authority records that satisfy the values specified in the other parameters are returned.
Do not specify ProfileName if the value of ObjectType is MQOT_Q_MGR.
The profile name is always returned regardless of the attributes requested.
The maximum length of the string is MQ_AUTH_PROFILE_NAME_LENGTH.
- ObjectType (MQCFIN)
- The type of object referred to by the profile (parameter identifier: MQIACF_OBJECT_TYPE).
The value can be:
- MQOT_ALL
- All object types. This is the default if you do not specify a value for ObjectType.
- 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.
Parent topic:
Inquire Authority Records
pc11900_
Home