Batch Abend-AID configuration tasks — upgrade

If your site is not licensed for batch Abend-AID, go to Abend-AID for CICS Configuration Tasks Abend-AID-for-CICS-configuration-Tasks-upgrade.

Note

You must have already completed Abend-AID-viewer-configuration-tasks-upgrade before configuring batch Abend-AID/Abend-AID for CICS.

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

Task 1: Configure batch Abend-AID

This task utilizes the Abend-AID Configuration and Customization Dialog panels to configure batch Abend-AID.

Complete the batch Abend-AID screens

Access the Abend-AID Configuration and Customization Dialog again, or press the END (PF3) key to navigate to the products configuration menu (Abend-AID configuration and customization dialog 17.2 products configuration menu Figure).
Enter S (Select) to the left of the Configure Abend-AID option.
The screen shown in the following figure is displayed.
--------------- Abend-AID Configuration (Screen 1 of 6) ---------------------- Command ===>
More: +
PF8=NEXT PANEL

Configuring Abend-AID consists of creating/migrating report routing
information and batch Abend-AID global options, as well as creating
the Installation Verification (IVP) jobs.

Abend-AID Load Lib ===> 'SYS1.CPWR.MPAA170.SPAALOAD'
AA Common High Level Qualifier ===> SYS1.CPWR.MKAZ170
AA Customization File ===> 'SYS1.CPWR.MKAZ170.CUST.FILE'
AA Customization Load Lib ===> 'SYS1.CPWR.MPAA170.CUST.LOAD'
AA Source Report Shared Directory
===> ‘SYS1.CPWR.MKAZ170.SHDRRPT’
AA Source Listing Shared Directory
===> 'SYS1.CPWR.MKAZ170.SHDRLST'

Go to the next panel.
Verify that the displayed Abend-AID load library name, the Abend-AID Common Components high-level qualifier name, the customization file name, the customization load library name, the report shared directory name, and the source listing shared directory name are correct for your site.
If not, correct the names.
Press the PF8 (NEXT) key to display the screen shown in the following figure:
------- Abend-AID Configuration: Report Routing (Screen 2 of 6) --------------
Command ===>
                                                                    More: - +
                                                PF7=PREV PANEL PF8=NEXT PANEL

This configuration dialog provides for the creation/migration of Report
Routing information in the Abend-AID Customization file.

If you already have Report and Listing Datasets and a Routing Criteria load
module (CWROUTE) that you want to import from a previous release, enter
the name of the load library where that information is currently located
below. Otherwise, leave blank and the Customization file will be updated using settings where all Abend-AID reports will be written to the site default
shared directory.

Existing Load Library ===>

Go to the next panel.
If you are upgrading from Abend-AID Release 12.2 or less current and you have a CWROUTE module whose values you would like to use, specify the customization load library file in the Existing Load Library name field. Otherwise, leave this line blank to create only the default routing option of routing all Abend-AID reports to the site default report shared directory.
Press the PF8 (NEXT) key to display the screen shown in the following figure:
---- Abend-AID Configuration Batch Global Options (Screen 3 of 6) ------------
Command ===>
                                                                     More: - +
                                                 PF7=PREV PANEL PF8=NEXT PANEL
This customization dialog provides for the creation/migration of Batch
Abend-AID Global Options in the Abend-AID Customization file.

If you already have a Global Options load module (CWGLOBAL) that you want
to import from a previous release, enter the name of the load
library where that load module is currently located below. Otherwise, leave
blank and the Customization file will be updated using the default values for
all Global Options.

Existing Load Library ===>

