[UNIX, Linux, Windows, IBM i]

DELETE AUTHREC (delete authority records) on Multiplatforms

Use the MQSC command DELETE AUTHREC to delete authority records associated with a profile name.

Using MQSC commands

For information on how you use MQSC commands, see Performing local administration tasks using MQSC commands.

DELETE AUTHREC

Read syntax diagramSkip visual syntax diagram DELETE AUTHREC PROFILE(profile-name)OBJTYPE(AUTHINFO)OBJTYPE(CHANNEL)OBJTYPE(CLNTCONN)OBJTYPE(COMMINFO)OBJTYPE(LISTENER)OBJTYPE(NAMELIST)OBJTYPE(PROCESS)OBJTYPE(QUEUE)OBJTYPE(QMGR)OBJTYPE(RQMNAME)OBJTYPE(SERVICE)OBJTYPE(TOPIC)PRINCIPAL(principal-name)GROUP(group-name)IGNSTATE(YES)12IGNSTATE(NO)13IGNSTATE(YES)
Notes:
  • 1 Valid only on AIX®, Linux®, and Windows.
  • 2 Default value is YES for QMGR, TOPIC, RQMNAME and QUEUE objects when set using the OBJTYPE parameter. Setting IGNSTATE to NO is not valid for these objects.
  • 3 Default value is NO for objects apart from QMGR, TOPIC, RQMNAME and QUEUE.

Parameter descriptions

PROFILE(profile-name)
The name of the object or generic profile for which to remove the authority record. This parameter is required unless the OBJTYPE parameter is QMGR, in which case it can be omitted.
OBJTYPE
The type of object referred to by the profile. Specify one of the following values:
AUTHINFO
Authentication information record
CHANNEL
Channel
CLNTCONN
Client connection channel
COMMINFO
Communication information object
LISTENER
Listener
NAMELIST
Namelist
PROCESS
Process
QUEUE
Queue
QMGR
Queue manager
RQMNAME
Remote queue manager
SERVICE
Service
TOPIC
Topic
PRINCIPAL(principal-name)
A principal name. This is the name of a user for whom to remove authority records for the specified profile. On IBM® MQ for Windows, the name of the principal can optionally include a domain name, specified in this format: user@domain.

You must specify either PRINCIPAL or GROUP.

GROUP(group-name)
A group name. This is the name of the user group for which to remove authority records for the specified profile. You can specify one name only and it must be the name of an existing user group.
[Windows]For IBM MQ for Windows only, the group name can optionally include a domain name, specified in the following formats: 

GroupName@domain
domain\GroupName

You must specify either PRINCIPAL or GROUP.

[MQ 9.2.1 Dec 2020][AIX, Linux, Windows]IGNSTATE
This parameter allows you to specify whether you want the command to return an error code if the object is already in the state the command moves it to.
A value of YES means the return code and message are the same as if the MQSC object has not been deleted.

A value of NO means that the return code is zero, even if the object has been deleted.

Attention: You can only set the value to YES for QMGR, TOPIC, RQMNAME and QUEUE objects. For these objects, the value NO is not valid. For all other objects the default value is NO.