If you enter tacdadm together with the operand DELETE, you can delete messages from a message queue.
You can:
Delete a specific message.
To do this, you must provide unique identification for the message queue and the message. You identify the message queue, depending on the type, by means of the TAC name, the name of the LTERM partner, the user ID or the name of the temporary queue. You identify the message by means of its job ID and the time when the message was created. You can determine both of these items of data using the tacdadm INFORM.Delete all messages currently buffered in a message queue. This would delete all messages which are not yet being processed by the recipient (TAC, LTERM partner, user ID, temporary queue).
tacdadm DELETE
,DESTINATION=destination
[ ,DEST-TYPE = { LTERM | TAC | USER | QUEUE } ]
,DPUTID={ ALL | dput-id,GENTIME=time [,CHAINMSG= {ACT | DEL} ] }
DELETE | Delete one message or all messages waiting in a message Queue. | |
DESTINATION=destination | ||
Specifies the message queue of the recipient containing the message to be canceled. For destination you must specify the name of a TAC, an LTERM partner, a user ID or the name of a temporary queue. | ||
DEST-TYPE= | Specifies the type of the recipient (destination). Possible entries are: | |
LTERM | The recipient is an LTERM partner. | |
TAC | The recipient is a TAC or a TAC queue. | |
USER | The recipient is the queue of a user ID. | |
QUEUE | The recipient is a temporary queue. | |
DPUTID= | In DPUTID you specify which message is to be deleted. | |
ALL | All messages to the recipient named in destination are to be deleted. | |
dputid | One message in the queue is to be deleted. For dputid you must then specify the job ID for the message which is to be deleted. | |
GENTIME=time | ||
| You only have to enter this if you wish to delete one specific message from a queue (for DPUTID= dputid ) In this case, for time you must indicate the time at which the message was generated. Enter time in the form (ddd,hh,mm,ss) where ddd is the number of the day of the year, hh is the time in hours, mm the time in minutes and ss the time in seconds. openUTM requires time for unique identification of which message is to be deleted. | ||
CHAINMSG= | Indicates whether the negative confirmation job should be activated or not when deleting a job complex (DPUT job with confirmation jobs). | |
ACT | The negative confirmation job is activated if it exists. | |
DEL | The negative confirmation job is also deleted. Default: ACT | |
Result
openUTM sends a message to the LTERM partner/LPAP partner through which the command was called. From the message you can identify whether the job was accepted or rejected. To find out whether openUTM was able to successfully execute the job, you must follow up with a KDCDADM INFORM query.