rcdmqimg (record media image)

 

 

Purpose

Use the rcdmqimg command to write an image of an object, or group of objects, to the log for use in media recovery. Use the associated command rcrmqobj to recreate the object from the image.

You use this command with an active queue manager. Further activity on the queue manager is logged so that, although the image becomes out of date, the log records reflect any changes to the object.

 

Syntax

>>-rcdmqimg--+--------------+--+------+--+------+--------------->
             '- -m queue_manager-'  '- -z -'  '- -l -'
 
>---t ObjectType--GenericObjName-------------------------------><
 
 

 

Required parameters

GenericObjName

The name of the object to record. This parameter can have a trailing asterisk to record that any objects with names matching the portion of the name before the asterisk.

This parameter is required unless you are recording a queue manager object or the channel synchronization file. Any object name you specify for the channel synchronization file is ignored.

-t ObjectType

The types of object for which to record images. 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
>	qmgr	Queue manager object
>	syncfile	Channel synchronization file
>	ctlg or catalog	An object catalog
>	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 record images. If you omit this, the command operates on the default queue manager.

-z

Suppresses error messages.

-l

Writes messages containing the names of the oldest log files needed to restart the queue manager and to perform media recovery. The messages are written to the error log and the standard error destination. (If you specify both the -z and -l parameters, the messages are sent to the error log, but not to the standard error destination.)

When issuing a sequence of rcdmqimg commands, include the -l parameter only on the last command in the sequence, so that the log file information is gathered only once.

 

Return codes

0	Successful operation
36	Invalid arguments supplied
40	Queue manager not available
49	Queue manager stopping
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
131	Resource problem
132	Object damaged
135	Temporary object cannot be recorded

 

Examples

The following command records an image of the queue manager object saturn.queue.manager in the log.

rcdmqimg -t qmgr -m saturn.queue.manager

 

Related commands

rcrmqobj

Recreate a queue manager object

 

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.