DADM DA allows you to delete all messages to a given recipient which have not been processed at the time of the DADM DA call. In the case of service-controlled queues, messages that are currently being read cannot be deleted. If a service-controlled queue is deleted dynamically (KC_DELETE_OBJECT or QREL RL), the messages in this queue are lost. Messages already processed by the recipient are not deleted. With DADM DA calls you have to specify the name of the recipient in the kclt field of the KB parameter area.
With DADM DL you delete one specific message. To identify this message you have to enter the job ID and the time when the message was created. Both these items of data can be determined using DADM RQ.
If the specified message has already been processed by the recipient, the DADM DL call is rejected by openUTM (return code 40Z).
In particular, you cannot use DADM DA/DL to delete any print output which has already been started. To do this, you must follow the procedure described below:
Terminate the connection to the printer on which the job is being processed (PADM CS). openUTM also terminates the link to the printer if you disable the printer using PADM CS.
Delete the print job (DADM DL).
Restore the connection to the printer (PADM CS; see chapter "Changing the printer status - PADM CS").
If confirmation jobs are assigned to the message being deleted (DPUT jobs in job complexes) you can specify with DADM DL whether the negative confirmation job is to be activated when the message is deleted or whether the confirmation jobs are to be deleted together with the main job (kcmod field in the KB parameter area).
For information about job complexes and confirmation jobs, see the openUTM manual „Programming Applications with KDCS”.
|