INGE2E

Purpose

The INGE2E command provides the operational API for the end-to-end automation adapter and the end-to-end agent.

Parameters

RESET

Specifies cleaning up end-to-end automation adapter-specific settings in the primary automation agent.

This command is used in SA automation policy in case of normal (IEF404I) or abnormal (IEF450I) termination of E2E automation adapter address space. It's normally not issued manually by operators.

RESYNC

Specifies resynchronizing event notification of the E2E agent or SMU server with the first-level automation. For this purpose, SA first notifies them that the automation domain is offline. Afterwards, an online notification is sent. This causes the E2E agent or SMU server to request initial status information for all resources known by it in that automation domain.

This command is used by SA, for example if PAM hot-start takes longer than the value specified in the AOF_E2E_TKOVR_TIMEOUT variable (default is 2 minutes). It's normally not issued manually by operators.

RECYCLE

Specifies recycling a MOVE group. The MOVE group is part of the end-to-end automation high availability policy as described in High Availability of the End-to-End Automation Adapter. The MOVE group includes the end-to-end automation adapters on the different systems within a subplex. The INGE2E command is specified in REFRESHSTART of the entry type E2EADPT in the STARTUP policy. It recycles the MOVE group either by recycling the primary automation agent, or by a refresh or an ACF COLD of the configuration file.

move-group

The name of the MOVE group to be recycled.

Example to recycle the MOVE group E2EADPT_X/APG, specify:

INGE2E RECYCLE, E2EADPT_X/APG

SETDBGLVL

Use this function only if IBM Support asks you to do so. Set ON debug level for the End-to-End Adapter REXX backend.

NORMAL

The standard debug level.

EXP

Specifies to debug expiration checking.

SEC

Specifies to debug security user exit.

DELDBGLVL

Use this function only if IBM support asks you to do so. Deletes all debug levels for the End-to-End Adapter REXX backend.

VERIFY

Verifies the installation of the end-to-end adapter. Requires that you have copied and customized the end-to-end adapter configuration files.

Requires that E/AS is already running, if the end-to-end adapter is used together with E/AS.

Requires that the operator that calls function VERIFY has rights to access OMVS and to access files and subdirectories within CPATH.

JOBEAS

Specifies the job name of the E/AS address space.

It's required only if the end-to-end adapter is used together with E/AS. Otherwise, omit this option.

CPATH

Specifies the customization path of the end-to-end adapter. This is the directory that contains the /config subdirectory. For example, local/ing/adapter.

PING

Specifies whether a ping should be performed for the hostnames specified in the adapter configuration file.

Specify NO if you do not want to send a ping to the hostnames.

If you omit this parameter or you set it to anything else than the NO function, VERIFY checks if the ping to the hostnames works correctly.

This function verifies:

• GRPID in INGXINIT must match GRPID in USS file ing.adapter.plugin.properties.
• ServerLocation in E/AS message adapter configuration file must match eif-recieve-from-hostname in USS file ing.adapter.properties.
• ServerPort in E/AS configuration file must match eif-receive-from-hostname in USS file ing.adapter.properties.
• PPI parameter in E/AS start procedure must match INGEVE2E or Cglobal AOF_E2E_EAS_PPI.
• PPI=YES must be set in INGXINIT.
• E2E_CUSTOM_ROOT in USS file ingadapter.properties must match value of CPATH.
• E/AS is not running.
• Performs PING to eif-send-to-hostname in USS file ing.adapter.properties.
• Performs PING to eif-send-to-agent-hostname in USS file ing.adapter.properties.

If verification was not successful it writes information text to the console that describes the parameter mismatch in more detail.

Example:

NETVASIS INGE2E VERIFY JOBEAS=EVE2E CPATH=/local/ing/adapter

DISPCFG

Reads end-to-end adapter configuration files from the custom-root directory CPATH and displays them all one after another on the NetView WINDOW.

Example:

NETVASIS INGE2E DISPCFG CPATH=/local/ing/adapter

PREPARE

This function prepares the USS configuration files for the end-to-end adapter and completes the following:

1. creates necessary subdirectories within the custom-root directory,
2. copies all necessary configuration files from the install-root to the custom-root,
3. updates the configuration files with the input parameters.

Note: If the directory structure already exists then the command INGE2E PREPARE stops with an error message in order to prevent overwrite an existing configuration.

IPATH

Specifies the install path of the end-to-end adapter. The default install path is /usr/lpp/ing/adapter.

CPATH

Specifies the customization path of the end-to-end adapter. The function PREPARE or the end-to-end adapter writes into this directory.

All subdirectories are automatically created.

This is the subdirectory that for example contains the subdirectory /config or /data.

For example, /local/ing/adapter.

SERVER

Specify the end-to-end management server hostname.

JAVA

Optionally specify the 32-bit java home directory, for example, /local/java/a60/j6.0

You may omit this parameter if the default java runtime is already 32-bit java version 1.6.

Example:

NETVASIS INGE2E PREPARE IPATH=/user/lpp/ing/adapter
                CPATH=/local/ing/adapter
                SERVER=lnxe2e4x JAVA=/local/java/a60/J6.0

STOP_E2EAGT

Stops the E2E agent in a normal manner. This command is used in the SA automation policy. It's normally not issued manually by operators.

CLEANUP_E2EAGT

Cleans up the E2E agent when the E2E agent is not terminated normally, for example, after the E2E agent is canceled. It deregisters the E2E agent from the automation manager and cleans up internal data such as CGlobals. This command is used in the SA automation policy. It's normally not issued manually by operators.

DEBUG_E2EAGT

Specifies whether debugging the E2E agent is on or off.

ON

Switches on debugging the E2E agent for the REXX trace and for the Java logger.

OFF

Switches off debugging the E2E agent.