Abend-AID viewer configuration tasks — new installation

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

Task 1: Access the configuration and customization dialog

1. Access the Abend-AID configuration and Customization Dialog 17.02 by executing the following command on the TSO command line, specifying your site’s Abend-AID installation sample library name, followed by the member name KAZRDIAG. For example: 

   TSO EX 'hlq.CTL(KAZRDIAG)'

2. Upon your first time accessing the Abend-AID configuration and customization dialog 17.02, the screen shown in the following figure displayed:

   ---------------------- Migrate SMP/E Installation Values ---------------------
   Command ===>
   The Configuration and Customization dialog can be populated with values that were set either in the ISPF SMP/E dialog or the media browser. If you SMP/E installed using the BMC AMI DevX Common Installation, enter the DSN of the file that contains the stored ISPF tables.
   ===>
   If you SMP/E installed using the Media Browser, enter the DSN of the SMPE.DATA file created during file upload.
   ===>
   If you have not used any of the above mentioned methods, clear or leave the above fields blank and press ENTER to accept the default values for this dialog. Press Enter to load values and continue. Press End to exit this dialog.
   Press Enter to load values and continue. Press End to exit this dialog.
3. Do one of the following:
   
   • If you used the new Release 17.02 Receive From Network (RFN) SMP/E installation procedure described in the BMC Installer Mainframe Products SMP/E Installation Guide, enter the data set name of the file you specified to store your ISPF installation tables. The default is hlq.CPWR.INSTLIB. However, if you SMP/E-installed more than one BMC product at different times, you may have more than one data set that you renamed to avoid overwriting your specified values.
   • If you used the media browser interface to SMP/E-install the product files as described in the BMC Installer Mainframe Products SMP/E Installation Guide, enter the SMPE.DATA data set name. The name is displayed at the bottom of the media browser. The default is SYS1.CPWR.COMMON.BCnnnnnn.SMPE.DATA.
   •  If you used neither of the above two methods to SMP/E-install the product files, press the Enter key to use the default values.
     Respond to the displayed confirmation message.

   • Each of the above options displays the installation dialog menu shown in the following figure. Any future time you access this installation dialog again, this screen is displayed.

     ----------- Abend-AID Configuration and Customization Dialog 17.02 ----------
      Command ===>                                                                   
      Welcome to the Abend-AID Configuration and Customization Dialog. This dialog   
      will be used to configure and customize Abend-AID, Abend-AID for CICS and      
      the Abend-AID Viewer. The SMP/E install must be completed before this dialog   
      can be used.                                                                   
                                                                                    
      To view new features, position cursor here: what's new and press Enter.        
                                                                                    
      Type an S next to the appropriate option and press Enter to continue.          
                                                                                    
           Configuration                                                              
4. Select the Configuration option by entering the S (Select) line command next to it. The screen shown in Access Abend-AID configuration dialog Menu is displayed.

Task 2: Verify ECC is installed

ECC Release 17.02 or more current must be installed to continue with the installation of Abend-AID. The Abend-AID installation procedure also requires a License Management System (LMS) and Host Communications Interface (HCI).

Access Abend-AID Configuration Dialog Menu

Step 1: Determine the ECC installation status

Option 1: Enterprise Common Components (ECC) is not installed at this site. Refer to the BMC Installer Mainframe Products SMP/E Installation Guide for instructions to complete the ECC SMP/E installation. After completing that installation, you can return here and continue with the Abend-AID installation.

Option 2: ECC is already installed. This option begins the Abend-AID installation configuration process. Leave the Prev Release DSN field blank and press Enter to continue, using Abend-AID/Abend-AID for CICS for CICS Release 17.02 defaults.

After you either verify that ECC is already installed or you have completed its installation, continue with Option 2 and press the Enter key to access the screen shown in the following figure.

Step 2: Specify ECC libraries

Perform the following steps to specify ECC libraries:

