The specification of IMS procedures

When you specify IMS.SDFSRESL procedures, you must consider where they are stored, whether they need to load the IMS SVC modules, and which IMS environments support the procedures.

For each of the procedures:

Storing IMS.SDFSRESL procedures

In IMS 15, sample procedures are no longer generated by system definition in the IMS.PROCLIB data set. They are now generated during SMP/E processing and delivered in the IMS.SDFSPROC data set. Users can copy the procedures from IMS.SDFSPROC to IMS.PROCLIB and rename and modify them as necessary so that they match what they would have been if generated in the IMS.PROCLIB. The JCL supplied in the IMSMSG and IMSWTnnn members of the IMS SDFSPROC data set must be modified for your installation requirements and stored in IMS.JOBS.

IMS conforms to z/OS® rules for data set authorization. If an IMS job step is to run authorized, all libraries to be used in that job step must be authorized. To run an IMS batch region as unauthorized, a nonauthorized library must be concatenated to IMS.SDFSRESL.

Specifying the DFSRESLB DD statement in IMS batch procedures

Certain batch procedures must load the IMS SVC modules, all of which must be in an authorized library. The DFSRESLB DD statement specifies the library that contains these modules. All libraries that are specified by this statement must be authorized through the Authorized Program Facility (APF).

When you include the DFSRESLB DD statement in a batch procedure, all IMS SVC modules are loaded from the specified library. If this library does not contain the required modules, IMS does not search any other library for the modules and then terminates.

In the batch procedure for your DFSRESLB DD statement, if you identify a specific library from which the IMS SVC modules are to be loaded, this specification does not become the SDFSRESL library search order for the remaining IMS (non-SVC) modules. You must still specify your SDFSRESL library in a JOBLIB or STEPLIB DD statement.

When you do not include the DFSRESLB DD statement in a batch procedure, IMS searches the standard default libraries for the modules (JOBLIB/STEPLIB, followed by LINKLIB). If the IMS SVC modules are not in an authorized library, IMS terminates.

In addition to the DFSRESLB DD statement, the EXEC parameter SRCH, which is allowed on selected batch procedures, also affects the library search order. When SRCH=1, IMS searches the link pack area and directories before searching any other library. When SRCH=0 and the DFSRESLB DD statement is specified, IMS searches only the specified library and does not search the link pack area.

The following modules must be loaded from an authorized library during the IMS batch initialization:
  • DFSABND0
  • DFSAFMX0
  • DFSAOSF0
  • DFSAOS70
  • DFSBC000
  • DFSCBT10
  • DFSDCFC0
  • DFSDCFR0
  • DFSDMAW0
  • DFSDXES0
  • DFSFSWA0
  • DFSKPXT0
  • DFSLMGR0
  • DFSLRH00
  • DFSMDA00
  • DFSMODU0
  • DFSMODX0
  • DFSMRC00
  • DFSMRC20
  • DFSRRSB0
  • DFSRTM00
  • DFSRTMI0
  • DFSSPF00
  • DFSSTM00
  • DFSTOPR0
  • DFSVCI00
  • DFSVCI10
  • DFSV4200
  • DFSV4300
  • DFSV4400

Procedures and the IMS management of ACBs

When the IMS management of ACBs is enabled, IMS procedures that require access to the application control blocks (ACBs), database definitions (DBDs), or program views (PSBs), automatically retrieve this information from the IMS catalog instead of from ACB, DBD, and PSB libraries.

The enablement of the IMS management of ACBs is determined by the ACBMGMT= parameter in the <CATALOG> section of the DFSDFxxx PROCLIB member or it can be indicated in a batch environment by turning the DXPL_FUNDIREN flag on in the DXPL_FUNCV2 byte in the IMS Catalog Definition exit routine (DFS3CDX0).

Environments that support IMS.SDFSRESL procedures

Table 1 shows all the cataloged procedures, control statements, and jobs. Each procedure is listed, followed by the environments in which it applies. Unless noted otherwise, all items in the Name column of the table are procedures.
Table 1. IMS.SDFSRESL procedures and the environments in which they apply
Name DB Batch TM Batch DBCTL DB/DC DCCTL Description
DBBBATCH X X       A one-step procedure for offline DL/I batch processing regions that use an IMS.ACBLIB or the IMS catalog: DBBBATCH procedure
DBC     X     An online execution procedure to initialize the DBCTL environment: DBC procedure
DBRC     X X X A procedure to execute the DBRC address space: DBRC procedure
DCC         X An online execution procedure to initialize the DCCTL environment: DCC procedure
DFSJBP X X       Starts a JVM non-message-driven dependent region, called a JBP region: DFSJBP procedure
DFSJMP       X   Starts a JVM message-driven dependent region, called a JMP region: DFSJMP procedure
DFSMPR       X X A procedure to execute an IMS message processing address space: DFSMPR procedure
DLIBATCH X X       A one-step procedure for an offline DL/I batch processing program that uses either PSB and DBD libraries or the IMS catalog: DLIBATCH procedure
DLISAS     X X   A procedure to execute the DL/I address space: DLISAS procedure
DXRJPROC X   X X   A procedure that defines the Internal Resource Lock Manager and its use to the system: DXRJPROC procedure
FDR     X X   A procedure to execute an FDBR region: FDR procedure
FPUTIL     X X   A procedure to execute the Fast Path utility program with DEDBs online: FPUTIL procedure
IMS       X   An online execution procedure to initialize the DB/DC environment: IMS procedure
IMSBATCH     X X X A procedure to execute an IMS online batch message processing address space: IMSBATCH procedure
IMSCOBGO X X       A three-step compile, bind, and go procedure combining the IMSCOBOL procedure with an execution step for a stand-alone DL/I batch address space: IMSCOBGO procedure
CBLTDLI² X X X X X Control statements necessary to establish a COBOL-to-DL/I interface.
IMSCOBOL X X X X X A two-step compile and bind procedure for IMS applications written in COBOL: IMSCOBOL procedure
IMSFP       X X A procedure for executing a Fast Path application program: IMSFP procedure
IMSMSG¹       X X A job to execute an IMS message processing program: IMSMSG procedure
IMSPLI X X X X X A two-step compile and bind procedure for IMS applications written in PL/I: IMSPLI procedure
IMSPLIGO X X       A three-step compile, bind, and go procedure combining the IMSPLI procedure with an execution step for a stand-alone DL/I batch processing address space: IMSPLIGO procedure
IMSRDR     X X X A DASD read procedure to read an IMSMSG job into the operating system job stream from direct access storage devices: IMSRDR procedure
PLITDLI² X X X X X Control statements necessary to establish a PL/I-to-DL/I interface.
RDIBATCH X   X X   A procedure to help maintain database availability in failure situations: RDIBATCH procedure
Notes:

¹ Job

² Control Statement. For information about these control statements, refer to Establishing a DL/I interface from COBOL or PL/I in IMS Version 15 Application Programming.