Entire Transaction Propagator Version 1.5.2
 —  Entire Transaction Propagator  —

ETC Installation and Operation

The Entire Transaction Propagator Interface for CICS (product code: ETC) is a separate Software AG Selectable Unit to support the operation of the Entire Transaction Propagator (product code: ETP) for 3GL programs running in a CICS/TS or CICS/VSE environment. ETC is not needed when running Natural application programs alone with CICS. ETC is provided in your installation library only if the ETC selectable unit has been ordered for your site.

This document covers the following topics:

For a description of the ETC ABEND codes that can occur when ETC is active, refer to ETP Abend Codes (in the Natural Messages and Codes documentation).


Overview on ETC Operation

The figure below shows how 3GL user application programs, Natural and ETC/ETP work together to use ETP services for logging Adabas database transactions.

ETP Interface for CICS (ETC)

Top of page

Prerequisite Requirements and ETC Release Contents

This section describes the operating system and companion software needed to run ETC, and describes the modules contained on the ETC release (distribution) tape.

Operating System and Software Requirements

ETP Version 1.5.2 and a CICS installation is required to install ETC. The prerequisite versions of

are listed in the current Natural Release Notes for Mainframes.

ETC Distribution Tape

The ETC distribution tape contains the following datasets:

Dataset Name: Description:
ETCvrs.LIBR On z/VSE system tapes only. z/VSE LIBR backup format of the ETC product sub-library. This sub-library also contains the assembler macro ETCPARM for parameter module generation and an example for calling the ETCPARM macro.
ETCvrs.LIBJ On z/VSE system tapes only. Example installation jobs.
ETCvrs.LOAD On z/OS system tapes only. z/OS load library.
ETCvrs.SRCE On z/OS system tapes only. Assembler macro ETCPARM for parameter module generation and an example for calling the ETCPARM macro.

- where vrs is the respective ETC version/release/SM. For more information, see the Report of Tape Creation delivered with the distribution tape.

Top of page

General Information on ETC Installation

This document describes how to install ETC. The headings in each section are keyed to the corresponding job and step numbers of Software AG's System Maintenance Aid (SMA)-generated installation. This information is shown in brackets.

The Entire Transaction Propagator Interface for CICS (ETC) provides the functionality for Natural as well as 3GL applications running with ETP in a CICS environment. When running only Natural with ETP and CICS, however, only ETP is required.

When running ETC, the following restrictions apply;

If the Adabas Bridge for VSAM is installed, AVBUSER MODE=ET should be specified.

Proceed with ETC Installation Procedure.

Top of page