$T TPDEF

Function

To specify characteristics of the JES2 teleprocessing environment.

Syntax


>>-$T--TPDEF--+---------------------+--------------------------->
              '-,--AUTOINTV--=--nnn-'   

>--+--------------------------------------------+--------------->
   |                  .-,------------------.    |   
   |                  V                    |    |   
   '-,--BSCBUF--=--(----+-LIMIT--=--nnnn-+-+--)-'   
                        '-WARN--=--nnn---'          

>--+---------------------------------------------+-------------->
   |                  .-,-------------------.    |   
   |                  V                     |    |   
   '-,--SNABUF--=--(----+-LIMIT--=--nnnnn-+-+--)-'   
                        '-WARN--=--nnn----'          

>--+-------------------+---------------------------------------->
   '-,--RMTMSG--=--nnn-'   

>--+----------------------------------------------+------------><
   |                    .-,------------------.    |   
   |                    V                    |    |   
   '-,--SESSIONS--=--(----+-LIMIT--=--nnnn-+-+--)-'   
                          '-WARN--=--nnn---'

Parameters

AUTOINTV=nnn

The interval (10-600 seconds) between autologon scans; that is, the time between JES2 attempts to search the output queue for work for a particular remote. The default is 32 seconds between scans.

The timer is necessary only when a previous logon attempt has failed or when messages are queued for a remote, and the normal events that drive the autologon scan have not occurred. Proper specification of this parameter decreases the number of unnecessary output searches.

BSCBUF=

Defines the specifications for the BSC teleprocessing buffers. These buffers reside below 16 megabytes of virtual storage.

LIMIT=nnnn: The maximum number (1-9999) of the specified teleprocessing buffers which JES2 allows for RJE and NJE. The teleprocessing buffers are dynamically allocated up to this user specified maximum. To ensure that an error in JES2 does not cause a total depletion of JES2 private storage, the installation should limit the number of teleprocessing buffers obtained. Once this number of buffers is reached, all requestors of buffers must wait until a buffer is freed. You can only increase the limit using this command.
WARN=nnn: Specifies the percentage (0-100) of I/O buffer use. If the buffer use is at or above this percentage, the operator is alerted by message $HASP050.

Note:

Use this parameter to increase the limit for the JNUM resource that is reported on the HASP050 message. End of change

SNABUF=

Defines the specifications for the SNA (VTAM®) teleprocessing buffers. These extended buffers reside above 16 megabytes of virtual storage.

LIMIT=nnnnn: The maximum number (1-32512) of the specified teleprocessing buffers which JES2 allows for RJE and NJE. The teleprocessing buffers are dynamically allocated up to this user specified maximum. To ensure that an error in JES2 does not cause a total depletion of JES2 private storage, the installation should limit the number of teleprocessing buffers obtained. Once this number of buffers is reached, all requestors of buffers must wait until a buffer is freed. You can only increase the limit using this command.
WARN=nnn: Specifies the percentage (0-100) of I/O buffer use. If the buffer use is at or above this percentage, the operator is alerted by message $HASP050.

Note:

Use this parameter to increase the limit for the JNUM resource that is reported on the HASP050 message. End of change

RMTMSG=nnn

The maximum number of messages (0-255) that may be queued to a remote console. When this count is exceeded, JES2 spools the messages until the message backlog for that remote console returns to zero.

SESSIONS=

Defines the specifications for VTAM sessions.

LIMIT=nnnn: Specifies the maximum number (1-9999) of VTAM sessions that can be active at any one time. Terminals or SNA NJE nodes attempting to log on when nnnn sessions are already active are not allowed to log on. You can only increase the limit using this command.
WARN=nnn: Specifies the percentage (0-100) of session utilization. If the session usage is above this percentage, the operator is alerted by message $HASP050.

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.

Scope

The scope of this command varies by parameter.

The value supplied for the RMTMSG parameter will be in effect for this member only. Depending on your installation's setup, however, you might want this parameter 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).

All other parameters will be in effect for this member only, and there is no need to have these parameters issued to all members of the MAS.

See z/OS MVS System Commands for more information on using the ROUTE *ALL command.

Messages

The $HASP839 message displays the current values of all the parameters on the TPDEF initialization statement.

Example

 1   $t tpdef,bscbuf=(warn=75)

  $HASP839 TPDEF  AUTOINTV=32,AUTONUM=2,BSCBUF=(LIMIT=42,
  $HASP839        WARN=75,FREE=42,SIZE=520),MBUFSIZE=400,
  $HASP839        RMTMSG=200,RMTNUM=51,SESSIONS=(LIMIT=102,
  $HASP839        WARN=80,FREE=102,FROZEN=0),SNABUF=(LIMIT=18,
  $HASP839        WARN=80,FREE=18,SIZE=400)