1. Application Runtime for CICS Reference Guide
  2. ServerConfiguration
  3. Configuration Reference of CICS Runtime Servers
  4. ARTDPL Configuration
  5. Parameters

10.3.7.4 Parameters

minn and maxn
Specify respectively the initial and maximum number of servers to start. For more information see the UBBCONFIG section of the Tuxedo documentation.
CLOPT options
The following CLOPTrun-time parameters are recognized:
-s SystemID
Mandatory option, see CICS SYSID Argument.
-b suffix
Specifies the SUFFIX value in the program_list_table.desc to choose which programs the ARTDPL want to execute during its initialization.
-d suffix
Specifies the SUFFIX value in the program_list_table.desc to choose which programs the ARTDPL want to execute during its shutdown.
-a Application_ID
Optional argument, see CICS Application ID Argument.

Note:

You must configure at least one ARTDPL for each CICS region.
-L List_name(s)
Mandatory argument, see Dynamic List of Groups Argument.
-l GroupList
Mandatory option, see Dynamic List of Groups Argument.

Note:

For both -l and -L options, if there are multiple ARTDPL in one ART CICS region and -s is configured in such region, please set the same value for all -l specified in this region, and set the same value for all -L specified in this region. For more information about -L configurations, please refer to List of Groups Configuration File.
-S
Optional argument. ARTDPL servers can receive service requests from Tuxedo client, such as JCA client. In the Tuxedo client, you just need to add the COMMAREA data to the FML field CXMW_MESSAGE, and then TPCALL the corresponding program which is published as a service by ARTDPL. After receiving the service request, ARTDPL executes the corresponding program and finally TPRETURN the COMMAREA data returned by program with FML field CXMW_MESSAGE.

Sometimes, the length of the COMMAREA data returned by program is larger than the length of the COMMAREA data initialized in Tuxedo client. In this case, you need to add one more FML field CXMW_COMMAREAINLENGTH before TPCALL to the Tuxedo client. The CXMW_COMMAREAINLENGTH must be specified the total length of COMMAREA which is initialized in Tuxedo client, and its data type is long. In this way, ARTDPL can TPRETURN COMMAREA data with the total length CXMW_COMMAREAINLENGTH which is definitely larger than the length of the data filled in COMMAREA.

When the length of COMMAREA data returned by program is smaller than the total length CXMW_COMMAREAINLENGTH, ARTPDL normally adds X'00' (null padding character) at the end in the return FML field CXMW_MESSAGE. If you want to strip the NULL padding characters to reduce the data communications between the Tuxedo client and ARTDPL and improve the performance, add “-S” in the CLOPT options of ARTDPL. ARTDPL server will strip the padding characters and then TPRETURN the COMMAREA data with FML field CXMW_MESSAGE.

--IMSDB -x -o host:port:dra

Optional argument, see IMS DB Argument.

Parent topic: ARTDPL Configuration