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

>>-rcrmqobj--+--------------+--+------+---t ObjectType---------->
             '- -m queue_manager-'  '- -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:

>	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 object, for use with 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 queue_manager

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

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.