1. Enter the appropriate Enterprise Common Components (ECC) library names for use with this Abend-AID release.
   These libraries are used throughout the installation process. They were created during the ECC installation. The following libraries are required if you are installing Abend-AID, Abend-AID for CICS for CICS, the Abend-AID Viewer, or data base support.
   • ECC Auth Library — Authorized library data set name for ECC (SLCXAUTH).
   • ECC Load Library — Target load library data set name for ECC (SLCXLOAD).
   • ECC Sample Library — Sample library used for ECC installation (SLCXCNTL).
   • ECC REXX Library — Library containing the REXX programs from the ECC installation. The SLCXEXEC library is created during ECC installation.
   • ECC Message Library — Message library from the ECC installation (SLCXMENU).
   • ECC Panel Library — Panel library from the ECC installation (SLCXPENU).
   • ECC Table Library — Table library from the ECC installation (SLCXTABL).
   • ECC Skeleton Library — Skeleton library from the ECC installation (SLCXSENU).
2. Enter the information for the job card at the bottom of the screen.
3. Press the Enter key to continue and to display the products configuration menu shown in Abend-AID configuration and customization dialog 17.2 products configuration menu shown in Task 3: Access the product configuration menu.

Task 3: Access the product configuration menu

From the Abend-AID Configuration and Customization 17.02 Dialog products configuration menu, under the Configure Abend-AID Viewer heading, select Abend-AID and/or Abend-AID for CICS.

Abend-AID Configuration and Customization Dialog 17.2 Products Configuration Menu

The screen shown in Abend-AID viewer configuration is displayed in Task 4: Complete the Abend-AID viewer configuration screens.

Task 4: Complete the Abend-AID viewer configuration screens

Abend-AID Viewer Configuration (Screen 1 of 5)

Perform the following steps to complete the Abend-AID viewer configuration:

1. Verify that the displayed Abend-AID load library name, the Abend-AID for CICS high-level qualifier name, and the Abend-AID Common Components nonauthorized load library are correct for your site.

2. Specify the correct CICS Transaction Server load and link library names for your site.

   Note

   If you receive a pop-up error message that any of the CICS libraries are not found, either press the END (PF3) key to correct the names or press Enter to continue without these libraries.

3. Press the PF8 (NEXT) key to proceed to the screen displayed in the following figure:

   Abend-AID Viewer Configuration (Screen 2 of 5)

   ----------- Abend-AID Viewer Configuration (Screen 2 of 5) --------------------
   Command ===>
                                                                         More: - +
                                                     PF7=PREV PANEL PF8=NEXT PANEL
   
   The Abend-AID Viewer uses one shared directory for reports. The Default
   Shared Directory for reports must have at least one database attached.
   
   Enter the dataset name below that will be used as your Default Shared
   Directory.
   
   Dataset Name of New or Existing Report Shared Directory
   ===> 'SYS1.CPWR.MKAZ170.SHDRRPT'
              TYPE: SHARED DIRECTORY
              Number attached Tran Report DBs: 6
              Number attached Batch Report DBs: 11
   Go to the next panel.
4. Enter the name of a new report shared directory.
   A pop-up window is displayed, indicating that the default shared directory does not exist.

5. Press the Enter key to allocate the new report shared directory.
   The  BMC AMI CSS Utilities screen shown in the following figure is displayed.

   ---  BMC AMI CSS UTILITIES - CREATE/FORMAT Shared Directory ----- CSS 17.2.0
   COMMAND ===>
   Commands: SEtup A (Advanced Parms)
             DD (DDIO tutorial)   SD (SD/DB tutorial)   LP (LP tutorial)
         Dataset Name ===> 'SYS1.CPWR.MKAZ170.SHDRRPT'
          Preparation ===> EDITJCL (Batch/Editjcl/Foreground)
           Reallocate ===> NO (Yes/No)
            Model DSN ===> 'AC.R1702.DEV.SHDRRPT'
        Storage Class ===> (optional, unless site requires)
     Management Class ===> (optional, unless site requires)
           Data Class ===> (optional, unless site requires)
               Volume ===> (optional, unless site requires)
          Space Units ===> TRACKS (Blocks/Tracks/Cylinders)
     Primary Quantity ===> 70 ( <= 5 cylinders for most installations)
            OR
    Number of Entries ===> (optional)
   (This field overrides above space parms & calculates space needed)
        Press ENTER to process or enter END command to terminal
