PRT statement

A PRT statement (also called a printer definition) is required to define each FSA.

The PRT(nnnn) statement contains these parameters:

PRT(nnnn)

Specifies the name of an FSA that is associated to the sender, where nnnn is 1- to 5-digits. In addition to the PRT(nnnn) format, AFP Download Plus accepts the PRINTnnn and PRINTERn formats, if the name is no more than 8 characters. In this documentation, PRT(nnnn) is used to represent the FSA definition statement.

CKPTMODE={PAGE | SEC}

Specifies whether checkpointing of a data set being transformed is based on the number of pages or on time. If you specify both CKPTPAGE and CKPTSEC, the CKPTMODE parameter determines which value is used. This parameter is optional.

Note:

AFP Download Plus checkpoints data sets; however, when an error occurs, AFP Download Plus restarts from the beginning of a job, not from a checkpoint.

CKPTPAGE=nnn

Specifies the number of pages between checkpoints of a data set being transformed.

Note:

AFP Download Plus checkpoints data sets; however, when an error occurs, AFP Download Plus restarts from the beginning of a job, not from a checkpoint.

CKPTSEC={nnnnn | 0}

Specifies the seconds between checkpoints of a data set being transformed. The value must be 0 - 32767.

The default is 0, which means AFP Download Plus only checkpoints a data set if a checkpoint value is specified on the OUTPUT JCL statement for the data set.

Note:

AFP Download Plus checkpoints data sets; however, when an error occurs, AFP Download Plus restarts from the beginning of a job, not from a checkpoint.

CLASS=n

Specifies the output class that is processed by this FSA. List all classes to be selected by this FSA; do not separate each class with a comma.

This parameter is optional. If you omit it, this FSA selects data sets with any output class.

FCB=pdefname

Specifies the 1- to 4-character name of a default page definition. Do not code the P1 prefix of the page definition. This name is translated to uppercase.

This parameter is optional. If you omit it, JES2 determines the default page definition from the NIFCB parameter of the JES2 PRINTDEF statement. If no default is specified on the PRINTDEF statement, the default is that specified on the PRINTDEV statement in the FSS startup procedure.

FORMS=(formnames)

Specifies the 1- to 8-character form names processed by this FSA. List 1 - 8 different form names that can be selected by this FSA; separate each form name with a comma.

If you designate F as a work-selection criterion on the WS parameter, the FSA selects data sets whose form name matches one of the values specified here.

This parameter is optional. If you omit it and do not specify F as a work-selection criterion, this FSA selects data sets with any form name.

FSS=fssname

Specifies the name of the sender FSS associated with this FSA. This parameter is required.

MODE=FSS

Specifies that the FSA is managed by an AFP Download Plus sender. This parameter is optional. The default is FSS if you do not code the FSS parameter.

PRESELCT={YES | NO}

Specifies whether output data sets are preselected for this FSA. This parameter is optional. If you omit it, the default is YES.

PRMODE=(processingmodes)

Specifies the data-set processing modes that are supported by this FSA. Separate the modes with commas. List all PRMODE values to be accepted by this FSA, because the FSA processes only data sets with a mode that matches one of the values specified in this parameter:

LINE

Specifies that data sets containing line data are selected.

PAGE

Specifies that data sets containing MO:DCA-P data are selected.

SOSIn

Specifies that data sets with the shift-out, shift-in processing mode of SOSI1, SOSI2, SOSI3, or SOSI4 for double-byte fonts are selected.

installation-defined

Specifies any mode that your installation has defined.

Specify both LINE and PAGE for FSAs that are to transmit both types of data sets.

This parameter is optional. If you omit it, the default is LINE.

SEP={YES | NO}

Specifies whether this FSA produces job-header and job-trailer separator pages. The default is YES.

SEPDS={YES | NO}

Specifies whether this FSA produces formatted data set header separator pages. The default is NO.

START={YES | NO}

Specifies whether JES2 is to automatically start this FSA whenever JES2 starts. If you specify NO, the operator must start the FSA.

This parameter is optional. If you omit it, YES is the default.

TRKCELL={YES | NO}

Specifies whether track-cell despooling is to be used with this FSA. You specify the size of the track cell, in terms of buffers, in the TRKCELL parameter of the JES2 SPOOLDEF statement. For improved performance, you should specify TRKCELL=YES on this statement and TRKCELL=5 on the JES2 SPOOLDEF statement.

This parameter is optional. If you omit it, the default is NO.

UCS={fontname | 0}

Specifies the 1- to 4-character default font name. 0 specifies that no default font is passed to AFP Download Plus.

This parameter is optional. If you omit it, JES2 determines the default font from the NIUCS parameter of the PRINTDEF statement or, if NIUCS is not specified, from the PRINTDEV statement of the startup procedure.

WS=(criteria)

Specifies the work-selection criteria for this FSA; separate each value with a comma. See the z/OS JES2 Initialization and Tuning Reference for the valid values and defaults.

This parameter is optional but recommended. If you omit it, the FSA selects output data sets for processing according to default work-selection criteria.