OUTPUT command operands

(jobname (jobid))

specifies one or more names of batch or foreground jobs. The job name for foreground session is user ID. Each job name must begin with your user identification and, optionally, can include one or more additional characters unless the default IBM-supplied installation exit that scans and checks the job name and user identification is replaced by a user-written routine. The system processes the held output from the jobs identified by the job name list.

To avoid duplicate job names, you should include the optional job ID for uniqueness. The job ID is a unique job identifier assigned by the job entry subsystem (JES) at the time the job was submitted to the batch system. Currently the only valid forms of job identifiers (jobid) assigned by JES are:

JOBnnnnn or Jnnnnnnn – Jobs
STCnnnnn or Snnnnnnn – Started Tasks
TSUnnnnn or Tnnnnnnn – TSO Users

CLASS(class_name)

specifies the name or names of the output classes to be searched for output from the jobs identified in the job name list. If you do not specify the name of a class, all held output for the jobs are available. A class name is a single character or digit (A-Z or 0-9).

PRINT(dsname | *)

specifies the name of the data set to which the output is to be directed. If unqualified, the prefix is added to and the qualifier OUTLIST is appended to the data set name. You can substitute an asterisk for the data set name to indicate that the output is to be directed to your terminal. If you omit both the data set name and the asterisk, the default value is the asterisk. PRINT is the default value if you omit PRINT, DELETE, NEWCLASS, DEST, and HOLD/NOHOLD.

If the PRINT data set is not pre-allocated, RECFM defaults to FBS, LRECL defaults to 132, and the BLKSIZE defaults to 3036.

BEGIN | HERE | NEXT

BEGIN: indicates output operations for a data set are to start from the beginning of the data set regardless of whether it has been checkpointed.
HERE: indicates output operations for a data set that has been checkpointed are to be resumed at the approximate point of interruption. If the data set is not checkpointed, it is processed from the beginning. If you omit HERE, BEGIN, and NEXT, then HERE is the default.
NEXT: indicates output operations for a data set that has been previously checkpointed are to be skipped. Processing resumes at the beginning of non-checkpointed data sets.

CAUTION:

The checkpointed data sets that are skipped are deleted unless the KEEP operand is specified.

PAUSE | NOPAUSE

PAUSE: indicates output operations are to pause after each SYSOUT data set is listed to allow you to enter a SAVE or CONTINUE subcommand. Pressing the Enter key after the pause causes normal processing to continue. This operand can be overridden by the NOPAUSE operand of the CONTINUE subcommand. If PAUSE is not specified, then NOPAUSE is the default.
NOPAUSE: indicates output operations are not to be interrupted. This operand can be overridden by the PAUSE operand of the CONTINUE subcommand.

KEEP | NOKEEP

KEEP: specifies the SYSOUT data set is to remain enqueued after printing (see also HOLD and NOHOLD).
NOKEEP: specifies the SYSOUT data set is to be deleted after it is printed. If neither KEEP nor NOKEEP is specified, then NOKEEP is the default.

HOLD | NOHOLD

HOLD

specifies the kept SYSOUT data set is to be held for later access from the terminal.

Note: HOLD may be overridden if DEST(remote_station_id) specifies a network job entry (NJE) node. For example,

TSO OUTPUT job DEST(DETROIT) HOLD

issued on a node in TAMPA will not hold the output.

For JES3 users, HOLD may also be overridden if NEWCLASS(class_name) specifies a class defined on a JES3 SYSOUT initialization statement with a default NJE networking node DEST. For example,

SYSOUT,CLASS=D,TYPE=PRINT,DEST=DETROIT

is included in the JES3 initialization stream.

TSO OUTPUT job NEWCLASS(D) HOLD

issued on a node in TAMPA will not hold the output.

Note to JES3 Users: To view the output, you must specify an output class that has been defined as HOLD (for TSO/E) or RSVD (reserved) on the DD statement. If you specify RSVD class, then MSGCLASS and SYSOUT class must be the same as the RSVD class. For more information, see z/OS JES3 Initialization and Tuning Guide.

NOHOLD

specifies the kept SYSOUT data set be released for printing by the subsystem. NOHOLD is the default.

DELETE

specifies classes of output specified with the CLASS operand are to be deleted.

NEWCLASS(class_name)

is used to change one or more SYSOUT classes to the class specified by the class_name subfield.

DEST(remote_station_id)

routes SYSOUT classes to a remote workstation specified by the station ID subfield. The station ID is 1 to 8 characters in length.