Record MQ Object Image (RCDMQMIMG)
- 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
| 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.
We 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.
Examples
>None
Error messages
>Unknown
Parent topic: CL commands reference for IBM i