Technical data

Setting Up and Maintaining Queues
14.6 Using Queue Options
14.6.2 Using Job Retention Options
Job retention options allow users to retain a job in a queue after the job
completes. System managers can use job retention options to keep information
about all jobs in the queue after the jobs complete; this is helpful when tracking
jobs submitted by other users.
14.6.2.1 Setting Job Retention
Users can set job retention, as can system managers. The following sections
explain how each can perform this task.
User Commands
Users can request that a job be retained in a queue after the job completes by
using the /RETAIN qualifier with the PRINT or SUBMIT command. For example:
PRINT/RETAIN
SUBMIT/RETAIN
System Manager Commands
By default, no job retention option is set on a queue. To specify a job retention
option, use one of the following commands:
INITIALIZE/QUEUE/RETAIN=option
START/QUEUE/RETAIN=option
SET QUEUE/RETAIN=option
You can specify one of the following options:
Option Description
ALL Holds all jobs in the queue after execution (default).
ERROR Holds jobs in the queue only if they complete unsuccessfully.
The following command specifies that the queue retain all jobs that complete with
a status other than success:
$ SET QUEUE/RETAIN=ERROR BATCH_QUE
For example, if you need to know all batch jobs that do not complete successfully
on a specific queue, set the queue to retain jobs that complete with an error
status. You can enter SHOW QUEUE to display a list of jobs (including
their completion status) that completed unsuccessfully. If a job completes
unsuccessfully, this message helps determine why. The displays also include
the date and time at which a retained job completed.
The job retention option you specify on a queue overrides any job retention option
requested by a user for a job in that queue. Figure 14–10 shows how job retention
affects a job submitted to a generic queue.
Setting Up and Maintaining Queues 14–27