Go to the next panel.
If you are upgrading from Abend-AID Release 12.2 or less current and you have a CWGLOBAL module whose values you would like to use, specify the customization load library file in the Existing Load Library name field. Otherwise, leave this field blank to create batch Abend-AID global options using the Abend-AID installation default values.
Press the PF8 (NEXT) key to display the screen shown in Figure.
New, BMC-recommended JES2 Support Method One
If your site is not using JES2, go to step 12.
Depending on your site’s security requirements, your z/OS administrator may be required to provide the z/OS SMP/E Global CSI DSN and the z/OS SMP/E Target Zone name.
PTF ACF495Y provides an alternate, BMC-recommended method of making CWJESTAB available to Abend-AID by applying USERMOD PAAJES2 to JES2. Member PAAJES2 in the SKAZSAMP library contains a sample job to apply the USERMOD. Before running the job, customize it for your environment.
Member PAAJES2 in the SKAZSAMP library contains a sample job to apply the USERMOD. Before running the job, customize it for your environment.
1. If you have not done so, copy member PAAJES2 from SKAZSAMP to your hlq .CTL library.
2. Update the JOB card and JOBPARM to meet your installation standards.
3. Specify the DSNAME of your MVS global CSI.
4. Specify the target zone name where JES2 is applied.
5. Specify ALIAS names to match the CWJTxxxx modules that you have in your hlq .CUST.LOAD sample library that will be used with the target IPL volume.
When you apply the USERMOD, SMP/E will install the CWJESTAB module in the SYS1.LINKLIB data set on that target zone. When that IPL volume (or a copy of it) is IPLed, Abend-AID will find the CWJESTAB module in SYS1.LINKLIB that will match the JES2 on that volume.
Once the USERMOD is applied, any JES2 maintenance that updates the macros used to assemble CWJESTAB will cause SMP/E to automatically reassemble CWJESTAB, keeping it updated along with JES2.
We recommend this new method for making CWJESTAB available to Abend-AID. Using this method makes running the $09ASMJT, $10SMPU1, JCLSMPDD, or JCLSMPU2 jobs no longer necessary. Skip to Step 12 below.
-------- Abend-AID Configuration: JES2 Support (Screen 4 of 6) ---------------
Command ===>
More: - +
PF7=PREV Panel PF8=NEXT PANEL

Enter parameters below specific to your site to create the Abend-AID
CWJESTAB.

z/OS SMP/E Global CSI DSN ==> 'ZOS.SMPE.GLOBAL.CSI'
z/OS Target Zone Name ==> OSTZONE
SMP/E Usermod Name to Use ==> AAJESTA

There is no USERMOD required for sites using JES3. If you are using
JES3, please PF8 to bypass this step.

Go to the next panel.
Less Current, Alternative JES2 Support Method Two
Note
BMC still supports the following less current, alternative method for implementing JES2 support.
Depending on your site’s security requirements, your z/OS administrator may be required to provide the z/OS SMP/E Global CSI DSN and the z/OS SMP/E Target Zone name and to run the generated jobs.
Specify your site’s SMP/E Global CSI data set name and Target Zone name where JES2 was installed.
Specify a maximum 8-character name for the SMP/E USERMOD name.
Press the PF8 (NEXT) key to display the screen shown in the following figure.
------------ Abend-AID Configuration: IVP (Screen 5 of 6) --------------------
Command ===>
More: - +
PF7=PREV PANEL PF8=NEXT PANEL
Supply the appropriate parameters below in order to generate the jobs that
will execute the IVPs to verify Abend-AID diagnostic support for COBOL.

Select the supported COBOL compiler used at your site:
COBOL Z/OS ===> Y (Y/N)

COBOL Compiler Library ===> 'IGY.SIGYCOMP'
COBOL Runtime Library ===> 'CEE.SCEERUN'
COBOL LKED Library ===> 'CEE.SCEELKED'

SORTLIB Dataset Name ===> 'SYS1.SORTLIB'

Go to the next panel.
Complete the fields on this screen with values appropriate for your site if your site requires Abend-AID support for Enterprise COBOL for z/OS.
Press the PF8 (NEXT) key to display the next screen, shown in the following figure.
------------ Abend-AID Configuration: IVP (Screen 6 of 6) --------------------
Command ===>
More: -
PF7=PREV PANEL
Supply the appropriate parameters below in order to generate the jobs that
will execute the IVPs to verify Abend-AID diagnostic support for PL/I.

Select the supported PL/I compiler used at your site:
PL/I Enterprise ===> Y (Y/N)

PL/I Compiler Library ===> 'IBMZ.SIBMZCMP'
PL/I Runtime Library ===> 'CEE.SCEERUN'
PL/I LKED Library ===> 'CEE.SCEELKED'

Enter parameters below specific to your site to create the Abend-AID
CWJESTAB.

Assembler Macro Library ==> 'SYS1.SHASMAC'

