Skip to Content
Information
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.

Adding support for new CICS releases

For Abend-AID for CICS only, this section describes how to install support for additional releases of CICS. You will be able to have support for multiple CICS releases at the same time. Use this section to add support in CICS dump capture and the Abend-AID Viewer for any release of CICS Transaction Server (CTS) that is supported by this Abend-AID for CICS release. To remove support for an older CICS release, see Removing-support-for-older-CICS-releases.

The Abend-AID for CICS installation sample library hlq.CTL contains the following sample jobs for each CICS release:

  • CxxxLTRC: Links the trace formatting module for the indicated CICS release.
  • CxxxSYSD: Add the DSECT images for the indicated CICS release to the Abend-AID for CICS system DSECT file.
  • FXRDOxxx: Update the CICS system definition (CSD) file for the indicated CICS release.

The xxx in the member names represents the release level of CICS.

CTS Releases, Values, and FMIDs

CTS Release

xxx Value

English FMID

Japanese FMID

6.3.0760NKFX17EOKFX17E

6.2.0

750

NKFX17D

OKFX17D

6.1.0

740

NKFX17C

OKFX17C

5.6.0

730

NKFX17B

OKFX17B

5.5.0

720

NKFX17A

OKFX17A

5.4.0

710

NKFX179

OKFX179

The rest of this section provides detailed instructions for adding CICS support.

This section provides information about the following tasks:

Task 1: APPLY current maintenance to ECC and existing Abend-AID FMIDs

Enterprise Common Components (ECC) and all existing Abend-AID for CICS and Abend-AID Viewer FMIDs must be at the current maintenance level prior to adding support for a new CICS release.

  1. Contact BMC Support to ensure you have the most current maintenance files. Do one of the following:
    1. Download the files and transfer them to the mainframe.
    2. Contact BMC Support to request current maintenance. Depending on your site’s requirements, you will either receive an email with instructions for obtaining the maintenance or a new installation media containing the current cumulative maintenance file (a CD or CD image). If you received a CD, insert the media into the drive. On the Setup dialog that appears, complete the fields, check the Maintenance Only checkbox, and click Upload.
  2. Apply Abend-AID for CICS maintenance as described in Installing-preventive-maintenance.

  3. Apply ECC cumulative maintenance as described in the BMC AMI Enterprise Common Components.

Task 2: Copy up-to-date configuration dialog members

Installation sample library hlq.CTL member JCLCPCTL contains JCL to copy the members changed in SKAZSAMP by the Abend-AID cumulative maintenance, applied in the previous step, to hlq.CTL. Run hlq.CTL member JCLCPCTL. If JCLCPCTL is not in hlq.CTL, copy it to hlq.CTL from the SKAZSAMP library.

Task 3: Reorder Abend-AID for CICS 17.2 to obtain the new CICS FMIDs

The JCL for job CISAMP is attached to the Product Order Letter email. This job creates a new hlq.INS library. See CTS Releases, Values, and FMIDs table.

Warning

Note

We recommend that you specify a new hlq.INS library to avoid overwriting previously existing members.

Task 4: Select product components

Follow the instructions in the BMC Installer Mainframe Products SMP/E Installation  guide beginning.

  1.  Execute ‘hlq.INS($$CWINST)’.
  2.  Select the Abend-AID for CICS menu.

  3.  Select the new release levels of CICS support you are installing.

    Warning

    Note

    When the message BASE CICS Warning is displayed, you can ignore it. Press Enter to continue.

  4.  Continue with the instructions in the BMC Installer Mainframe Products SMP/E Installation  to generate the required JCL.

Task 5: SMP/E RECEIVE the new FMIDs and the corresponding PTFs to support the additional CICS release

  1.  Review and verify the contents of hlq.INSTLIB member $04RECV.
  2.  Run $04RECV in a job class suitable for long-running jobs.

Task 6: SMP/E APPLY the new FMIDs and the corresponding PTFs

  1. Review and verify the contents of hlq.INSTLIB member $05APPLY.
  2.  Run $05APPLY specifying APPLY CHECK. Once the APPLY CHECK is successful, proceed to the APPLY.
  3.  Run $05APPLY specifying APPLY in a job class suitable for long-running jobs.

Task 7: SMP/E ACCEPT the new FMIDs and the corresponding PTFs

  1.  Review and verify the contents of hlq.INSTLIB member $06ACCPT.
  2.  Run $06ACCPT specifying ACCEPT CHECK. Once the APPLY CHECK is successful, proceed to the ACCEPT.
  3.  Run $06ACCPT specifying ACCEPT.

