Sample initialization statements for JES3

Figure 35 shows sample JES3 statements for a host-connected, channel-attached, non-SNA printer (JNAME=PRT1), an SNA-attached printer (JNAME=PRT2), and a TCP/IP-attached printer (JNAME=PRT3).

FSSDEF,TYPE=WTR,FSSNAME=FSS1,PNAME=SAMPPRO1
DEVICE,DTYPE=PRTAFP1,JNAME=PRT1,JUNIT=(00E,SYS1,UR,ON),
       XTYPE=(PRT1,UR),XUNIT=(00E,SYS1,UR,OFF),FSSNAME=FSS1,
       MODE=FSS,PM=(LINE,PAGE,SOSI1),CHARS=(YES,60D8),DYN=(NO),
       CARRIAGE=(YES,A868),CKPNTPG=100,HEADER=YES,
       BURST=(YES,M),NPRO=99,WC=(A),FORMS=(NO,NARROW),FEATURES=(SS),
       STACKER=(NO,S)

FSSDEF,TYPE=WTR,FSSNAME=FSS2,PNAME=SAMPPRO2,SYSTEM=SYS1,TERM=NO
DEVICE,DTYPE=PRTAFP1,JNAME=PRT2,JUNIT=(,SYS1,,OFF),FSSNAME=FSS2,
       MODE=FSS,PM=(LINE,PAGE,SOSI1),CHARS=(YES,60D8),
       CARRIAGE=(YES,A868),CKPNTPG=100,HEADER=YES,WC=(B)

FSSDEF,TYPE=WTR,FSSNAME=FSS3,PNAME=SAMPPRO3,SYSTEM=SYS1,TERM=NO
DEVICE,DTYPE=PRTAFP1,JNAME=PRT3,JUNIT=(,SYS1,,OFF),FSSNAME=FSS3,
       MODE=FSS,PM=(LINE,PAGE,SOSI1),CHARS=(YES,60D8),
       CARRIAGE=(YES,A868),CKPNTPG=100,HEADER=YES,WC=(C)

Figure 36 shows sample JES3 statements for running multiple FSAs under a single FSS.

FSSDEF,TYPE=WTR,FSSNAME=J3PSFSW,PNAME=J3PSFSW
DEVICE,DTYPE=PRTAFP1,JNAME=PRT12,XTYPE=(PRM,UR),CKPNTPG=5,
       DGROUP=LOCAL,JUNIT=(390,SYS1,UR,OFF),XUNIT=(390,SYS1,UR,ON),
       FSSNAME=J3PSFSW,MODE=FSS,PM=(LINE,PAGE),WS=(CL),WC=(M)
DEVICE,DTYPE=PRTAFP1,JNAME=PRT17,CKPNTPG=5,
       DGROUP=VOYAGER,JUNIT=(,SYS1,,OFF,,SYS2,,OFF),
       FSSNAME=J3PSFSW,MODE=FSS,PM=(LINE,PAGE),WS=(CL),WC=(Y)

Parameters for the JES3 initialization statement

FSSDEF statement and DEVICE statement describe the JES3 initialization statements shown in Figure 35, which are typical of the JES3 statements used with PSF. For more detailed descriptions of all the JES3 initialization statements, see the z/OS JES3 Initialization and Tuning Referencez/OS JES3 Initialization and Tuning Reference.

The descriptions show which statements and parameters are required. In the programming syntax shown for each parameter, defaults are underscored.

FSSDEF statement

The FSSDEF initialization statement is optional but recommended. If it is omitted, JES3 generates a default FSS for the printer being started.

The FSSDEF statement can contain the following parameters:

TYPE

Specifies that the FSS is an output writer for deferred printing (TYPE=WTR). This parameter is required.

FSSNAME

Specifies the unique name of a particular FSS. This parameter is required.

PNAME

Specifies a procedure for starting a specific PSF FSS. The procedure, which must be defined before that FSS is started, is a member of the procedure library defined by the STCPROC parameter of the STANDARDS statement or of the IATPLBST procedure library (the default). Different FSSDEF initialization statements can refer to the same startup procedure.

