Parameter Description for PRT(nnnnn) (All Printers)

CKPTLINE=nnnnnn|0

Specifies the maximum number of lines (0-32767) in a logical page. JES2 uses this value, the CKPTPAGE= parameter on this statement , and the LINECT= parameter on the PRINTDEF, to determine when to take output checkpoints as follows:

JES2 compares the "line count values" you specified on the PRINTDEF LINECT= and PRT(n) CKPTLINE= parameters and then always uses the lesser value.

Checkpoint Interval = line count * CKPTPAGE (if non-zero)

where line count is either:

CKPTLINE if CKPTLINE < LINECT 
                     hence Checkpoint Interval = 
                        CKPTLINE * CKPTPAGE (if non-zero)

LINECT if CKPTLINE > LINECT 
                   hence Checkpoint Interval = 
                      LINECT * CKPTPAGE (if non-zero).

The size of a logical page is also defined as the number of lines printed until:

A channel skip is encountered
The line count specified by the LINECT= parameter on the PRINTDEF statement, the /*JOBPARM control statement, the JCL OUTPUT statement, or the JOB statement accounting field has been exceeded.

Note: This operand is ignored if specified for a printer under the control of a functional subsystem. The functional subsystem does its own physical and logical pages checkpoint based on the CKPTPAGE and CKPTSEC values passed to it from JES2.

Modification: $T PRTnnnnn operator command.

CKPTPAGE=nnnnnn|100

Specifies the number (1-32767) of logical pages for non-page-mode printers and physical pages for page-mode printers to be printed before each checkpoint is taken. This parameter and CKPTLINE= control the amount of checkpoint activity to spool. Although the default is set to 100, a lower value is recommended for slow devices. However, too low a value will degrade performance; therefore, use Exit 15 to protect the JES2 member from users who may specify this value too low in a job. (For further information on Exit 15, see z/OS JES2 Installation Exits).

Note: If you code both CKPTPAGE= and CKPTSEC=, and code CKPTMODE=SEC, the CKPTSEC= specification overrides the CKPTPAGE= specification.

Performance Considerations: This parameter should be set low for slow devices and high for faster printers such as the 3800 to prevent excessive checkpoint cycles from occurring for faster devices.

Modification: $T PRTnnnnn operator command.

CLass | QUEUE=c1...cn|AJ

Specifies the output classes to be processed initially by this printer. You can specify any number of classes up to a maximum of 36 classes.

Modification: $T PRTnnnnn operator command.

CReator=cccccccc

Specifies the 1- to 8-character userid whose output can be selected by this printer. Wildcard specifications are allowed on this parameter.

If this parameter is allowed to default, JES2 can select all output for processing, regardless of userid.

Modification: $T PRTnnnnn operator command.

DEVFCB=xxxx

Specifies a 1- to 4-character name of the forms control buffer (FCB) this printer uses as the default if the printer selects output that does not have an FCB associated with it. If you do not specify DEVFCB=, the printer uses the last FCB that you loaded to process the output if that FCB has the default bit turned on. However, JES2 still determines the default FCB for 3800 printers as described in the FCB= parameter description if you do not specify DEVFCB=. Otherwise, the printer uses the NIFCB specified on the PRINTDEF statement.

Modification: $T PRTnnnnn operator command.

FCB|C=xxxx

Specifies, for impact printers, the forms control buffer image or the carriage control tape that is to be initially mounted on this printer. For the 3800, xxxx specifies the name of both the FCB image that JES2 initially loads into the printer and the installation's default FCB image for data sets not specifying an FCB, unless you coded DEVFCB=.

For all printers, xxxx is the forms control buffer (FCB) identifier that resides in SYS1.IMAGELIB. If this FCB is to be a default FCB, the image in SYS1.IMAGELIB must have the default bit turned on. (For information about the 3800, see Advanced Function Presentation: Printer Information.)

If you do not specify this parameter, JES2 specifies a default based upon the type of printer.

For impact printers, the identifier specified by the FCB= parameter on the PRINTDEF statement
For 3800 printers, the identifier specified by the NIFCB= parameter on the PRINTDEF statement.
FCB=RESET causes the printer to use the default FCB.

Modification: $T PRTnnnnn operator command. For FSS-controlled printers only, if you modify this parameter value and then reconnect the printer on a hot start, the parameter value in effect before termination will be used.

Note: See z/OS JES2 Initialization and Tuning Guide for FCB format restrictions that apply to JES2 printers.

Forms=(xxxxxxxx[,...])

Specifies the 1- to 8-character forms identifier that is to be initially loaded in this printer. Wildcard specifications are allowed on this parameter. You can supply up to eight different forms identifiers to be used as work selection criteria. If the device only supports one form, it is recommended that you only code one form. The forms identifier specified by the STDFORM parameter on the OUTDEF statement.

Modification: $T PRTnnnnn operator command. For FSS-controlled printers only, if you modify this parameter value and then reconnect the printer on a hot start, the parameter value in effect before termination will be used.

FSAROLTR=(YES/NO)

Specifies whether the internal rolling trace for an FSS printer is activated or deactivated. Yes is the default.

HONORTRC=Yes| No

Specifies whether or not the TRC=Yes/No parameter specified on the job's OUTPUT JCL statement will be honored or not honored for a given JES mode printer. HONORTRC= only applies to JES mode printer.

JES mode printer (other than D/T3800) deletes (skips) the Table Reference Character if HONORTRC=YES and TRC=Yes is specified for sysout.

JES mode printer (other than D/T3800) treats Table Reference Character as data if HONORTRC=NO and TRC=Yes is specified for sysout.

Modification: $T PRTnnnnn operator command.

JOBname=jccccccc

Specifies the 1- to 8-character name for a job whose output can be selected by this printer. Wildcard specifications are allowed on this parameter.

If this parameter is allowed to default, JES2 can select all output for processing, regardless of jobname.

Modification: $T PRTnnnnn operator command.

LIMit=m|m-n|m-*

Specifies that output is selected for specific printers based upon the amount of the output (in records). The values m and n specify the range (in records) into which a job output element (JOE) must fall to be processed by this printer. The integer m specifies the lower output size limit and n specifies the upper output size limit.

For both variables m and n, you can specify a range of values 0-4294967295. m and n can be equal. If they are not equal, n must be larger than m.

If you code only m, that value becomes both the lower and upper limit. If m-* is specified, the upper limit is set to the default value of 4294967295.

After a warm start, the original size of the output (before any printing) will be used to determine where the remainder of the output will be printed. That is, the original size of the JOE will be used to determine output device selection.

Default: If you omit this parameter, JES2 uses the defaults m=0 and n=4294967295.

Modification: $T PRTnnnnn operator command.

MODE=JES

Specifies this printer is initially started under the operation of JES2. An operator can change the control mode by use of the $T PRTnnnnn command whenever the printer is drained.

If you do not specify this parameter, the default is JES. Although you can also specify FSS here; however, that value is reserved for FSS-controlled printers only.

Modification: $T PRTnnnnn operator command.

NEWPAGE={1|ALL|DEFAULT}

Specifies how a ‘skip to channel’ is counted as a new page.

1: Specifies that JES2 treats only skip-to-channel-1 as a new page.
ALL: Specifies that JES2 treats skip-to-any-channel as a new page.
DEFAULT: Specifies that JES2 uses the NEWPAGE= value specified on the PRINTDEF initialization statement.

Modification: $T PRT(nnnnn) operator command.

Pause=Yes|No

Specifies whether (Yes) or not (No) this printer is to pause between data set groups.

Modification: $T PRTnnnnn operator command.

Note: This operand has no effect on page-mode printers that operate under the control of a functional subsystem.

PRMode=(vvvvvvvv[,vvvvvvvv...])

Specifies one to eight names that identify the processing modes used by JES2 to direct output data sets to this output device. Wildcard specifications are allowed on this parameter. To specify no processing mode, specify PRMode=() to cause this printer to select no output group if PRMode is also coded on the WS= list. If only one PRMODE is specified, the parentheses are optional.

vvvvvvvv

Specifies the process mode:

LINE: Specifies that the data set contains formatting controls that only a line-mode printer can process.
PAGE: Specifies that the data set contains formatting controls that only a page-mode printer can process.
installation-defined: Specifies that the data set contains formatting characteristics defined at the installation for specific output groups. Users can assign a PRMode= value to the data sets by using JCL OUTPUT statements. However, if the user does not specify a process mode for the data set, JES2 assigns a process mode. IBM® suggests that you prefix installation-defined process mode names with the character U.

Installation-defined and IBM-defined process mode designations may be mixed on one PRMODE= parameter statement. For example, you can specify names on this parameter designating the output device as capable of accepting data sets that can be printed on either a plotter device (for example, UPLOT2) or a page-mode printer device.

PRMODE=(UPLOT2,PAGE)

If you do not specify this parameter, JES2 defaults all printers to LINE.

Modification: $T PRTnnnnn operator command.

RANGE={J|S|T} nnnnnn[-nnnnnn]|J1-999999

Specifies the job ID range for output jobs that can be selected by this printer. Use J to specify batch jobs, S to specify started tasks, and T for TSO/E jobs. You can specify a single job number or range (up to 65534) of jobs.

If you code this parameter, you can specify one or two values:

If you specify one value, that value becomes both the low and the high end of the range.
If you specify two values, the first value is the low end of the range and the second value the high end. If they are not equal, the second value must be larger than the first value. If you specify two equal values, this printer can select only those jobs assigned that particular number.

Modification: $T PRTnnnnn operator command.

Routecde=rtcode

Specifies up to four internal route codes to be assigned to this printer.

The maximum size of a route code is 18 characters. Wildcard specifications are allowed on this parameter for userids only. You can specify a route code in any of the forms listed below.

Ummmmm
destid
remote
user

Note: If you specify a destid on the Routecde parameter, you must place the DESTID initialization statement before the PRTnnnnn statement in the initialization stream. Explanations of the different forms of specifying route codes follow.

Ummmmm

Indicates that output for special local routing is selected. The special routing numbers range from 1 to 32767.

destid

Indicates that output routed to the specified node(s) is selected. If destid is specified alone, it refers to both the node and the remote.

LOCAL | ANYLOCAL

Indicates that output routed to the local node is selected.

remote

Indicates that output routed to a remote is selected. Remote can be specified in any of the following ways:

Rmmmmm: Indicates that output routed to the specified remote is selected. Rmmmmm can also be specified as RMmmmmm or RMTmmmmm. The value specified for mmmmm can range from 1 to 32767.
destid: Indicates that output routed to a destid referring to a remote is selected.

user

Indicates that output routed to a specific userid is selected. Generic userids are also valid. A generic userid is a userid that ends in an asterisk (*), and refers to all userids that begin with the characters preceding the *. Note that the * can only be specified in the last position of the userid.

A userid at the local node must be in the form of a valid TSO/E userid. It must begin with an alphabetic (A-Z) or a special character ( @ # or $ ), and the remaining characters may be alphabetic, numeric, or special characters.

If you specify only one route code the parentheses are optional. To specify a null route code, use Routecde=( ) to cause this printer to select no work if Routecde is also specified in the WS= list.

Note: Route codes for local devices should be used cautiously if you have also coded R on the WS= parameter on this statement. When a printer has been assigned a route code or route codes, it is considered available only for a job that requests printed output through the /*ROUTE control statement, through the DEST keyword on the /*OUTPUT control statement, the JCL OUTPUT statement, the output initialization parameter, or through an operator command. A printer with print routing may also be the default destination for jobs read through a local or remote reader specifying PRDEST= and PRLCL=|PRRMT=. See the RDRnn and Rnnnnn.RDn statements for the details of these options.

Modification: $T PRTnnnnn operator command.

If you do not specify this parameter, the default is LOCAL.

Sep=Yes|No

Specifies whether (Yes) or not (No) separator pages are provided initially between data set groups. (Separator pages can be specified later by the JES2 $T PRTnnnnn command.) JESNEWS data will not be printed unless the job separator page is requested. This specification can be overridden by an Exit 1 routine.

If you do not specify this parameter, JES2 supplies a default of SEP=Yes. However, if LOCAL=NONE or REMOTE=NONE was specified on the SEPPAGE= parameter of the PRINTDEF initialization statement, separator pages are not be produced even if SEP is specified.

SEPDS=Yes|No

Specifies whether (Yes) or not (No) data set separator pages are desired for the data sets within the output groups selected for processing by printers. For this parameter to affect processing, you must customize JES2 or a functional subsystem as follows.

For JES-mode printers (MODE=JES), your systems programmer must have written an Exit 15 (Output Data Set/Copy Separators) that examines the SEPDS= specification and produces separator pages when SEPDS=Yes. Exit 15 controls both the production of separator pages and whether they are affected by the SEPDS= parameter. If Exit 15 is enabled, it is invoked even if SEPDS=No. To enable Exit 15, see z/OS JES2 Installation Exits.

For functional subsystem printers (MODE=FSS), JES2 makes an indication of the parameter's setting available to the functional subsystem. If an FSS printer is controlled by PSF, an APSUX03 exit must have been installed to produce data set header pages. APSUX03 is not invoked if SEPDS=NO. For more information about the APSUX03 exit, see S544-5622 PSF for OS/390 Customization.

Default: SEPDS=NO

Note: Be careful not to confuse this parameter with the SEP=.

SETUP=HALT|NOHALT

Specifies whether JES2 issues the device setup message ($HASP190) after a change of device characteristics (for example, forms control).

SETUP=HALT halts the printer and issues the setup message. This allows the operator to verify the changes to the printer.

SETUP=NOHALT allows the printer to process output without requiring setup verification by the operator. With SETUP=NOHALT, JES2 can load any printer characteristics that require no manual intervention. have not changed to process output.

START=Yes|No

START=No specifies that this printer is to be started by operator command. START=Yes specifies that this printer (if it is ready) will be started automatically when JES2 starts processing.

Default: START=Yes: if the Yes keyword was specified on this initialization statement and unit was not specified for a non-FSS mode printer.

Modification: $S PRTnnnnn operator command or $P PRTnnnnn operator command.

TRace=Yes|No

Specifies whether tracing is activated or deactivated for the specified print processor. To trace a printer, you must also provide the following initialization statements:

TRace(n) START=Yes
TRACEDEF ACTIVE=Yes

Trace IDs 11, 12, 14, 15, and 16 can be specified through the TRACE(n) initialization statement and the $S TRACE command by coding nn for each trace ID. Note that trace ids 14, 15, and 16 apply to FSS printers.

Modification: $T PRTnnnnn command. For FSS-controlled printers only, if you modify this parameter value and then reconnect the printer on a hot start, the parameter value in effect before termination will be used.

For further information about coding this parameter, see z/OS JES2 Initialization and Tuning Guide. For further information about the tracing facility, see z/OS JES2 Diagnosis. For an explanation of the $S TRACE command, see z/OS JES2 Commands.

TRANS=Yes|No|DEFAULT

If this PRT(nnnnn) statement specifies or defaults to MODE=JES, the TRANS= parameter on this statement affects data translation:

If the PRT(nnnnn) statement specifies TRANS=Yes, JES2 translates each line of output sent to the device regardless of the device type or the setting of the PRINTDEF TRANS= parameter.
If the PRT(nnnnn) statement specifies TRANS=No, JES2 does not translate output sent to the device regardless of the device type or the setting of the PRINTDEF TRANS= parameter.
If the PRT(nnnnn) statement specifies TRANS=DEFAULT, or TRANS= is omitted from the PRT(nnnnn) statement, and the PRINTDEF statement specifies TRANS=Yes, and the device is either a local 1403 or a remote printer, JES2 translates each line of output sent to the device. Otherwise, JES2 does not translate output sent to the device.

Modification: $T PRTnnnnn,TRANS= operator command. Do not issue this command unless the printer is inactive or drained.

TRKCELL=Yes|No

Yes specifies that an entire track cell is to be despooled (read from the spool) in one operation, for data sets that belong to a SYSOUT class that has the track-cell characteristic. The number of records in the track cell is governed by the TRKCELL parameter on the SPOOLDEF statement. Specifying TRKCELL=Yes and double buffering (DBLBUFR=Yes on the PRINTDEF statement) indicates double track-cell buffering.

NO indicates that track-cell despooling is not to be used. Instead, spool records are despooled 1 record per despooling operation.

Performance Considerations: You can use track-cell despooling for any printer supported by JES2. However, TRKCELL=No (the default) is recommended for low-speed printers such as the 3820 because a considerable amount of storage space is saved. But for high-speed printers such as the 3800-3 running under the control of an FSS, TRKCELL=YES is required to prevent performance degradation.

UCS|T=vvvv

Specifies, for impact printers, the print train (print chain or print band) that is mounted on this printer. The value of vvvv is the identifier (1-4 characters) of a universal character set (UCS) image that resides in SYS1.IMAGELIB.

For 3800 printers, vvvv specifies both the character arrangement table that JES2 initially loads into the printer and the installation's default character arrangement tables for data sets not specifying any character arrangement. See Advanced Function Presentation: Printer Information for information about the IBM-supplied character arrangement tables and the addition of other character arrangement tables to SYS1.IMAGELIB.)

If you specify an incorrect identifier, JES2 bypasses the UCS loading procedure and issues the $HASP190 setup message allowing the operator to specify a valid image.

If you do not specify this parameter, JES2 selects the default based upon the type of printer:

For impact printers, the identifier specified by the UCS= parameter on the PRINTDEF statement.
For 3800 printers, the identifier specified by the NIUCS= parameter on the PRINTDEF statement.

Note: This parameter is not supported for a 1403 printer that does not have the UCS feature. If you specify UCS=0 (or if a zero value was specified for the UCS parameter on the PRINTDEF statement), JES2 will not load the UCS buffer.

UCSVERFY=Yes|No

Specifies whether (Yes) or not (No) UCS verification processing is performed when a UCS image is loaded for 4245 and 4248 printers. UCS images are loaded on 4245 and 4248 printers only when required for print processing (they are not loaded in response to a $T PRT operator command that specifies a change in UCS setup). Specifying UCSVERFY=Yes provides UCS verification and causes the band image to be displayed to the 4245 and 4248 printers. UCSVERFY=No suppresses the image display.

Modification: $T PRTnnnnn operator command.

UNIT={hhhh|/hhhh}

Specifies a 3- or 4-digit hexadecimal device number. Device numbers can be specified by any of the following formats:

UNIT=hhh
UNIT=hhhh
UNIT=/hhh
UNIT=/hhhh

where hhh and hhhh represent the device numbers.

A slash (/) can optionally precede the device number (for compatibility with other initialization statements that require a slash to denote a 4-digit device number).

If not specified, JES2 does not assign an available printer; instead, a printer can be dynamically assigned using a $T PRT command.

Note:

This parameter is not required if the printer defined by this statement is an SNA-attached IBM 3820 printer. If a UNIT= specification is provided when defining a non-channel attached IBM 3820 printer, JES2 will ignore it.
If UNIT= is not specified at this time, the defaults for COPYMARK=, FLASH=, FCB=, and UCS= will be based on the setting of the MODE= parameter. If MODE=FSS, the defaults will be the same as if the device were a non-impact printer. If MODE=JES, the defaults will be set assuming the device is an impact printer.

Volume=(v1[,v2][,v3][,v4])|()

Specifies the 5- to 6-character volume serial number of a volume containing a spool data set. Only output jobs containing tracks on the specified volume can be selected for printing. As many as four volumes can be specified. Use commas to separate individual volume IDs and enclose this list in parenthesis if more than one ID is specified.

Modification: $T PRTnnnnn operator command

Writer=xxxxxxxx

Specifies the 1- to 8-character writer name assigned to this printer. Wildcard specifications are allowed on this parameter.

If you do not specify this parameter, no writer name is assigned.

Modification: $T PRTnnnnn operator command.

WS=criteria | (W,Q,R,PRM/F,T,C)

Specifies the work selection criteria (listed below) for this device. Criteria that are not specified are not considered during output selection although they are used by JES2 to determine setup requirements. This parameter can be particularly useful when draining a specific spool volume. You specify a list of selection criteria as follows:

One and only one slash (/) may precede or follow any number of criteria. The slash separates the work selection criteria that must be matched exactly from those that need not be matched exactly to the characteristics of the output. If you do not code a slash, all criteria specified must be matched exactly. (See z/OS JES2 Initialization and Tuning Guide for a further discussion of device to job matching.)
The order of those criteria specified before the slash (those that must be matched exactly) may affect output selection. All criteria will be matched regardless of the sequence in which they are listed. See z/OS JES2 Initialization and Tuning Guide for details on output selection.
The order of those criteria specified after the slash (those that need not match exactly) indicates the priority (highest to lowest in left to right order) in which JES2 will attempt to match them.
Queue (class), Routecde (route) and Volume criteria are exceptions; these must be matched exactly, and will be, no matter where you specify them in the criteria list. However, specifying these criteria before the slash indicates a left to right priority order of multiple values, if multiple values are designated. Specifying either one after the slash indicates no priority order of multiple values, if multiple values are designated on the output device initialization statement.
If a criterion is omitted from the list of selection criteria, it will not influence work selection, but if characteristics of the selected output differs from the output device's selection criteria, a setup message may be issued to the operator.

Unless otherwise noted, if the criterion is specified before the slash, an exact match is required; if after the slash, an exact match is preferred (and attempted in left to right priority) but not required, only the priority order is considered.

You can specify the following criteria on the WS= parameter:

Burst

Specifies that the current BURST= specification is either required or preferred.

CLass|Queue

Specifies that a match must be found for the output classes specified on this device. If Q is omitted from the WS list, all output queues (beginning with queue A) will be searched for work.

Note: If specified before the slash, the priority of the device characteristics table class list is from left to right. If specified after the slash, there is no device characteristics table class list priority ordering. To increase performance, this criterion should be placed before the slash.

CReator

Specifies that output for the current userid is preferred. JES2 attempts to consecutively select all eligible output for a particular userid. However, output is only grouped in this manner depending upon the specification of the current work selection list and output queues. If specified to the left of the slash, an exact match is required.

FCB|C

Specifies that the current forms control buffer (FCB) image or carriage control tape is either required or preferred.

FLash|O

Specifies that the current FLASH= specification is either required or preferred.

Forms

Specifies that the current FORMS= specification is either required or preferred. If FORMS is omitted from the criteria list, work selection will not contain any forms checking.

JOBname

Specifies that JES2 gathers all output for a job and attempt to process that output consecutively. The JOBNAME= parameter for a particular device determines what job name JES2 selects when JES2 has processed all output that matches the current job name.

If JOBname= is specified before the slash in the WS= list:
JES2 selects only those jobs that match the value specified on JOBNAME= for a specific device. When JOBNAME= is specified as a generic name, JES2 only processes jobs that match that pattern and attempts to process all output for that job name consecutively.
If JOBname= is specified after the slash in the WS= list:
JES2 uses the value specified on JOBNAME= to select new job names for the specific device. If there are no job names that match the JOBNAME= specification, JES2 selects jobs as if JOBname were not listed in the WS= list. A device gathers and processes all output for a particular job before again examining the value specified on JOBNAME= for more jobs.

If you require JES2 to group jobs based on job name but do not want JES2 to prefer a particular JOBNAME= pattern, specify JOBNAME=* on the device statement and code JOBname after the slash in the WS= list.

LIMit

Specifies that the limits of output, as noted on the LIMIT= keyword (on this initialization parameter) will be supported, that is, the amount of generated output must fall within the LIMIT= specification.

This subparameter has no effect as a work selection value for files received from a node that does not provide a page count for its files. For more information, see the sending node's reference documentation.

PRMode|PMD

Specifies that the current PRMODE= specification is preferred. If more than one mode is specified, they are in left to right priority order.

Note: To print output, a match must be found; this criterion should be placed before the slash.

Priority

Specifies that output priority will be considered. Priority is not matched with any other parameter; rather, it specifies that a higher output priority receives greater output preference. If specified before the slash, the importance of selecting output by priority is increased.

Routecde

Specifies that only output destined for a destination specified by a route code listed on the ROUTECDE= parameter is eligible for selection by this device.

Note: If Routecde is specified before the slash, the route code(s) are in left to right priority order; if specified after the slash, there is no such priority order.

RANGE

Specifies that the current job ID range is preferred. If specified to the left of the slash, an exact match is required.

Volume

Specifies that only output with tracks on the currently specified volume can be selected for printing. If specified to the left of the slash, the volumes are considered to be in left to right priority order. If specified to the right of the slash, no priority order exists, but an exact match is still required.

Writer

Specifies that the writer name (W=) specification is either required or preferred.

UCS|T

Specifies that the currently mounted print train (on impact printers only) is either required or preferred. If omitted from the work selection list, the UCS specified for the output is not required to match the device setup, but a setup message will be issued to the operator if the UCS= specifications differ.

Note: Embedded comments are not allowed within the WS= parameter specification.

Modification: $T PRTnnnnn operator command.