Making the End-to-End Agent Highly Available

The end-to-end agent runs as a started task and should be defined as APL within a System Automation policy. It must run once per SAplex. For that purpose, a new application category E2EAGT has been introduced.

A sample policy is available for the end-to-end agent.

The customer may import the following PDB entries within *E2E via component 'E2E Automation Agent':
Table 1. E2E Sample Policy - E2E Agent Component
PDB Entry Name Type
E2EAGENT APL
E2EDVIPA APL
C_DVIPA APL, (only a placeholder here, the original values can be found in *BASE)
E2EAGENT APG, system group to contain applications E2EAGENT and E2EDVIPA
E2EAGENT_X APG, Sysplex move group – serial mode
E2EAGENT_AUTOOPS AOP, Auto operator INGAGT maps on AUTAGT

Since E2EAGENT_X is a move group between systems of the SAplex, it is necessary for the end-to-end automation adapter to connect to the end-to-end agent via a virtual IP address (VIPA). A VIPA stays the same, even though the application (end-to-end agent) using it can be moved from one system to another.

The E2EDVIPA application makes use of class C_DVIPA, which is delivered with the *BASE add-on policy in the 'Dynamic Virtual IP Addressing (DVIPA)' component.

After you import the PDB entries, additional adaptions are needed:
  • Change the XCF group ID. Change the startup parameter XID=00 in the E2EAGENT application according to your needs.
  • Change the startup parameter of E2EDVIPA application using the correlated IP stack and the DVIPA address.
    Note: This DVIPA address has to be specified also in the INGAGT_HOST parameter of inge2eagt.properties file for the E2E agent, and in the eif-send-to-agent-hostname parameter of ing.adapter.properties file for each E2E automation adapter.

The automation policy has definitions for the broken E2E agent and its IEF450I abend message. It automatically performs cleanup recovery of the end-to-end agent.

The automation policy exploits the following messages to set the status of the corresponding end-to-end agent APL:
Message SA Agent Status
INGX9632I System Automation E2E agent jobname terminates: reason No status change and only message capturing is done.
INGX9633I System Automation E2E Agent jobname initialization complete UP
INGX9634I System Automation E2E agent jobname user ID or password is not correctly specified or the credential file cannot be loaded from path. HALTED
INGX9874I System Automation Agent Java Adapter jobname is active. ACTIVE
INGX9876I System Automation Agent Java Adapter jobname has been stopped. AUTODOWN
INGX9877I System Automation Agent Java Adapter jobname has been stopped due to failure, rc=return code. BROKEN
ING377I The E2E agent service xxx failed with RC=retcode, REASON=reason_text HALTED