Parameter Description for CONDEF

AUTOCMD=nnnnn|20

Specifies the number (2-9999) of automatic commands that can be active concurrently in JES2. The value should be large enough to permit operators to leave a JES2 dynamic display in each user defined (“out of line”) area of all graphic display consoles and one on each printer console controlled by MVS™.

For additional information, see the description of the $T A command in z/OS JES2 Commands.

Modification: Hot start.

BUFNUM=nnnnn|100

Specifies the maximum number (4-9999) of console message buffers to be provided for JES2 from private storage (above 16-megabytes in virtual storage). The value specified for BUFNUM will be rounded up to the next page boundary to take advantage of available storage.

You must specify enough buffers to accommodate all message processing. When using NJE or RJE, you need more message buffers, especially for console support for multileaving terminals. If you do not specify BUFNUM= large enough, JES2 will fail during initialization.

If there is a large amount of console activity and buffers are unavailable, JES2 discards certain noncritical messages to avoid any delay in processing. These messages include: RJE-oriented messages, execution-time job overflow messages, and certain I/O error messages on JES2-controlled devices.

For multileaving terminal consoles, if the number of messages received exceeds the number of buffers specified by BUFNUM=, JES2 spools the excess messages and prints them later. Normal message processing resumes when the console accepts the messages queued before exceeding the BUFNUM= limit.

Note: Use this parameter to increase the limit for the JNUM resource that is reported on the HASP050 message.

Performance Considerations: Use BUFNUM=1000 as a minimum starting value and increase the value using the $T CONDEF command if the $HASP050 message indicates a shortage. Because console messages must wait for buffers, too small a value slows the system.

As a rough approximation, estimate the BUFNUM= value as follows:

  BUFNUM=
      (PARTNUM= on INITDEF statement) x 2
      + number of typically active readers (i.e., local, remote, internal)
      + number of typically active printers (i.e., local, remote)
      + number of typically active punches (i.e., local, remote)

Use the larger of the two values: either 1000 or the value specified above.

Modification: $T CONDEF operator command to increase the limit. Hot start to decrease the limit.

BUFWARN=nnn|80: Specifies the percentage (0-100) of use of console message buffers at which the operator will be alerted by message $HASP050. If you specify 0, no alert will be given.
Modification: $T CONDEF operator command.

CMDNUM=nnnnn

Specifies the maximum number (4-9999) of console message buffers to be allocated for command processing for JES2 from common storage.

JES2 refuses any commands entered after the command that exceeds the CMDNUM= limit. If you queue a large number of commands to JES2, too large a value may lead to an excessively large allocation of ECSA virtual storage.

Note: Use this parameter to increase the limit for the JNUM resource that is reported on the HASP050 message.

Default: BUFNUM parameter

Modification: $T CONDEF operator command to increase or decrease the limit.

CONCHAR=c|$

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 CONCHAR, 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:

  1/2  |  (  %  :  .  & +  _  #  <  !  -  >  @  "  /  ?  =  ¬  *

If the CONCHAR parameter is changed to a character other than its default ($), the commands will vary from their documented format in z/OS JES2 Commands, the messages will vary from the format in z/OS JES2 Messages, and the character chosen will be on the consoles and hardcopy log.

You must use the default CONCHAR= character ($) on JES2 commands imbedded in the JES2 initialization data set regardless of what you specify for CONCHAR=.

Note: To use the MVS ROUTE *ALL command to expand the scope of a command (so that a command can be routed to all the members of the MAS), each member of the MAS must have the same CONCHAR character. See z/OS JES2 Commands for more information about the scope of each command, and about using JES2 and MVS commands together.

Modification: $T CONDEF operator command. You cannot modify this parameter on a hot start.

DISPLEN =nnn|64

Specifies the length (50-70 characters) of output lines for most multi-line display and diagnostic messages. If you specify too low a number, single-line command responses can wrap around your console. If you enter the $N nnnn,Mn command, the node and specific multi-access spool (MAS) member appear at the start of each line. If you specify DISPLEN=70 and the node and specific MAS member total eight characters, your console only displays the first 62 characters of the message.

Modification: $T CONDEF operator command.

DISPMAX=nnnnnnn|100

Specifies the maximum (10-9999999) lines of output that JES2 allows before the $SCAN facility ends the output because of excessive output. This option does not affect all the JES2 commands. Commands that use a range of values as an operand, could cause an enormous amount of output. DISPMAX= will limit the output without limiting the range of objects the command will affect. For example, if you enter $T NODE(*),RECEIVE=JOBS, the command will change all nodes, and then start to display them. DISPMAX= will stop the display after the number of lines specified, but all nodes will be changed.

Modification: $T CONDEF operator command.

The DISPMAX= parameter is not honored when:

Output is displayed for error conditions.
Output is destined for an out-of-line area on the MCS console, or a command is issued with the explicit L= parameter that specifies an out-of-line area or L=Z. In this case, the output will still be ended at the maximum of 9999999 lines.

MASMSG=nnn|200

Specifies the maximum number (10-999) of messages or commands that will be queued between any two members of a multi-access spool configuration before messages are discarded. This count also applies to the number of input messages or commands queued for the system.

Modification: $T CONDEF operator command.

RDIRAREA=c|Z

Specifies a character representing the default console out-of-line area JES2 uses to direct display responses for commands subject to redirection. Redirectable commands that do not include an L= and are not named on a REDIRect initialization statement, or a $ADD or $T statement, will have their responses directed to the RDIRAREA specification. See z/OS MVS Planning: Operations for information on out-of-line display areas and how to define them.

This parameter defaults to Z, which specifies that the response will be in-line.

Modification: Hot Start or $T CONDEF operator command.

RDRCHAR=c|$

Specifies the character that will be used to identify all JES2 operator commands entered from a local or remote card reader. If a JES2 control card is read (/* in columns 1 and 2) that contains this character in column 3, JES2 will assume that the card is a JES2 command statement and will attempt to process the command.

The specification should be one of the following characters:

  1/2  |  (  %  :  .  & +  _  #  <  !  -  >  @  "  /  ?  =  ¬  *

If this parameter is changed to a value other than its default, the command control statement will vary from the format given in z/OS MVS JCL Reference. You can use the same character as that specified for the CONCHAR parameter on this initialization statement.

Modification: $T CONDEF operator command.

SCOPE=SYSTEM | SYSPLEX

Specifies whether the command prefix specified on the CONCHAR parameter is recognized by this MVS system only, or by all MVS systems in the sysplex.

SCOPE=SYSTEM specifies that the prefix is recognized by this MVS system, but if the command was entered on a different MVS system, that system would not recognize or send the command to this system.

SCOPE=SYSPLEX specifies that the prefix is recognized as belonging to this system no matter which MVS system in the sysplex the command was entered on, and, if necessary, is routed to the correct MVS system for processing by this subsystem.

See z/OS JES2 Initialization and Tuning Guide for a discussion of how to correctly specify SCOPE= in a sysplex to provide unique CONCHAR= character definitions for multiple JES2 images.

Modification: Single-member warm start.