z/OS JES2 Commands
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


$T PRINTDEF - Control the JES2 print environment

z/OS JES2 Commands
SA32-0990-00

Function

To specify the characteristics of the JES2 print environment.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-$T--PRINTDEF--+-------------------+-------------------------->
                 '-,--LINECT--=--nnn-'   

>--+------------------------+----------------------------------->
   '-,--NEWPAGE--=--+-ALL-+-'   
                    '-1---'     

>--+----------------------------------------------------+------><
   |                   .-,-------------------------.    |   
   |                   V                           |    |   
   '-,--SEPPAGE--=--(----+-LOCAL--=--+-DOUBLE-+--+-+--)-'   
                         |           +-FULL---+  |          
                         |           +-HALF---+  |          
                         |           '-NONE---'  |          
                         '-REMOTE--=--+-DOUBLE-+-'          
                                      +-FULL---+            
                                      +-HALF---+            
                                      '-NONE---'            

Parameters

LINECT=nnn
The maximum number (0-254) of lines to be printed per page on job output. If you specify LINECT=0, automatic page overflow (normally standard in JES2) is suppressed.
  • For MODE=JES printers: Table 1 shows the interaction and overriding order that JES2 uses when determining the number of lines it will use when writing a checkpoint record for printers set to MODE=JES (that is, non-FSS-mode printers).
    Table 1. Interaction of PRINTDEF and PRT(n) parameters that JES2 uses to calculate the output checkpoint interval
    PRINTDEF LINECT= and PRT(n) CKPTLINE= "Lines" Setting JES2 Uses to Calculate Checkpoint
    > 0 0 (or defaulted) PRINTDEF LINECT= value
    > 0 > LINECT= PRINTDEF LINECT= value¹
    > 0 < LINECT= PRT(n) CKPTLINE= value¹
    0 >0 PRT(n) CKPTLINE= value
    ¹ If CKPTPAGE=>0, then JES2 calculates total checkpoint lines to be the product of this value times the CKPTPAGE= value
  • For MODE=FSS printers:
    • If you set CKPTMODE= on PRT(nnnnn), JES2 uses that value to determine if checkpoints are taken based on page count or time.
    • If you set CKPTSEC= on PRT(nnnnn) or allow the default of 0, and CKPTMODE=SEC, this value sets the number of seconds before taking an output checkpoint.
Note:
  1. A 3800 printer does not print more than 60 lines per 11-inch page at 6 lines per inch or 80 lines per 11-inch page at 8 lines per inch.
  2. The LINECT= parameter does not affect a job if a line count was specified:
    • In the accounting field of the JOB statement
    • On a /*JOBPARM control statement
    • On the /*OUTPUT control statement
    • On the JCL OUTPUT statement.
  3. Changing LINECT= does not affect jobs that have been previously submitted.
NEWPAGE={ALL|1}
Specifies when a ‘skip to channel' is counted as a new page. The method selected on this parameter is used for all printers that do not explicitly specify NEWPAGE=, or for printers that have the NEWPAGE=DEFAULT parameter specified. You can override this parameter for a specific printer by specifying the NEWPAGE= parameter on a PRT or R(nnnn).PR(m) initialization statement. You can specify one of the following:
ALL
Specifies that JES2 will treat skip-to-any-channel as a new page.
1
Specifies that JES2 will treat only skip-to-channel-one as a new page.
SEPPAGE=([LOCAL=pagetype] [,REMOTE=pagetype])
Specifies the type of separator page JES2 produces on local and remote printers. Changing SEPPAGE affects jobs that have been submitted but have not yet printed. The value of the SEPPAGE parameter that is in effect at the time an output group starts to print, controls the production of both header and trailer separator pages. You can assign one of the following values for SEPPAGE:
DOUBLE
Requests the production of two full separator pages including jobname and jobid in block letters. Having two separator pages guaranties an outward facing page. DOUBLE is the default for LOCAL printers.
FULL
Indicates that a complete separator page including jobname and jobid is produced.
HALF
Specifies a separator page containing only detail separator information. Jobname and jobid do not appear in block letters. HALF is the default for REMOTE printers.
NONE
Inhibits separator page generation.

Authority Required

This command requires 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 control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Processing Considerations

This command affects only those jobs that have not yet printed.

Scope

Single member. 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 $HASP833 message displays the current values of all the parameters on the PRINTDEF initialization statement.

Example

 1   $t printdef,linect=80,seppage=(local=full,remote=half)

  $HASP833 PRINTDEF CCWNUM=49,LINECT=80,NIFCB=STD3,
                    NIFLASH=****,NIUCS=GT10,FCB=6,TRANS=NO,
                    UCS=0,DBLBUFR=YES,RDBLBUFR=NO,
                    SEPPAGE=(LOCAL=FULL,REMOTE=HALF)

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014