The Discovery Library Adapter for CICS

The Discovery Library Adapter (DLA) for CICS® is a utility that collects information during runtime about CICS and CICSPlex® SM resources. It generates XML files that can be used by a discovery library reader to track these resources and their interdependencies across your enterprise.

The CICS DLA uses CICSPlex SM services to generate XML files that conform to the Discovery Library IdML XML schema and Common Data Model. The XML files called discovery library books can be loaded by several products including Tivoli® Change and Configuration Management Database (CCMDB) and Tivoli Business Service Management (TBSM).

The CICS DLA operates against all the CICSplexes that are associated with a specified CMAS. The specified CMAS must be running at the current release level; however, the CICS regions discovered by the DLA can be at earlier release levels, as allowed by the cross-release support rules for CICSPlex SM.

To use the CICS DLA you run EYUJXDD0 as a batch job on a z/OS® system. Running the DLA creates IdML discovery library books in a PDS data set. The DLA also writes control files and debug information to this data set.

When you run the DLA, it can generate three types of discovery library books:
  • One CTSPLEX discovery library book containing summary information about discovered CICSplexes
  • One or more CICSPLEX discovery library books containing information about the CICS system topology in a CICSplex and also the CICSPlex SM logical scopes and their associated resources.
  • One or more CICSREGION discovery library books containing information about CICS resources associated with a CICS region
The DLA also generates FTP PUT and RENAME statements to facilitate the transfer of the discovery library books to the discovery library file store (DLFS) located on your local system or accessible through a network connection. You control whether the FTP transfer is carried out as part of the DLA run or is done later as an independent operation.

From the DLFS you can load the discovery library books into CCMDB or TBSM using FTP or another transfer mechanism.

You control the output of the DLA using input parameters. These parameters control the range and depth of the discovery and specify which discovery library books are created. The parameters also set general options about the operating environment, including the name of the CMAS under which the discovery takes place. You can supply these parameters in startup JCL or in an input file referred to by the parameter DD statement in the JCL.

You can run the DLA in either create mode or refresh mode:
  • Create mode is the default. In this mode, the DLA produces a snapshot of your CICSplexes. The DLA produces discovery library books that might not contain information about all affected resources because some are not currently active.
  • In refresh mode, the discovery library books contain everything known about the environment. The reader treats as obsolete anything that was previously loaded from a similar discovery library book and is not in this discovery library book. CCMDB and TBSM support refresh mode by deleting these obsolete resources. Refresh mode can be useful when there has been a significant configuration change but you should use it with caution because of the large amount of processing that might be involved.


dla_overview.html | Timestamp icon Last updated: Sunday, 4 June 2017