rcrmqobj (recreate object)
Purpose
Use this command to recreate an object, or group of objects, from their images contained in the log. This command can only be used when using linear logging. Use the associated command, rcdmqimg, to record the object images to the log.
Use this command on a running queue manager. All activity on the queue manager after the image was recorded is logged. To recreate an object, replay the log to recreate events that occurred after the object image was captured.
Syntax
>>-rcrmqobj--+----------------+--+------+-- -t ObjectType-------> '- -m --QMgrName-' '- -z -' >--GenericObjName----------------------------------------------><
Required parameters
- GenericObjName
- The name of the object to re-create. This parameter can have a trailing asterisk to re-create any objects with names matching the portion of the name before the asterisk.
This parameter is required unless the object type is the channel synchronization file; any object name supplied for this object type is ignored.
- -t ObjectType
- The types of object to re-create. Valid object types are:
* or all All 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 clchltab Client channel table listener or lstr Listener 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 service or srvc Service syncfile Channel synchronization file. We can use this option when circular logs are configured but syncfile will fail if the channel scratchpad files, which are used to rebuild syncfile, are damaged or missing.
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 recreate objects. If omitted, the command operates on the default queue manager.
- -z
- Suppresses error messages.
Return codes
0 Successful operation 36 Invalid arguments supplied 40 Queue manager not available 49 Queue manager stopping 66 Media image not available 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 135 Temporary object cannot be recovered 136 Object in use
Examples
- The following command recreates all local queues for the default queue manager:
rcrmqobj -t ql *- The following command recreates all remote queues associated with queue manager store:
rcrmqobj -m store -t qr *
Related commands
rcdmqimg Record an object in the log
Parent topic:
The control commands
fa15880_
Home