1. Display the AAON Transaction Options Menu, as shown in the following figure, by typing AAON and pressing Enter from a cleared CICS screen.

AAON Transaction Options Menu

The AAON Transaction Options Menu displays AAON options that start, stop, or cancel a transaction or region dump interface (or a combination of the two interfaces). You may also display the temporary transaction dump capture option table from this screen. The current status of each dump interface appears below the list of AAON options.

 2.  Select an AAON option using one of two methods:

a. Tab to the option you want to select and press Enter.

b. Type the name of the option in the OPTION field and press Enter. If you accidentally enter an invalid option, the system redisplays the AAON Transaction Options Menu.

Once you make a selection, the status of the appropriate dump interface changes accordingly.

 3.  Press Enter to return to the AAON Transaction Options Menu, or press Clear Screen to return to CICS.

You may also control the transaction and region dump interfaces directly from CICS using a combination of the AAON transaction ID and an AAON option. For example:

Press Enter to process the command from CICS.

Transaction Dump Interface

The transaction dump interface must be started for Abend-AID to process any transaction dumps, or if you want to view dumps from CICS (with the AADF transaction). To start the transaction dump interface, select AAON ON, AAON ONRT, or AAON DB2ON. Also note the following conditions that affect starting the transaction dump interface:

• The transaction dump capture subsystem must be active before you start the transaction dump interface.
• If your site is licensed for the Abend-AID Db2 extra-cost option and if Abend-AID is installed in a CICS region where Db2 itself is not running, the transaction dump interface still turns on, even if the table updates for the Db2 option have not been completed. Messages are written to the CSMT log and/or the terminal indicating that Db2 is licensed, but is not active in the CICS region.
• If your site is licensed for the Abend-AID Db2 extra-cost option, and if Db2 itself is running in a region and the Db2 option table updates are not completed, the transaction dump interface will not start in that region, regardless of which AAON option you select.

Additional AAON options are available, but do not appear on the AAON Transaction Options Menu. These options can be issued from CICS with the AAON transaction ID, or from the OPTION field on the AAON Transaction Options Menu:

• AAON T0C7 creates a transaction ASRA abend (S0C7).
• AAON DISP allows all Abend-AID for CICS messages issued in the CICS region to appear in the CICS FDBDLOG.
• AAON SUPP reduces the number of Abend-AID for CICS messages that appear in the CICS FDBDLOG.   This is the default setting in order to reduce the size of the FDBDLOG output.

Region Dump Interface

The region dump interface is not required to capture CICS region dumps. It is required only if you want to capture a list of recently changed programs from the CICS RPL concatenation. If this list is captured, you can view it through the Abend-AID region dump display screens. Entering the CHANGES fast-path command displays the Program Change Summary screen.

If you want to use the optional region dump interface, use the Abend-AID AAON ONR or AAON ONRT CICS transaction. For PLT processing, the program name associated with the region dump interface is CTCCJRGN. Note that you may experience some overhead and increased dump capture time when you enable the region dump interface. Usually this amount is insignificant, but if you see any performance degradation at dump capture time, you can turn off only the region dump interface, while still leaving the transaction dump interface active.

Starting Abend-AID from a Sequential Terminal

If you want to start Abend-AID from a sequential terminal, complete the steps described below for each CICS region from which you want this support.

Task 19.1  Add the Sequential Terminal Definitions to your TCT

Add the appropriate definitions for a sequential terminal to your TCT. The sample library distributed with CICS contains a sample TCT definition for sequential terminals in member DFH$TCTS. The CICS Transaction Server for z/OS 3.2 version of this definition is shown in the following figure.

Sample TCT Definitions for CICS Transaction Server for z/OS

Task 19.2  Ensure the TCT Supports Non-VTAM Devices

Ensure that the CICS DFHTCT TYPE=INITIAL macro specifies the ACCMETH=NONVTAM parameter. For example:

Task 19.3  Verify the DFHSIT EODI Parameter

The EODI SIT parameter specifies a hexadecimal value that indicates the end of a sequential terminal input card. The default is E0 (hexadecimal E0), which is a character back slash (\). The value you specify must be added to the end of each transaction in the sequential input reader.

Task 19.4  Add DD Statements to the CICS JCL

Add the following statements to the CICS JCL: