CA IDMS DLI Transparency Run-Time Environment › Batch Considerations › Executing the CA IDMS DLI Transparency Region Controller

Executing the CA IDMS DLI Transparency Region Controller

The Basic Execute Statement

To run CA IDMS DLI Transparency in a batch environment, you must execute the CA IDMS DLI Transparency region controller (IDMSDLRC). Use the JCL provided in Appendix D.

The basic execute statement (shown for z/OS) is as follows:

EXEC  PGM=IDMSDLRC,PARM='DLI,userpgm,ipsb,parms'

Parameter List

In the PARM list:

• Userpgm is the name of the DL/I batch application.
• Ipsb is the name of the IPSB that the application uses when accessing the CA IDMS/DB database.
• Parms are additional optional parameters, as follows:
  • TRACE -- Traces the call sequence, the I/O areas, the PCBs, and the SSAs. In a central version environment, the trace results are written to the CA IDMS/DB log. In a local mode environment, the trace results are placed in a special dataset called ESCDUMP. If you use TRACE when running in local mode, make sure that you include a DD statement for ESCDUMP. Generally, TRACE is used only for debugging internal problems.
  • NOSPIE/NOSTAE/NOSTXIT -- Prevents recursive abends in the case of CA IDMS DLI Transparency abend exit failures.The back-end module (RHDCDLBE) maintains a trace table of activity. If a DL/I application aborts, an abend exit is invoked to format and output the trace information to the CA IDMS/DB log in central version, or to the ESCDUMP DD in local mode. This information is valuable and used by support for diagnostic purposes. Under the central version, if the abend exit also abends, this recursive abend will bring the central version down. These parameters are available in case this situation should ever occur. This parameter should not be routinely specified.

    When running under the central version, only specify one of these options. NOSPIE and NOSTAE are for z/OS only. They turn off SPIES and STAES, respectively. NOSTXIT is for z/VSE only.

  • DYN -- Allocates dynamic buffers to the front-end module for use by PL/I programs. In order to use this parameter in a central version environment, you must make sure that the IPSB is available to both the region controller (IDMSDLRC) and the front-end module (IDMSDLFE), as well as to the back-end module (RHDCDLBE).