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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.