Function

To dynamically add a local printer.

Parameters

nnnnn

The identifier of the local printer (1-32767) to dynamically add.

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).

C|FCB={id|RESET}

Specifies the carriage tape name for the 3211, 3203 Model 5, or 1403 printer for printing this output class.

id

The identifier (1-4 alphanumeric characters) of the tape for a printer lacking 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.

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 any 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 message.

Note:

1. When you explicitly set the FCB= parameter for the 3800 printer, the specified value is used as the installation's default FCB image for SYSOUT data sets that 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 FCB= parameter to correct the problem.

CKPTLINE=nnnnn

The maximum number of lines (range 0-32767) in a logical page. JES2 uses this value, with the CKPTPAGE value, to determine when to take output checkpoints. 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 initialization statement, the /*JOBPARM control statement, the JCL OUTPUT statement, or the JOB statement accounting field has been exceeded.

If you specify CKPTLINE=0, a logical page is defined only by the items noted above. If the LINECT value specified is greater than zero, setting CKPTLINE to a value greater than LINECT results in the LINECT value being used as the definition of a logical page; it overrides CKPTLINE.

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=nnnnn

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|SPACE=(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 $TPRTnnnn,CKPTPAGE=nnnnn command while this data set is printing. If you issue the $TPRTnnnn,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=ttttt

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.

CLass|Queue=c1[...c36]

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

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.

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={xxxx|RESET}

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|FLASH|O=name

The 1 to 4 alphanumeric character name that specifies the name of the default forms FLASH ID.

Forms=cccccccc

The 1 to 8 character name of the forms that are loaded into this printer.

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

F=(STD1,STD2)

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. If this parameter is not specified, the MODE setting becomes MODE=JES.
2. You must also specify UNIT= if this PRT(nnnn) command defines a 3827 or 3835 printer.

JOBname=jobname

The 1 to 8 character name of jobs whose output is to be selected by this printer.

A null parameter of (JOBname=) specifies that jobname is not a criterion for output selection.

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 from 0 through 2147483647. 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 (4294967295).

Note: If the printing of a data set is interrupted by a warm start, JES2 uses the original size of the output (prior to any printing) to determine where the remainder of the output is printed. That is, the original size of the JOE is used to determine output device selection.

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 wait for this printer to drain and then enter a $T PRTnnnn command. The $HASP097 message indicates when the draining process is complete. If the printer is not drained before entering this command, JES2 ignores it.
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 function subsystem device, JES2 honors the MODE specification, but incorrect output results.

NEWPAGE={ALL|DEFAULT|1}

Specifies when a ‘skip to channel' is counted as a new page. You can specify one of the following:

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.

1

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

NPRO=tttt

Specifies the non-process runout (NPRO) time interval in seconds (0-3600). You can use this operand 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 operand has no effect on cut-sheet page printers.

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.

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

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

Specifies the lower and upper page limits 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 from 0 through 2147483647. 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 you code m-* the upper limit is set to the default value (4294967295). This parameter is valid only when the printer is controlled by a functional subsystem.

If the printing of a data set is interrupted by a warm start, JES2 uses the original number of pages specified by the job output element and the original priority value to determine when and where the remaining output is printed.

PRESELCT={No|Yes}

Specifies whether JES2 preselects data sets for a device. Specifying PRESELECT=N makes data sets selectable by any device. Y is the default.

Note: The PRESELECT operand is valid only when the printer is under control of a functional subsystem.

PRMode=(mode1[,..mode8])

The SYSOUT mode(s) (1 to 8 alphanumeric characters) to be processed by this printer. You can specify as many as 8 SYSOUT modes for a single printer. 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.

RANGE={J|S|T} nnnnn[-nnnnn]| J1-65534

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 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. The two values can be equal. If they are not equal, the second value must be larger than the first value.

Routecde=routecde

Specifies up to four internal route codes to be assigned to this printer. If more than one route code is assigned, enclose the list in parentheses. For specification requirements, refer to Route codes.

Note: NODENAME=REQUIRED on the DESTDEF initialization statement will cause JES2 to require that a userid be prefixed with a node name.

Ummmm

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.

remote

Indicates routing to a remote. Remote can be specified in any of the following ways:

LOCAL|ANYLOCAL

Indicates that jobs are to be run at the local node.

Rnnnnn

Indicates routing to the specified remote. Rnnnnn can also be specified as RMnnnnn or RMTnnnnn. The value specified for nnnnn can range from 1 to 32767.

destid

Indicates routing to a destid referring to a remote.

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.

For more information about specifying userids as remotes, refer to Route codes.

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 transmission of operator messages to the remote terminal, with the exception of the $HASP190 setup message.

Note:

1. If you specify Sep=Y, but SEPPAGE=(LOCAL=NONE) (for local printers) was specified on either the PRINTDEF initialization statement or through the $T PRINTDEF command, default JES2 separator pages are not produced.
2. If you specify Sep=Y, but SEPPAGE=(REMOTE=NONE) (for remote printers) was specified on either the PRINTDEF initialization statement or through the $T PRINTDEF command, default JES2 separator pages are not produced.
3. If you specify Sep=N, a user created 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 an enabled EXIT 15 (output data set/copy separators) to generate separator pages. For printers under control of a functional subsystem, SEPDS is supported with a default separator page.

Note: If EXIT 15 is not enabled when you specify Y on this operand, separator pages are not generated.

SETUP={HALT|NOHALT}

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

HALT

Allows the operator to verify the changes to the printer by halting the printer and issuing the setup message.

NOHALT

Allows the printer to process output without requiring setup verification by the operator. With SETUP=NOHALT, JES2 can unload any printer characteristics that require no manual intervention. The printer uses any previously existing setup characteristics that you have not changed to process output.

T|UCS=id

Specifies, for impact printers, the 1 to 4 character identifier of the print train that is mounted on this printer. The identifier must reside in SYS1.IMAGELIB and the indicated printer must have the universal character set (UCS) feature.

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 operand 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 operand is only valid for a 1403 printer that has the UCS feature.

TRace={No|P|Yes}

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. Trace IDs 11, 12, 14, and 15 can be enabled either at initialization on the TRACE(n) statement or through the $S TRACE(n) command.

TRANS={DEFAULT|No|Yes}

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=DEFAULT, or 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.

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.

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 4245 and 4248 printers only when required for print processing (they are not loaded in response to a $T PRT 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. This operand can be modified through a JES2 Warm start.

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:

1. You can omit this parameter when defining local printers; however, if you do and the printer requires a unit address (for example, all JES mode printers), you must specify a unit address on the UNIT parameter of the $T command before starting the printer.
2. 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 you specify MODE=FSS, the defaults will be the same as if the device was a non-impact printer. If you specify MODE=JES, the defaults will be set assuming the device is an impact printer.

Volume=volume

Specifies the 5 to 6 character volume serial number of a volume containing a spool data set. Only the output of jobs which reside on one or more of the specified volume(s) can be selected for printing. You can specify as many as four volumes. Use commas to separate individual volume IDs and enclose this list in parentheses if more than one ID is specified.

Note: A null parameter of VOLUME=() specifies that volume is not a value specified for work selection. You must specify the empty parentheses.

Writer=writer

Specifies the 1 to 8 character writer name assigned to this printer. If you do not specify this parameter, no writer name is assigned.

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

WS=ws

Specifies the work values for this printer. Using any combination of user and JES2-defined criteria, you can specify up to 19 criteria in the WS= list. Values which are not specified are not considered during output selection, although they are used by JES2 to determine setup requirements. This operand can be particularly useful when draining a specific spool volume. To specify a printer work selection list, use the following values:

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

   Table 1 defines each value 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 values 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 values 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 value removes it from the list.
   Note: Message $HASP650 is issued if an incorrect operand is found in the WS operand; that is, this message is issued if you try to remove a value that is not there. For example, if you enter: $addprt1,ws=(-o) you get the $HASP650 message because ‘o' (forms overlay) is not in the current work selection list for printer1.
5. Specifying a value that is not currently specified adds it to the list. List position depends upon whether you specify a slash before or after the value in the command.
6. Demand setup presumes that characteristics change throughout the output group. As a result, if your output specifies demand (DMND) setup, you cannot specify an exact match between that output and the device.

   To print demand (DMND) setup output you must first remove the work selection criteria specified for the printer that is referenced by DMND.

7. If the device is a remote printer, route code (R=) must be specified in the work selection list.
8. The smaller the work selection list, the less the placement of certain values affects work selection. Job output elements are queued to the class queues by route code, then by priority. You can improve system performance by using this information to tune the work selection list.

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

• If you shut down this JES2 system and then attempt to restart it, you will lose the specifications of any printer defined through the $ADD PRT unless those specifications had been permanently defined by a PRT(nnnnn) initialization statement.
• If you are uncertain of the controls in effect, enter either the $D U command or the $D PRT command for the printer in question.
• When adding printers, you might experience a system delay of several seconds or even a few minutes before the printer is available in SDSF. The delay might be caused by the additional processing JES2 needs while performing tasks such as extracting the SECLABEL associated with a device for use by applications such as SDSF. JES2 performs this processing independently of the $ADD command processing. As a result, if you add a large number of printers it is possible that SDSF might recognize some of the printers before JES2 has completed extracting the SECLABELs. If this occurs, an SDSF display might provide data you might consider inconsistent with the $ADD command. For example, a printer might initially be displayed with no SECLABEL or a printer you added is not displayed at all due to SECLABEL restrictions. Allow JES2 time to extract the SECLABEL before exiting and re-entering the SDSF printer display.

Scope

Single member. The values supplied for this command will be in effect for this member only.

Depending on your installation's setup, however, you might want this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

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

The $HASP003 rc=65 indicates that the device specified by the UNIT= parameter exists, but does not match the device type information specified on the $ADD PRT command.

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

The $HASP003 rc=67 indicates that the FSS device specified by the UNIT= parameter is not defined on the $ADD PRT command or the PRT initialization statement.

JES2 defines page-mode printer 114 under the control of a functional subsystem to the current installation.