z/OS JES3 Initialization and Tuning Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Parameters

z/OS JES3 Initialization and Tuning Reference
SA32-1005-00

CARRIAGE=
Indicates the specific name (1-to-8 characters) of the 1403 printer carriage tape or the FCB module that is to be the installation standard. FCB modules are in the SYS1.IMAGELIB data set. For 3211 printers, the FCB module is named FCB2, plus the first four characters of the carriage tape name. For 3800 printers, the FCB module is named FCB3, plus the first four characters of the carriage tape name. For more information about SYS1.IMAGELIB, refer to z/OS DFSMSdfp Advanced Services.
Note: If you are using the user exit IATUX23 and you are coding FCBs for use with JES3 defined printers that are other than 3800, then you must code a CHANNEL 12 in the FCB.
CB=
Specified for the 3800 printer only. This parameter specifies when the device's buffer is to be cleared. The buffer is cleared by the clear printer channel command.
D
Indicates that the data set option is to be used. This causes output service to issue a clear-print channel command at the end of each data set. This causes a short pause at the end of each data set.
J
Indicates that the job option is to be used. This causes output service to issue a clear-printer channel command only at the end of each job. This causes a short pause at the end of each job.
N
Indicates that the device's buffer is not to be cleared unless required by a function. Maximum performance is obtained with CB=N. Examples of functions that require a clear printer command are:
  • Loading new characters
  • Requesting operator setup
  • Waiting for work

When the device is in manual mode (M specified on *X, *R, or *S and M is specified in message IAT8562), a clear printer command is issued before each data set and CB has no effect.

If you specify an invalid subparameter, JES3 uses the parameter default.

CDSTOCK=
Indicates the stock name (1-to-8 characters) or stock number of the cards to be considered the installation standard. This parameter is analogous to the FORMS parameter for printer output.
CHARS=
Specifies the 1-to-4 character name(s) of the image to be set up on the printers that support character sets. Up to four names can be specified.

This parameter specifies default information for the OSE that can be used on printers that support character sets (for example, AFP printers).

The parameter default is GS10.

EXTOSENUM=
Indicates whether extended IATYOSE sequence numbers (numbers exceeding 65,535) are allowed to be created. EXTOSENUM=NO can be used during migration to the z/OS® V1R9 level of JES3 to ensure that jobs do not create output that cannot be handled by earlier levels of JES3. See z/OS Migration for more information.
Note: Specifying EXTOSENUM=NO has no effect on output that has already been created. It does not prevent additional Output Scheduling Elements from being added to spool records that have already been created either. Therefore, in order to ensure that all output can be processed on down level JES3 systems, you must specify EXTOSENUM=NO the first time when a z/OS V1R9 JES3 global is IPLed.
FLASH=
Specifies the name (1-to-4 characters) of the forms flash cartridge to be used on the 3800 printer.
name
Specifies the name of the standard forms flash cartridge; the subparameter default is NONE.
count
Specifies the standard flash count. If NONE is specified, then this subparameter should not be specified. If FLASH=name is specified and the count subparameter is not specified, then 255 is the default.
FORMS=
Specifies the name of the printer forms (1-to-8 alphanumeric or national characters) to be considered the installation standard. This parameter is analogous to the CDSTOCK parameter for punched output.
MODIFY=
Specifies the module identifier and reference character to be used as the standard copy modification option for the 3800 printer.
id
Specifies the name of the copy modification module to be used (one to four characters).
NONE
Specifies that the copy modification option is not being used.
0,1,2,3
Specifies the table reference character to be used with the copy modification option.
OUTLIM=
Specifies the default record limit for a SYSOUT data set. When this limit is exceeded, the installation SMF exit is entered. Upon return from the SMF exit, the job is either canceled or a new limit is used. The value of limit must be from 1 to 16777215. For more information concerning SMF exits, see z/OS MVS Installation Exits.

If you specify an integer greater than the maximum allowable, JES3 uses the parameter default. If you specify a negative integer or a non-numeric character, JES3 issues message IAT3245 and initialization terminates.

If you specify an invalid subparameter, JES3 uses the parameter default.

OUTSVFCT=
Specifies the number of OUTSERV FCTs that are available to process jobs from the output service queues. The valid values for OUTSVFCT are 1 to 10. The default is one.

Defining more than one FCT allows output service to process multiple jobs simultaneously and prevent bottlenecking. IBM® recommends that you specify at least three OUTSERV FCTs.

SNAGROUP=
Specifies whether JES3 group DSISO data sets are destined for SNA/NJE or TCP/IP nodes.
YES
Specifies that JES3 group DSISO data sets, if possible, are destined for SNA/NJE or TCP/IP nodes. Specifying YES allows the receiving node to assign a single job number to a group of data sets that were produced by one job at the originating node.

