RCDMQMIMG (Record MQ Object Image)

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

The Record MQ Object Image (RCDMQMIMG) command is used to provide a marker for the selected set of MQ objects, so that the Re-create MQM Object (RCRMQMOBJ) command can recover this set of objects from journal data recorded subsequently.

This command is intended to enable journal receivers, detached prior to the current date, to be disconnected. On successful completion of this command those journals are no longer required to be present for a Re-create MQ Object (RCRMQMOBJ) command on this set of MQM Objects to succeed.

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, *TOPIC	Required, Positional 2
MQMNAME	Message Queue Manager name	`Character value`, *DFT	Optional, Positional 3
DSPJRNDTA	Display Journal Receiver Data	YES, NO	Optional, Positional 4

Object name (OBJ)

Specifies the name of the objects that should be recorded. This is a 48-character MQ object or generic object name.

The possible values are:

*ALL

All MQ objects of the specified type (OBJTYPE) are recorded.

generic-object-name

Specify the generic name of the objects to be recorded. A generic name is a character string followed by an asterisk (*). For example, ABC*. It selects all objects that have names which 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 recorded.

Object type (OBJTYPE)

Specifies the 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 objects 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 MQ queue manager catalog object. This has the same name as the queue manager object.
*MQM: Specifies the Message Queue Manager object.
*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.
*TOPIC: Specifies the 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.

Display Journal Receiver Data (DSPJRNDTA)

Specifies whether additional messages should be written to the job log when the command completes to inform the user which journal receivers are still required by IBM® MQ.

The possible values are:

*NO: No messages are written to the job log.
*YES: Messages will be sent to the job log when the command completes. The messages will contain details about which journal receivers are required by IBM MQ.