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
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
- The following command re-creates all local queues for the default queue manager:
rcrmqobj -t ql *
- 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 |