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.

Environmental considerations

The information in this section describes requirements or conditions involving programs or systems other than those of BMC.

IBM DFSMS Modules

Abend-AID has full support for the IBM Data Facility Storage Management Subsystem (DFSMS). DFSMS information is provided in the Data Management Control Block section of the Abend-AID report.

Abend-AID searches for IBM module IGWASMS, usually located in the callable system service library SYS1.CSSLIB, to obtain DFSMS information. IGWASMS must be available to Abend-AID at abend time. If IGWASMS is not available, a CSV003I error appears in the JES log for the job as a result of the load. Also, a warning message is printed in the Data Management Control Block Section of the Abend-AID report indicating that IGWASMS was not available and that no construct information will be given.

Support for PDSE Object Libraries

Abend-AID has exploitative support for PDSE object libraries. The Error Location section of the Abend-AID report displays the abending PDSE object module name, the time it was bound, and the binder information. In addition to supporting application PDSE object libraries, Abend-AID can be installed into a PDSE object library.

CICS Dumps

Include an Abend-AID ignore (//ABNLIGNR DD) statement in the JCL for all CICS online regions. Because Abend-AID does not contain specialized diagnostics for online CICS transaction terminations, We recommend that normal CICS dump processing occur. Abend-AID diagnostics are provided for batch CICS U37xx abends. Therefore, do not include a //ABNLIGNR DD statement in the JCL of batch CICS sessions.

CA-OPTIMIZER Detector Compatibility

To get an Abend-AID report when using the CA-OPTIMIZER Detector feature, modify the Detector’s User Abend Control Table to set DUMP=ON for all system and user abends.

CA-OPTIMIZER’s Extended Detector Support uses an IBM SVC51 interface. Contact Abend-AID Technical Support for details on the requirements for allowing coexistence of the Abend-AID IBM SVC51 interface and the CA-OPTIMIZER IBM SVC51 interface.

CA-PANEXEC Interface

CA-PANEXEC provides an Abend-AID interface, “PANEACCS”. This module must be available to Abend-AID to provide support for modules stored in libraries managed by CA-PANEXEC. If you are no longer using CA-PANEXEC, ensure that PANEACCS is not available to Abend-AID. Refer to IBM Dump Processing in this space and the for more information.

Innovation Access Method (IAM) File Support

If your site uses IAM files, you must set “Provide IAM Support” to YES in the Abend-AID global site options (CWGLOBAL). See Provide IAM file Support for more information.

JES2 Support

Note

No Abend-AID installation step or setup is required for JES3 sites.


The File section of the Abend-AID report provides extensive information about SYSOUT (JES2) files that are open at abend time. This reporting requires a special Abend-AID load module table called CWJESTAB that is based on the particular version and maintenance level of JES2 that you are running. Abend-AID also uses CWJESTAB to perform dynamic allocation of the ABENDAID SYSOUT statement, when needed in Language Environment. CWJESTAB must be in a library that is available to Abend-AID at abend time.

New and recommended JES2 Support Method One

Note

PTF ACF495Y provides an alternate recommended method of making CWJESTAB available to Abend-AID by applying USERMOD PAAJES2 to JES2. Member PAAJES2 in the SKAZSAMP library contains a sample job to apply the USERMOD. Before running the job, customize it for your environment.

Refer to the Abend-AID Installation and Configuration Guide for the steps for implementing JES2 support Method One for a new or upgraded Abend-AID installation.

Less Current, Alternative JES2 Support Method Two.

Note

  • BMC still supports the following less current, alternative method for implementing JES2 support.
  • Depending on your site’s security requirements, your z/OS administrator may be required to provide the z/OS SMP/E Global CSI DSN and the z/OS SMP/E Target Zone name and to run the generated jobs.

Refer to the Abend-AID Installation and Configuration Guide for the steps for implementing JES2 support Method Two for a new or upgraded Abend-AID installation.

During batch Abend-AID configuration, the installer creates CWJESTAB with an assembly and link. The assembly uses the current JES2 macros, which are required for Abend-AID’s JES2 reporting. CWJESTAB must be assembled with the JES2 macros that represent the state of JES2 in the system on which Abend-AID will be running. If a new level of JES2 is installed, or any type of SMP/E JES2 maintenance is installed, it is possible and likely that changes will be made to the JES2 macros and the current CWJESTAB will be invalidated.

Symptoms of Problems With CWJESTAB

The File section of an Abend-AID report for a JES2 file can indicate an invalid CWJESTAB in the following ways.

  • Data management control block information appears in a non-JES2 file format. Abend-AID does not summarize JES2 information. The current and previous records are displayed from the user’s buffers rather than the JES2 buffers.
  • This warning occurs in the report where JES2 information is normally printed
ABJES001  Unable to format JES2 file information.  Level of
JES2 not recognized.  Contact the Abend-AID installer at your site for
JES2 level verification.

CWJESTAB and JES2 Maintenance

Perform the following steps to ensure that CWJESTAB remains valid.

  1. Modify job JCLSMPDD in Abend-AID’s installation sample library (CTL) to point to the SMP/E global zone, and then run the job. This job performs an SMP/E LIST DDDEF to list the DD statements and data set names in your SMP/E global zone.
  2. Search the output of the JCLSMPDD job for the //SHASMAC DD statement. This statement corresponds to the data set name of the current JES2 macros. Use this name on the //SYSLIB DD statement in the $09ASMJT job, which is generated during batch Abend-AID configuration. The load module CWJESTAB will be the site default load module. The second load module created is CWJTxxxx, where xxxx is the four-character system ID of the system for which the load module was created. This allows the same load library to be used across a sysplex where different levels of JES2 are being used.
  3. Specify an SMP/E USERMOD name following the conventions of your installation. Edit and run job $10SMPU1, which is generated during batch Abend-AID customization. This job adds the USERMOD name to the set of UMIDs associated with the JES2 macros used in assembling CWJESTAB. This updates the SMP/E control files so that you will be warned when maintenance is installed on JES2.

Corrective Action

When maintenance is applied to your JES2, a warning message will be issued to update the CWJESTAB table for Abend-AID. During the installation of Abend-AID, JCL member $10SMPU1 was executed to update the SMP/E zones so that they would generate the warning when JES2 maintenance is performed.

In order to reassemble and install a current table of JES2 control block field offsets, perform the following steps.

  1. JCL member JCLSMPU2, supplied in the Abend-AID installation sample library (CTL), will remove the USERMOD name associated with the JES2 macros used in the assembly of CWJESTAB. This must be completed before the application of system maintenance to JES2.
  2. Apply JES2 maintenance.
  3. After completing the JES2 maintenance, JCL member $09ASMJT, generated in the Abend-AID installation library, assembles CWJES4TB using the correct IBM macros and links it as CWJESTAB in the Abend-AID load library.
  4. JCL member $10SMPU1, generated in the Abend-AID installation library, updates the SMP/E ZONES so that a warning message is generated when maintenance is performed on JES2.

Installation job $09ASMJT must be executed on each system that will use Abend-AID. A load module, CWJTxxxx, where xxxx is the system ID, will be created. Store the load modules in the Abend-AID customization load library. This load library must be available to Abend-AID on each system.

Japanese Language Facility

This section describes Abend-AID’s optional Japanese language facility, which presents Abend-AID reports in Japanese and works with software products that use the IBM double-byte character set (DBCS) and/or Japanese language. Abend-AID displays Japanese language only when viewing an Abend-AID report via the Abend-AID Viewer.

Follow the procedures described below to obtain Abend-AID reports in Japanese language and Abend-AID for DBCS.

User Requirements

Use 3270 Emulator supporting Japanese (i.e., Network Personal Communications Workstation Program), or any equivalent hardware.

Usage Procedure

  1. Use the Abend-AID Viewer to view an Abend-AID report in Japanese language.
  2. Set JAPANESE as the national language on the Site User Profile customization screen in the Abend-AID Viewer. See Task 2: Specify the Default Site User Profile for more information.
  3. Optionally, you can use Language type for report text to provide uppercase English in reports written to SYSOUT. Review the complete description of this parameter.

Japanese text is available for Abend-AID reports only when they are viewed via the Abend-AID Viewer. It includes most Abend-AID report text, panels, and messages.

Abend-AID for DBCS

Abend-AID is compatible with software products installed with the appropriate DBCS and Japanese language features. The requirements for installing DBCS for these software products must be followed in order for Abend-AID to function with them.

Operating System Upgrade

Do the following when you upgrade your site’s operating system:

  1. Verify that the new operating system is supported at the level of Abend-AID currently installed.   If not, you may need to add current Abend-AID maintenance to obtain support for the new release.
  2. Install Language Environment support for the new operating system. See Task 3: Register an Abnormal Termination Exit for language environment support and Task 4: Register LEAID64 as a Language Environment 64-Bit Abnormal Termination Exit in the Abend-AID Installation and Configuration Guide for more information. LEAID is required to call Abend-AID in the Language Environment.
  3. For JES2 sites only, complete the procedures described in JES2 Support .


 

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