10.3.7.3 Description

Theses servers present application programs restricted to DPL subsets as tuxedo services and when receiving a DPL service request execute the corresponding program. These programs are screen less programs which cannot interact directly with terminal users. Theses servers do not need to (cannot) address the principal facility (the user terminal) and so do not need to be conversational. They are pure RPC mode servers.

When a program requests a LINK, if the requested program is configured as DPL then the link is not resolved as usual by a call, but by a tpcall, which will be served by one of the DPL servers offering this service (this DPL program).

Only programs with the attribute REMOTESYSTEM(sysid) positioned to DPL, will be advertised by DPL servers, and only by servers with this sysid as system indicated thru the -s option.

ARTDPL can choose whether to invoke some special programs for themselves during its initialization and shutdown. There are two methods. One is specifying the "-b suffix_name" or "-d suffix_name" option in their CLOPT of UBBCONFIG file. The other specify the PLTPI or PLTSD parameters in the system.desc configuration file. Both ways need to write the program_list_table.desc configuration file. This function does not support the "XA DISABLE" feature.

  • Method 1:

    For CLOPT, when ARTDPL specifies the -b suffix name or -d suffix name option, the server loads program_list_table.desc configuration file to obtain the right program list (with suffix_name). Then in tpsvrinit() or tpsvrdone(), the server executes these programs.

    In the initialization programs, you may want to invoke some EXEC CICS commands, these command require ART CICS provided services. ARTDPL (which invokes the initialization programs), needs to be configured last in the UBBCONFIG file, so that it is booted last during ART CICS boot. The initialization programs can use the services provided in the previous application servers.

    If ARTDPL specifies the -d option, it executes some programs during shutdown. You must first shutdown ARTDPL separately, and then shutdown all remaining ART CICS servers. For example, you must use "shutdown -g groupname -I SRVID" first, and then run shutdown -y to shutdown the entire ART CICS region.

  • Method 2:

    If you specify PLTPI or PLTSD in the system.desc file, when ARTDPL boots or shutdown, it invokes the programs list where SUFFIX is the same as the PLTPI/PLTSD value.

During the initialization or shutdown, the programs listed in program_list_table.desc (which is indicated by the PLTPI or PLTSD), are executed first, and then are the programs indicated by the -b or -d options.