$T CONDEF

Function

To specify or modify the console communication characteristics of JES2.

Syntax


>>-$T--CONDEF--+--------------------+--------------------------->
               '-,--BUFNUM--=--nnnn-'   

>--+---------------------+--+--------------------+-------------->
   '-,--BUFWARN--=--nnnn-'  '-,--CMDNUM--=--nnnn-'   

>--+------------------+--+--------------------+----------------->
   '-,--CONCHAR--=--c-'  '-,--DISPLEN--=--nnn-'   

>--+---------------------------+--+-------------------+--------->
   '-,--DISPMAX--=--nnnnnnnnnn-'  '-,--MASMSG--=--nnn-'   

>--+-------------------+--+------------------+-----------------><
   '-,--RDIRAREA--=--c-'  '-,--RDRCHAR--=--c-'

Parameters

BUFNUM=nnnn

The BUFNUM parameter specifies the 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 can only increase the limit using this command.

BUFWARN=nnnn

The percentage (0-100) of console message buffers used at which the $HASP050 message alerts the operator of a shortage of console message buffers. JES2 deletes this message from the console when the resource shortage is relieved (either by a decrease in resource use or an increase in the threshold).

Note: If you specify 0, no alert is given.

CMDNUM=nnnn

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

CONCHAR=c

A single character used to identify JES2 commands from MCS consoles.

The specification must be one of the following characters:

|    %    :    ¢   +    ¬    #    [    ]    !    &

-    @    .    $    /    ?    =    _    (     *    "

Note: To use the MVS™ ROUTE *ALL command to expand the scope of a command, each member of the MAS must have the same CONCHAR character.

DISPLEN=nnn

The display length (50-70) that is used for the displays and error message processing of:

All initialization statements
Those commands processed by $SCAN (most of those commands are the $D and $T commands for initialization statement parameters)
The $DU command.

The main purpose of the DISPLEN= parameter is to control message wrapping on MCS consoles. You should set it to a value that takes into account the MFORM value used for most MCS consoles in your installation. The value 64 is appropriate for single MFORM options, such as MFORM=(J). The minimum value of 50 is appropriate for two MFORM options, such as MFORM=(J,T).

DISPMAX=nnnnnnn|100

The maximum number (10-9999999) of lines that JES2 displays for those requests processed by the $SCAN facility.

Note: The DISPMAX= parameter is not honored when any of the following situations occur:

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 specifying an out-of-line area or L=Z. In this case, the output is still ended at the maximum of 9999999 lines.

MASMSG=nnn

The maximum number (10-999) of messages or commands that are queued between any two members of a multi-access spool configuration. Messages or commands exceeding this number are discarded.

RDIRAREA=c

This parameter specifies the default console out-of-line area which JES2 uses to direct display responses for commands subject to redirection. All redirectable commands which do not use either an L= or do not have redirection set up on the issuing console for that command have their responses directed to the RDIRAREA specification.

Default: If RDIRAREA is not specified, JES2 uses a default console area specification of Z.

RDRCHAR=c

The character used to identify all JES2 operator commands entered from a local or remote card reader.

The specification must be one of the following characters:

|    %    :    ¢   +    ¬    #    [    ]    !    &

-    @    .    $    /    ?    =    _    (    )    *    "

Note:

The RDRCHAR value may be the same as that specified for the CONCHAR parameters on the CONDEF initialization statement.
If you change this parameter to a value other than its default ($), the command control statement varies from the format given in z/OS MVS JCL Reference, SA23-1385.

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.

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 $HASP830 message displays the current values of all the parameters on the CONDEF statement.

Examples

 1   $t condef,masmsg=300,rdrchar=%

  $HASP830 CONDEF  AUTOCMD=20,CONCHAR=$,BUFNUM=200,CMDNUM=100,
  $HASP830         BUFFREE=200,BUFWARN=80,MASMSG=300,RDIRAREA=Z,
  $HASP830         RDRCHAR=%,SCOPE=SYSTEM,DISPLEN=64,DISPMAX=100

JES2 queues a maximum of 300 messages between any two members of a multi-access spool configuration. All commands entered from a local or remote card reader that begin with a percent sign (%) are identified as JES2 commands.

 2   $t condef,bufnum=9998

  $HASP830 CONDEF  AUTOCMD=20,CONCHAR=.,BUFNUM=10013,CMDNUM=100,
  $HASP830         BUFFREE=10013,BUFWARN=80,MASMSG=200,RDIRAREA=Z,
  $HASP830         RDRCHAR=.,SCOPE=SYSTEM,DISPLEN=64,DISPMAX=100

The number of console message buffers to be provided has been increased. Note that the value specified for BUFNUM has been rounded up to the next page boundary.