Function

One or more parameters on this command accepts wild cards. Parameter descriptions will note that.

Parameters

nnnnn

For PRT, the identifier of the local printer (1-32767) to control. For R, the identifier of the remote workstation (1-32767) that is attached to printer m (1-7).

m

The identifier of the printer (1-7) that is attached to the remote workstation Rnnnnn (1-32767).

ASIS={Y|N}

Specifies whether JES2 will send the print data to the remote printer without suppressing extraneous ejects and adding an eject at the end of a data set. This parameter should be specified as NO if the installation wants to continue to suppress ejects and receive ejects at the end of each print data set.

Note: This keyword applies only to remote printers.

Burst=[No|Yes]

Specifies whether the printed output from the indicated 3800 printer is to be burst into separate sheets (Y) or is to be in continuous fanfold form (N).

CCTL

CCTL={YES | NO}

Displays whether (YES) or not (NO) JES2 places carriage control characters in the output stream transmitted to this remote printer. If you specify CCTL=NO, JES2 neither compresses (COMPRESS=NO) nor compacts (COMPACT=NO) data, and standard character string (SCS) control characters are not placed in the output string.

Note: The CCTL= parameter applies to remote printer and SNA devices only.

C|FCB={xxxx|RESET}

xxxx

The identifier (1– to 4–alphanumeric or special character ($ # @)) of the carriage control tape for a printer without a forms control buffer (FCB) feature, or the FCB image for a printer having the FCB feature. If you specify an FCB image, it must be available in SYS1.IMAGELIB. If loading is required for Rnnnn.PRm, it must be done by the operator at the JES2 RJE workstation, unless the workstation has FCB-loading capability.

RESET

Specifies that a 3800 printer or a printer running under the control of a functional subsystem (FSS mode) is to construct a 6 lines per inch FCB based on the forms loaded in the printer. For a 3800 (and other printers) in FSS mode, JES2 uses the FCB specified in the PROC that starts the FSS. RESET can be used to correct the problem indicated by the $HASP180 load error message.

Note:

1. When you explicitly set the C= parameter for the 3800 printer, the specified value is used as the installation's default FCB image for SYSOUT data sets which do not specify the FCB= parameter through JCL.
2. If you have received the $HASP180 load error message indicating an FCB image error, specify the C= parameter to correct the problem.

CKPTLINE=ckptline

Specifies the maximum number of lines (0-32767) in a logical page. JES2 uses this value, the CKPTPAGE= parameter, and the LINECT= parameter on 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.

CKPTMODE={PAGE|SEC}

Specifies whether the functional subsystem is to take checkpoints based on page count or elapsed time.

Note: This operand is valid for printers under the control of a functional subsystem only, not those under the control of JES2.

PAGE

The functional subsystem uses the checkpointing interval specified by the CKPTPAGE operand.

SEC

The functional subsystem uses the checkpointing interval specified by the CKPTSEC operand.

Note: The installation should set the values for CKPTSEC and CKPTPAGE so they are best for the printer; then control which checkpoint method to use, either SEC or PAGE, by changing the CKPTMODE parameter.

CKPTPAGE=ckptpage

The number (1-32767) of logical pages for non-page mode printers and physical pages for page-mode printers to be printed before each output checkpoint is taken. This parameter and CKPTLINE control the amount of checkpoint activity to spool.

Note:

1. When you use the K=(1|2|3|R) operand for a data set that is printing on a 3800-3 printer operating in FSS mode, the forced spacing is reset either at the end of that data set, or when you issue a $T PRTnnnn,CKPTPAGE=nnnnn command while this data set is printing. If you issue the $T PRTnnnn,CKPTPAGE command and forced spacing is still desired, you must include the K=(1|2|3|R) operand.
2. The CKPTPAGE parameter should be set to a low value for slow printers and a high value for faster printers such as the 3800 to prevent the occurrence of excessive checkpoint cycles for faster devices.

CKPTSEC=ckptsec

The number (0-32767) of seconds to elapse before each output checkpoint is taken. This parameter is valid only for a printer under control of a functional subsystem.

CMPCT=[YES|NO]

For SNA RJE workstations only, specifies whether (YES) or not (NO) this remote printer has compaction capabilities. If it does and the corresponding RJE workstation definition (RMT(nnnn) ) specifies COMPACT=YES, JES2 forces this remote printer to use compaction.

If you specify CMPCT=YES, JES2 forces compression of the data (COMPRESS=YES). If you specify CMPCT=NO, JES2 turns off compaction, even if it is specified on the RJE workstation definition.

Note that the CMPCT= parameter:

• Applies only to remote printers
• Can be changed only when the printer is inactive
• Must be specified as NO if CCTL=NO

COMPACT|Z=compact

Specifies the compaction table number or the 1 to 8 character compaction table name that must be defined through a COMPACT initialization statement.

Note: The COMPACT= parameter can be changed only when the printer is inactive.

COMPRESS=[No|Yes}

Specifies whether (YES) or not (NO) this remote printer has compression/expansion capabilities.

If you specify COMPRESS=YES and the corresponding RJE workstation and LINE(nnnn) initialization statements specify COMPRESS=YES, JES2 forces this remote SNA printer to use compression. If you specify COMPRESS=NO, JES2 turns off compression, even if the corresponding RJE workstation specifies COMPRESS=YES.

Note that the COMPRESS= parameter:

• Applies only to remote printers
• Can be changed only when the printer is inactive

For SNA RJE workstations only:

• Must be specified as NO if CCTL=NO
• Sets on the corresponding bit setting in the RJE BIND if COMPRESS=YES.

COPYMARK={CONSTANT|DATASET|DEFAULT|JOB}

Specifying DATASET or JOB causes copy marks (SYSOUT separation indicator markings) to be incremented on a data set level or on a JOE level, respectively. Copy marks are not incremented when you specify CONSTANT.

Note: The COPYMARK parameter applies to FSS-controlled devices only.

CReator=jccccccc

Specifies the 1– through 8–character userid that creates the SYSOUT data sets to be processed. You can also specify wild cards on this parameter. See Using wildcards for additional information.

j

An alphabetic character (A-Z) or any of the special characters ($, #, or @).

ccccccc

Any combination of EBCDIC characters except a comma, a right parenthesis, or an equal sign.

DEVFCB=devfcb

Specifies the default FCB attribute JES2 uses when FCB= is not coded in the job's JCL. (JES2 does not validate the existence of the FCB name in SYS1.IMAGELIB.) Specifying RESET sets the default FCB attribute to null.

Note: 3800 printers use the FCB specified on the PRT initialization statement.

DEVFLASH={xxxx|NONE}

Specifies the name of the device default forms FLASH ID.

xxxx

The identifier (1 to 4 alphanumeric or special ($ # @) characters) of the forms FLASH ID for the specified 3800 printer. This forms FLASH ID is used for jobs selected by this printer that do not have FLASH= explicitly coded in the job's JCL.

NONE

The forms FLASH ID is unspecified (the value is set to asterisks).

Note: The printer must be drained before the DEVFLASH parameter can be used to modify the default forms FLASH ID.

EJECT=Yes | No

Specifies whether JES2 sends a page eject to a remote printer on the printer's first use following the start of an RJE session, depending upon the assumed position of the printer. JES2 assumes that the remote printer is not positioned at the top of a page on the first use after JES2 is started, restarted, or after an RJE session fails and the remote printer is not at the top of a page.

EJECT=Yes causes JES2 to send a page eject when the remote printer is not assumed to currently be at the top of a page. Use this parameter value when the output is destined for a physical printer.

EJECT=No ensures that a print stream never begins with a page eject. Workstations that write SYSOUT to media other than paper can use this parameter to create files that do not contain page ejects in the first line.

You can change this parameter after initialization using a $T command; however, the change takes effect at the beginning of the next RJE session, regardless of whether printing has begun.

FCBLOAD={YES|NO}

Specifies whether (YES) or not (NO) JES2 provides the forms control buffer (FCB) for this printer.

This parameter works only for SNA printers or a 3211 printer attached to a multileaving workstation with the text-transparency (TRANSPAR=YES on both the LINE(nnnn) and the RJE workstation definitions) feature.

For an SNA RJE workstation, the FCBLOAD= parameter uses only one stop for each channel, for a maximum of 12 stops.

Note that the FCBLOAD= parameter:

• Applies to remote printers only
• Can be changed only when the printer is inactive
• Is forced to NO if SETUP=PDIR on the corresponding RJE workstation.
• Is limited to the line length specified by the PRWIDTH= parameter minus 2 for this printer.

FLASH|O={xxxx|RESET|NONE}

Specifies the name of the active (current) forms FLASH ID.

xxxx

The identifier (1– to 4–alphanumeric or special ($ # @) characters) of the forms FLASH ID for the specified 3800 printer. This forms FLASH ID is used for jobs selected by this printer only when the job has explicitly coded the identical forms FLASH ID in the job's JCL, or if the FLASH ID is the same as the DEVFLASH ID on the DEVFLASH parameter.

RESET

The current forms FLASH ID is unspecified (the value is set to asterisks).

NONE

The current forms FLASH ID is unspecified (the value is set to asterisks).

Forms=form

The 1– to 8–alphanumeric or special ($ # @) character name of the forms that are loaded into this printer. You can also specify wild cards on this parameter. See Using wildcards for additional information.

Note: You can specify 1 through 8 forms for local printers.

F=(STD1,STD2)

FSAROLTR ={YES|NO}

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

FSS=accccccc

Specifies a 1– to 8–character functional subsystem name that supports a page-mode printer. If an FSSNAME is not defined on an FSS initialization statement, the functional subsystem name assigned on this statement will cause the generation of a default FSS initialization statement. The FSS statement then defines (by default) the FSSNAME and PROCname specified here.

Note:

1. This parameter must be specified if MODE=FSS is specified for this PRT(nnnn) command.
2. You must also specify UNIT= if this PRT(nnnn) command defines a 3827 or 3835 printer.

HONORTRC{YES|NO}

Specifies whether 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.

JOBname=jobname

The 1– to 8–character name of jobs whose output is to be selected by this printer. you can also specify wild cards on this parameter. See Using wildcards for additional information. A null parameter of (JOBNAME=) specifies that jobname is not a criterion for output selection.

K|SPACE=[DOUBLE|R|RESET|SINGLE| TRIPLE|1|2|3]

Specifies the spacing for printed output.

{1|2|3|SINGLE|DOUBLE|TRIPLE}

The printer is to single (1), double (2), or triple (3) space the printed output, regardless of the problem program specifications. When the end of the data set is encountered or when a $T PRTnnnn, K=R command is entered, the printer reverts to problem program specifications.

R|RESET

The printer is to be reset to the problem program-specified spacing.

Note: When you specify the K=(1|2|3|R) parameter for a data set that is being processed on a printer operating in FSS mode, the forced spacing is reset either at the end of that data set, or when you issue a $T PRTnnnn,CKPTPAGE=nnnnn command while that data set is printing. If you issue the $T PRTnnnn,CKPTPAGE command and forced spacing is still desired, you must include the K=(1|2|3|R) operand.

LIMit={m|m-n|m-*}

Specifies the lower and upper limits (in records) for the size of output that is to be selected by this printer.

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.

Note: If the printing of an output group is interrupted, JES2 compares the original size of the output (the number of lines prior to any printing rather than the lines remaining) with the LIM= specifications.

LRECL=nnn

For SNA RJE workstations only, specifies the logical record length (1-255) of data transmitted to this remote printer. Do not include carriage control characters (CCTL) when calculating the value of LRECL. The LRECL value cannot exceed the printer width specified during RMT generation through the &PRTSIZE RMT generation statement for this RJE workstation.

Note that the LRECL= parameter:

• Applies to remote printers only
• Can be changed only when the printer is inactive
• Can be used in place of the PRWIDTH= parameter to specify record sizes for records destined for remote printers.

Mark=[No|Yes]

Specifies for the 3800 printer, whether the edge of the separator page is to be marked.

Note: If the printer is under control of a functional subsystem, specifying N suppresses marking on the separator page, but produces a unique mark on the carrier strip (that is, the punched, perforated page edge).

MODE={FSS|JES}

Specifies whether the printer is under control of a functional subsystem (FSS) or JES2.

Note:

1. When a change of control mode is desired for a printer that is active (that is, output is being printed), you must enter a $P PRTnnnn command for the printer and wait for it to drain before entering this command. The $HASP097 message indicates when the draining process is complete. If the printer is not drained before entering this command, JES2 ignores the command.
2. JES2 ignores the MODE specification if the printer was not defined as a functional subsystem device (using the FSS= parameter) on the PRTnnnn initialization statement. (If a device was mistakenly defined as being a functional subsystem device, JES2 honors the MODE specification, but incorrect output results.)
3. The MODE specification is not supported for remote printers.

MODIFY | Y=modify

Specifies the 1 to 4 character identifier of the copy modification module for the specified 3800 printer.

NEWPAGE={1|ALL|DEFAULT}

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

1

Specifies that JES2 will treat only skip-to-channel-one as a new page.

ALL

Specifies that JES2 will treat skip-to-any-channel as a new page.

DEFAULT

Specifies that the NEWPAGE specification on the PRINTDEF initialization statement will be used.

NPRO=npro

The non-process runout (NPRO) time interval, in seconds (0-3600). This time interval is used to control the amount of time that an FSS-controlled printer is idle with output in the paper path but not at the stacker. When the time interval expires, the functional subsystem directs the printer to force the output to the stacker. NPRO=0 specifies that a timer-based NPRO is not used.

Note: The NPRO parameter has no effect on cut-sheet page printers (for example, the 3820).

Pause=[No|Yes]

Specifies whether the local printer is to pause between data sets. If you specify Y, you can restart the device by changing it from a not-ready to a ready state or by entering a $S PRTnnnn command.

Note: This operand has no effect for a printer under control of a functional subsystem.

PLIM={m|m-n|m-*}

Specifies the lower and upper limits (in pages) for the size of output that is to be selected by this printer.

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.

Note:

1. Normally the PLIM should only be used with functional subsystem printers capable of printing page mode data.
2. If the printing of an output group is interrupted, JES2 compares the original size of the output (the number of pages prior to any printing rather than the pages remaining) with the PLIM= specifications.
3. When PLIM is specified (non–zero value) for r(nnnn).pr(m) PRMODE of PAGE will be of significance for remote printers and WS criteria for remote printers.

PRESELCT={Yes|No}

Specifies whether JES2 preselects an output group for a device. Specifying PRESELCT=N makes output groups selectable by any device. Y is the default.

Note:

1. The PRESELCT operand is valid only when the printer is under control of a functional subsystem.
2. When PRESELCT=YES is specified, a printer that is busy printing one output group may preselect another large output group. The operator will be unable to change the destination of the second output group to another printer once the output group is preselected.

PRMode=(mode1[,...mode8])

The SYSOUT mode(s) (1 to 8 alphanumeric characters) to be processed by this printer. You can specify up to 8 SYSOUT modes for a single printer. You can also specify wild cards on this parameter. See Using wildcards for additional information. Multiple entries must be separated by commas and the list must be enclosed in parentheses. If all processing modes are selectable by this printer, specify a null parameter of PRMODE=(). You must specify the empty parentheses.

Note: For a list of valid process-mode values, see your system programmer.

PRTnnnnn

The identifier of the local printer (1-32767) that is controlled.

PRWIDTH=nnn

Specifies the number (1-255) of characters printed on one line. The PRWIDTH value cannot exceed the printer width specified during RMT generation through either the &PRTSIZE or the &PRFOTLW RMT generation statements for this RJE workstation.

Note that the PRWIDTH= parameter:

• Applies to remote printers only
• Can be changed only when the printer is inactive.
• Should not exceed 120 for printers attached to a BSC terminal defined as a 2770 without the buffer-expansion feature.

CLass|Queue=c1[...c36]

The output class(es) (A-Z, 0-9) the printer is to process. You can specify up to 36 output classes.

Routecde=routecde

Specifies up to four internal route codes to be assigned to this printer. If more than one route code is specified, enclose the list in parentheses. You can also specify wild cards on this parameter, but wildcard specifications are allowed on this parameter for userids only. See Using wildcards for additional information. For specification requirements, see Route codes.

Note:

1. JES2 does not allow remote printers to change Routecde= to another destination or to delete Routecde from the work selection list.
2. NODENAME=REQUIRED on the DESTDEF initialization statement will cause JES2 to require that a userid be prefixed with a node name.

If destid is specified alone, it refers to both the node and the remote.

Ummmm

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

Routing to a remote device can be specified in any of the following ways:

• LOCAL|ANYLOCAL
• Rnnnn
• destid
• userid

LOCAL|ANYLOCAL

Indicates routing to a local device.

Rnnnn

Indicates routing to the specified remote device. Rnnnn can also be specified as RMnnnn or RMTnnnn. The value specified for nnnn can range from 1 to 32767.

destid

Indicates routing to a destination at the local node.

userid

Indicates routing to a valid TSO userid. 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.

Note: This command accepts Nnnnn or an installation-defined name as the value of the R= parameter; however, the resulting internal route code must be for the local node.

Rnnnnn.PRm

The identifier of the remote printer (1-32767) that is controlled.

RANGE={Jnnnnn|Snnnnn|Tnnnnn} [-nnnn]

Specifies the range (1-65534) of batch jobs (J), started tasks (S), or time sharing users (T) whose output is to be selected by this printer. 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. The two values can be equal. If they are not equal, the second value must be larger than the first value.

SELECT={PRINTnn|EXCHnn|BASICnn}

Specifies the device type (PRINT, EXCH, or BASIC) and the device subaddress (0 - 14) to which JES2 sends output for this remote device.

The SELECT= options:

PRINTnn

Sends output to the remote printer.

EXCHnn

Sends output to an exchange diskette service.

BASICnn

Sends output to a basic exchange diskette service.

The value nn specifies the device number (1 to 15; subaddress 0 to 14). If you do not specify the nn value, JES2 provides a default of any available device of the type specified (subaddress=15).

Note that the SELECT= parameter:

• Applies to remote printers only
• Can be changed only when the printer is inactive
• Is ignored for BSC devices
• Should specify a BASIC type only if CCTL=NO and the LRECL= value does not exceed 128.

Sep=[No|Yes]

Specifies whether JES2-supplied separator pages are to be placed between output groups. If you specify N, the JESNEWS data set is not printed. If this is a remote printer, specifying N also suppresses the transmission of operator messages to the RJE workstation, with the exception of the $HASP190 setup message.

Note: If you specify Sep=Y, but SEPPAGE=(LOCAL=NONE) (for local printers) or SEPPAGE=(REMOTE=NONE) (for remote printers) was specified on the PRINTDEF initialization statement or using the $T PRINTDEF command, default JES2 separator pages are not produced. If you specify Sep=N, a user created separator page (made in Exit 1) is not suppressed.

SEPCHARS={CURRENT|DEFAULT}

Specifies the character arrangement table to use for separator pages printed on the 3800 printer. The NUICS parameter on the PRINTDEF initialization statement defines this value at system initialization.

CURRENT

Specifies use of the character arrangement table loaded in the 3800. The first character arrangement table is used if the installation default is not loaded.

DEFAULT

Specifies use of the installation default character arrangement table. If not already loaded, this parameter specifies that this table be loaded before printing the separator pages.

SEPDS=[No|Yes]

Specifies whether a header separator page is to be produced for each copy of each data set within an output group. If the printer is running under JES2, specifying Y causes JES2 to invoke EXIT 15 (output data set/copy separators), if enabled, to generate separator pages. For printers under control of a functional subsystem, SEPDS is supported with a default separator page.

SETUP={HALT|NOHALT}

Specifies whether JES2 is to halt the printer and issue the $HASP190 message requesting the operator to verify the output control specifications when the output requirements for a particular job differ from the output characteristics specified for the printer. (If halted, the printer must be restarted using the $S command.)

SUSPEND=[No|Yes]

Specifies whether a remote printer can (No) or cannot (Yes) use the printer-interrupt feature which allows the remote operator to interrupt printing for the transmitting of jobs or JES2 commands to this JES2 system.

Note:

1. Applies only to printers connected to BSC hardware terminals.
2. This parameter can only be changed when the printer is inactive.

T|UCS=ucs

For impact printers, T= specifies the identifier (1 to 4 alphanumeric or special ($ # @) characters) of the print train character set that is mounted on the specified printer. The identifier must be available in SYS1.IMAGELIB and the indicated printer must have the universal character set (UCS) feature. If loading is required for Rnnnn.PRm, it must be done by the operator at the JES2 RJE workstation.

For 3800 printers, T= specifies both the identifier (1 to 4 alphanumeric characters) of the print train character set that is mounted on the printer and the installation's default character set for SYSOUT data sets that do not specify the UCS= parameter through JCL. This identifier must be available in SYS1.IMAGELIB.

Note:

1. If you specify an invalid identifier, JES2 bypasses the UCS loading procedure and issues the $HASP190 setup message so the operator can specify a valid image.
2. If you specify T=0 or a zero value was specified for the UCS parameter on the PRINTDEF initialization statement, JES2 does not load the UCS buffer.

   You would want to nullify the UCS operand when running a printer in FSS mode if you wish to use the default character set specified in the FSS procedure used to start the printer.

3. This parameter is only valid for a 1403 printer that has the UCS feature.

TRKCELL={No|Yes}

Specifies whether data sets that belong to a SYSOUT class with the track-cell characteristic are read from the spool in one operation. The TRKCELL parameter on the SPOOLDEF initialization statement specifies the number of records in the track cell. If you specify NO, one record is read from the spool for each despooling operation.

TRace={No|Yes|P}

Specifies whether tracing is to be activated or deactivated for this print processor. This operand requires system authority.

No

Tracing is disabled.

P|Yes

Tracing is activated if trace IDs 11, 12, 14, and 15 are currently enabled.

Note: Trace IDs 11, 12, 14, and 15 may be enabled either at initialization on the TRACE(n) statement or using the $S TRACE(n) command.

TRANS={Yes|No}

IF MODE=JES, the TRANS= parameter on this statement affects data translation:

• If TRANS=YES, JES2 translates each line of output sent to the device regardless of the device type or the setting of the TRANS= parameter of the PRINTDEF initialization statement.
• If TRANS=NO, JES2 does not translate output sent to the device regardless of the device type or the setting of the TRANS= parameter on the PRINTDEF initialization statement.
• If TRANS= is omitted and the PRINTDEF initialization 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.

UCSVerfy={No|Yes}

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 these printers only when required for print processing, not in response to a $T PRT command that specifies a change in UCS setup. This parameter can be modified through a JES2 warm start.

YES

Provides UCS verification and causes the band image to be displayed to the 4245 and 4248 printers.

NO

Suppresses the image display.

UNIT={devnum|/devnum}

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

  UNIT=        (to specify a null value)
  UNIT=ddd
  UNIT=dddd
  UNIT=/ddd
  UNIT=/dddd
 

where ddd and dddd represent the device numbers.

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

Note: You cannot use $T PRTnnn to remove the UNIT specification for a JES mode printer.

VOLUME=(v1[,...v4])

The volume serial (5-6 characters) of a volume containing a spool data set. Only the output of jobs which reside on one or more of the specified volume(s) are to be selected by this printer. You can specify up to 4 volumes. Multiple entries must be separated by commas and the list must be enclosed in parentheses. A null parameter of VOLUME=() specifies that volume is not a criterion for output selection. You must specify the empty parentheses.

Writer=xxxxxxxx

The 1 to 8 alphanumeric or special ($ # @) character writer name assigned to this printer. You can also specify wild cards on this parameter. See Using wildcards for additional information. A null parameter of (W=) specifies that no writer name is assigned to this printer.

Note: If you do not assign a writer name to the printer, and Writer is specified as an exact match criteria in the work selection (WS) list, the printer selects only output groups without a writer name.

WS=ws

Specifies the work selection criteria for this printer. Using any combination of user and JES2-defined criteria, you may specify a maximum of 19 criteria in the WS= list. Criteria that are not specified are not considered during output selection although JES2 does use them to determine setup requirements. Multiple entries must be separated by commas and the list must always be enclosed in parentheses (even if only one criterion is specified).

The general rules for specifying a printer work selection list are:

1. One slash (/) can precede or follow one of the selection criterion. Criteria placed before the slash must be matched exactly if the work is to be selected. Criteria placed after the slash do not have to match exactly except in the following cases:
   • Queue
   • Routecde
   • PRMode
   • Volume

   Table 1 defines each criterion when placed either before or after the slash.

2. Queue, Routecde, PRMode, and Volume can be specified as multiple values on the output device statements. Placing these criteria before the slash in the WS= list, indicates a left to right priority order of multiple values, if multiple values have been specified. Placing these criteria after the slash indicates no priority order of multiple values, but a match is still required.
3. The order of those criteria specified after the slash indicates the priority (highest to lowest, in left to right order) in which JES2 attempts to match them.
4. Specifying a minus sign (-) before a criterion causes that criterion to be removed from the list.
   Note: An invalid operand message ($HASP650) is issued if an error is found in the WS operand, that is, if you try to remove a criterion that is not there. For example, if you enter $tprt1,ws=(-o), you get the $HASP650 message because ‘o' (forms overlay) is not in the current work selection list for printer1.
5. Specifying a criterion that is not currently specified in the list adds it to the end of the list either before or after the slash, depending on the placement of the slash in the command. If the slash is omitted from the command, JES2 assumes that the slash is at the end of the command.
6. For all exact match criteria, if the output matches the device for a specific criterion, but the output specifies demand (DMND) setup, the match is not considered an exact match and the output is not selected because demand setup indicates that the characteristics do not remain the same throughout the output group.

   To print demand (DMND) setup output, the work selection criteria specified for the printer that is referenced by DMND must be removed from the list.

7. If the device is a remote printer, route code (R=) must be specified in the work selection list.
8. The LIMit 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, refer to the sending node's reference documentation.
9. In general, the smaller the work selection list the less the placement of certain criteria within the list affects the work selection. Job output elements are queued to the class queues by route code, then priority. This information should be used to tune the work selection list to optimize performance.

X|CHAR=id

The identifier(s), 1 to 4 alphanumeric characters, available in SYS1.IMAGELIB, for the first through fourth character arrangement tables, respectively, to be used in the specified 3800 printer.

Note: You should specify this operand only if you have received an error message indicating that a character arrangement table was not found.

Authority Required

This command requires device and system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires update security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Processing Considerations

• The setting of forms, trains, carriage controls, or FCB image is valid only when the specified device is inactive, pausing, or awaiting operator action (halted).
• You should either issue a $P PRTnnnnn command and wait for the device to drain before entering the $T command, or issue the $T command while the system is waiting for forms to be loaded. Because JES2 does not issue a setup message for a printer that does not require operator intervention to change the carriage control, the requested image cannot be overridden unless there is an error.
• If you are uncertain of the controls in effect, enter the $D PRT command or the $D U command for the printer in question.

Scope

Single member. This command will be in effect for this member only. There is no need to have this command issued to all members of the MAS.

Messages

The $HASP603 message displays the status of the specified printer and its current characteristics.

The $HASP003 rc=65 message indicates that the device type specified through the UNIT= parameter does not match the defined JES2 device information.

The $HASP003 rc=66 message indicates that the device type specified through the UNIT= parameter does not exist.

Examples

 1   $t prt101,unit=0b08,fss=psf1,mode=fss
$HASP603 PRT101    UNIT=0B08,STATUS=DRAINED,BURST=NO,CKPTLINE=0, 
$HASP603           CKPTMODE=PAGE,CKPTPAGE=100,CKPTSEC=0,         
$HASP603           CREATOR=,DEVFCB=,DEVFLASH=****,FCB=6080,      
$HASP603           FORMS=(STD,,,,,,,),FSS=PSF1,HONORTRC=YES,     
$HASP603           JOBNAME=,LASTFORM=STD,LIMIT=(0-*),            
$HASP603           COPYMARK=DATASET,MARK=YES,MODE=FSS,           
$HASP603           NEWPAGE=DEFAULT,NPRO=5,PAUSE=NO,PLIM=(0-*),   
$HASP603           PRESELCT=YES,PRMODE=(LINE,PAGE),QUEUE=V,      
$HASP603           RANGE=(J1,999999),ROUTECDE=(LOCAL),SEP=YES,   
$HASP603           SEPCHARS=DEFAULT,SEPDS=NO,SETUP=HALT,SPACE=,  
$HASP603           TRACE=NO,TRANS=DEFAULT,TRKCELL=YES,UCS=GB12,  
$HASP603           UCSVERFY=NO,VOLUME=(,,,),WRITER=,             
$HASP603           WS=(W,Q,R,PRM,LIM,UCS,FCB/F,P),FSAROLTR=NO