Specifying job output characteristics

JOEs are selected for output processing based on the job's output priority. The original priority is set by the OUTPRTY(n) statement, but this level is permitted to increase based on the minimal priority aging level set by the PRTYLOW= and the maximum priority aging level set by the PRTYHIGH= parameters on the OUTDEF statement at a rate as specified by the PRTYRATE= parameter on the JOBDEF statement. You can use JES2 commands to specify these and other parameters and control output processing.

JES2 allows you to specify print train and either carriage tape name or forms control buffers for SYSOUT directed to printers with these features. JES2 also supports the 3525 print and interpret features for SYSOUT data sets. Additionally, you can specify all options and features of the 3800 printer for SYSOUT data sets directed to the 3800. This allows you to minimize operator interaction due to forms, carriage tape, and print train loading for impact printers, and forms, overlay frames, and burster loading for the 3800.

You can specify JES2 output characteristics in the following ways:

Set output characteristics for JOEs

There are two ways of dynamically changing the output characteristics for all or selected JOEs belonging to the specified jobs:

By using SDSF or a functionally equivalent product to access the output JCL statements
By using the $T O command to set output characteristics

Since all JES2 output characteristics are assigned on either output JCL statements or on JES2 initialization statements, it is recommended that you use the SDSF interface to change the output characteristics for a SYSOUT data set. For further information about the SDSF interface, see z/OS SDSF Operation and Customization, SA23-2274. For further information on output JCL statements, see z/OS MVS JCL Reference, SA23-1385. The following table lists all output characteristics and shows how they can be dynamically modified.

Table 1. Changing Output Characteristics for SYSOUT Data
Output Characteristic keyword	Purpose	How To Modify
ADDRESS=	Specifies an address to be printed on print separator pages.	SDSF
BUILDING=	Specifies a building location to be printed on print separator pages.	SDSF
BURST=	Directs output to a stacker on a 3800 printer subsystem.	SDSF(BURST=) or $T O line command (B=)
CLASS=	Assigns the data set to an output class.	SDSF(CLASS=) or $T O line command (Q=)
COMSETUP=	Specifies options for microfiche printers.	SDSF
CONTROL=	Specifies that the data set records begin with carriage control characters or specifies line spacing.	SDSF(CONTROL=) or $T O line command (C=)
DEPT=	Specifies a department identification to be specified on separator pages.	SDSF
DEST=	Sends a data set to the specified destination.	SDSF(DEST=) or $T O line command (D=)
FLASH=	Indicates that the data set is to be printed with forms overlay and can specify how many copies are to be flashed.	SDSF(FLASH=) or $T O line command (O=)
FORMS=	Identifies forms on which the data set is to be printed or punched.	SDSF(FORMS=) or $T O line command (F=)
FORMDEF=	Names a library member that PSF uses in printing the SYSOUT data set on a page-mode printer.	SDSF
NAME=	Specifies the preferred name to be printed on output separator pages.	SDSF
NOTIFY=	Specifies the print complete message to as many as four users.	SDSF
OUTBIN=	Specifies the output bin.	SDSF
OUTDISP=	Specifies the disposition of the process instance for normal or abnormal termination of the job step.	SDSF(OUTDISP) or $T O line command (OUTDISP=)
PAGEDEF=	Names a library member SYSOUT data set on a page-mode printer.	SDSF
PRMODE=	Identifies the process mode required to print the SYSOUT data set.	SDSF(PRMODE) or $T O line command (PRMODE=)
PRTY=	Specifies initial priority at which the SYSOUT data set enters the output queue.	SDSF(PRTY) or $T O line command (P=)
ROOM=	Specifies a room identification to be printed on output separator pages.	SDSF
TITLE=	Identifies a report title to be printed on new separator pages.	SDSF
USERLIB=	Identifies the libraries containing Advanced Function Printing (AFP) resources to be used by Print Services (PSF) when processing SYSOUT data sets.	SDSF
UCS=	Specifies universal character set, print train, or character-arrangement table for a 3800 Printing Subsystem.	SDSF(UCS=) or $T O line command (T=)
WRITER=	Names an external writer to process the SYSOUT data set rather than JES2.	SDSF(WRITER=) or $T O line command (W=)

Specify JES2 job output characteristics

The $T OUTDEF command allows you to specify the general output processing characteristics of JES2, such as whether the MAS configuration is to use shared broadcasting. You also specify the number of job output copies that may be requested, set the percentage of JOE usage at which you are alerted of a shortage, and set the PRTYHIGH and PRTYLOW characteristics for jobs that have not yet been selected for execution. The PRTYOUT=Y|N parameter specifies whether the priority specification (PRTY=) on the JCL OUTPUT statement is supported or not.

Note: The $T OUTDEF command does not affect output that has already been created. This also applies to the $T commands that control conditional purging described below.

