This section describes the JES2 initialization parameters, their functions, formats, and default values. The parameters are described in alphabetical order (excluding the first characters if & or $). The following conventions are used in the parameter descriptions:
• Numbers and uppercase letters must be coded exactly as shown.
• Lowercase letters represent variables for which you must substitute specific information or specific values.
&BSPACE (Console Backspace Character)
• Paired parameter values or paired sub parameters (for example, HOLD/NOHOLD) indicate that you may choose one or the other. If you specify neither, the underlined one will be used as the default value.
The following syntax rules apply to the coding of most of the parameters. (Exceptions are contained within the parameter descriptions.) Refer to Figure 3-2 for examples of coded parameters.
• A parameter is separated from its subparameters by at least one blank; sub parameters are separated from each other by commas.
• Any columns between 1 and 71 can contain data; column 72 is used for continuation;
columns 73-80 are ignored.
• Parameter statements can be continued on successive cards; continuation is indicated by a comma followed by a blank. (If the last subparameter on a card is not followed by a comma and column 72 is not blank, then the next card is considered to contain only comments.)
• Subparameters cannot contain embedded blanks. The first blank terminates the parameter statement and the rest of the card is considered to contain comments.
• Only one parameter can be coded per card although several subparameters can be coded on the same card.
• Leading zeros cannot be used in parameter values (except as noted for specific parameters). This is especially true for device names: READEROI is an error;
READER 1 is correct.
• A parameter deck is terminated by an end of me or any card that contains a
/*
in columns 1 and 2.• Character specifications, unless otherwise noted, can include any alphanumeric or national characters or the period(.).
Parameter cards can be put in the card deck in any order. Subparameters may also be specified in any order. Once a parameter or sub parameter is specified, that value is used until that parameter or subparameter is specified again. That is, if the same parameter occurs more than once, or if the same sub parameter occurs more than once for a parameter, JES2 uses the value from the last one it reads.
& BSPACE=nn
The &BSP ACE parameter specifies the character that will be interpreted as the machine-defined backspace character X'16'. nn is the two-digit hexadecimal representa-tion of the EBCDIC character that will be interpreted as the machine-defined backspace character X' 16'. When the character specified by this parameter is entered from any operator console, it is removed from the command text along with the previously entered character (if any). Characters following the backspace character are shifted left to replace the removed backspace characters.
This backspace function applies to all commands entered by means of operator command input sources, regardless of their position in the text of the data entered. This function does not apply to a JES2 card reader or remote work station sources.
Note: The character selected for the backspace function must be chosen with caution because it eliminates the use of that character (except as a backspace operation) in all commands and replies to WTORs.
&BSVBOPT (2780 End of Media Punch Recognition Option)
&BUFSIZE (JES2 Buffer Size)
&CCOMCHR (Local Operator Command Identifier)
Default: The EBCDIC character '" (X'SF') is used for backspace command entry on operator consoles.
& BSVBOPT=YES/NO
The &BSVBOPT parameter provides the option of recognizing an EM (end of media) punch in card images transmitted nontransparently by the 2780 Data Transmission Terminal.
Default: NO
& BUFSIZE=nnnn
The &BUFSIZE parameter specifies the size, a decimal number of bytes, of each JES2 buffer. If the value specified is not a multiple of 8, it is rounded up automatically.
Each JES2 buffer is allocated to virtual storage, so the input/output block (lOB), which is 88 bytes, and the data area (the number of bytes in &BUFSIZE) are always contained in one 4K page. The maximum value, 4008, allows three records per track on a 3330.
Lower Limit: 600 Upper Limit: 4008
Default: 1960, which is the maximum size that allows two buffers per page of virtual storage and good utilization of 2314 and 3330 track capacities (three or six records per track, respectively).
Note: The maximum value, 4008, and the default value, 1960, are dependent on the current JES2 control block definitions. The value selected for &BUFSIZE must be at least the greater of 600 or (368 + &NUMDA * ((&NUMTGV + 7)/8 + 3)/4*4 + 7)/8*8, where the number 368 is dependent on the current JES2 control block definitions.
&CCOMCHR=c
The &CCOMCHR parameter specifies the character that will be used to identify JES2 commands from local consoles. If a command from a local console begins with the character specified for &CCOMCHR, JES2 assumes that the command is a JES2 command and attempts to process it.
The value you specify should be a special character that is not used as the first character of any command of any other subsystem that may be operated concurrently with JES2.
The character should be one of the following:
¢
<
-, &
$
*
)+
/
%>
?# @ "
Notes:
1. The specification must not be the character specified for the &BSPACE parameter.
l
&CHKPT (JES2 Check ..
point Volume ID)
&CKPTIME (JES2 Checkpoint Interval)
&DEBUG (JES2 Debug Option)
2. If·this parameter is changed to a character other than its default ($), the commands will vary from their documented format in Operator's library: OS/VS2 JES2 Commands and the messages will vary from the format in OS/VS Message library:
VS2 Messages.
Default: $
&CHKPT=cccccc
The &CHKPT parameter specifies the volume serial number of the volume that contains the JES2 checkpoint data set, SYS1.HASPCKPT. (Space for this data set is allocated at JES2 generation as described in Chapter 2.) The value you specify for &CHKPT should be from one to six characters that define a valid volume serial number. When this parameter is specified as a volume serial number other than SPOOL 1 (the default for
&SPOOL), certain messages will vary from their documentation in OS/VS Message Library: VS2 System Messages.
Note: The checkpoint data set is frequently referred to, especially in multi-access spool configurations. Therefore, only low-usage data sets (if any) should be allocated on the same volume as the checkpoint data set. Otherwise, JES2 performance could be seriously degraded.
Default: The volume serial number specified in the &SPOOL parameter.
CKPTIME=nnn
The &CKPTIME parameter specifies, in seconds, the interval at which certain checkpoints of JES2 information are taken for warm start. (Checkpoints are taken, for example, when a job changes its status in the JES2 job queue.) The time interval specified is a maximum checkpoint time for a non-shared JES2 system (that is a single-member configuration).
For JES2 systems sharing pool and checkpoint volumes, the time interval specified is used for print/punch checkpoints only. For these systems, a value of 120 or greater is recommended.
Lower Limit: 10
Upper Limit: 300 (5 minutes) Default: 60 (1 minute)
&DEBUG=YES/NO
The &DEBUG parameter provides the option for JES2 to record certain JES2 events and to monitor certain JES2 activities. Selection of this option will degrade JES2 performance.
Note: The information recorded as the result of selecting this option can only be made available through a dump of the JES2 memory. For more information about a JES2 dump, refer to the description of diagnostic aids in OS/VS2 MVS JES2 Logic.
Default: NO
&DELA YTM (Transmis-sion Delay Time)
&DELA YTM=nnnn
DESTID (Route Code Name)
The &DELA YTM parameter specifies, in microseconds, the delay time to be applied by RTAM when transmitting to either a MULTI-LEAVING System/360 Model 20, submodel 2, 4, or 6, or to a 2922 remote terminal over a high-speed (19,200 baud or greater) teleprocessing line. This delay time avoids the possibility of certain line errors.
If data-overrun line errors occur at the work station when the default value is used, the value should be increased.
Lower Limit: I Upper Limit: 9999 Default: 100
DESTID NAME=cccccccc
DEST=Rnnn/Unnn/LOCAL
The DESTID parameter specifies a user-defined name for a JES2 route code. JES2 route codes normally are of the form Rnnn for remote workstations (for example, R4 indicates SYSOUT data for remote 4), Unnn for special routed local printer or punch devices (for example, UI indicates SYSOUT data for local printer or punch with route code of I), or LOCAL for normal printer or punch devices with route code of O. The user may refer to these JES2-defined routings in the DEST operand of the JCL data definition (DD) ) statement for /*OUTPUT, for SYSOUT data sets, in dynamic allocation of SYSOUT, or in the TSO OUTPUT command. The operators also refer to the JES2-defined routings in many JES2 operator commands. By assigning DESTID names to be equivalent to these routings, the users and operators may refer to the names· in lieu of the names provided by /
JES2. -J.
NAME=cccccccc
specifies the name, I to 8 alphanumeric characters (first character alphabetic), that the users and operators may use to refer to the JES2-defined destinations. The characters in the name must not match an acceptable name that could be used in the DEST parameter.
You should therefore refrain from using names of the form Xnnn (where X is any alphabetic character and nnn is a numeric value), RMnnn, or RMTnnn.
DEST=Rnnn
specifies the identification of the remote work station (nnn) the user or operator desires when the name is used. If the remote work station devices are pooled with another remote, the destination refers to the pool of remotes. The nnn values range from I to the maximum work station number defined to the system (refer to the description of
&NUMRJE).
DEST=Unnn
specifies the special routing number to be associated with the name. The nnn values range from I to 255 and correspond to the settings specified in the local reader, printer, and punch route code settings.
DEST=LOCAL
specifies that the name may be used to refer to normal local printer and punch devices;
that is, printer and punch devices that are to receive normally routed output.
&DMNDSET (Demand Setup Option)
&ESTIME (Default Estimated Execution Time)
&ESTLNCT (Default Estimated Print Output)
&ESTPUN (Default Estimated Punch Output)
&DMNDSET=YES/NO
The &DMNDSET parameter specifies whether inline printer setup will be allowed for data sets whose SYSOUT class matches the job message class.
If the def~u1t value is not used, all SYSOUT data sets that are not specified for special processing in any other way (for example, HOLD) and whose class matches the job's message class, are printed on one printer with appropriate setup messages to the operator as the data sets are printed.
If &DMNDSET=NO is specified or if the SYSOUT class does not match the message class, separate class work queues are created for each unique setup required. Thus, data sets can be printed simultaneously on all printers available.
Default: NO
&ESTIME=nnnn
The &ESTIME parameter specifies, in minutes, the default estimated execution time for a job. This value is used if you do not specify a value for estimated execution time in the
accounting field of the JOB card or on a /*JOBPARM control card.
Lower Limit:
Upper Limit: 1440 (24 hours) Default: 2
&ESTLNCT=nnnn
The &ESTLNCT parameter specifies, in thousands of lines, the default estimated print line count for a job. This value is used if you do not specify a value for the estimated print line count in the accounting field of the JOB card or on a /*JOBPARM control card.
Lower Limit: 0 Upper Limit: 9999 Default: 2
&ESTPUN=nnnnnnn
The &ESTPUN parameter specifies, in number of cards, the default estimated punched card output for a job. This value is used if you do not specify a value for the estimated card count in the accounting field of the JOB card or on a /*JOBPARM control card.
Lower Limit: 0 Upper Limit: 9999999 Default: 100
Innnn (Logical Initiator) Innnn CLASS=c 1 ••• cn DRAIN/START NAME=cc
The Innnn parameter specifies the characteristics of one logical initiator. Initiators are numbered consecutively (11-11332) for the number of initiators specified by the
&MAXPART parameter. Initiator characteristics are specified by the following subparameters.
CLASS=c 1 ••• cn
specifies the job classes (in order of their priority) from which this initiator will schedule jobs. You can specify any number of job classes (A-Z,O-9) up to 36. Those in excess of the number specified by the &MAXCLAS parameter are ignored.
Default: If not specified, JES2 assigns job classes in the following manner:
For Logical Initiator Default Classes Are
11 A
12 BA
13 CBA
126 127 128
136 137
199
ZYX ... CBA OZYX ... CBA
IOZYX ... CBA
987 ... CBA 987 ... CBA
987 ... CBA
Note: When &MAXCLAS specifies a number less than 36, JES2 determines the d.efault job classes as shown above, but recognizes only the number of the1J1 allowed by the
&MAXCLAS value. For instance, when 18 is assigned default classes HGFEDCBA, but
&MAXCLASS=5, JES2 recognizes only the first five (HGFED) job classes as default classes for 18.
DRAIN/START
DRAIN specifies that this initiator will be started by operator command.
Default: START specifies that this initiator is to be started automatically when JES2 starts processing.
NAME=cc
specifies a unique name that the operator can use to refer to this initiator. cc may be 1 or 2 characters (A-Z,O-9).
Default: nnnn of the Innnn specification. (Beyond 199, you must specify a name.)
INTRDR (Internal Readers)
INTRDR AUTH=n CLASS=c HOLD/NOHOLD PRIOINC=nn PRIOLIM=nn
The INTRDR parameter specifies the characteristics of all JES2 internal readers defined by the &NUMINRS parameter. An internal reader is a special SYSOUT data set that other programs can use to submit jobs, control statements, and commands to JES2.
External readers (for example, RDR) and time-sharing users use the internal readers to submit jobs from direct access devices or tapes. Internal readers are treated like physical input devices. Internal reader characteristics are specified by the following subparameters.
AUTH=n
specifies the command authority number for internal readers. This number authorizes certain JES2 commands to be submitted through an internal reader. n is a number from 0-7 defining the kind of commands that can be entered:
7 - display only 6 - system authority 5 - device authority
4 - system and device authority 3 - job authority
2 - system and job authority 1 - device and job authority
o -
system, device, and job authorityThis command authority can be changed at any time by the operator.
Note: The numbers defining these command authorities are intentionally opposite to the numbers of the command authorities defined for the $T operator command.
Default: 0 CLASS=c
specifies the default job class to be assigned to all jobs submitted through an internal reader that do not specify a job class in the CLASS operand of their JOB statements. c can be any character A-Z,0-9.
Default: A HOLD/NOH OLD
HOLD specifies that all jobs submitted through an internal reader are to be held after JCL conversion until they are released for execution by the operator.
Because all internal readers are treated as a single facility, if one internal reader is held, all internal readers are held. This can be particularly troublesome if TSO users are submitting jobs and the central operator has held the internal readers. This can be overcome by several operating techniques:
• All jobs submitted through an internal reader can be assigned a class and that class can be held by means of a JES2 parameter library entry or the $HQn operator command.
• Jobs submitted through the internal reader can use the TYPRUN=HOLD parameter on the JOB card.
• Jobs submitted through an internal reader can be individually held with the $HJ operator command.
Default: NOHOLD, which specifies that jobs submitted through an internal reader are to be queued as usual.
PRIOINC=nn
specifies a number (0-15) to be added to the selection 'priorities of all jobs submitted through internal readers. If the total of this number and a job's priority exceeds the value specified by PRIOLIM, JE82 assumes the priority specified by PRIOLIM.
Default: 0 PRIOLIM=nn
&JCOPYLM (Maximum Job Output Copies)
&LINECT (Lines Per Page Limit)
specifies the maximum priority level (0-15) that can be assigned to jobs submitted through an internal reader. If a job's priority (with or without the increment specified by PRIOINC) exceeds this level, it will be reduced to this level.
Default: 15
&JCOPYLM=nnn
The &JCOPYLM parameter specifies the maximum number of job output copies that can be requested in the accounting field of the JOB card or on a /*JOBPARM control card. If the number of copies requested is greater than the value of &JCOPYLM, the request is reduced to the value of &JCOPYLM. No error message is produced.
The setting of this parameter does not affect requests for multiple copies of data sets through a /*OUTPUT control card.
Lower Limit: 1 Upper Limit: 255 Default: 3
&LINECT=nnn
The &LINECT parameter specifies the maximum number of lines to be printed per page of a job's printed output. This value is used if you do not specify a value for line count in the accounting field of the JOB card or on a /*JOBPARM control card.
&LINECT=O causes automatic page overflow (normally standard in JE82) to be suppressed unless overridden by the JOB card accounting parameter or a /*JOBPARM control card specification.
If a print data set is generated without any ejects (that is, no skips to any channel in the carriage tape), and if 0 is specified in this parameter, the JOB card accounting field, or a /*JOBPARM control card, the data set is treated as one page when forward-spaced, backspaced, interrupted, or warm started while printing.
Lower Limit: 0 Upper Limit: 255 Default: 61
LINEnnn (RJE Lines)
Note: When using standard forms (14 7/8 X 11), a 3800 printer will not print more than 60 lines per page at 6 lines per inch or 80 lines per page at 8 lines per inch.
LINEnnn CODEB/.CODEA FDUPLEX/HDUPLEX HISPEED/LOWSPEED IF ACEB/IF ACEA NOADISC/ ADISCON PASSWORD=cccccccc TRANSP/NOTRANSP UNIT=cau/SNA USASCII/EBCDIC
The LINEnnn parameter specifies the characteristics of one teleprocessing line or logical line (for SNA RIE terminals) to be used during remote job entry. This parameter should be specified for each teleprocessing line. Lines are numbered consecutively (LINEI-LINE255) for the number of lines specified by the &NUMLNES parameter.
line characteristics are specified by the following subparameters.
Note: If UNIT=SNA is specified, all other LINEnnn subparameters, except PASSWORD, are ignored.
CODEB/CODEA
CODEB specifies code B for this line. Code B refers to the second code in a BSC adapter that has the Dual Code feature. If the Duat Code feature is not present, CODEB should not be specified.
Default: CODEA which specifies code A for this line; Code A refers to the first code in a BSC adapter that has the Dual Code feature.
FDUPLEX/HDUPLEX
FDUPLEX specifies that this is a duplex line.
Default: HDUPLEX, which specifies that this is a half-duplex line.
HISPEED/LOWSPEED
HISPEED specifies that this is a high-speed (greater than 9600 bits per second) line.
HISPEED specifies that this is a high-speed (greater than 9600 bits per second) line.