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.

Abend-AID for CICS configuration Tasks — upgrade

 Do one of the following:

Warning

You must have already completed Abend-AID Viewer Configuration Tasks before configuring batch Abend-AID/Abend-AID for CICS. 

Perform the following tasks to configure Abend-AID for CICS for a new installation of Abend-AID Release 17.02.

Task 1: Configure Abend-AID for CICS

This task utilizes the Abend-AID Configuration and Customization Dialog panels to configure Abend-AID for CICS and creates JCL for all CICS releases that Abend-AID for CICS Release 17.02 supports.

  1. Access the Abend-AID Configuration and Customization Dialog again, or use the End (PF3) key to navigate to the products configuration menu (Abend-AID configuration and customization dialog 17.2 products configuration menu) screen.

  2. Enter S (Select) to the left of the Configure Abend-AID for CICS option.
    The screen shown in the following figure is displayed.

    ------------------------ Implement Abend-AID for CICS ------------------------
    Command ===>
    Enter the correct dataset names below for use in the Abend-AID for CICS dump
    capture jobs. Jobs will be created to support all releases of CICS, but only
    the jobs that support the CICS versions running at your site need to be run.
     CTS Release 5.4 LOAD Lib ===> 'CTS540.CICS.SDFHLOAD'
     CTS Release 5.4 LINK Lib ===> 'CTS540.CICS.SDFHLINK'
     CTS Release 5.5 LOAD Lib ===> 'CTS550.CICS.SDFHLOAD'
     CTS Release 5.5 LINK Lib ===> 'CTS550.CICS.SDFHLINK'
     CTS Release 5.6 LOAD Lib ===> 'CTS560.CICS.SDFHLOAD'
     CTS Release 5.6 LINK Lib ===> 'CTS560.CICS.SDFHLINK'
     CTS Release 6.1 LOAD Lib ===> 'CTS610.CICS.SDFHLOAD'
     CTS Release 6.1 LINK Lib ===> 'CTS610.CICS.SDFHLINK'
     CTS Release 6.2 LOAD Lib ===> 'CTS620.CICS.SDFHLOAD'
     CTS Release 6.2 LINK Lib ===> 'CTS620.CICS.SDFHLINK'
     CICS Dataset Prefix   ===> CICS
     AA Common Load Lib    ===> 'SYS1.CPWR.MKAZ170.SKAZLOAD'
     AA/CICS Load Lib      ===> 'SYS1.CPWR.MKFX171.SKFXLOAD'
     AA Customization File ===> 'SYS1.CPWR.MKAZ170.CUST.FILE'
    Enter "generate" on command line to create the installation JCL.
  3. Verify your site’s data set names for the CICS load and link libraries for the CICS versions that you indicated to be supported during the Configure the Abend-AID Viewer task screen.
  4. Enter the CICS data set prefix, the load library names, and the Abend-AID Viewer customization file name that are correct for your site.

  5. Enter generate on the command line to create the JCL members listed in the $$ICFLOG member of the Abend-AID hlq.CTL library.

    Edit and execute jobs for each currently supported release of CICS Transaction Server for which your site requires viewing support in the Abend-AID Viewer.

    For example, hlq.CTL library member CnnnSYSD adds DSECT support for the CICS Transaction Server for z/OS 5.4, (710), 5.5 (720), 5.6 (730), and so on. The nnn in the member name represents the CICS release. See the following table.

    CICS Transaction Server nnn Values

    CTS Release

    nnn Value

    6.2.0

    750

    6.1.0

    740

    5.6.0

    730

    5.5.0

    720

    5.4.0

    710

Task 2: Implement the Transaction Dump Capture Address Space PARMLIB under CMSC

  1. Review the TDCAS core parameters located in the AATD00 member of the hlq.CTL library.
  2. Edit the AATD00 member to include valid values for your site.
    The last line in the new parameter member is $$$ V2 END $$$ -- DO NOT MODIFY OR REMOVE. This line marks the end of new format and must not be modified or removed.
  3. In order to use the CMSC component, copy the TDCAS parameter data set member AATD00 from the hlq.CTL library to a data set in the //CWPARM DD concatenation in the CMSC JCL, or ask your CMSC administrator to do so.

  4. Update CMSC with AATD00.
    Use the z/OS MODIFY (F) command to update the CMSC with the Abend-AID Viewer PARMLIB member you created or ask your CMSC administrator to do so.

    F cmscname,PARMLIB REFRESH member_name

    Whenever you modify an existing CMSC PARMLIB member or add a new member, you must execute the CMSC REFRESH command to update the contents of the CMSC cache.

Task 3: Activate the Transaction Dump Capture Address Space

  1. Edit member $67TDCAS found in the hlq.CTL library according to the comments in the JCL. In the second step of the job, modify the following EXEC statement:

    //FXTDCAS   EXEC PGM =FDBMMPLU,DYNAMIC=125,TIME-1440,
    //              PARM=’xxxxxxxx,TDCAS,yyyy’,
    //              REGION=8M

    xxxxxxxx is the 1- to 8-character name of this TDCAS. You must define a unique TDCAS name for each TDCAS configured on this MVS image.

    yyyy is the 1- to 4-character suffix of the TDCAS PARMLIB member configured for this TDCAS. The default suffix is 00, but you or the CMSC administrator can change the suffix and it must be specified here. The TDCAS PARMLIB member prefix must be AATD.

  2. Submit $67TDCAS.
  3. Ensure that the TDCAS is active by finding the following message in the JES message log:
    FDBRC1999I REGION INITIALIZATION COMPLETE FOR SERVER xxxxxxxx
    Where xxxxxxxx is the name of this TDCAS

 

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