The PNAME parameter can specify either a startup procedure supplied with PSF, or one of your organization’s procedures. In the examples shown in Figure 35, SAMPPRO2 is the PNAME for the host-connected, channel-attached, non-SNA printer and SAMPPRO3 is the PNAME for the SNA-attached printer. SAMPPRO1 and SAMPPRO2 are shown in Figure 38.

SYSTEM

Specifies the JES3 processor on which the FSS is to run. The name must be the same as that specified on the NAME parameter of the MAINPROC statement for the processor.

TERM=YES|NO

YES specifies that the FSS is to be stopped if the JES3 global address space ends by a *RETURN or *DUMP operator command.

DEVICE statement

A DEVICE statement is required for each printer. The DEVICE parameters create JES3 default values that are used unless other values are specified in the JCL application program. The DEVICE statement can contain the following parameters:

BURST=(YES|NO [,M])

Specifies whether trailer pages are printed and marked.

YES

Specifies that trailer pages are to be printed.

NO

Suppresses the printing of trailer pages.

M

Specifies that the edges of the trailer pages are to be marked.

Notes:

1. This parameter is not related to the burster-trimmer-stacker (BTS) feature installed on continuous-forms printers. To specify burster-trimmer-stacker options, see STACKER.
2. If DPF is installed, you must specify BURST=(YES). For more information, see Distributed Print Function (DPF) considerations.

CARRIAGE=(YES|NO,aaaa)

Specifies the JES default page definition.

YES

Specifies that the page definition can be changed during startup procedure.

NO

Specifies that the page definition cannot be changed during the startup procedure.

aaaa

Specifies that the unprefixed name (1 to 4 characters) of the page definition is to be used as a default. The name specified here, or the JES3 system default, is the PSF default page definition. For information about selecting PSF defaults, see How PSF selects resources.

CHARS

Specifies a default JES3 font. For a chart showing how fonts are selected in PSF, see How PSF selects resources.

CKPNTPG

Specifies the number of pages between data set checkpoints. Specify no more frequent checkpoints than you actually need in order to monitor a print job. If checkpoint intervals are too frequent, printer performance is significantly reduced. If intervals are too few, and a PSF error occurs, the job will need to be reprocessed from the last checkpoint. For printing to paper, a starting value of 100 is recommended. For printing to microfilm output, specify a CKPNTSEC keyword instead of CKPNTPG. For additional information about printing to microfilm, see Supporting AFP output on microfilm.

Note:

PSF can only use checkpoint information created by the same level of PSF that is currently printing the data set. For example, if a data set was checkpointed by PSF 4.4.0, but is now being printed by PSF 4.5.0, the checkpoint data is ignored and the data set is restarted from the beginning.

CKPNTSEC

Specifies the seconds between data set checkpoints.

Notes:

1. For printing to microfilm output, specify the CKPNTSEC parameter. For additional information about printing to microfilm, see Supporting AFP output on microfilm.
2. PSF can only use checkpoint information created by the same level of PSF that is currently printing the data set. For example, if a data set was checkpointed by PSF 4.4.0, but is now being printed by PSF 4.5.0, the checkpoint data is ignored and the data set is restarted from the beginning.

COPYMARK=C|N|J

Specifies that you want vertical separator lines printed on the edges of the output or that you want offset stacking done. These separator lines help identify the beginning and end of each job or data set in a stack of output. A change in the thickness of the copy mark indicates the beginning of a new job, a new data set, or one of multiple copies of a data set.

C

Specifies that copy marks are to be printed or offset stacking is to be done for each copy of a data set. For multiple copies of a data set, JES3 increments the thickness of the copy mark after each copy.

N

Specifies that you do not want to use copy marks or offset stacking. Although JES3 continues to print a vertical line on the edges of output from 3800 printers, the thickness does not vary.

J

Specifies that you want copy marks printed or offset stacking done on a job basis. A change in the thickness of the copy mark indicates the beginning of a new job.

For more information about copy marking, see Copy marking and offset stacking.

DTYPE

Identifies these printer device types:

