System Administration Guide

rcrmqobj (recreate object)

Purpose

Use the rcrmqobj command to recreate an object, or group of objects, from their images contained in the log. 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

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:

	nl or namelist	Namelists
	prcs or process	Processes
	q or queue	All types of queue
	ql or qlocal	Local queues
	qa or qalias	Alias queues
	qr or qremote	Remote queues
	qm or qmodel	Model queues
	syncfile	Channel synchronization file
	authinfo	Authentication information, for use with Secure Sockets Layer (SSL) channel security
	* or all	All the above

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

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

rcdmqimg

Record an object in the log