DXRJPROC procedure

The DXRJPROC procedure starts the internal resource lock manager (IRLM). This procedure is supplied on the IRLM distribution tape.

For information about obtaining the IRLM from the distribution tape and preparing it for use, see IMS Version 15.5 Installation.

The procedure shown in Sample procedure to start IRLM 2.2 executes IRLM 2.2.

Usage

When you install the IRLM, a unique copy of DXRJPROC should be created for each IRLM that might run concurrently. The procedure name and parameters should be changed, as required, for each IRLM. Because no default value is provided for the IRLMID parameter, the DXRJPROC procedure must at least be altered to assign a value for IRLMID.

In a configuration in which two systems are sharing data, the two IRLMs must execute concurrently. A typical way to define this configuration is:
  • Procedure name IRLM1 with IRLMID=1
  • Procedure name IRLM2 with IRLMID=2
For testing purposes, two IRLMs can communicate with one another by using the z/OS® cross-system coupling facility while executing concurrently on a single system. A typical way to define this environment is:
  • Procedure name JRLM1 with IRLMID=1 and IRLMNM=JRLM
  • Procedure name KRLM8 with IRLMID=8 and IRLMNM=KRLM

IRLM has a global deadlock manager, which is designated as the IRLM with the lowest IRLMID. IRLMs in a Parallel Sysplex® group dynamically readjust the global manager identity as members join and leave the group. If you are concerned about the placement of the global deadlock manager, you can put the lowest IRLMID on a specific processor.

Parameters

The following parameters are valid for the DXRJPROC procedure.

  • DEADLOK=
  • IRLMGRP=
  • IRLMID=
  • IRLMNM=
  • LOCKTAB=
  • LTE=
  • MAXCSA= (ignored by IRLM)
  • MAXUSRS=
  • PC= (IRLM sets PC=YES regardless of what is specified in the DXRJPROC procedure.)
  • PGPROT=
  • SCOPE=
  • TRACE=

See Parameter descriptions for IMS procedures for descriptions.

DD statements

The following DD statements are valid for the DXRJPROC procedure:

  • STEPLIB DD
  • SYSABEND DD

See DD statement descriptions for descriptions.

Sample procedure to start IRLM 2.2

//DXRJPROC PROC  RGN=3072K,
//            IRLMNM=IRLM,
//            IRLMID=,
//            SCOPE=LOCAL,
//            DEADLOK='5,1',
//            MAXCSA=8,
//            PC=NO,
//            MAXUSRS=,
//            IRLMGRP=,
//            LOCKTAB=IRLMT1,
//            TRACE=YES,
//            PGPROT=YES,
//            LTE=
//         EXEC PGM=DXRRLM00,DPRTY=(15,15),
//         PARM=(&IRLMNM,&IRLMID,&SCOPE,&DEADLOK,&MAXCSA,
//         &PC,&MAXUSRS,&IRLMGRP,&LOCKTAB,&TRACE,&PGPROT,&LTE),
//         REGION=&RGN
//STEPLIB  DD DSN=SDXRLM21.SDXRRESL,DISP=SHR
//*
//* The following DUMP dd statement should not be specified unless
//* you are having IRLM STARTUP problems and are not getting the 
//* dump needed to diagnosis the problem.
//*
//SYSABEND DD SYSOUT=A