Skip to Content

Deploy Abend-AID

This milestone identifies the tasks required to deploy the verified Abend-AID Release 17.02 instance to other LPARs in your site’s sysplex.

If you prefer to postpone deployment to a later date, see Troubleshooting.

The following roles are involved for this milestone:

  • Abend-AID installer
  • Abend-AID for CICS installer
  • z/OS system programmer
  • CICS system programmer
  • CMSC administrator
  • Db2 database administrator
  • IMS database administrator

Task 1: Prepare for deployment

Perform the following tasks by role on each LPAR where Abend-AID Release 17.02 is to be installed.

Abend-AID/Abend-AID for CICS installer

  1. Allocate and copy your site’s Abend-AID Release 17.02 SMP/E target libraries listed below to the names that conform to the naming standards on the LPAR they are being written to.
    1. Batch Abend-AID (if deploying batch Abend-AID)
      • hlq.CUST.LOAD
      • hlq.SPAAAUTH
      • hlq.SPAALOAD
      • hlq.SPAALODE
    2. Abend-AID Common Components (all sites)
      • hlq.SKAZAUTH
      • hlq.SKAZLOAD
      • hlq.SKAZREXX
      • hlq.SKAZSAMP
    3. Abend-AID for CICS (if deploying Abend-AID for CICS)
      • hlq.SKFXAUTH
      • hlq.SKFXLOAD
      • hlq.SKFXCLIB
      • hlq.SKFXDSCT
  2. Allocate and copy the following additional libraries and files:
    • hlq.CTL library
    • hlq.FDBDCLST library

    • If you are deploying a new Abend-AID installation, all of the libraries and files that were created for the Abend-AID Viewer, including the Abend-AID report shared directory and databases, the Abend-AID source listing shared directory and databases, and the new or upgraded customization file. 

      Warning

      Note

      If you do not plan to use the CMSC Simple Deploy PARMLIB members DDSNnnnn to contain the data set names of BMC products, such as Abend-AID, Code Debug TSO, File-AID, go to step 4.

       

  3. Review your DDSNnnnn member to ensure the data set names of the BMC run-time libraries at your site for Abend-AID, ECC, and File-AID are correctly provided. A sample member is located in the ECC library hlq.SLCXCNTL(DDSN00).
    If you make changes to the DDSN0000 member, use the z/OS MODIFY (F) command to update the CMSC with the DDSN0000 member you edited or ask your CMSC administrator to do so.
  4. Edit hlq.CTL($66CLST) according to the comments in the member:
    1. Update the SET commands to point to the proper libraries.
    2. Move the CLIST to one of the system CLIST libraries, renaming it to suit your site requirements.
    3. If Abend-AID is invoked from an ISPF panel, edit the panel to point to the updated CLIST name.
  5. Customize the hlq.FDBDCLST CLISTs to allow the seamless integration between batch Abend-AID and File-AID/MVS, File-AID for DB2, and File-AID/IMS and to enable the CSS utilities to be executed from the Abend-AID Viewer. Modify the following CLIST members based on the comments within each member:
    • MFDCCFD2: for File-AID for DB2 integration
    • MFDCFDB2: for File-AID for DB2 integration
    • MFDCFIMS: for File-AID for IMS integration
    • MFDCFMVS: for File-AID/MVS integration
    • MFDCCSSU: for CSS utilities

z/OS system programmer

  1. Add the following current release authorized libraries to the APF:
    • hlq.SPAAAUTH (if deploying batch Abend-AID)
    • hlq .SKAZAUTH (all sites)
    • hlq .SKFXAUTH (if deploying Abend-AID for CICS)
  2. If you are deploying an upgraded release, stop all of the Abend-AID started tasks and the SVC51 interface by entering the following operator commands:
    • S xxxxxxxxx,PARM='STOP' (stop the SVC51 interface)
    • Stop the Abend-AID Viewer.
    • Stop the BDCAS (if upgrading batch Abend-AID)
    • Stop the TDCAS (if upgrading Abend-AID for CICS)

  3. Add the following current release load libraries to the link list:

    • hlq .CUSTLOAD
    • hlq .SPAALOAD
    • hlq .SPAALODE
    Warning

    Note

    Note the following if you are deploying an upgraded batch Abend-AID release:

    1. Add the batch Abend-AID current release load libraries to the link list before the existing load libraries or replace the previous release’s libraries.
    2. Ensure that the Enterprise Common Components (ECC) hlq.SLCXLOAD library appears before the batch Abend-AID load libraries:

  4. Use the z/OS MODIFY (F) command to update the link list:

    F LLA,REFRESH

