Prerequisite checklist before configuring extensions

Ensure that the IMS SCI address space is active on the z/OS® images on which IMS Queue Control Facility will be running.

Notes:
  • IMS does not need to be SCI-enabled for IMS Queue Control Facility to work. If your current IMS environment does not use SCI, you can continue to use that environment without any changes. The IMS Queue Control Facility extensions use of SCI is independent of IMS.
  • IMS only uses SCI for a SYSPLEX environment. To enable IMS for SCI , the DFSPBxx PROCLIB member must contain the keyword CSLG=.

The IMS Queue Control Facility extensions are enabled through the IMS Partner Product user exit interface (PPUE).

Ensure that you have completed the following steps before enabling and configuring IMS Queue Control Facility extensions:

  1. Add the IMS Queue Control Facility load library to your JOBLIB or STEPLIB concatenation for the IMS control region JCL.

    The IMS Queue Control Facility load library must be concatenated in front of the IMS RESLIB, and the IMS Queue Control Facility load library must be APF authorized.

  2. Specify a Partner Product user exit by completing either of the following steps:
    • Define IQCPPUE0 as a Partner Product user exit to the IMS DFSDF member, as follows:
      <SECTION=USER_EXITS>
 EXITDEF=(TYPE=PPUE,EXITS=(IQCPPUE0))
    • If your IMS system uses the IMS Tools Base Generic Partner exit routine, add the following statement to the GPRxxxx0 member in the IMS PROCLIB, where xxxx is the IMS ID. 
      EXITDEF(TYPE(PARTNER) EXITNAME(IQCPPUE0)  LOADLIB(library_name))

      where library_name is the data set name of the IMS Queue Control Facility load library.

      For more information, see the topic "Generic Partner exit overview and usage" in the IMS Tools Base for z/OS IMS Tools Common Services User's Guide and Reference.

  3. Optional: To enable the QCF functions provided by IMS Tools Online System Interface (TOSI) by use of the TOIPARMS statement for UNLOAD, install IMS Tools Online System Interface and define FOIPPUE0 as an additional Partner Product user exit. If these functions are not required, you can skip this step.
    1. Install the IMS Tools Online System Interface component.
    2. Complete either of the following steps:
      • Define FOIPPUE0 as an additional Partner Product user exit to the IMS DFSDF member as follows:
        <SECTION=USER_EXITS>
 EXITDEF=(TYPE=PPUE,EXITS=(IQCPPUE0,FOIPPUE0))

        IQCPPUE0 and FOIPPUE0 can be specified in any order.

      • If your IMS system uses the IMS Tools Base Generic Partner exit routine, add the following statements to the GPRxxxx0 member in the IMS PROCLIB, where xxxx is the IMS ID.
        EXITDEF(TYPE(PARTNER) EXITNAME(IQCPPUE0)  LOADLIB(library_name))
EXITDEF(TYPE(PARTNER) EXITNAME(FOIPPUE0)  LOADLIB(tosi_name))

        where library_name is the data set name of the IMS Queue Control Facility load library, and tosi_name is the data set name of the IMS Tools Online System Interface load library.

        For more information, see the topic "Guidelines for using IMS Tools Online System Interface" in the IMS Tools Base for z/OS IMS Tools Common Services User's Guide and Reference.