Configuration lists

A configuration list specifies the resources that are to be activated when you start VTAM®. Place the member names of the resources you want to have activated when VTAM starts into an ATCCONxx member in the VTAM definition library, where xx is any two alphanumeric characters. The value xx can then be used on the CONFIG operand of the VTAM START command, or on the CONFIG start option in your start option list, to specify which definitions are to be activated at startup. In Figure 1, to use the configuration list defined in ATCCON01, you can specify CONFIG=01 on the VTAM START command.

Figure 1. Configuration list

Example of a configuration list that specifies the resources that are to be activated when you start VTAM.

ATCCON01 contains the member names LOCSNA1, LOCNS1, NCP1, which will be activated when VTAM starts. CHAN1 and RSNA1 (found in the VTAM definition library) are not included in ATCCON01, and therefore must be activated manually by the VTAM operator using the VARY command, if they are to be used. If no configuration lists exist, the VTAM operator must use the VARY command to activate all resources.

Following is sample coding for configuration list ATCCON01.

LOCSNA1
LOCNS1
NCP1

Examples of resource definitions that can be included in a configuration list are:

Paths
Major nodes
Minor nodes defined in previously listed major nodes
Tables
Dynamic reconfiguration files
Network node server list

You can also use a configuration list to activate an NCP using a different PU name than the one specified in the NEWNAME operand on the BUILD definition statement. For example, if you want to load a communication controller with load module X3745A and want the PU name to be NCPA1, you would code the following in your configuration list:

NCPA1/X3745A

This would have the same result as using the following command:

VARY NET ACT,ID=NCPA1,LOADMOD=X3745A

Each of the names specified in the configuration list must be one to eight characters (one to seven characters for the load module name when specifying pu_name/load_module). The first character of each name must be alphabetical (A–Z) or one of the national characters (@, #, or $). The remaining characters of each name must be alphabetical (A–Z), numerical (0–9), or one of the national characters (@, #, or $). If a name is found that is not valid, VTAM stops processing the configuration list and is unable to initialize any of the subsequent major nodes.