Customizing Abend-AID viewer dump capture
This section describes the steps for modifying the Abend-AID Viewer dump capture component, which gives you a great deal of flexibility regarding dump capture and processing. Using a combination of job name and MVS SYSID, you can indicate what type of region dump to take (SYS1.DUMPxx; SDUMP to an automatically allocated data set; or an SDUMP to a user-defined data set).
The Abend-AID Viewer dump capture and processing options function has four main components, the first three of which are highly interrelated, and are described in this section:
- Summary and region configurations — If your site has batch Abend-AID only installed, the Summary Configuration screen is used to specify the following information for your regions. Regions are specific address spaces. Regions are identified by job name and MVS SYSID:
- The region dump capture profile to use
- Which Abend-AID Viewer server is to process dumps from this region
- An optional region description. The region description is used on the Fault Summary display to group dumps into categories. You create the categories using the region descriptions.
If your site has Abend-AID and Abend-AID for CICS or Abend-AID for CICS only installed, the Region Configuration screen is used to specify the following information for your regions. Regions are identified by job name, CICS APPLID, and MVS SYSID: - The region dump capture profile to use
- The transaction dump capture profile to use
- The transaction dump global options member to use
- The transaction dump handler profile to use
- Which Abend-AID viewing server is to process dumps from this region
- Which CICS transaction dump capture address space (TDCAS) is processing dumps for this region
- An optional region description. The region description is used on the Fault Summary display to group dumps into categories. You create the categories using the region descriptions.
- Region dump capture profiles — The options you specify for region dump capture and processing are stored in named members called dump capture profiles. BMC supplies a default region profile member, and you can create new profile members with unique names and content.
On the Summary Configuration screen (option 1 on the Dump Capture and Processing menu), you assign regions (using job name and MVS SYSID as qualifiers) to use the dump capture profiles you create. Multiple regions and groups of regions can use the same profile. If you don’t specify a profile, the default is used. - Dump capture profiles (region and transaction) — The options you specify for region and CICS transaction dump capture and processing are stored in named members called dump capture profiles. BMC supplies two default profile members, one for transaction dumps (used by Abend-AID for CICS only) and one for region dumps, and you can create new profile members with unique names and content.
On the Summary Configuration screen or Region Configuration screen (option 1 on the Dump Capture and Processing menu), you assign regions (using job name, APPLID, and MVS SYSID as qualifiers) to use the dump capture profiles you create. Multiple regions and groups of regions can use the same profile. If you do not specify a profile, the default is used. - Transaction dump global options — If you have Abend-AID for CICS installed, several options globally control how Abend-AID for CICS processes transaction dumps for a CICS region. These include how much of the CICS trace table is captured with dumps, and internal performance processing options.
As with dump capture profiles, transaction dump global options are specified in named members. BMC supplies a default transaction dump global options member, and you can create additional members.
Transaction dump global option members are assigned to CICS regions and groups of regions in the same way as dump capture profiles. Multiple CICS regions can use the same profile. If you do not specify a profile, the default is used. - Transaction dump handler profiles — If you have Abend-AID for CICS installed, you can use CICS transaction dump handler profiles to specify that Abend-AID for CICS identify in the transaction abend analysis for your CICS regions the location in the programs from which the IBM or user-defined abend routines were called. The default profile contains the IBM abend routines ILBOABN0 and CEE3ABD.
Dump capture options allow you to indicate what actions to perform when a region or transaction dump is taken. There are several steps involved in specifying dump capture options. These options are available from the Dump Capture and Processing Menu, shown in figure Dump Capture and Processing Menu for Abend-AID only or Dump Capture and Processing Menu for Abend-AID and Abend-AID for CICS figures, and are described below. Customizing Abend-AID Viewer Dump Capture.
This section provides information about the following topics: