[IBM i]

Re-create MQ Object (RCRMQMOBJ)

Where allowed to run
All environments (*ALL)
Threadsafe
Yes

The Re-create MQ Object (RCRMQMOBJ) command is used to provide a recovery mechanism for damaged MQ objects. The command completely re-creates the objects from information recorded in the MQ journals. If no damaged objects exist, no action is performed.

Parameters

Table 1. Command parameters
Keyword Description Choices Notes
OBJ Object name Character value, *ALL Required, Positional 1
OBJTYPE Object type *ALL, *Q, *ALSQ, *LCLQ, *MDLQ, *RMTQ, *AUTHINFO, *CTLG, *MQM, *NMLIST, *PRC, *CHL, *CLTCN, *LSR, *SVC, *SYNCFILE, *CLCHLTAB, *TOPIC Required, Positional 2
MQMNAME Message Queue Manager name Character value, *DFT Optional, Positional 3

Object name (OBJ)

Specifies the name of the objects which should be re-created if they are damaged. This is a 48-character MQ object or generic object name.

The possible values are:

*ALL
All damaged MQ objects of the specified type (OBJTYPE) are re-created.
generic-object-name
Specify the generic name of the objects to be re-created. A generic name is a character string followed by an asterisk (*). For example, ABC*. It selects all objects that have names that start with the character string.

You are recommended to specify the name required within quotation marks. Using this format ensures that your selection is precisely what you entered.

You cannot select all the uppercase and lowercase versions of a generic name on a single panel, without requesting all the names.

object-name
The name of an MQ object to be re-created if it is damaged.

Object type (OBJTYPE)

Specifies the object type of the objects to be re-created.

The possible values are:

*ALL
Specifies all MQ object types.
*Q
Specifies MQ queue objects with names specified by OBJ.
*ALSQ
Specifies MQ alias queue objects with names specified by OBJ.
*LCLQ
Specifies MQ local queue objects with names specified by OBJ.
*MDLQ
Specifies MQ model queues with names specified by OBJ.
*RMTQ
Specifies MQ remote queue objects with names specified by OBJ.
*AUTHINFO
Specifies MQ authentication information objects with names specified by OBJ.
*CTLG
Specifies the message queue manager catalog object. The catalog object has the same name as the message queue manager object. It holds the names of MQ objects. A user needs authorities on this object to be able to start or stop the message queue manager, or, to create or delete MQ queues and process definitions.
*MQM
Specifies the message queue manager. This object holds the attributes of the message queue manager.
*CHL
Specifies MQ channel objects with names specified by OBJ.
*CLTCN
Specifies MQ MQI client connection channel objects with names specified by OBJ.
*NMLIST
Specifies MQ namelist objects with names specified by OBJ.
*PRC
Specifies MQ process objects with names specified by OBJ.
*LSR
Specifies MQ listener objects with names specified by OBJ.
*SVC
Specifies MQ service objects with names specified by OBJ.
*SYNCFILE
Specifies the MQ channel synchronisation file.
*SYNCFILE
Specifies the MQ MQI client channel table file.
*TOPIC
Specifies MQ topic objects with names specified by OBJ.

Message Queue Manager name (MQMNAME)

Specifies the name of the message queue manager.

The possible values are:

*DFT
Use the default queue manager.
message-queue-manager-name
Specify the name of the queue manager.