Parameters

CLASS=

Specifies the SYSOUT class (A-Z,0-9) being defined.

CARR=

Specifies the name (1 to 8 characters) of the carriage tape or FCB required to print this SYSOUT class. This parameter overrides the CARRIAGE parameter specified as an installation default on the OUTSERV statement and the CARRIAGE parameter on the DEVICE statement indicating the carriage tape or FCB initially mounted. If STANDARD is specified, the carriage tape name is taken from that specified on the OUTSERV initialization statement.

If the device is a 3211, 3203, or 3800 printer, a module must be included in SYS1.IMAGELIB, having the name FCB2xxxx or FCB3xxxx, where xxxx is the 1- to 4-character name of the FCB.

Note: If you are using the user exit IATUX23 and you are coding FCBs for use with JES3 defined printers that are other than 3800, then you must code a channel 12 code in the FCB.

For more information about SYS1.IMAGELIB, refer to z/OS DFSMSdfp Advanced Services.

CHARS=

Specifies the name of the character image to be used in processing this SYSOUT class.

id1-id4: Specifies up to four images to be used for processing this SYSOUT class.
STANDARD: Specifies that the image to be used is as defined by the OUTSERV statement.

CONTROL=

Specifies the type of carriage spacing control required to print this SYSOUT class.

PROGRAM: Specifies that the carriage control character is to be the first character of each logical record in the data set.
SINGLE: Specifies single spacing for the data set.
DOUBLE: Specifies double spacing for the data set.

COPIES=

Specifies the number of copies of each data set to be produced.

num: Specifies the number of copies, from 0 to 255, to be produced for this SYSOUT class. If specified alone, it applies to all printers.
n1-n8: Specifies the number of transmissions of a data set and the number of copies, from 1 to 255, to be produced with each transmission. If n1 is specified, it is applicable only to impact printers. For example, COPIES=(1,5,2,6) produces one copy on an impact printer and three transmissions of the data set to a 3800 printer, where the first transmission produces five copies, the second produces two copies, and the third produces six copies.

DEST=

Specifies the printer or punch to process this SYSOUT class. This parameter indicates the device specifically by name or nonspecifically by device type, device group, or both.

devname: Specifies a 1- to 8-character name for the printer or punch. The name must match the JNAME parameter on a DEVICE statement defining this device.
dtype: Specifies a 1- to 8-character device type which matches the DTYPE parameter on a DEVICE statement for a printer or punch. If dtype only is specified, then any device of this type may process the output class. If dtype is specified with dgroup, then any device of that type within the group processes the output class.
dgroup: Specifies a 1- to 8-character device group name which matches the DGROUP parameter on a DEVICE statement for a printer or punch. If dgroup only is specified, then any device in that group may process the output class. If dgroup is specified with dtype, then any device in that group of the specified type processes the output class.
nodename: Specifies a 1- to 8-character name that is the name of the node to which JES3 networking output is directed. The nodename cannot be defined as the name of the current home node.

Note:

If the DEST= parameter is omitted, there is no default destination associated with this class.
If you specify DEST=(dtype), JES3 assigns LOCAL as the dgroup.

FLASH=

Specifies the name of the forms flash cartridge for a 3800 printer to be used on this SYSOUT class.

id: Specifies the name of the forms flash cartridge.
cnt: Specifies the number of consecutive copies the forms flash is to print.
STANDARD: Specifies that the forms flash cartridge to be used was defined in the OUTSERV statement.

FORMS=

Specifies the name of the printer forms or card stock (1-to-8 alphanumeric or national characters) to be used when processing this output class. This parameter overrides the FORMS parameter specified on the OUTSERV or DEVICE statement. If STANDARD is specified, the forms or card stock specification is taken from that specified on the OUTSERV initialization statement.

HOLD=

Specifies that the output data set is to be held for use by a system function.

TSO: Specifies that the data set is to be held for return to a TSO user.
EXTWTR: Specifies that the data set is to be returned to an external writer.
3540: Specifies that the data set is to be returned to the 3540 external writer.

3540

Specifies that the data set is to be returned to the 3540 external writer.

INT=

Specifies whether the interpret option is required for punched output.

YES: Indicates that a card punch with the interpret option (device type PUN3525I or 3525M) is to be used. Note that the DEST parameter must include a PUN3525I (or M) punch; otherwise, INT=NO is assumed.
NO: Indicates that the interpret option is not needed.

MODIFY=

Specifies the copy modification module (for 3800) and table reference character to be used for this SYSOUT class.

STANDARD: Specifies the copy modification module to be used as defined by the OUTSERV statement.
name: Specifies the name of the copy modification module to be used (1-4 characters).
NONE: Specifies that no copy modification module is to be used.
0-3: Specifies the table reference character to be used with the copy modification module.

OVFL=

Specifies the overflow option.

ON: Indicates that the printer should eject whenever the end-of-forms indicator is sensed (skips to channel 12).
OFF: Indicate that the forms overflow control is not to be used.

PRTY=

Specifies the priority at which the data set is to enter the output queue. The value may be from 0 to 255.

SPART=

Specifies the spool partition that JES3 is to use when it writes data for this SYSOUT class. To specify the default spool partition, omit this parameter. If you specify a partition name, the name must match the NAME parameter on a SPART statement. If you specify the SPART parameter, you must also specify TYPE=DSISO.

If you specify an undefined partition name, JES3 uses the default spool partition.

STACKER=

Specifies the 3800 stacker in which this SYSOUT class output is to be placed.

STANDARD: Specifies the stacker as defined in the OUTSERV statement.
C: Specifies the continuous stacks. If no 3800 has BTS features, STACKER=C is forced.
S: Specifies the sheet stacker, where offset stacking takes place.

TRAIN=

Specifies the print train or band required to print this SYSOUT class.