6. Complete the required fields.
7. Press the PF1 (HELP) key to access the CSS Utilities Tutorial for further explanations.
8. In the Preparation field, specify one of the following:
   • EDITJCL: To build, verify/edit, and manually submit the JCL for the new report shared directory.
   • FOREGROUND: To dynamically allocate and format the new report shared directory from ISPF in your TSO session.
   • BATCH: To automatically submit the allocation/formatting JCL for the new report shared directory.
9. Press the Enter key to create the new report shared directory.
10. Press the END (PF3) key to return to the Abend-AID Viewer configuration screen.
    A pop-up window is displayed, indicating that the default report shared directory does not have any batch report databases attached to it. At least one attached database is required for batch Abend-AID.
    If you instead selected only the Abend-AID for CICS option under the Abend-AID viewer heading on the products configuration menu, a pop-up window is displayed, indicating that the default shared directory does not have any transaction report databases attached to it. At least one attached database is required for Abend-AID for CICS.

11. Press the Enter key to allocate and attach a batch/transaction report data base.
    The  BMC AMI CSS UTILITIES - Create/Format Report Database screen as show in following figure is displayed.

    -----  BMC AMI CSS UTILITIES - Create/Format Report Database ---- CSS 17.2.0
    COMMAND ===>
    Commands: SEtup A (Advanced Parms) DDCV (DDIOCalc Values)
    DD (DDIO tutorial) SD (SD/DB tutorial) LP (LP tutorial)
        Dataset Name ===> 'ENTER.NEW.REPORT.DATABASE.HERE'
    
    
         Preparation ===> EDITJCL(Batch/Editjcl/Foreground)
     DS Organization ===> VSAM (Vsam/Sequential)
          Reallocate ===> NO (Yes/No)
                TYPE ===> BATCH (BATCH/CICS)
           Model DSN ===>
       Storage Class ===> (optional, unless site requires)
    Management Class ===> (optional, unless site requires)
          Data Class ===> (optional, unless site requires)
              Volume ===> (optional, unless site requires)
                Unit ===> (optional, unless site requires)
        
         Space Units ===> TRACKS (Blocks/Tracks/Cylinders)
    Primary Quantity ===> 200
    Number of Members ===> 500 (1 to 16000)
    Shared directory ===> 'SYS1.CPWR.MKAZ170.SHDRRPT'
    
         Press ENTER to process or enter END command to terminate

12. Allocate a new batch/transaction report database using the CSS utilities.

    Note

    To allocate a new batch/CICS report database using the CSS utilities, do the following:

    1. Press PF1 (HELP) to access the CSS Utilities Tutorial for further explanations.
    2. Ensure that you specify TYPE=BATCH for batch Abend-AID report databases, and TYPE=CICS for Abend-AID for CICS transactions databases when creating these databases.
    3. Ensure that you specify the Abend-AID Viewer target nonauthorized load library (SKAZLOAD) in the CSS setup for creation of the Abend-AID report/transaction databases.
    4. In addition to the CSS online help, refer to the BMC AMI Common Shared Services User/Reference Guide for information about using the CSS Utilities and how to modify your compile JCL to run the BMC COBOL, PL/I, and Assembler language processors. This guide is available https://www.bmc.com.
    5. If your site is using an external security package, all users require UPDATE authority to the report shared directory and its attached data bases. See Specifying Access to Report/Transaction Databases.

13. Press the PF3 (END) key to return to the Abend-AID viewer configuration screen.
    The number of attached batch report databases is displayed beneath the report shared directory data set name.
    If you also selected the Abend-AID for CICS option under the Abend-AID Viewer heading on the products configuration menu, a pop-up window is displayed, indicating that the default report shared directory does not have any transaction report databases attached to it. At least one attached database is required for Abend-AID for CICS. Press the Enter key to display BMC AMI CSS UTILITIES - create/format report database screen again and to allocate at least one transaction report database.
