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.

Verify Abend-AID configuration

This milestone describes the tasks required to execute the Abend-AID and/or Abend-AID for CICS IVP (installation verification program) jobs to test the Abend-AID/Abend-AID for CICS configurations.

The following roles are involved for this milestone:

  • Abend-AID installer/Abend-AID for CICS installer
  • CICS system programmer
  • Db2 database administrator

This section provides information about the following tasks

Task 1: Verify batch Abend-AID

If your site is not licensed for batch Abend-AID, go to Verify Abend-AID for CICS.

Edit according to the comments in the member and run the following hlq.CTL library member $$IAALOG jobs to verify a new/upgraded instance of batch Abend-AID:

  • $11VERIF: Executes the CWVERIFY utility and verifies that the batch Abend-AID load library was correctly built. Investigate any return code other than 0.
  • $12INSTL: Executes the CWINSTAL utility to install the Abend-AID SVC51 Interface. Execute this job with the following criteria:
    • PARM='TEST,jobname,jobname,jobname...': The string of job names can be from one to 95 characters. Jobname can be the name of a specific job name or the initial characters of the job name.
    • The TEST option with the job names or job masks listed indicates that any jobs that abend with that job name or jobs that start with the mask will have the Abend-AID report generated with the new release.
    • Specify the Abend-AID authorized load library hlq.SPAAAUTH containing the CWINSTAL and ABENDAID modules on the //STEPLIB and //ABENDLIB DD statements.

    • Ensure that the Abend-AID viewing server ($65SRVR) and BDCAS ($68BDCAS) long-running jobs are running.

      Note

      Refer to the  for more information about the CWVERIFY and CWINSTAL utilities.

Task 2: Execute the batch Abend-AID IVP jobs

Edit according to the comments in the member and run the following hlq.CTL library member $$IAALOG batch Abend-AID IVP jobs:

  • $71ABTST: Executes the CWABTEST program to cause four abends.
  • $72LECOB: Tests diagnostics for COBOL programs using batch Abend-AID Language Environment support.
  • $73LEPLI: Tests diagnostics for PL/I programs using batch Abend-AID Language Environment support.

  • Test batch Abend-AID Extended Language Support (XLS) for language programs for which your site is licensed, using the jobs listed in the following table:
    Extended Language Support (XLS) IVPs

    $75XLSC1 for COBOL preprocessor 

    $75XLSC2 for COBOL postprocessor

    $75XLSC3 for COBOL preprocessor

    $75XLSC4 for COBOL preprocessor

    $75XLSC5 for COBOL preprocessor

    $75XLSC6 for COBOL preprocessor

    $75XLSP1 for PL/I preprocessor 

    $75XLSP2 for PL/I postprocessor

    $75XLSP3 for PL/I postprocessor

    $75XLSP4 for PL/I preprocessor

    $75XLSA1 for Assembler preprocessor 

    $75XLSA2 for Assembler preprocessor

    $75XLSA3 for Assembler preprocessor

    $75XLSA4 for Assembler preprocessor

  • JCLMQ1 and JCLMQ2: Test Abend-AID for WebSphere MQ support for a COBOL program if your site is licensed for this support.
    Db2 testing if your site is licensed for Abend-AID for Db2 support:

    If you do not have the authority to bind plans, ask your Db2 administrator to run the jobs.

    For COBOL:

    • Member $82nxxxx causes a -310 SQLCODE, and binds the DBRM using Db2 packages.
    • Member $83nxxxx can be used to test Db2 stored procedures support. The sample consists of two COBOL programs, the stored procedure and the application that calls it. The sample stored procedure produces a -407 SQLCODE and the sample application receives a +000 SQLCODE.
    • Member $84nxxxx causes a -818 SQLCODE. For Db2 10.1 or more current in new function mode, this sample produces a -805 SQLCODE instead of the -818 SQLCODE.

    For PL/I:

    • Member $92nxxxx causes a -310 SQLCODE, and binds the DBRM using Db2 packages.
    • Member $93nxxxx can be used to test Db2 stored procedure support. The sample consists of two PL/I programs, the stored procedure and the application that calls it. The sample stored procedure produces a -407 SQLCODE and the sample application receives a +000 SQLCODE.

Each of the IVP jobs generates a batch Abend-AID report. Access the Abend-AID Viewer to verify the reports.

Task 3: Verify Abend-AID for CICS

If your site is not licensed for Abend-AID for CICS, see Configure BMC AMI DevX Workbench for Eclipse integration. 

Perform the following tasks to verify Abend-AID for CICS:

Step 1: Make changes required before verification

