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 re-create an object, replay the log to re-create events that occurred after the object image was captured.

Syntax

Read syntax diagramSkip visual syntax diagram>>-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

Note:
When using WebSphere MQ for UNIX systems, you 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 re-create 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

  1. The following command re-creates all local queues for the default queue manager:
    rcrmqobj -t ql *
  2. The following command re-creates all remote queues associated with queue manager store:
    rcrmqobj -m store -t qr *

Related commands

rcdmqimg Record an object in the log