14. Press the PF3 (END) key to return to the Abend-AID Viewer configuration screen.
    The number of attached batch/transaction report databases is displayed beneath the report shared directory data set name.

15. Press the PF8 (NEXT) key to proceed to the screen displayed in following figure.

    ----------- Abend-AID Viewer Configuration (Screen 3 of 5) --------------------
    Command ===>
                                                                          More: - +
                                                      PF7=PREV PANEL PF8=NEXT PANEL
    The Abend-AID Viewer uses BMC Source Listing datasets to provide source
    support in Abend-AID reports. Each site must have one source listing shared
    directory to be used by the Abend-AID Viewer.
    The BMC source listing files will be allocated to the MFDDXLSF DD in the
    viewing server startup JCL. Additional datasets can be entered below or the
    JCL can be edited after it is generated.
    
    Dataset Name of New or Existing Source Listing Shared Directory
    ===> 'SYS1.CPWR.MKAZ170.SHDRLST'
               TYPE: SHARED DIRECTORY
                     Number attached Source Listing DBs: 2
    Additional Source Listing Datasets(optional)
    ===>
    ===>
    ===>
    ===>
    
    Go to the next panel.
16. Enter a new source listing shared directory name to allocate a source listing shared directory using the BMC AMI Common Shared Services (CSS) utilities screen.
17. Complete the required fields.
18. Press the PF1 (HELP) key to access the CSS Utilities Tutorial for further explanations.
19. Press the Enter key to dynamically allocate the new source listing shared directory.
20. Press the PF3 (END) key to return to the Abend-AID viewer configuration (screen 3 to 5).
    A pop-up window is displayed, indicating that the default source listing shared directory does not have any source listing databases attached to it. At least one attached source listing database is required for the Abend-AID Viewer.

21. Press the Enter key to allocate and attach a new source listing database.
    The CSS Utilities Create/Format Source Database screen as shown in following figure is displayed.

    -----  BMC AMI CSS UTILITIES - Create/Format Source Database ---- CSS 17.2.0
    COMMAND ===>
    Commands: SEtup A (Advanced Parms) DDCV (DDIOCalc Values)
    DD (DDIO tutorial) SD (SD/DB tutorial) LP (LP tutorial)
    
    Dataset Name ===> 'ENTER.NEW.SOURCE.DATABASE.HERE'
    Preparation  ===> EDITJCL(Batch/Editjcl/Foreground)
     DS Organization ===> VSAM(Vsam/Sequential)
          Reallocate ===> NO(Yes/No)
           Model DSN ===>
       Storage Class ===> (optional, unless site requires)
    Management Class ===> (optional, unless site requires)
          Data Class ===> (optional, unless site requires)
              Volume ===> (optional, unless site requires)
                Unit ===> (optional, unless site requires)
    
         Space Units ===> TRACKS (Blocks/Tracks/Cylinders)
    Primary Quantity ===> 200
    Number of Members ===> 500 (1 to 16000)
    Shared directory ===> 'SYS1.CPWR.MKAZ170.SHDRLST'
    
    Press ENTER to process or enter END command to terminate
22. Complete the required fields.
23. Press the Enter key to dynamically create the source listing database.
24. Press the PF3 (END) key to return to the Abend-AID Viewer configuration (screen 3 to 5).
    The number of attached source listing databases is displayed below the source listing shared directory data set name.

25. If desired, enter additional existing source listing data sets to be used with this viewing server.

    You can also create additional source listing data sets outside the installation dialog to be used with this viewing server. Use sample JCL members provided in the ECC target sample library (hlq.SLCXCNTL). Refer to the  Enterprise Common Components Installation and Configuration Guide for more information.

