In many cases, the information about messages provided by openUTM (see section "DADM RQ" in chapter "Displaying information on messages in a queue - DADM RQ") is not sufficient to enable the administrator to uniquely identify a message. For this reason, the job submitter can store additional information when creating a message using the DPUT call: this information is known as user information. User information is written with the DPUT NI call or, in the case of confirmation jobs in job complexes, with DPUT +I or DPUT -I (see the openUTM manual „Programming Applications with KDCS”).
This user information is not passed to the recipient of the message. However, it is linked to the job ID of the message and can only be read with DADM UI.
When a call is received from DADM UI, you must pass the job ID and the time the message was created in the KB parameter area. Both items of data can be determined in advance with DADM RQ.
You cannot read the user information relating to confirmation jobs in job complexes until the confirmation job has been activated.
See sections "KDCDADM INFORM", "LIST=LONG" in chapter "INFORM - Display information about message queues and messages". |