Statements and parameters for TSOKEY00

The TSO/VTAM time sharing parameters are as follows:

ACBPW

Specifies the optional password that is associated with all TSO/VTAM ACBs. If a password is specified on the PRTCT parameter of VTAM's APPL definition statement, ACBPW must be specified.

To prevent unauthorized disclosure of the ACB password when the CBPW keyword is specified, take the following steps:

Place the TSOKEY00 member in a password protected data set that is compatible with SYS1.PARMLIB (for example SYS1.VTAMLST).
Modify the parmlib DD statement in the TSO/VTAM start procedure to refer to the password protected data set, as show in the following example:
```
//PARMLIB DD DSN=SYS1.VTAMLST(&MBR),DISP=SHR,FREE=CLOSE
```

Value range: Any 1 - 8 EBCDIC character.

Default: None.

BASENAME

Specifies a 1 - 4 character prefix to be used for the ACBNAME operand in the VTAM® application program major node. As an example, if you specify BASENAME=tttt, you would use the names tttt0001, tttt0002, tttt0003, and so forth. See the z/OS Communications Server: SNA Network Implementation Guide for an example of how to use BASENAME.

Value range: Any 1 - 4 EBCDIC characters, following the VTAM naming requirement that is specified in the z/OS Communications Server: SNA Resource Definition Reference.

Default: TSO

BUFRSIZE

Specifies the size in bytes of a VTIOC buffer. Input and output data smaller than the BUFRSIZE value uses cells equal to the BUFRSIZE value. Input and output data larger than the BUFRSIZE value is assigned to dynamically allocated buffers (allocated by the GETMAIN macro) equal to the data size.

Value range: 4 - 3016

Default: 132

CHNLEN

Specifies for output the number of request units (RUs) in each RU chain for IBM® 3767 and IBM 3770 terminals. This value determines the maximum size of a chain and, therefore, the maximum amount of data that can be sent to the terminal in one chain (CHNLEN x 256=data transmitted). This value also determines the maximum amount of data that is purged when the CANCEL key is pressed to stop printing of outbound (host-to-terminal) data.

The CHNLEN value is associated with the values specified on the PACING operand of the LU macro during network control program definition, and on the VPACING operand of the LU or PU macro during VTAM definition. Use the CHNLEN default value (4) if the PACING and VPACING default values are used. Otherwise, calculate CHNLEN by using the formula (2pn-2pm)+(2vn-2vm), where pn and pm are the PACING n and m values, and vn and vm are the VPACING n and m values. If more than one network control program is used with TSO/VTAM time sharing, the smallest value that is found when calculating the CHNLEN value should be used. Otherwise, the network control program could enter slowdown mode.

Value range: 1 - 10

Default: 4

CODEPAGE (YES | NO)

Specifies to obtain the code page (CGCSGID) information for a TSO session from the terminal or the emulator. YES indicates that TSO/VTAM queries the terminal or the emulator to obtain the code page information.

Default: NO

CONFTXT (YES | NO)

Specifies whether the buffer output is to be confidential. YES indicates that the buffer output is to be confidential and, as such, not traceable; the data in the VTAM buffers is overwritten with zeros immediately after it is sent to the terminal.

Default: YES

ENGTRANS

Specifies the type of English language translation that is to be performed when the TPUT EDIT macro is used to write to terminals that support the coded graphic set global identifier (CGCSGID) X'02B90025'. (For details about TPUT, see z/OS TSO/E Programming Services.) You can specify one of the following values:

BASE: Base English translation.
EXTENDED: Extended English translation, as described in 3174 Character Set Reference, GA27-3831.
NONE: Translation is not performed.

Value range: BASE, EXTENDED, or NONE

Default: BASE

GNAME

Specifies a generic name by which one or more TSO/VTAM systems in a sysplex can be referenced. A generic name can also be specified on the START command to activate TSO/VTAM. If a generic name is not specified in TSOKEY00, or on the START command, then no generic name is used. If a generic name is used, TSO/VTAM registers its generic name by issuing the SETLOGON GNAMEADD macro instruction.