26. Press the PF8 (NEXT) key to proceed to the screen displayed in following figure.

    ------------ Abend-AID Viewer Configuration (Screen 4 of 5) --------------------
    Command ===>
                                                                           More: - +
                                                        PF7=PREV PANEL PF8=NEXT Panel
    Abend-AID Viewer Global Compiler Listing Dataset
    The Abend-AID Viewer provides source support for abending programs
    using program compiler listings. Enter the name of a partitioned dataset below
    that contains program compiler listings. This dataset is optional but is
    required if you want to provide source support using program compiler listings.
    It will be available to all users of this Abend-AID Viewer.
    
    A partitioned dataset that contains your program compiler listings:
    (will be allocated to DDNAME MFDDLIST in the Abend-AID Viewer JCL):
             ===> ‘SYS1.CPWR.MKAZ170.VIEWER.COMPILER.LISTINGS’
    
    Additional datasets can be concatenated to the DDNAME by editing the JCL for
    the viewer. The generated JCL for the viewer will be contained in
    installation member $65SRVR. In addition, we recommend that you review the
    Abend-AID Installation Manual.

27. Enter the name of an existing partitioned data set that contains compiler listings to provide source support for abending programs and to be available to all users of this viewing server.

    Note

    You can concatenate additional compiler listing data sets to the //MFDDLIST DD statement outside the installation dialog by editing the $65SRVR JCL member of the Abend-AID installation sample library (hlq.CTL).

    We recommend that you specify at least one compiler listing. If you do not want to use your IBM compiler listings for Abend-AID source support, leave this line blank and the JCL will be generated without a reference to this file.

28. Press the PF8 (NEXT) key to proceed to the screen displayed in following figure.

    ----------- Abend-AID Viewer Configuration (Screen 5 of 5) -------------------
    Command ===>
                                                                           More: -
                                                                    PF7=PREV PANEL
    The Abend-AID Viewer requires a customization file. An existing viewer
    customization file can be converted and used for this release or a new
    customization file can be created. Enter the dataset name on the
    appropriate line.
    New Customization File      ===> 'SYS1.CPWR.MKAZ170.CUST.FILE'
    Existing Customization File ===> ‘SYS1.CPWR.MKAZ160.CUST.FILE’
    
    Does this site use JES2? ===> Y (Y/N)
    
    AA Customization Load Lib ===> 'SYS1.CPWR.MPAA170.CUST.LOAD'
    
    Enter four high-level qualifiers to be used to generate JCL which will create and utilize the Abend-AID Viewer workfiles.
    VSAM Workfile High Level Qualifier ===> SSST
    Non-VSAM Workfiles High Level Qualifier ===> HLQX
    CWPDDIO Scratch-Pad High Level Qualifier ===> MSSY
    CWPESS ESS High Level Qualifier             ===> xxxx
    
    Enter "generate" on command line to create the installation JCL.
29. Because you are configuring a first-time Abend-AID installation, specify only a new Abend-AID Viewer customization file name to create a new Abend-AID Viewer customization file.
30. Does your site use JES2 (Y or N)?
31. Verify that your site’s new Abend-AID Release 17.02 customization load library name is correct. If not, change it. This library is a repository for batch Abend-AID customization modules such as CWDB2OPT and CWJESTAB.
32. Specify a high-level qualifier for each of the following data set names:
    • VSAM work file
    • Non-VSAM work file
    • Scratchpad listing file (CWPDDIO)
33. Enter generate on the command line to create the configuration jobs listed in the hlq.CTL library member $$VWRLOG.

Task 5: Run the Abend-AID viewer generated jobs

Edit according to the comments in the member and run the following hlq.CTL library member $$VWRLOG jobs to create a new instance of the Abend-AID Viewer:

• $60CUSTL: Allocates the customization load library you specified.   

• $61DSECT: Allocates and formats the 

  Abend-AID

   and/or Abend-AID for CICS system DSECT file

• $61MVSD: Adds the formatted MVS DSECTS to the DSECT file

• $62CUST: Allocates the VSAM customization file and loads default records based on the customization information that you entered.  

  Warning

  If you deploy the Abend-AID Viewer to other LPARs, unless you share the same VSAM customization file allocated by the $62CUST job member across LPARs, you must run this job member again on each additional LPAR.

  In addition, ensure that the BDCAS and/or TDCAS started tasks on each LPAR point to the associated customization file.

• $63INFO: Allocates and initializes the dump information file
• $63IPCS: Allocates and initializes the IPCS dump directory
• $63PDSM: Allocates and initializes the persistent data file
• $63WORK: Allocates the viewing server work file

