Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Considerations for adding file entries

File entries are used for Abend-AID for CICS transaction abend source support and the transaction abend demonstration program. In addition, you can use a File entry to specify the Abend-AID for CICS customization file definition.

Customization File Definition

Abend-AID for CICS requires the customization file to determine what processing options apply to CICS transaction dumps. You can define the file in the CSD using RDO or by adding a DD statement in the CICS JCL.

To define the file in the CSD, use the appropriate RDO member for your CICS release, as described in Using-resource-definition-online-or-the-CSD-utility-DFHCSDUP. With this method, you must modify the DSNAME operand to point to the customization file for this Abend-AID for CICS release.

Note

The customization file must be defined as a local file to the CICS region for which Abend-AID for CICS processing is required.

See Modifying-the-CICS-startup-JCL for information about adding a DD statement for the customization file to the CICS JCL.

Source Listing Files

To use Abend-AID for CICS source support, you must define your source listing files to either the viewing server or to your CICS regions.

  • Defining them in the viewing server JCL makes them available to all reports in the viewing server. See BMC source listing DSNs for more information.
  • Defining them to the CICS region makes them available to the reports for that region. For more information about defining them to the CICS region, see Modifying-the-CICS-startup-JCL.
    The configuration and customization dialog prompts you for a source listing shared directory or source listing database for the viewing server JCL that it generates.

If you want to define source listing files to the CICS region, either:

  • Create file entries. Installation sample library (CTL) member FXRDOFIL contains the RDO definition for the file entries.
  • Add DD statements to the CICS JCL. Modifying-the-CICS-startup-JCL describes adding a source listing file DD statement to the CICS region JCL.

Note

  • The Common Shared Services User/Reference Guide contains information about allocating source listing files.
  • If Code Debug CICS is installed in your CICS regions, you have already defined the source listing files to your CICS regions. Abend-AID for CICS uses the files allocated for Code Debug CICS. Ensure that the first four characters of the DD names used for the Code Debug CICS files match the value specified for the SLSDDN transaction dump global option, as described in SLSDDN.
  • Source listing files added by Code Debug CICS after Abend-AID for CICS is activated will not be known to Abend-AID for CICS. Run the AAON transaction, as described in Using Supplied Abend-AID for CICS Transactions to remedy the situation. Alternatively, users can add source listing files with the Source Directory screen, as described in the Abend-AID for CICS User’s Guide.


Demonstration Transactions

If you want to use the Abend-AID for CICS COBOL (CCAADEMO), PL/I (CCAADEMP), or Assembler (CCAADEMA) transaction abend demonstration program, a file entry is required for the demonstration file. The CCAADEMO, CCAADEMP, CCAADEMA demonstration file is a VSAM KSDS. Installation sample library hlq.CTL member FXRDOxxx contains the RDO entry. Refer to the Abend-AID Installation and Configuration Guide for more information about installing and using the demonstration transactions.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*