rcdmqimg (record media image)
Purpose
Use the rcdmqimg command to write an image of an object, or group of objects, to the log for use in media recovery. This command can only be used when using linear logging. Use the associated command rcrmqobj to recreate the object from the image.
You use this command with an active queue manager. Further activity on the queue manager is logged so that, although the image becomes out of date, the log records reflect any changes to the object.
Syntax
>>-rcdmqimg--+----------------+--+------+--+------+-------------> '- -m --QMgrName-' '- -z -' '- -l -' >-- -t ObjectType--GenericObjName------------------------------><
Required parameters
- GenericObjName
- The name of the object to record. This parameter can have a trailing asterisk to record that any objects with names matching the portion of the name before the asterisk.
This parameter is required unless you are recording a queue manager object or the channel synchronization file. Any object name you specify for the channel synchronization file is ignored.
- -t ObjectType
- The types of object for which to record images. Valid object types are:
* or all All the object types authinfo Authentication information object, for use with Secure Sockets Layer (SSL) channel security channel or chl Channels clntconn or clcn Client connection channels catalog or ctlg An object catalog listener or lstr Listeners namelist or nl Namelists process or prcs Processes queue or q All types of queue qalias or qa Alias queues qlocal or ql Local queues qmodel or qm Model queues qremote or qr Remote queues qmgr Queue manager object service or srvc Service syncfile Channel synchronization file.
When using WebSphere MQ for UNIX systems, we need to prevent the shell from interpreting the meaning of special characters, for example, *. How you do this depends on the shell you are using, but might involve the use of single quotation marks, double quotation marks, or a backslash.
Optional parameters
- -m QMgrName
- The name of the queue manager for which to record images. If you omit this, the command operates on the default queue manager.
- -z
- Suppresses error messages.
- -l
- Writes messages containing the names of the oldest log files needed to restart the queue manager and to perform media recovery. The messages are written to the error log and the standard error destination. (If you specify both the -z and -l parameters, the messages are sent to the error log, but not to the standard error destination.)
When issuing a sequence of rcdmqimg commands, include the -l parameter only on the last command in the sequence, so that the log file information is gathered only once.
Return codes
0 Successful operation 36 Invalid arguments supplied 40 Queue manager not available 49 Queue manager stopping 68 Media recovery not supported 69 Storage not available 71 Unexpected error 72 Queue manager name error 119 User not authorized 128 No objects processed 131 Resource problem 132 Object damaged 135 Temporary object cannot be recorded
Examples
The following command records an image of the queue manager object saturn.queue.manager in the log.
rcdmqimg -t qmgr -m saturn.queue.manager
Related commands
rcrmqobj Recreate a queue manager object
Parent topic:
The control commands
fa15870_
Home