Task 8: Configure the Abend-AID viewer for CICS

  1. Execute hlq.CTL member KAZRDIAG for the English dialog or KAKRDIAG for the Japanese dialog.
  2.  From the initial dialog screen, select Configuration and press Enter.
  3.  Verify that Enterprise Common Components (ECC) Release 17.02 or more current is installed and that the library names for the various components are correct. Press Enter to continue.
  4.  From the Abend-AID Configuration and Customization Dialog 17.2 products configuration menu, under the Configure Abend-AID Viewer heading, select Abend-AID for CICS. Press Enter to continue.
  5.  On the Abend-AID Viewer Configuration (Screen 1 of 5), verify/change the CICS Transaction Server data set names. Press Enter to continue.
  6.  Proceed through the Abend-AID Viewer Configuration screens until you get to Screen 5 of 5. Enter generate to create the updated JCL.

Task 9: Configure Abend-AID for CICS to integrate the CICS release

 1.  Execute hlq.CTL member KAZRDIAG for the English dialog or KAKRDIAG for the Japanese dialog.

 2.  From the initial dialog screen, select Configuration and press Enter.

 3.  Verify that the ECC Release 17.02 library names for the various components are correct. Press Enter to continue.

 4.  From the Abend-AID Configuration and Customization Dialog 17.2 products configuration menu, select Configure Abend-AID for CICS. Press Enter to continue.

 5.  On the Implement Abend-AID for CICS screen, verify that the data set names are correct. Enter generate to create the updated CTS JCL.

Task 10: Link the trace formatting module

Installation sample library hlq.CTL member CxxxLTRC contains sample JCL to link a copy of the CICS trace formatting module for the CICS release. Review, modify, and submit this JCL. Ensure that:

  • The TLIB DD statement points to your CICS load library for this release of CICS.
  • The SYSLMOD DD statement points to the Abend-AID for CICS nonauthorized load library (SKFXLOAD).
Warning

Note

  • The following message is normal and can be ignored: IEW2646W ESD RMODE(24) CONFLICTS WITH USER-SPECIFIED RMODE(ANY) FOR SECTION section-name CLASS class-name.
  • If you apply IBM maintenance to the CICS trace formatting module DFHTTxxx, where xxx is the CICS release, you must run CxxxLTRC again.
  • Place modules DFHTTxxx in a system link list library. Failure to do so results in messages CSV003I, CSV031I, and IEW4009I when viewing Abend-AID for CICS trace displays.

Task 11: Load the System DSECT File

Installation sample library hlq.CTL CxxxSYSD contains sample JCL to add the CICS DSECT images for the new CICS release to the Abend-AID for CICS system DSECT file. Review, modify, and submit this JCL. Ensure that:

  • The //STEPLIB DD statement points to a concatenation of the following libraries:
    • Abend-AID Common Components target nonauthorized load library (SKAZLOAD)
    • Abend-AID for CICS target nonauthorized load library (SKFXLOAD)
    • ECC load library (SLCXLOAD).
  • The //MSDCCNTL DD statement points to the Abend-AID for CICS DSECT images input distribution library (AKFXDSCT).
  • The //MSDDSECT DD statement points to your current system DSECT file. This file is the system DSECT file you allocated using hlq.CTL library member $61DSECT when you initially installed this Abend-AID for CICS release.
     
Warning

Note

If CxxxSYSD ends with RC=04, verify that Step 7. SMP/E ACCEPT the New FMIDs and the Corresponding PTFs completed successfully.

Task 12: Update viewing server JCL for IPCS support

If you are using IPCS support in a viewing server, add a MFDDPxxx DD statement to the viewing server JCL, where xxx is the CICS release. Ensure that the DD statement points to the CICS load library for the CICS release that contains module DFHPDxxx, where xxx is the CICS release. Adding the statement allows you to use the CICS IPCS VERBEXIT (DFHPDxxx) from within Abend-AID for CICS.
 

Warning

Note

CICS Transaction Server for z/OS V6.3.0, 6.2.0, 6.1.0, 5.6.0, 5.5.0 are represented in Abend-AID for CICS ddnames and member names as 760, 750, 740, 730, 720, respectively.

Task 13: Stop and restart the Abend-AID viewer

After you complete the previous steps, you must stop and then restart the Abend-AID Viewer to enable support for the new release of CICS.

Task 14: Perform updates to CICS

Use the appropriate RDO member FXRDOxxx for your CICS release to update the CICS system definition (CSD) file. See Abend-AID for CICS RDO Entries table for the installation sample library hlq.CTL members to create the RDO definitions.

Review “Abend-AID for CICS configuration tasks” in the Abend-AID Installation and Configuration Guide for any additional modifications that may be required, make any modifications that are needed, and then submit the JCL.

Task 15: Stop and restart the Abend-AID for CICS TDCAS

To enable support for the new release of CICS, you must stop and then restart the Abend-AID for CICS transaction dump capture address space (TDCAS). See Controlling-the-viewing-server-BDCAS-and-TDCAS for information about stopping and starting Abend-AID for CICS.

Task 16: Recycle CICS to enable Abend-AID support for the new CICS release

If CICS is already running, recycle the new release of CICS to pick up the Abend-AID for CICS support for that new release.

 

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

BMC AMI DevX Abend-AID 17.02