Running the CICS DLA

To use the CICS® DLA, you specify the necessary DLA parameters with startup JCL file, run the DLA utility as a batch program, then transfer the discovery library books in the resulting data set to the discovery library file store for exploitation by a discovery library reader.

Before you begin

  • Ensure that CICS and CICSPlex® SM are properly installed and configured. You must install CICSPlex SM because the CICS DLA uses the CICSPlex SM API.
  • Ensure that you have the necessary update access to the partitioned data set used for the IdML output of the DLA.

About this task

This task assumes that you want to use FTP to transfer the DLA output to your DLFS. If you use a transfer mechanism other than FTP, you must ensure the discovery library books are saved in the DLFS using the correct naming conventions. See IdML file naming conventions for more information about naming DLFS files correctly.

To run the DLA:

Procedure

  1. Open the sample JCL file EYUJXDD0 in the SEYUSAMP library for editing. EYUJXDD0 contains startup JCL and sample input parameters for controlling the operation of the DLA.
  2. Enter high-level qualifiers for CICS, CICSPlex SM, and for the CICS DLA partitioned data set by overtyping the parameter values in CPSMHLQ=@thlq@.CPSM, CICSHLQ=@thlq@.CICS with your own values.
  3. Specify the CMAS, your z/OS® IP host name, and your organization name using the mandatory SET CMAS, SET HOSTNAME, and SET ORGNAME parameters respectively.
  4. Ensure that the SET FTP parameter is set to YES, the default. With this parameter set to YES, if the operation runs successfully, the DLA automatically transfers the discovered data to the DLFS as part of the DLA operation. FTP PUT and RENAME statements are always generated as part of the DLA run regardless of the SET FTP parameter.
  5. Specify the remaining SET parameters. If you want to accept the default values, you do not have to make any changes. If you want to make changes to any parameters, overtype the defaults with your own values. For example, if you want to run the DLA in refresh mode, specify SET REFRESH YES.
  6. Specify the BOOK TYPE parameters. These three parameters control which of the three types of discovery library books are generated, and also which information the discovery library books contain.
    You can include multiple instances of each of these parameters and use the optional cplexname or cics_name attributes to include or exclude the specific CICSplexes or CICS regions from the information gathering process. The default for each of these parameters is YES, which means that all discovery library books of the specified type are included in the discovery. If you want to select specific discovery library books, set the parameter to NO, to suppress the discovery of all discovery library books of that type, and then add one or more subsequent parameters specifying the discovery library books to be selected. For example, if you want to select only the CICSPLEX discovery library book named plex1 specify:
    BOOK TYPE CICSPLEX NO
    BOOK TYPE CICSPLEX.plex1 YES
    If you specify BOOK TYPE CICSPLEX.plex1 NO, the DLA generates an discovery library book for each CICSplex associated with the CMAS except CICSplex plex1.
    You can also specify partial CICSplex or CICS region names. For example, to select only CICS regions beginning with the letter a, specify:
    BOOK TYPE CICSREGION NO
    BOOK TYPE CICSREGION.a YES

    If you omit cplexname or cics_name attributes, the parameter applies to all of the CICSplexes or CICS regions associated with the CMAS.

    Using multiple instances of the same BOOK TYPE parameter can lead to consequences that are difficult to predict. The DLA processes these parameters in the order that they are included in the input file. It is therefore possible for one parameter to conflict with an earlier one.

  7. Save and submit the EYUJXDD0 module to start the DLA operation. The DLA populates a partitioned data set with discovery library books containing the discovered data. The default name of the data set is hlq.cmas.CICSTS.DLAnnn.IDML, where hlq is the high-level qualifier you supply, cmas is the name of the CMAS specified in the SET CMAS parameter, and nnn is the CICS version number, for example 660. If the data set already exists, its contents are overwritten with the newly discovered data.

    The DLA also creates FTP PUT and RENAME statements in to facilitate the transfer of the data.

    See DLA output for more information about the output files produced by the DLA.

    If the DLA operation is successful, it generates a return code of zero, then continues and transfers the discovered data to the DLFS using the FTP statements in the data set member @FTPRUN.

    If the DLA generates a nonzero return code, or if you have specified SET FTP NO, the DLA does not carry out the FTP part of the operation. You can run the EYUJXDD1 module at any time to carry out the FTP step independently. In this case, the DLA uses the FTP statements from the @FTPALLP or @FTPCHGP data set members to transfer the data.

Results

After transferring the DLA output, your DLFS contains the discovery library books required for validation and exploitation by your discovery library reader.


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