For example, three TSO/VTAM systems in a sysplex could have network names of TSO1, TSO2, and TSO3 respectively, and each defined with GNAME=TSOGR. A TSO user could logon to the name “TSOGR” and be transparently assigned to any one of the 3 TSO systems as determined by load balancing.

Value range: Any 1 - 8 EBCDIC characters that must be unique from any real resource name in the network, and cannot be TSO.

Default: None.

HIBFREXT

Specifies the maximum amount (in bytes) of virtual storage that can be dynamically allocated for output data. When this value is reached, no more output requests are honored until LOBFREXT is reached. (Input requests are rejected only when no virtual storage is available in the address space.)

Value range: The maximum size TPUT used at the installation-maximum amount of available virtual storage. Minimum value of 48000 is forced to minimize the output wait due to an out of storage condition. For details about TPUT, see z/OS TSO/E Programming Services.

Default: 48000

LOBFREXT

Specifies the minimum number of virtual storage bytes that can be dynamically allocated for output data. When this value is reached, tasks that are suspended for lack of output buffers are marked as dispatchable.

Value range: 0 - (HIBFREXT-1)

Default: 24000

MODE (BREAK | NOBREAK)

Specifies how 3276 and 3278 terminals are to be supported for TSO/VTAM. BREAK indicates that the terminal keyboard is unlocked whenever possible and does not necessarily correspond to the issuance of a TGET. NOBREAK indicates that the terminal keyboard is locked except when a TGET is issued. The BREAKIN option of TPUT applies only when BREAK is specified.

Default: NOBREAK

MODESW (YES | NO)

Specifies whether the TERMINAL command or the STBREAK macro can be used to change the mode of operation that is specified with the MODE parameter.

Default: NO

RCFBDUMP

Specifies the values of the return code (xx) and the feedback field (yy) for a RPL-type request. When an abnormal termination occurs that produces a return code and a feedback value that matches those specified in RCFBDUMP, a dump is taken to the extent specified in z. The specification z=0, specifies that only the local address space is to be dumped; z=1 specifies a full storage dump. The RCFBDUMP parameter can be used to request dumps for I/O errors from which TSO/VTAM can recover.

For the value range, see return code and feedback values in z/OS Communications Server: SNA Programming.

Default: None.

RECONLIM

Specifies the time limit in minutes within which a user can reconnect after the line is disconnected. That is, the amount of time an address space remains active in the event of terminal disconnection. A setting of RECONLIM=0 means that there is a zero wait for reconnection, which means that a reconnect is not possible.

Value range: 0 - 32767

Default: 3

SCRSIZE

Specifies the default screen size of IBM 3270 systems network architecture (SNA) terminals. The valid values for this parameter are as follows:

Screen size	Value
12 x 40	480
24 x 80	1920
32 x 80	2560
43 x 80	3440
27 x 132	3564
62 x 160	9920

(Use the FEATUR2 operand of the LOCAL or TERMINAL macros to specify non-SNA IBM 3270 screen sizes.) This value affects only those terminals whose sizes were not specified by using the PSERVIC parameter of the MODEENT macro during VTAM definition.

If an installation has IBM 3270 SNA terminals of only one screen size, SCRSIZE should specify that size. If the installation has IBM 3270 SNA terminals of both screen sizes, SCRSIZE can be used to define the more common size, and the PSERVIC parameter can be used to define the less common size.

Value range: 480-9920

Default: 480

USERMAX

Specifies the maximum number of users that can be logged on to the TSO/VTAM time sharing system at one time. Because VTAM considers each user to be an application program, and because there must be an APPL definition statement that defines each application program to VTAM during VTAM network definition. This value cannot exceed the number of APPL definition statements.

Value range: 0 - maximum number of address spaces in the system.

Default: 40