Delete Authority Record on Multiplatforms
The Delete Authority Record (MQCMD_DELETE_AUTH_REC) command deletes an authority record. The authorizations associated with the profile no longer apply to IBM MQ objects with names that match the profile name specified.
Required parameters
- ObjectType (MQCFIN)
- The type of object for which to delete authorizations (parameter identifier:
MQIACF_OBJECT_TYPE).
The value can be any of the following values:
- 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.
- ProfileName (MQCFST)
- Name of the profile to be deleted (parameter identifier: MQCACF_AUTH_PROFILE_NAME).
If we have defined a generic profile then we can specify it here, using wildcard characters to specify a named generic profile to be removed. If you specify an explicit profile name, the object must exist.
The maximum length of the string is MQ_AUTH_PROFILE_NAME_LENGTH.
Optional parameters
- GroupNames (MQCFSL)
- Group names (parameter identifier: MQCACF_GROUP_ENTITY_NAMES).
The names of groups having a profile deleted. At least one group name or principal name must be specified. An error occurs if neither are specified.
Each member in this list can be a maximum length of MQ_ENTITY_NAME_LENGTH.
- PrincipalNames (MQCFSL)
- Principal names (parameter identifier: MQCACF_PRINCIPAL_ENTITY_NAMES).
The names of principals having a profile deleted. At least one group name or principal name must be specified. An error occurs if neither are specified.
Each member in this list can be a maximum length of MQ_ENTITY_NAME_LENGTH.
Error codes (Delete Authority Record)
This command might return the following error codes in the response format header, in addition to the values shown on page Error codes applicable to all commands.
- Reason (MQLONG)
- The value can be any of the following values:
- MQRC_OBJECT_TYPE_ERROR
- Invalid object type.
- MQRC_UNKNOWN_ENTITY
- Userid not authorized, or unknown.
- MQRCCF_ENTITY_NAME_MISSING
- Entity name missing.
- MQRCCF_OBJECT_TYPE_MISSING
- Object type missing.
- MQRCCF_PROFILE_NAME_ERROR
- Invalid profile name.
Parent topic: Definitions of the Programmable Command Formats