You can control conditional purging of output for jobs according to the type of job.

STCs, using the $T JOBCLASS(STC) command.
TSUs, using the $T JOBCLASS(TSU) command.

Specify output disposition

You can specify the disposition for output data sets through the OUTDisp parameter on the following commands:

$T JOBCLASS
$T OUTCLASS

You can specify the following dispositions:

HOLD: Hold the output. JES2 does not process the output until you either change the disposition to WRITE or KEEP, or release the output. When the output is released, the disposition changes to WRITE.
KEEP: Process the output and then keep a copy of it on spool. After processing, the disposition of this output becomes LEAVE.
LEAVE: JES2 does not process the output until you change the disposition to either WRITE or KEEP, or release the output. When the output is released, the disposition changes to KEEP.
PURGE: Purge the output immediately.
WRITE: Process the output then purge it.

For each command you can specify abnormal and normal dispositions. The abnormal disposition applies when a job abends or contains a JCL error. The default is abnormal disposition.

Below you can see the output disposition changes that take place after a data set has been released and/or processed.

Figure 1. Specify Output Dispositions

                                  ┌────────────┐         ┌────────────┐
     WRITE ──────────────────────→│            │────────→│            │
                              ↑   │            │         │            │
                              │   │            │         │            │
                              │   │            │         │            │
                              │   │            │         │            │
                              │   │            │         │            │
                              │   │            │         │            │
                  ┌───────┐   │   │            │         │            │
     HOLD  ──────→│ Hold  │───┘   │            │         │            │
                  │       │       │   Print    │         │  Purge     │
                  │       │       │            │         │            │
                  │ Queue │       │            │         │            │
 ──────→LEAVE ──────→     │───┐   │            │         │            │
  │               │       │   │   │            │         │            │
  │               │       │   │   │            │         │            │
  │               │       │   │   │            │         │            │
  │               │       │   │   │            │         │            │
  │               │       │   │   │            │         │            │
  │               └───────┘   │   │            │         │            │
  │                           │   │            │         │            │
  │                           │   │            │         │            │
  │                           │   │            │         │            │
  │                           ↓   │            │         │            │
  │  KEEP  ──────────────────────→│            │──→──┐   │            │
  │                               └────────────┘     │   └────────────┘
  │                                                  │
  │                                                  │
  └───────────────────←──────────────────────────────┘

Specify JES2 output scheduling priority in relation to output quantity

The $T OUTPRTY(n) relates scheduling to the quantity of records or pages of output. When JES2 builds JOEs for a job, it assigns a priority to each JOE based on the total number of output lines, cards, or pages represented by the JOE. The $T OUTPRTY(n) command allows you to specify page, record, and priority parameters to control output scheduling.

Note: This command does not affect post-execution jobs, nor does it affect an output data set if the PRTY= parameter was specified on the data set's OUTPUT JCL statement and PRTYOUT=YES was specified on the OUTDEF initialization statement.

Specify the default spool space utilization for job output

Use the $T ESTBYTE command to specify the default amount of spool space needed for a job's output (1-99999 bytes) and the action that JES2 takes if the output exceeds this amount. You specify the interval at which JES2 issues the $HASP375 message informing you that the amount has been exceeded and control whether the job is to continue executing or be cancelled (with or without issuing a dump).

Specify the estimated print line count for jobs

The $T ESTLNCT command allows you to specify the default print line count (1-9999) in thousands of lines for a job's output and the action JES2 takes if the job exceeds this estimate. You receive the $HASP375 message informing you that the line count has been exceeded at the interval specified on the INT parameter. The OPT parameter allows you to control whether JES2 is to allow the job to continue executing or cancel the job and, optionally, issue a dump.

For example, specifying $T ESTLNCT,NUM=20,INT=1000,OPT=1 indicates to JES2 that, if a job that has not yet been selected for execution exceeds 20,000 print lines, JES2 should issue the $HASP375 message for every 1000 lines after 20,000 and cancel the job without issuing a dump.

Specify the estimated page count for a job's output

The $T ESTPAGE command allows you to specify the default page count (1-999999)for a job's output and the action JES2 takes if the job exceeds this estimate. You receive the $HASP375 message informing you that the page count has been exceeded at the interval specified on the INT parameter. The OPT parameter allows you to control whether JES2 is to allow the job to continue executing or cancel the job and, optionally, issue a dump.

Specify the estimated punched card output for jobs

The $T ESTPUN command allows you to specify the default number of punched cards per job (0-9999999) and the action JES2 takes if the job exceeds this estimate. You receive the $HASP375 message informing you that the page count has been exceeded at the interval specified on the INT parameter. The OPT parameter allows you to control whether JES2 is to allow the job to continue executing or cancel the job and, optionally, issue a dump.