Using BASENAME to define TSO/VTAM applications programs

The BASENAME operand, coded in the TSOKEYxx parmlib member, can be used to specify up to four characters for the "base" part of the TSO/VTAM application program name. The default value for BASENAME is TSO.

Using BASENAME, you are not limited to the names TSO0001, TSO0002, and so forth. For example, if you code

                BASENAME=TTTT

the names will be TTTT0001, TTTT0002, and so forth.

The ACBNAME operand must be coded for TCAS and must specify TSO. The value you specify for BASENAME does not apply to the TCAS definition.

When using BASENAME, coding the ACBNAME operand on the APPL definition statements for TSO users is not necessary. The default value for the ACBNAME on an APPL definition statement is the name specified on the APPL definition statement. When BASENAME is used, TSO will use the same name for the APPL name and the ACBNAME. Therefore ACBNAME is not required on the TSO user APPL definition statement when BASENAME is used.

By specifying a unique BASENAME on every VTAM®, you provide the name TCAS needs to start the TSO application address spaces, and provide the network-unique application name. Using the example above, you can code the following application program definitions:

tso1     APPL  ACBNAME=TSO,PRTCT=password,
               AUTH=(NOACQ,PASS,NVPACE,TSO,NOPO),EAS=1
 
tttt0001 APPL  PRTCT=password,
               AUTH=(NOACQ,PASS,NVPACE,TSO,NOPO),EAS=1
 
tttt0002 APPL  PRTCT=password,
               AUTH=(NOACQ,PASS,NVPACE,TSO,NOPO),EAS=1
 
tttt0003 APPL  PRTCT=password,
               AUTH=(NOACQ,PASS,NVPACE,TSO,NOPO),MODSRCH=FIRST,EAS=1
 
⋮

You can combine BASENAME with wildcard characters, eliminating the multiple application program definitions. The following example shows how to do this:

tso1     APPL  ACBNAME=TSO,PRTCT=password,
               AUTH=(NOACQ,PASS,NVPACE,
               TSO,NOPO),EAS=1
 
tttt*    APPL  PRTCT=password,
               AUTH=(NOACQ,PASS,NVPACE,TSO,NOPO),
               MODSRCH=FIRST, EAS=1

As each terminal logs on to TSO/VTAM, the * in the label tttt* will be replaced with the appropriate sequential 4-digit decimal integer; for example, 0001, 0002, and so forth.