Specifying SNAGROUP=YES also causes JES3 to always group non-spinoff DSISO data sets (TYPE=DSISO specified on the SYSOUT initialization statement for the SYSOUT class). However, spinoff data sets, such as those produced by specifying FREE=CLOSE in the JCL, are sent separately because they are sent when the data set is closed rather than at the end of the job.

Attention: Specifying SNAGROUP=YES prevents JES3 from releasing spool space used for DSISO data sets until all of the job's data sets have been sent to the specified node.

NO
Specifies that JES3 send DSISO data sets destined for SNA/NJE or TCP/IP nodes as separate data sets. Specifying SNAGROUP= NO allows JES3 to release spool space as soon as a data set is sent.
STACKER=
Specifies which stacker option is to be standard for a 3800 printer.
C
Specifies that output is to be placed in the continuous forms stacker. If no 3800 described as BTS feature, STACKER=C is forced by initialization.
S
Specifies that output is to be placed in the sheet stacker, where offset stacking is automatically performed.

If you specify an invalid subparameter, JES3 uses the parameter default.

TRAIN=
Indicates the installation standard printer train or band.
train
Specifies the name (1 to 4 characters) of a specific printer train or band to be used as the installation standard.
ANY
Specifies that any printer train or band that is mounted is acceptable, provided the printer can otherwise fulfill processing requirements.
PN
Specifies the PN Printer train.
THRESHLD=
Specifies the default maximum size for a SYSOUT data set. The maximum value that may be specified is 99999999. THRESHLD=-1, which is the default, indicates that no threshold processing is in effect. This parameter is used by output service to build and queue OSEs for writers. The THRESHLD parameter assumes that the data set size is the number of records in the data set multiplied by the number of copies. Data sets that equal or exceed the value specified are queued as separate piece of work for output service writers.

A job that has work created in this manner is eligible to be concurrently processed by several output service writers that have the same processing characteristics. Normally, similar pieces of work for a job are assigned to the same writer. This parameter should be used when the user wants to permit concurrent printing or punching of multiple copies of data sets or a large volume of data sets for a job on several output service writers. This parameter is ignored when the copy distribution for a data set is 3000 or more.

Example: Job ABC generates three SYSOUT data sets with similar processing characteristics (such as same forms, carriage). Assume that data set A is 3000 records and the user needs 2 copies; data set B is 10000 records and the user needs 1 copy; data set C is 1000 records and the user wants 10 copies.

If the THRESHLD for the job is 20,000, then the first writer to select the job is assigned all three data sets.

If the THRESHLD for the job is 10000, then the first writer to select the job is only assigned data set A. Data sets B and C are eligible for selection by another writer.

WC=
Specifies the writer classes. This parameter indicates SYSOUT classes in the order they are processed by the output service writers. Data sets for a class not specified will not be selected. The value of c specifies a valid SYSOUT class (A-Z, 0-9) that appears as a SYSOUT parameter on a DD statement. If a list of classes is specified, separate each class by a comma.

This parameter is effective only for writers that have a writer selection list that includes CL, the SYSOUT class. The list could have been specified explicitly or by default.

JES3 uses a null list as the parameter default and selects data sets, regardless of class, to be processed by output service writers.

WS=
Specifies the writer selection criteria. The value of c indicates the items JES3 output service checks, in order of importance, when selecting a data set for output processing. (These WS parameter values remain in effect over a hot start.) Specify the selections in order of importance and separate specifications with a comma.
Selection Character
  Meaning
C
Carriage tape or FCB (printers only)
CL
SYSOUT class
CM
Copy modification (3800 printer only)
D
Data set destination
F
Forms requested
FL
Flash (3800 printer only)
L
Limit scheduling (line, page or record)
SS
Stacker (3800 printer only)
P
Data set priority
PM
Processing mode
T
Specific device type requested
U
Character arrangement table name (CHARS) or train image (UCS).

All the selection characters are valid for printer output. C is not valid for punched output.

Attention: JES3 does not take any action (such as issue mount messages or load FCB and UCS) if you omit printer and punch setup characteristics on this parameter. For example, a job that requires special forms may print on the wrong form if you omit forms as a selection criterion.For additional information on the relationship of the WS= settings to the JCL of your installation job workload, see Work Selection for JES3.

NPRO=
Specifies the non-process run-out interval for a channel-attached AFP printer.
nnnn
Specifies the number of seconds the printer will wait for more data before forcing out the already-printed pages. The value specified must be between 0 and 9999, inclusive.
NO
Specifies that the run-out interval will not be used for this printer.

If you specify an invalid subparameter, JES3 uses the parameter default.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014