$T BUFDEF

Function

To specify the percentage of local buffers used at which JES2 alerts the operator of a local buffer shortage. Local buffers can reside above or below 16 megabytes of virtual storage.

Syntax


>>-$T--BUFDEF--------------------------------------------------->

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

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

Parameters

BELOWBUF=

The specifications for buffers that reside below 16 megabytes of virtual storage.

LIMIT=nnnn: The maximum number (10-2000) of buffers that is allowed. You can only increase the limit using this command.
WARN=nnn: The percentage (0-100) of local buffers used at which the $HASP050 message alerts the operator of a shortage of local 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 do not want JES2 to issue a message, specify zero for this parameter.

EXTBUF=

The specifications for buffers that reside above 16 megabytes of virtual storage.

LIMIT=nnnn: The maximum number (10-9999) of buffers that is allowed. You can only increase the limit using this command.
WARN=nnn: The percentage (0-100) of local buffers used at which the $HASP050 message alerts the operator of a shortage of local 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 do not want JES2 to issue a message, specify zero for this parameter.

Note:

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

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

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 for more information on using the ROUTE *ALL command.

Messages

The $HASP840 message displays the current values of all the parameters on the BUFDEF initialization statement.

Example

 1   $t bufdef,belowbuf=(limit=200,warn=75),
extbuf=(limit=225,warn=5)

  $HASP840 BUFDEF BELOWBUF=(LIMIT=200,WARN=75,FREE=200),
           EXTBUF=(LIMIT=225,WARN=65,FREE=225)

The WARN value indicates that, when 75% of the local buffers are in use, JES2 issues the $HASP050 message to alert the operator of a local buffer shortage.