Perform the following changes before running the Abend-AID for CICS installation verification program (IVP) jobs:

  1. Add the following DD statements to your CICS region startup JCL, specifying your site’s library names for the current release:

    • //DFHRPL DD Statement
      Append a DD card for the Abend-AID for CICS CICSLIB load library to the library concatenation for the //DFHRPL DD statement. 

      //DD  DSN=SYS1.CMPW.MKFX171.SKFXCLIB,DISP=SHR

    • //FDBDCUST DD Statement
      If you did not add an RDO file entry for the Abend-AID for CICS customization file, you must include a DD statement for the file in the CICS region JCL. 

      //FDBDCUST  DD  DSN=SYS1.CPWR.MKAZ170.CUST.FILE,DISP=SHR

  2. Add CICS Transaction Server for z/OS RDO entries for the CICS versions for which your site desires Abend-AID for CICS support in the Abend-AID Viewer. The resource definition online (RDO) statements for the CICS table entries for Abend-AID for CICS are contained in the job members in the hlq.CTL library. Run the job for each desired CICS version as shown in the following table.
    Abend-AID for CICS RDO Entries

    Member

    Description

    FXRDO750

    Abend-AID for CICS RDO entries and JCL for CICS Transaction Server for z/OS 6.2.0

    FXRDO740

    Abend-AID for CICS RDO entries and JCL for CICS Transaction Server for z/OS 6.1.0

    FXRDO730

    Abend-AID for CICS RDO entries and JCL for CICS Transaction Server for z/OS 5.6.0

    FXRDO720

    Abend-AID for CICS RDO entries and JCL for CICS Transaction Server for z/OS 5.5.0

    FXRDO710

    Abend-AID for CICS RDO entries and JCL for CICS Transaction Server for z/OS 5.4.0

    FXRDOFIL

    Abend-AID for CICS RDO entries and JCL for the transaction abend source listing files (optional).

    FXRDODB

    Abend-AID for CICS RDO entries for Db2.

  3. Add Abend-AID for CICS trace table entries to the new release by running the following jobs to update the trace tables for each CICS Transaction Server for z/OS version for which your site desires Abend-AID for CICS trace support in the Abend-AID Viewer, as shown in the following table.
    Abend-AID for CICS trace table entries

    Member

    Description

    C750LTRC

    Abend-AID for CICS trace entries and JCL for CICS Transaction Server for z/OS 6.2.0

    C740LTRC

    Abend-AID for CICS trace entries and JCL for CICS Transaction Server for z/OS 6.1.0

    C730LTRC

    Abend-AID for CICS trace entries and JCL for CICS Transaction Server for z/OS 5.6.0

    C720LTRC

    Abend-AID for CICS trace entries and JCL for CICS Transaction Server for z/OS 5.5.0

    C710LTRC

    Abend-AID for CICS trace entries and JCL for CICS Transaction Server for z/OS 5.4.0

Step 2: Prepare and run the IVP jobs and the demonstration programs

The Abend-AID for CICS COBOL (CCAADEMO, CCAADEMW, CFDB2IVP, CFDB2IV2, and CCAADEME), PL/I (CCAADEMP), and Assembler (CCAADEMA) demonstration programs located in the installation sample library hlq.CTL illustrate the transaction abend support provided by Abend-AID for CICS. They use a small VSAM file that is created by the process described in this step. You can delete the file when you no longer need it for demonstration purposes.

BMC supplies demonstration transactions to illustrate Abend-AID for CICS transaction abend support and to illustrate Abend-AID for CICS region dump support.

The transaction dump support demonstration transactions are AADM, AADP, AADA, AAON with the T0C7 parameter, and AAEB.