• DTYPE=PRT38003 for a 3800 Model 3 printer
• DTYPE=PRT38003 for a 3800 Model 6 printer
• DTYPE=PRT38008 for a 3800 Model 8 printer
• DTYPE=PRT3820 for a 3820 printer
• DTYPE=PRTAFP1 for all other printers and microfilm devices

This parameter is required.

DYNAMIC=YES|NO

Specifies whether you want this device started dynamically when work is available to print, to punch, or to be sent to a remote printer or punch. For all devices except those that run under the control of an output writer FSS, the default is YES. For devices that run under the control of an output writer FSS, the default is NO. For more information, see the see the z/OS JES3 Initialization and Tuning Guidez/OS JES3 Initialization and Tuning Guide.

FEATURES

FEATURES=SS specifies that the printer has a burster-trimmer-stacker.

FLASH

Specifies whether forms flash is used (3800 printer only), and specifies the name of the forms overlay to be used.

Note:

If you want to use the FLASH parameter specified in the form definition specified in the PSF PRINTDEV statement, do not define a FLASH parameter in the JES3 DEVICE statement.

FORMS

Specifies whether forms can be changed between print jobs; specifies the initial form loaded in the printer.

FSSNAME

Specifies a unique FSS for this printer DEVICE statement. The value must match the value coded for the FSSNAME parameter in the corresponding FSSDEF statement.

HEADER=YES|NO

Specifies if job and data set header pages are printed.

For microfilm devices, you should specify HEADER=NO.

Note:

If DPF is installed, you might need to specify HEADER=YES. For more information, see Distributed Print Function (DPF) considerations.

JNAME

Specifies the name of the printer FSA. Each printer FSA should have a unique JNAME. This unique JNAME is 8 characters or fewer and must correspond to its label on the CNTL, ENDCNTL, and PRINTDEV statements for the PSF startup procedure specified in the PNAME parameter. For more information, see Figure 38. This parameter is required.

JUNIT

Specifies:

• The device address (host-connected, channel-attached, non-SNA printers only)
• The name of the processor to which the device is attached
• A destination class for messages about the device
• Whether the device is initially online or offline

This parameter is required.

Note:

Do not specify a device address for SNA-attached or TCP/IP-attached printers.

MODE=FSS

Specifies that the printer is managed by an FSS. This parameter is required.

NPRO

Specifies the interval after which output in the paper path is forced to the stacker with a nonprocess run out.

This parameter is used only for continuous-forms printers and microfilm devices. For more information about printing to microfilm, see Supporting AFP output on microfilm.

If NPRO is non-zero when the printer is stopped and the PSF FSA stops, PSF causes the printer to do an NPRO immediately without waiting for the NPRO time to expire. This ensures that all data has reached the printer stacker before PSF releases the last data set to JES as complete.

If NPRO=0, PSF never sends an NPRO request to the printer, even when the printer is stopped and the PSF FSA stops. For some duplex continuous-forms printers, the back sides of some pages might not be printed when the printer indicates to PSF that the last page is printed. If a print problem occurs after PSF stops processing, data might be lost. Even if you do not typically want NPROs, you might want to set a large NPRO value to ensure that all data is complete when PSF stops. This is recommended for duplex continuous-forms printers. The maximum NPRO value allowed for JES3 is 9999 seconds (2 hours 46 minutes).

If NPRO=0 and the PSF DISCINTV (or Disconnect interval) parameter is being used, PSF does not force all the pages of the last job to the stacker when the DISCINTV timer expires. Specify a non-zero NPRO value to force the last pages of the last job to the stacker when the DISCINTV timer expires. For more information about the DISCINTV parameter, see Disconnect interval.

If NPRO=0 and the printer supports the Universal Printer Pre- and Post-Processing Interface (UP3I), the last pages of the last job sent to the printer are NOT forced through the post-processing equipment when stopping the PSF FSA. This can result in an incomplete job being found in the UP3I equipment. Therefore, make sure that you manually force all pages to the stacker before stopping the PSF FSA to prevent lost pages or an incomplete job in the post processor.

