3.17 Programs List Configuration File

The following table lists and defines programs list available to the CICS application server ARTDPL boot or shutdown.

The filename is program_list_table.desc.

The format of a program_list_table.desc definition is:

[plt] 
<field_name_1>=<field_value_1> 
<field_name_2>=<field_value_2>
...
<field_name_n>=<field_value_n>

For example,

[plt]
SUFFIX=p1
PROGRAM= RSSBT001, RSSBT002

Note:

Blank lines and comment lines are supported. You can use an asterisk in column 1 to code comments, or to remove temporarily an initialization parameter from a particular execution of CICS.

Using a "\", you can continue parameters on another line. Oracle Tuxedo Application Runtime for CICS concatenates the operands, omitting the remaining blanks after "\" in the current line. In this usage, only blank characters can appear after "\" in the current line; otherwise, "\" is treated as a backslash

To load and/or discover the defined programs list, you have two ways: one is add "-b" or "-d" option in ARTDPL CLOPT, and the other is to define the SUFFIX in the system.desc PLTPI/PLTSD parameter.

For example:

ARTDPL CLOPT="-s KIXA -l SIMPAPP -b p1"

In this example, ARTDPL will load and execute the programs named RSSBT001, RSSBT002 during its initialization.

Table 3-15 CICS Application Programs List

Field Name	Values	Type	Description
SUFFIX	X(2)	Mandatory	Name of the PLT suffix. The length of SUFFIX is 1-2 characters
PROGRAM	X(1024)	Mandatory	Specifies the program list. The format is: PROGRAM=program [,...,programn]. The value of program should consist of 1 - 8 alphanumeric characters.

If the programs in the PROGRAM is not defined or is disabled in programs.desc, when the application server boot or shutdown, it will ignore this program.

If more than one items in the Program_list_table.desc with the same SUFFIX are defined, only the first takes effect.