Home

 

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

  1. The following command recreates all local queues for the default queue manager:
    rcrmqobj -t ql *

  2. 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