rcrmqobj (re-create object)

Re-create an object, or group of objects, from their images contained in the log.


Purpose

Use the rcrmqobj command to re-create an object, or group of objects, from their images.

  • With ObjectType argument of clchltab or syncfile, this command re-creates the object files from the internal queue manager state.
  • For other ObjectType arguments, the command can only be used when the queue manager is configured to use linear logging. Use the associated command, rcdmqimg, to record the object images to the log. The object is re-created from images in 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

rcrmqobj  -m QMgrName -z -t ObjectType 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:

    Object Type Description
    * or all All object types
    authinfo Authentication information object, for use with TLS channel security
    channel or chl Channels
    clntconn or clcn Client connection channels
    clchltab Client channel table
    comminfo Communication information object
    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 the syncfile fails if the channel scratchpad files, which are used to rebuild syncfile, are damaged or missing. We might want to do this if the system has reported the error message AMQ7353 (krcE_SYNCFILE_UPDATE_FAILED).

    topic or top Topics

Note: When using IBM MQ for UNIX systems, we must prevent the shell from interpreting the meaning of special characters, for example, an asterisk (*). How you do this depends on the shell we 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

Return code Description
0 Successful operation
26 Queue manager running as a standby instance.
28 Object not media recoverable.
36 Invalid arguments supplied
40 Queue manager not available
49 Queue manager stopping
58 Inconsistent use of installations detected
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

Command Description
rcdmqimg Record an object in the log