MOVE - Move messages from the dead letter queue

The dead letter queue is made up of messages which could not be processed.
In order to process these messages after any errors have been corrected, they must be assigned either to their original destination or to a new destination.

tacdadm MOVE allows you to move individual messages or all messages stored in the dead letter queue. The messages can be assigned to their original message queues or to any new destination of the same type (asynchronous TAC / TAC queue, LPAP partner, OSI-LPAP partner).

---

tacdadm      MOVE

            ,DESTINATION = { *ORIG | destination }

            ,DPUTID = { ALL | dputid, GENTIME = (ddd,hh,mm,ss) }

---

MOVE		Move messages from the dead letter queue.
DESTINATION=
		Specifies the new destination for the message.
	*ORIG	The message is to be assigned to its original destination.  If you specify DESTINATION=*ORIG together with DPUTID=ALL, all messages are assigned to their original destinations.
	destination
		Name of the new destination for the message or for all messages with appropriate original destination (asynchronous TAC / TAC queue, LPAP partner, OSI-LPAP partner). If you move multiple messages (DPUTID=ALL), then those messages remain in the dead letter queue whose original destination does not match the new destination.
DPUTID=		ID of the message to be moved.
	ALL	All messages in the dead letter queue.
	dputid	Job ID of the message.
	GENTIME=(ddd,hh,mm,ss)
		Time the message was generated. Where: ddd working day, hh hours, mm minutes, ss seconds.

Result

The job to move all messages to their original destinations is accepted without an error message being issued if individual original destinations or all the original destinations no longer exist.

openUTM generates a message indicating whether the job was accepted or not. The message is output at the terminal of the user issuing the job.

You must use separate KDCDADM demands in order to determine whether the messages have actually been moved.

The sample program DADMMVS or dadmmvsc for selectively moving messages from the dead letter queue is supplied with openUTM. The interactive program moves all messages from the dead letter queue using a specified original destination and a specified new destination. You can find the description of the sample program in the relevant system-specific openUTM manual “Using UTM Applications”.