Providing CICS® resource definitions for ZDT/CICS on interconnected regions

ZDT/CICS can be used to edit, list, and so on, CICS® resources that are owned by remote CICS® regions. An active connection must be available on the region where the ZDT/CICS interface is running, to the resource-owning CICS® region. In addition, on each of the remote resource-owning CICS® regions, you must:

  • Add the ZDT/CICS load library to the DFHRPL DD statement in the CICS® startup procedure. This will be HFM.SHFMMOD2 if you installed ZDT/CICS into the default libraries.
  • Define and install the required ZDT/CICS load modules, HFM3CICS and HFMLVL, in the CSD group, HFMCICS. You can do this using the sample job HFM3INSR. Modify and run this job against the CSD of the interconnected regions to define the required ZDT/CICS resources on the remote regions. You do this as follows:
    1. Copy the member HFM3INSR from HFM.SHFMSAM1 into your own JCL library.
    2. Modify HFM3INSR in your library.
      • Change the job card to meet your site's requirements.
      • Change #cicshlq to the high level qualifier for your CICS® libraries.
      • Change #cee to the high level qualifier for your Language Environment® libraries. Remove the reference if Language Environment® is available from LINKLIST.
      • Change #csddsn to the data set name of the DFHCSD file.

After you have done this, a resource owned by a remote CICS® region can be processed through the ZDT/CICS interface by specifying the SYSID of the remote CICS® region.

Note: The service level (PTF level) of the ZDT/CICS load modules must be the same (or higher) on all interconnected regions that you want the ZDT/CICS interface to link to, as on the local region.

This will automatically be true if you use the same ZDT/CICS load library for all your interconnected CICS® regions. If you do not use the same load library, you must ensure that all the load libraries have the same service level applied. If ZDT/CICS calls another region to process remote files, an error message is produced if the remote region is not at the required service level.