• $65SCPY: Allocates and populates the 

  Abend-AID

   Viewer FDBDCLST CLIST library

• $65SCRT: Allocates a Scratchpad source listing DDIO file

• $65SRVR: Reorganizes the 

  Abend-AID

   dump information file and brings up the 

  Abend-AID

   viewing server. See Task 7: Activate the Abend-AID viewing server for more details.

• $66CLST: Invokes the Abend-AID Viewer for TSO/ISPF viewing access

  Note

  If you plan to implement the CMSC Simple Deploy method for specifying BMC product DDNAMES and data set names in Abend-AID CLISTs and REXX EXECs, refer to the Release 17.02  Enterprise Common Components Installation and Configuration Guide for more information. Verify that the default data set names defined in the ECC SLCXCNTL library member DDSNnnnn are correct for your site or change them to conform to your site’s standards. If you make changes to the DDSNnnnn member, use the z/OS MODIFY (F) command to update the CMSC with the DDSNnnnn member you edited or ask your CMSC administrator to do so.

  Refer to the comments in the $66CLST hlq.CTL member for additional instructions.

  Refer to the Abend-AID Advanced Configuration for more information about configuring the Abend-AID Viewer for TSO/ISPF access.

  Task 6: Implement the Abend-AID viewer PARMLIB under CMSC

  Depending upon your site’s security requirements, in addition to the Abend-AID installer, the CMSC administrator may also be required for this task.

  Abend-AID parameters are managed by the BMC AMI Common Mainframe Services Controller (CMSC). The CMSC component is SMP/E-installed with Enterprise Common Components (ECC) as described in Installing and configuring Enterprise Common Components. This address space is a centralized facility that provides BMC Common parameter library services. This facility functions in a similar manner to the IBM z/OS PARMLIB. Abend-AID requires CMSC to be installed for all Common PARMLIB processing.

  Perform the following tasks to implement the Abend-AID viewer PARMLIB under CMSC:

  Step 1: Review the Abend-AID viewer parameters

  Perform the following steps to Review the Abend-AID viewer parameters:

  1. Review the 

     Abend-AID

      Viewer core parameters located in the AAVW00 member of the hlq.CTL library.
     
     While most parameters have a default setting, some parameters are site-specific and should be reviewed at installation time. The AAVW00 member should contain the values you want for all LPARs on which 

     Abend-AID

      and Abend-AID for CICS are installed.

  2. Edit the AAVW00 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. Review the 

     Abend-AID

      Viewer comprehensive parameters member, AAVWALL, in the 

     Abend-AID

      hlq.CTL library.
     
     This member contains additional 

     Abend-AID

      Viewer parameters. Refer to the Abend-AID Advanced Configuration for a complete description of installation parameters that control 

     Abend-AID

      functions.

  4. Edit and copy any additional parameters needed at your site from the AAVWALL member to the AAVW00 member.

  Step 2: Create PARMLIB member AAVW00

  In order to use the CMSC component, copy the Abend-AID Viewer parameter data set member AAVW00 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.

  Step 3: Update CMSC with AAVW00

  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.

  Refreshing a Single Parameter Member

  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 7: Activate the Abend-AID viewing server

1. Edit member $65SRVR 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:

   //AAVIEW EXEC PGM =FDBMMPLU,DYNAMIC=125,TIME-1440,
   // PARM=’xxxxxxxx,VIEWER,yyyy’,
   // REGION=64

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

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

2. Submit hlq.CTL library member $65SRVR.

3. Ensure that the server is active by finding the following message in the JES message log: 

   FDBRC1999I REGION INITIALIZATION COMPLETE FOR SERVER xxxxxxxxWhere xxxxxxxx is the name of the Abend-AID viewing server

4. Test access to the 

   Abend-AID

    Viewer:

• 
  
  • For TSO/ISPF access, execute $66CLST located in hlq.CTL.
  • For VTAM access, log on using the defined APPLID.

 If the Abend-AID Viewer is configured correctly, the Fault Summary screen is displayed as shown in the following figure.