name: Specifies the name of the print train or band. This parameter specification overrides the TRAIN parameters specified on the OUTSERV or DEVICE statements.
STANDARD: Specifies that the value specified on the OUTSERV statement is to be used.

THRESHLD=

Specifies the default maximum size for a SYSOUT data set. The THRESHLD parameter assumes that the data set size is the number of records in the data set multiplied by the number of copies. Data sets that equal or exceed the value specified are queued as separate pieces of work for output service writers. Specifying STANDARD causes the value specified on the OUTSERV statement to be used.

The THRESHLD parameter on the SYSOUT statement overrides the THRESHLD parameter on the OUTSERV statement.

TRKGRPS=

Specifies the number of track groups (as defined by the GRPSZ parameter on the BUFFER or SPART statement) JES3 is to allocate to jobs within this SYSOUT class. For guidelines on how to determine the appropriate value for the TRKGRPS parameter for your installation, see "Determining Track Group Allocation Sizes" in z/OS JES3 Initialization and Tuning Guide.

prigrps: Specifies the number of track groups to be initially allocated to jobs in this SYSOUT class. The specified value may be 1 through 9.
secgrps: Specifies the number of track groups to be allocated to jobs in this SYSOUT class subsequent to their primary allocation. JES3 allocates the specified amount of spool space after the job uses up its initial allocation, and again (for an unlimited number of times) when the job uses up each secondary allocation and requests more spool space. The specified value may be 1 through 9. If you specify this parameter, you must also specify the TYPE=DSISO parameter.

If you specify an invalid subparameter, JES3 uses the parameter default.

TRUNC=

Specifies whether trailing blanks are to be truncated from SYSOUT data belonging to this SYSOUT class.

YES: Indicates that trailing blanks are to be truncated from SYSOUT data.
NO: Indicates that trailing blanks are not to be truncated from SYSOUT data.

Parameter Default: The default is the value specified on the TRUNC parameter of the BUFFER statement. If the TRUNC parameter is omitted from the BUFFER statement, the default for both parameters is TRUNC=YES.

TYPE=

Specifies the action JES3 takes after a data set in this SYSOUT class is processed. Multiple subparameters must be specified for type DSISO and RSVD data sets if PRINT, PUNCH, or TSO type characteristics are also required. For example, TYPE=(PRINT,DSISO) causes the data set to be printed, but TYPE=DSISO never prints. Omission of the output type subparameter results in the data set becoming lost to output service.

USER1: Specifies that no action is to be taken by JES3 for this class. It is a user responsibility to process data sets in this SYSOUT class.
USER2: Specifies that no action is to be taken by JES3 for this class. It is a user responsibility to process data sets in this SYSOUT class.
DSISO: Specifies that each data set in this class is to have its own track allocation table (TAT). This improves spool utilization because each data set can be purged when the data set processing is complete instead of when the job completes. (Note that the subparameter has no relationship to any other TYPE specification.)
This parameter does not apply to the JESMSGLG, JESJCL, or JESYSMSG data sets. If you specify the SPART or TRKGRPS parameter on this statement, you must also specify the DSISO parameter.
RSVD: Specifies that this is a reserved SYSOUT class. Reserved classes may be used to hold SYSOUT output for TSO. A SYSOUT data set assigned to a reserved class is held for TSO if the MSGCLASS parameter specified for the generating job is also a reserved class.
PUNCH: Specifies that data sets in this SYSOUT class are to be punched.
PRINT: Specifies that data sets in this SYSOUT class are to be printed.

COMPACT=

Specifies the 1- to 8-character name of a compaction table defined to JES3 by the COMPACT initialization statement. Any data set in this SYSOUT class which is sent to a SNA work station (which supports compaction) is compacted using this compaction table instead of the work station default compaction table.

If you omit this parameter, the default compaction table or default compaction table for the work station is used.

CHNSIZE=

Specifies the size of the RU chain to be transmitted to SNA work stations.

DS: Specifies that the entire data set is to be sent as a single chain.
nnn: Specifies the number of pages that the chain is to contain. Control characters in the data (skip to channel 1 for printers or eject for punches) delimit the page size. The value for nnn can be any number from 1-255.
(nnn,mmm): Specifies the number of pages (nnn) in the chain and the number of logical records (mmm) in each page. This form of the subparameter allows you to transmit, as a multiple chain, a data set that contains no control characters.
The value for nnn and for mmm can be any number from 1-255.

Note:

If CHNSIZE=DS is specified no output checkpoints are taken.
If you specify nnn or (nnn,mmm), JES3 takes an output checkpoint before each chain is transmitted.
CHNSIZE specified on a //*FORMAT statement overrides this specification. CHNSIZE specified on this statement overrides CHNSIZE specified on a DEVICE statement.
CHNSIZE=DS gives the best performance, but error conditions detected cannot result in a restart from the last checkpoint since checkpoints are not taken.

OUTDISP=

Specifies the initial output disposition to be assigned when this SYSOUT class is used. The first value specifies the normal output disposition to be used when the job does not abend. The second value specifies the abnormal output disposition to be used if the job abends. The valid output dispositions are:

HOLD: Specifies hold the output. JES3 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: Specifies process the output and then keep a copy of it on spool. After processing, the disposition of this output becomes LEAVE.
LEAVE: Specifies that JES3 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: Specifies purge the output immediately.
WRITE: Specifies process the output then purge it.

If only the normal output disposition value is specified, then the abnormal output disposition is assigned the same value.

If only the abnormal output disposition value is specified, then the normal output disposition is assigned a value of WRITE.

If OUTDISP is specified along with HOLD=3540, then OUTDISP is ignored as it does not apply to 3540 external writers.

If OUTDISP is specified along with HOLD=TSO, then HOLD=TSO is ignored.