Using model application program definitions for TSO/VTAM application programs

You can reduce the number of APPL definition statements for terminals that can be logged on to TSO/VTAM by using wildcard characters to define model application program definitions. See Model application program definitions for a full explanation of model application program definitions.

The following example shows how model application program definitions are used for TSO/VTAM application programs.

The following APPL definition statement defines TCAS.

tsoa     APPL  ACBNAME=TSO,PRTCT=password,
         AUTH=(NOACQ,PASS,NVPACE,TSO,NOPO),EAS=1

The following APPL definition statement defines a model that is used to define the TSO address space as terminals log on to TSO/VTAM.

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

Requirement: The label in these definitions must be 4 characters or less in length (without the *). In the previous examples, the labels tsoa and tsoa* are 4 characters in length (without the *).

As each terminal logs on to TSO/VTAM, the * in TSO* on the ACBNAME operand and in the label tsoa* will be replaced with the appropriate sequential 4-digit decimal integer; for example, 0001, 0002, and so forth. You do not need to code separate APPL definition statements for each terminal that can be logged on to TSO/VTAM concurrently. You need only the one model application program definition.

Notes:

If you plan to use model application program definitions for TSO/VTAM, then you must code MODSRCH=FIRST on the TSO application definition statement that represents the subordinate TSO APPLs.
With wildcard characters, you cannot limit the number of TSO address spaces created by limiting the number of application definitions you code. However, you can use the USERMAX operand in the TSOKEYxx parmlib member for this purpose.