Static IMS connectivity to MQ via Subzero

To create a static connection to MQ via Subzero

1. Change the IMS Configuration.

   1. Edit the MQ external Subsystem member in your IMS PROCLIB.This is a member name of iiiissss where iiii is the IMS ID and ssss is the SSM suffix specified in your IMS startup. For example, IMSA with an SSM=MQA would require a member of IMSAMQA in your IMS PROCLIB.

      Change the SSM member parameters from ESMT=CSQQESMT to ESMT=BRDQESMT as follows:

      SST=MQ,SSN=T3MQ,LIT=MQM1,ESMT=BRDQESMT,REO=R,CRC=@ 

      Warning

      Note

      Before you specify SST=MQ, you are required to apply PTF BPJ1960 to Subzero.  If you have not applied PTF BPJ1960, specify SST=DB2.  You can also use the positional parameter to identify the external subsystem to IMS as follows: 

      SSN,LIT,ESMT,RTT,REO,CRC

      The following example shows a valid modification:

      Warning

      T3MQ,MQM1,BRDQESMT,R,@

      
      

      is the same as:

      
      

      SST=DB2,SSN=T3MQ,LIT=MQM1,ESMT=BRDQESMT,REO=R,CRC=@

      Warning

      Note

      SSN must be the MQ source name in LGC options.

   2. Add the Subzero product library to both the STEPLIB and DFSESL library in the IMS dependent region.

      Warning

      Note

      Adding to the STEPLIB is required because IMS loads and executes the IMS dependent region initialization exit (BRDIMSDX) from STEPLIB.  The IMS dependent region’s STEPLIB concatenation does not need to be APF authorized for the exit module.

   3. Add Subzero load library to the DFSESL library in the IMS control region.
   4. Modify the IMS dependent region (MPP and BMP) to include a PREINIT=xx execution parameter
      

   5. Create a DFSINTxx member in the dependent region’s PROCLIB, and then add BRDIMSDX to this member.
      

      Warning

      Note

      The value you specify for xx must match the PREINIT value.

   6. Ensure that CSQQDEFV is in the STEPLIB concatenation of the IMS dependent region.
      You can use the default found in *.SCSQAUTH or create your own version of the CSQQDEFV module.

      Warning

      Note

      Refer to the MQ manual for Defining IBM MQ queue managers to the IMS adapterfor instructions on creating your own CSQQDEFV module. 

   7. From the *.SCSQAUTH load library, copy MQ module CSQBCRMH to an APF-authorized data set, and rename it MQSBCRMH.
      This is necessary to support local connectivity (where the SSM parameters point to Subzero modules and the MQ subsystem is local to the IMS control region).

      Warning

      The following conditions apply:

      • MQSBCRMH must be concatenated in the STEPLIB and DFSESL library concatenations of both the IMS control region and dependent regions.
      • The IMS dependent region’s STEPLIB does not have to be APF authorized.
      • DFSESL is required to be APF authorized.
      • For a local connection, Subzero loads MQSBCRMH and passes control to it. However, if MQSBCRMH does not exist, the IMS dependent region issues the following message: BMCBRD0070E BRDBCRMH failed to load MQSBCRMH.
2. Implement the IMS configuration changes.You do not need to stop and restart IMS in order to implement your changes. You can simply stop and restart the subsystem definitions.
   1. Issue a /STOP SUBSYS ALL command to IMS. This will stop the current connections to MQ.
   2. Issue a /START SUBSYS ALL command to IMS. This will restart the current connection to MQ using the new SSM parameters.

3. You should see the following messages:

    BMCBRDM0026I MQID connection is being managed by Subzero (DBCID)

    CSQQ000I IMS/TM IMSID connected to queue manager MQID
4. Restart your IMS dependent regions.

Related topics

Dynamic-IMS-connectivity-to-MQ-via-Subzero

Configuring-IMS-to-communicate-with-MQ