DLA parameters

You control the output of the CICS® DLA using parameters that you include in the SYSIN DD card of the EYUJXDD0 JCL file. The DLA SET parameters specify general options such as the organization name and debug options. DLA BOOK TYPE parameters control which discovery library books are written.

The DLA parameters are as follows:

BOOK TYPE CICSPLEX.cplexname {YES | NO}
Determines whether the DLA creates a CICSPLEX discovery library book and controls which CICSplexes to include in the discovery. Specify one of the following values:
  • YES to include the selected CICSplexes in the discovery.
  • NO to suppress the selected CICSplexes from the discovery.
The default is YES.

cplexname is an optional character string containing the name of a CICSplex. You can use partial names or a trailing asterisk (*) as a wildcard character. You can use cplexname with either the YES or NO option to restrict the discovery to specific CICSplexes. If you omit cplexname, all the CICSplexes associated with the CMAS are included in or excluded from the discovery.

You can use multiple BOOK TYPE CICSPLEX parameters. The DLA processes multiple parameters in the order in which you include them in the input file.

BOOK TYPE CICSREGION.cics_name{YES | NO}
Determines whether the DLA creates a CICSREGION discovery library book and controls which CICS regions to include in the discovery. Specify one of the following values:
  • YES to include the selected CICS regions in the discovery.
  • NO to suppress the selected CICS regions from the discovery.
The default is YES.

cics_name is an optional character string containing the name of a CICS region. You can use partial names or a trailing asterisk (*) as a wildcard character. You use cics_name with either the YES or NO options to restrict the discovery to specific CICS regions. If you omit cics_name, all of the CICS regions associated with the CMAS are included in or excluded from the discovery.

You can use multiple BOOK TYPE CICSREGION parameters. The DLA processes multiple parameters in the order in which you include them in the input file.

BOOK TYPE CTSPLEX {YES | NO}
Determines whether the DLA creates a CTSPLEX discovery library book containing a summary of the discovered CICSplexes. Specify one of the following values:
  • YES to produce a CTSPLEX discovery library book with a summary of all CICSplexes discovered by the DLA
  • NO to suppress the output discovery library book for the CTSPLEX CICSplex summary.
The default is YES. You can include no more than one instance of this parameter.
SET CMAS CMAS_name
The name of a CMAS. The CMAS must be running at the CICS TS 4.1 release level. The DLA discovers information about the CICSplexes connected directly to this CMAS, and about CICSplexes connected to other CMASs associated with this CMAS.
SET CONSOLE_MESSAGES {YES | NO}
Use this parameter only under the supervision of IBM® support staff.
Specify one of the following values:
  • YES to copy messages to the MVS™ console.
  • NO to bypass copying messages to the MVS console.
The default is NO.

Console messages are always displayed in English because the console does not support the double-byte character sets necessary to display the alternative languages.

SET FEEDBACK {QUIET | VERBOSE}
FEEDBACK specifies how the DLA handles exception condition reporting if an error is returned from the CICSPlex® SM API. The options are as follows:
  • QUIET: the DLA writes only progress messages and exception conditions. QUIET is the default FEEDBACK option.
  • VERBOSE: in addition to the standard message reporting response and reason codes, the DLA writes any associated CICSPlex SM feedback data.
All feedback information is sent to the SYSPRINT DD destination and the @DIALOG file.
SET FTP {YES | NO}
Specify one of the following values:
  • YES to transfer discovered data to the discovery library file store (DLFS) as part of the DLA run.
  • NO to suppress the transfer.
The FTP transfer takes place only if the DLA discovery operation completed successfully with a return code of zero. If you specify NO, or if the DLA run does not complete successfully, you can transfer the data to the DLFS as a separate operation by running the EYUJXDD1 module.
During operation the DLA generates FTP PUT and RENAME in the following PDSE data set members:
  • @FTPALLP: contains FTP statements to PUT and RENAME all discovery library books.
  • @FTPCHGP: contains FTP statements to PUT and RENAME all changed discovery library books.

The contents of either @FTPALLP or @FTPCHGP are copied to the @FTPRUN data set member depending on the settings of the SET IGNORE_CHECKSUMS and SET REFRESH parameters.

SET HOSTNAME host_name
Specify the z/OS IP host name.
SET IGNORE_CHECKSUMS {YES | NO}
Specify one of the following values:
  • YES, to bypass checksum processing for the discovery library books.
  • NO, to calculate checksums for the discovery library books.
The default is NO.

Checksum processing determines whether each discovery library book has changed since the last DLA run. The DLA calculates a checksum for each discovery library book that it creates. The @FTPCHGP member contains a list of the discovery library books that the DLA has changed. You can then transfer only the changed discovery library books to the DLFS.

The advantage of checksum processing is that it reduces the amount of data transferred to the DLFS. The disadvantage is that it increases the DLA run time. Because the checksum processing increases DLA processing, you might want to bypass it by setting SET IGNORE_CHECKSUMS YES.

SET LIMIT {1 - 9999999}
An integer between 1 and 9999999 specifying a limit to the number of resources to be discovered. The default is 10000.

The DLA issues warning messages if the limit is exceeded. Processing continues, but a non-zero DLA return code is set so that the FTP step, to transfer the discovery library books to the DLFS, will not run.

SET MESSAGE_LANGUAGE {|CHN | ENU | JPN}
This parameter determines the language used for the messages written to the destination specified on the SYSOUT option of the SYSPRINT file. Specify CHN for simplified Chinese, ENU for English, and JPN for Japanese Kanji. The default language is English. The Chinese and Japanese options use double-byte character sets.
SET ORGNAME organization_name
A single word without imbedded blanks denoting the name of your organization. This parameter can contain alphanumeric and national characters, with XML escape characters being used for other characters (for example: &lt; for < and &gt; for >).

The z/OS® SMFID and SYSPLEX names are typically unique in an enterprise. In some cases, for example in the case of a company acquisition, duplicates can exist: for example, two independent z/OS systems with SMFID called MVS1. In order to maintain separate instances with a CMDB, set different ORGNAME values.

The default is SET ORGNAME <defaultOrg>. This default is a special value that informs CCMDB that the CICS resources are related to the CCMDB defined default organization. Use this default setting unless your site has duplicate z/OS SMFIDs and SYSPLEXes that you want to have loaded into the same CCMDB.

SET REFRESH {YES | NO}
Specify one of the following values:
  • YES to produce refresh-type discovery library books
  • NO to produce create-type discovery library books.

The default is NO.

Specifying SET REFRESH YES causes the output XML files to be refresh-type discovery library books. This setting indicates the discovery library books contain everything known about the environment. The readers of the discovery library books (such as CCMDB and TBSM) delete data loaded from corresponding discovery library books provided by the CICS DLA. Specify SET REFRESH YES only after a major configuration change.

Specifying SET REFRESH NO causes the output XML files to be create-type discovery library books. This setting indicates that the generated discovery library books contain information only about resources that have changed since the last DLA run.



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