To activate the CCAADEMO, CFDB2IVP, CFDB2IV2, CCAADEMP, CCAADEMA, or CCAADEME program, perform the following procedure:

  1. Allocate and load the demonstration file.

    • Creating this file allows you to use the CCAADEMO, CFDB2IVP, CFDB2IV2, CCAADEMP, or CCAADEMA demonstration program. Modify and run installation sample library hlq.CTL member CCADEFEM to allocate the VSAM KSDS file and load it with five records.

      Note

      A return code of 4 from CCADEFEM is acceptable. If you receive a return code greater than 4, resolve the reason for the return code.

    • Add a DD statement for the demonstration file to the CICS region JCL, if you did not add an entry for the file when you added the other Abend-AID for CICS file entries. For example: 
      //CCAAEMPF  DD  DSN=COMPWARE.CICSAAFX.EMPLOYEE.FILE,DISP=SHR

      You can remove the demonstration file DD statement when the CCAADEMO, CFDB2IVP, CFDB2IV2, CCAADEMP, and CCAADEMA programs are no longer required for demonstration purposes

  2. Compile and link-edit the test programs.
    The programs that are used for transaction analysis demonstration are in members CCAADEMO, CCAADEMW, CFDB2IVP, CFDB2IV2, CCAADEMP, CCAADEMA, and CCAADEME:
    • Compile and link-edit program CCAADEMO and CCAADEMW using JCL in installation sample library hlq.CTL member $79KXCOB, or use your own JCL modified to use the BMC COBOL language processor if your site is licensed for this optional support.

    • Compile and link-edit the CFDB2IVP and CFDB2IV2 programs by using the JCL provided in the installation sample library hlq.CTL $95nxxxx and/or $96nxxxx members, where n is the one-numeric character representing the Db2 release identifier and xxxx is the four-alphanumeric character Db2 subsystem ID for which the JCL was generated. The installation procedure generates one $95nxxxx job and one $96nxxxx for each Db2 subsystem specified in the configuration and customization dialog.
      These jobs have all of the steps to precompile/translate/compile/link/bind both CFDB2IVP and CFDB2IV2 programs. The bind step in the $95nxxxx member binds both CFDB2IVP and CFDB2IV2 DBRMs into a plan named CFDB2IVP. The bind step in the $96nxxxx member binds both CFDB2IVP and CFDB2IV2 DBRMs into a Db2 package collection, and then binds a plan named CFDB2IVP with a Db2 package list.

      Note

      The person who runs these jobs must have bind authority on the designated Db2 subsystem.

      The DBRMs for CFDB2IVP and CFDB2IV2 are bound into a single plan. Alternatively, the DBRMs for CFDB2IVP and CFDB2IV2 are bound into a Db2 package collection, and then a single plan is bound with a Db2 package list. Only a single Db2 entry is required in the CICS resource definition online (RDO) facility (DFHCSD).
      CFDB2IVP is returned a -818 or -805 SQLCODE, resulting in an IVPA abend. CFDB2IV2 is returned a -303 or -304 SQLCODE, resulting in an IVPB abend. The -303 or -304 refers to a mismatch between a host variable and its data type. Add a Db2 entry for the AADM transaction using the resource definition online (RDO) facility for CICS. Use the plan name CFDB2IVP unless the plan name was changed in the bind step of the $95nxxxx or $96nxxxx job. If it was, use that plan name instead.CFDB2IVP and CFDB2IV2 attempt to access the SYSIBM.SYSDBRM catalog table. Because they do not use a test table, they can be run without further Db2 preparation.

    • Compile and link-edit program CCAADEMP using JCL in installation sample library hlq.CTL member $79KXPLI, or use your own JCL modified to test the BMC PL/I language processor if your site is licensed for this optional support.
    • Assemble and link-edit program CCAADEMA using JCL in installation sample library hlq.CTL member $79KXASM, or use your own JCL modified to test the BMC Assembler language processor if your site is licensed for this optional support.
    • Compile and link-edit program CCAADEME using JCL in installation sample library hlq.CTL member JCLMQ4, or use your own JCL modified to test the BMC COBOL language processor if your site is licensed for WebSphere MQ.
      Run the installation sample library hlq.CTL JCLMQDEF member to create the WebSphere MQ queues that are used in Abend-AID for CICS transaction AAEB. You can remove the queues when the CCAADEME program is no longer required for demonstration purposes. Sample JCL for removing the queues is in the installation sample library hlq.CTL member JCLMQDEL.

Step 3: Run the Abend-AID for CICS demonstration transactions

BMC supplies the following Abend-AID for CICS demonstration transactions for verifying the Abend-AID for CICS configuration:

  • AADM for COBOL Source Support: The COBOL AADM transaction uses the VSAM demonstration file that you allocated in Step 2: Prepare and run the IVP jobs and the demonstration programs. To use this transaction, you must have completed all the steps described in that section. In addition, the CFDB2IVP program uses the catalog table SYSIBM.SYSDBRM.
    AADM creates either an ASRA (S0C7), an AEIP, an AEIM, or an IVPA abend. Refer the Abend-AID for CICS User Guide for a description of using Abend-AID for CICS to analyze the ASRA abend created by the AADM transaction.
  • AADM for Db2: The AADM transaction for Db2 uses options 00004 and 00005 with return IVPA and IVPB error codes.
  • AADP for PL/I Source Support: The PL/I AADP transaction uses the VSAM demonstration file that you allocated in Step 2: Prepare and run the IVP jobs and the demonstration programs. To use this transaction, you must have completed all the steps described in that section. AADP creates either an ASRA (S0C7), an AEIP, or an AEIM abend.
  • AADA for Assembler Source Support: The Assembler AADA transaction uses the VSAM demonstration file that you allocated in Step 2: Prepare and run the IVP jobs and the demonstration programs. To use this transaction, you must have completed all the steps described in that section. AADA creates either an ASRA (S0C7), an AEIP, or an AEIM abend.
  • AAON T0C7: T0C7 is a supported AAON transaction option, but it does not appear on the AAON Transaction Options Menu. Refer to the Advanced-configuration for information about the AAON Transaction Options Menu.
  • AAEB for WebSphere MQ: The COBOL AAEB Transaction uses the demonstration WebSphere MQ queues that you created in Task 2: Prepare and run the IVP jobs and the demonstration programs. To use this transaction, you must have completed the applicable steps described in that section.

Each of the IVP jobs generates an Abend-AID for CICS report. Access the Abend-AID Viewer to verify the reports.

Related topics

Configure Abend-AID — new installation

Abend-AID-viewer-configuration-tasks-new-installation

Batch-Abend-AID-configuration-tasks-new-installation

Abend-AID-for-CICS-configuration-tasks-new-installation

Database-support-configuration-tasks-new-installation

IDMS support configuration tasks — new installation

 

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