INGDLA (deprecated)

Purpose

The INGDLA command invokes the SA z/OS® Discovery Library Adapter to discover SA z/OS configuration data, which is primarily the SA z/OS resources and their relationships. It then saves the data in an Identity Markup Language (IdML) book, which can be forwarded to a system that is hosting a Tivoli® Application Discovery Dependency Manager (TADDM).

The discovery scope of the INGDLA command is the entire sysplex, that is, all the systems that the SA z/OS automation manager controls.

You can use the INGDLA command, for example, after a major configuration change, or periodically driven by a NetView timer.

Parameters

CODEPAGE

Specifies the encoding codepage — this is the one that NetView uses. The default is 1047, unless it is overwritten by the installation defaults (using the INGCNTL command, see IBM Z System Automation Programmer's Reference).

You must specify this parameter if you are running with a different codepage. Failure to do so will result in the generation and downloading of a corrupt Identity Markup Language (IdML) book that Tivoli Application Discovery Dependency Manager (TADDM) cannot load.

ODSN

Specifies the name of the output data set. The data set must be a pre-allocated (catalogued) PDS with attribute VB=3000. The name must be fully qualified, with or without surrounding quotes. The user ID that NetView is running under must have UPDATE access to it. With the INGCNTL command, this parameter can be preset (see INGCNTL in IBM Z System Automation Programmer's Reference).

MEMBER

Specifies the name of the member that will contain the IdML data. The default is INGBOOK unless it is overwritten with installation defaults (see INGCNTL in IBM Z System Automation Programmer's Reference).

Reserved member name is @CHCKSUM.

ORGNAME

Specifies the name of the organization. The default is to take the default name from the IBM® Tivoli Change and Configuration Management Database (CCMDB) unless it is overwritten by the installation defaults (see INGCNTL in IBM Z System Automation Programmer's Reference).

Place quotes around the organization name in order to maintain mixed case names.

ENCODING

Specifies the encoding option. Valid values are EBCDIC, ASCII and UTF-8. The default is UTF-8 unless overwritten by the installation defaults (see INGCNTL in IBM Z System Automation Programmer's Reference).

HOSTNAME

Specifies the name of the host of the management software system (that is, SA z/OS). It is used to address SA z/OS. If specified, it takes precedence over a discovered host name.

WAIT

Specifies the maximum number of seconds to wait for the automation manager query to respond. The maximum time interval is 999 seconds. The default is 30 seconds.

CHECKSUM

Specifies whether to skip generating the SA z/OS DLA book if the checksum matches:

YES

Skip generation if the checksum matches. This is the default.

NO

Ignore checksum results.

CONTACTINFO

Provides details of ports and security keys that are needed to establish a session with NetView over TCP/IP when used in conjunction with the host name.

Return Codes

0

Successful completion.

8

Error occurred, such as a bad return code received from the automation manager.

12

Bad input parameters or allocation failed.

16

Fatal error.

Usage

The INGDLA command can be invoked from the NetView command line on any system in the sysplex.

The INGDLA command operates sysplexwide. For an overview see Overview of Commands that Operate Sysplexwide.