PDEFAULT=NONE|CHARS|FCB|CHARS,FCB

Specifies whether the JES3 default values are used during FSS processing or they are ignored and the PRINTDEV value for CHARS, FCB, or both is used.

NONE

Specifies that the FSS uses all the JES3 default values; no PRINTDEV values are used.

CHARS

Specifies that the JES3 default for characters (UCS or train) is ignored and the PRINTDEV value for CHARS is used when the WS=U parameter is specified on the DEVICE statement.

FCB

Specifies that the JES3 default for carriage (FCB or CARR) is ignored and the PRINTDEV value for PAGEDEF is used when the WS=C parameter is specified on the DEVICE statement.

CHARS,FCB

Specifies that the JES3 default for characters (UCS or train) and carriage (FCB or CARR) are ignored. PSF uses the PRINTDEV value for CHARS when the WS=U parameter is specified on the DEVICE statement and the PRINTDEV value for PAGEDEF when the WS=C parameter is specified on the DEVICE statement

Note:

JES3 always sends its default values to the FSS when PDEFAULT is not specified.

PM

Specifies which data set processing mode is supported. PM=LINE specifies a printer that can print line format data sets. PM=PAGE specifies a printer that can print MO:DCA-P data sets. PM=SOSI1, PM=SOSI2, PM=SOSI3, or PM=SOSI4 specifies a printer that can process double-byte fonts. For more information about SOSI processing, see PSF for z/OS: User’s Guide.

STACKER

Specifies whether output stacking can change, and whether the paper is to be threaded to the burster-trimmer-stacker for bursting and offset stacking (S) or sent to the continuous-forms stacker (C). This parameter is only for a continuous-forms printer with a burster-trimmer-stacker installed.

WC

Specifies the print output class that the printer is to process. You might want to consider handling disabled mechanisms by defining print classes. For more information, see Disabled mechanisms.

WS=(work_selection_criteria)

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

For a PSF FSA, consider these values:

C

Causes JES3 to pass the FCB name specified on the OUTPUT JCL statement to the FSA.

CL

Specifies that the FSA selects only those data sets with the same class as specified in the WC parameter of this statement.

D

Specifies that the FSA selects only those data sets with the same destination name as in the DGROUP parameter of this statement.

F

Causes JES3 to pass the form name specified as a JCL parameter to the FSA.

U

Causes JES3 to pass the font name specified as a JCL parameter to the FSA.

Notes:

1. This parameter is optional but recommended. If you omit it, the FSA selects output data sets for processing according to default work-selection criteria.
2. If you want PSF to use the FCB specified in the FCB JCL parameter to format output, specify WS=C as one of the work-selection criteria. Otherwise, JES3 does not pass the FCB name specified in JCL to the FSA.
3. If you want PSF to use the form name specified in the FORMS JCL parameter to select printer definitions in the Printer Inventory, specify WS=F as one of the work-selection criteria. Otherwise, JES3 does not pass the form name specified in JCL to the FSA.
4. If you want PSF to use the page definition specified in the PAGEDEF (or FCB) JCL parameter, specify WS=C as one of the work-selection criteria. Otherwise, JES3 does not pass the page definition name specified in JCL to the FSA.
5. If you want PSF to use the font specified in the CHARS (or UCS) JCL parameter, specify WS=U as one of the work-selection criteria. Otherwise, JES3 does not pass the font name specified in JCL to the FSA.

XTYPE

Specifies the characteristics of the FSS-managed printer as it is used by jobs in execution. This parameter is valid only for channel-attached printers, and is required if the JUNIT parameter specifies a device address. XTYPE, if used, must precede the XUNIT parameter.

Note:

XTYPE is not valid for SNA-attached or TCP/IP-attached printers.

XUNIT

Specifies the device address, the name of the processor to which the device is attached, a destination code for messages about the device, and the initial status of the device—online or offline. It also specifies whether the device is initially online or offline.

This parameter is valid only for channel-attached printers, and is required if the JUNIT parameter specifies a device address.

Note:

XUNIT is not valid for SNA-attached or TCP/IP-attached printers.