Db2 database administration

If your site is licensed for Abend-AID for Db2 and/or Abend-AID for CICS for Db2, the Db2 database administrators must run the Abend-AID for Db2 binds and grant security privileges to PUBLIC. Doing so has to be customized for each Db2 subsystem on the LPAR.

CICS system programmer

  1. Add the following DD statements to point to the new release library names:

    • //DFHRPL DD Statement

      //DD DSN=hlq.SKFXCLIB,DISP=SHR

    • //FDBDCUST DD StatementIf you did not add an RDO file entry for the Abend-AID for CICS customization file, you need to replace the library in the following DD statement with the current release customization file.

      //FDBDCUST DD DSN=hlq.CUST.File,DISP=SHR

  2. Add RDO entries for Abend-AID for CICS
    The resource definition online (RDO) statements for the CICS table entries for Abend-AID for CICS are contained in members in the installation sample library hlq.CTL. See the RDO entries table for the member names containing the RDO definitions for each release of CICS Transaction Server. The RDO commands and JCL are provided in the members. The appropriate job must be run to add the RDO definitions for the current Abend-AID for CICS release.
  3. Run the jobs listed in trace table entries to update the Abend-AID for CICS trace tables with the releases of CICS Transaction Server for z/OS running on the LPARs. If multiple releases of CICS are being run in different regions on the same LPAR, run the jobs that reflect the release of CICS in the various regions.

Task 2: Deploy the Abend-AID viewer

Abend-AID/Abend-AID for CICS Installer

  1. Convert hlq.CTL member $65SRVR to a started task, making any desired changes to the JCL for this deployed new or upgraded installation on this LPAR, and move the started task to the system PROCLIB.
  2. Perform the tasks as described in Task 6: Implement the Abend-AID viewer PARMLIB under CMSC in Abend-AID viewer configuration tasks — new installation or Task 6: Implement the Abend-AID viewer PARMLIB under CMSC in Abend-AID viewer configuration tasks — upgrade  .

Task 3: Deploy the BDCAS

Abend-AID Installer

  1. Convert hlq .CTL member $68BDCAS to a started task, making any desired changes to the JCL for this deployed new or upgraded installation on this LPAR, and move the started task to the system PROCLIB.
  2. Complete the tasks as described in  Task 5: Implement the Batch Dump Capture Address Space (BDCAS) PARMLIB under CMSC in Batch Abend-AID configuration tasks — new installation or Task 5: Implement the Batch Dump Capture Address Space (BDCAS) PARMLIB under CMSC in Batch-Abend-AID-configuration-tasks-upgrade.

Task 4: Deploy the TDCAS

Abend-AID for CICS installer

  1. convert  hlq .CTL member $67TDCAS to a started task, making any desired changes to the JCL for this deployed new or upgraded installation on this LPAR, and move the started task to the system PROCLIB.
  2. Complete the tasks as described in Task 5: Implement the Batch Dump Capture Address Space (BDCAS) PARMLIB under CMSC in Batch Abend-AID configuration tasks — new installation or Task 5: Implement the Batch Dump Capture Address Space (BDCAS) PARMLIB under CMSC in Batch-Abend-AID-configuration-tasks-upgrade.

Task 5: Set SYSSSTC for the BDCAS

This task is for the z/OS System Programmer. It should contain, "Change the MVS Workload Manager policy as needed so that the BDCAS is assigned to Service Class SYSSTC." For more information, see Assigning the BDCAS and TDCAS to the SYSSTC service class.

Task 6: Set SYSSTC for the TDCAS

This task is for the z/OS System Programmer. It should contain "Change the MVS Workload Manager policy as needed so that the TDCAS is assigned to Service Class SYSSTC. For more information, see Assigning the BDCAS and TDCAS to the SYSSTC service class.

Task 7: Start the deployed Abend-AID new or upgraded installation

If installing batch ID

  1. Stop the Abend-AID SVC51 Interface.
  2. Start the Abend-AID BDCAS as described in  or Task 6: Activate the Batch Dump Capture Address Space.

If Installing Abend-AID for CICS

Start the Abend-AID TDCAS as described in Activate the Transaction Dump Capture Address Space (TDCAS) or Activate the Transaction Dump Capture Address Space (TDCAS).

If installing batch Abend-AID and/or Abend-AID for CICS

Start the Abend-AID Viewer as described in Task 7: Activate the Abend-AID viewing server in Abend-AID viewer configuration tasks — new installation or Task 7: Activate the Abend-AID viewing server in Abend-AID viewer configuration tasks — upgrade.




 

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

BMC AMI DevX Abend-AID 17.02