Enter "generate" on command line to create the installation JCL.
Complete the fields with PL/I values appropriate for your site if your site requires Abend-AID support for Enterprise PL/I for z/OS.
If your site uses JES2, enter your site’s Assembler macro library name.
Enter generate on the command line to create the batch Abend-AID jobs to be listed into the $$IAALOG in the Abend-AID hlq .CTL library.

Task 2: Implement JES2 USERMOD (for JES2 sites only)

If you used New, BMC-recommended JES2 Support Method One, skip this section and continue with Task 4.10. Otherwise, continue with Task 4.10.

For sites using JES2, the file section of the Abend-AID report provides extensive information about JES2 (SYSOUT) files. This reporting requires the Abend-AID load module CWJESTAB that is based on the particular version and maintenance level of JES2 that you are running. Whenever a new level of JES2 is installed or any type of SMP/E JES2 maintenance is applied, hlq.CTL members $09ASMJT and $10SMPU1 must also be run. Refer to the Advanced-configuration for more information about the JES2 USERMOD.

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

$09ASMJT: Loads the JES2 DSECTS into the CWJESTAB module in the hlq.CUST.LOAD library. This job also generates another JES2 DSECT load module with the format of CWJTxxxx, where xxxx is the SYSID of the LPAR. You can then maintain multiple JES2 DSECT modules distinguished by the SYSID. Refer to the Advanced-configuration for more information about implementing JES2 support in Abend-AID.
$10SMPU1: Performs an SMP/E UCLIN of the target zone to associate a USERMOD name with the JES2 macros used to assemble CWJESTAB.
JCLSMPDD: Not included in the $$IAALOG of generated jobs, but included in the hlq.CTL library performs an SMP/E LIST DDDEF to list the DDNAMEs and DSNAMEs in the SMP/E target zone. The SHASMAC DDNAME found in the output of this job corresponds to the DSNAME of the correct JES2 macros.
JCLSMPU2: Performs an SMP/E UCLIN of the target zone to remove the USERMOD name associated with the JES2 macros used in the assembly of CWJESTAB.

Task 3: Run the generated jobs (if applicable)

Edit according to the comments in the member and run the following hlq.CTL library member $$IAALOG jobs:

$62PGLOB: Generated only if you are upgrading fromAbend-AID Release 12.02 or less current and you entered this previous release’s Abend-AID customization load library name on Abend-AID configuration batch global options (Screen 3 of 6) abend-aid configuration batch global options. Loads the Abend-AID customization file with your site’s previous CWGLOBAL values.
$62PROUT: Generated only if you are upgrading from Abend-AID Release 12.02 or less current and you entered this previous release’s Abend-AID customization load library name on Abend-AID configuration: report routing (screen 2 of 6). Loads the Abend-AID customization file with your site’s previous CWROUTE values.

Task 4: Register an Abnormal Termination Exit for Language Environment Support

If your site has installed a more current Language Environment release than the one installed with the Abend-AID release you are currently upgrading, complete the steps described in Task 3: Register an Abnormal Termination Exit (ATE) for language environment support and Task 4: Register LEAID64 as a Language Environment 64-Bit Abnormal Termination Exit (ATE).

Otherwise, continue with the following Task 5: Implement the Batch Dump Capture Address Space PARMLIB under CMSC.

Task 5: Implement the Batch Dump Capture Address Space PARMLIB under CMSC

Review the BDCAS core parameters located in the AABD00 member of the hlq.CTL library.
Edit the AABD00 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.
In order to use the CMSC component, copy the BDCAS parameter data set member AABD00 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.
Update CMSC with AABD00.
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 6: Activate the Batch Dump Capture Address Space

Edit member $68BDCAS 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:
//AABDCAS   EXEC PGM =FDBMMPLU,DYNAMIC=125,TIME-1440,
//              PARM=’xxxxxxxx,BDCAS,yyyy’,
//              REGION=8M
xxxxxxxx is the 1- to 8-character name of this BDCAS. You must define a unique BDCAS name for each BDCAS configured on this MVS image.
yyyy is the 1- to 4-character suffix of the BDCAS PARMLIB member configured for this BDCAS. The default suffix is 00, but you or the CMSC administrator can change the suffix and it must be specified here. The BDCAS PARMLIB member prefix must be AABD.
Submit $68BDCAS.
Ensure that the BDCAS 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 BDCAS