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 additional source listing files to a viewing server

Note

  • If Code Debug CICS was installed prior to the activation of Abend-AID for CICS, you have already completed the steps necessary to add source support. Ensure that the first four characters of the DD names used for the Code Debug CICS files match the value specified for the SLSDDN transaction dump global option, as described in SLSDDN. Specify the LU 6.2 APPLID for the viewing server that owns the Abend-AID for CICS subsystem.
  • Source listing files added by Code Debug CICS after Abend-AID for CICS is activated, will not be known to Abend-AID for CICS. Run the AAON transaction, as described in Using Supplied Abend-AID for CICS Transactions to remedy the situation.

To add additional source or compiler listings to a viewing server after installation, complete the following steps:

Step 1. Create Source Listing Files

See BMC AMI Common Shared Services User Reference for information about allocating and formatting source listing files, and how to modify your compile JCL to run the BMC COBOL, PL/I, and Assembler language processors.

Step 2. Update Viewing Server or CICS Region JCL

Define the source listing files created in the previous step to the viewing server or to the CICS region.

•Defining them to the viewing server makes them available to all reports in the viewing server.

•For Abend-AID for CICS, defining them to the CICS region makes them available to the reports for that region.

To define source listing files to the viewing server, concatenate them to the //MFDDXLSF DD statement in the viewing server start-up JCL ($65SRVR). You can add multiple source listing files. See BMC source listing DSNs for more information.

Alternatively, to define them to the CICS region for Abend-AID for CICS, either create an RDO file entry for each file or add the appropriate DD statements to the CICS region JCL. See Source Listing Files for detailed information.

Step 3. Specify Required DD Statement for the Scratchpad File

The viewing server requires the Scratchpad listing file (CWPDDIO). It is a single DDIO source file that holds the listings created from the compiler listing. Review your viewing server JCL to ensure that it contains the Scratchpad listing file. To add it, perform the following steps:

  1. Run job Abend-AID installation sample library member $65SCRT to create the Scratchpad listing file.

  2. Define the Scratchpad listing file in your viewing server JCL. At the end of the step that executes FDBMMPLU, add the following DD statement:

    //CWPDDIO DD DSN=server.CWPDDIO,DISP=SHR
  3. Replace server.CWPDDIO with the name of the Scratchpad listing data set that you supplied in job $65SCRT.
  4. After the //CWPDDIO DD, add the following work data sets:
//MFDDWK00 DD SPACE=(CYL,(5,20)),UNIT=SYSDA
//MFDDWK01 DD SPACE=(CYL,(5,20)),UNIT=SYSDA
//MFDDWK02 DD SPACE=(CYL,(5,20)),UNIT=SYSDA
//MFDDWK03 DD SPACE=(CYL,(5,20)),UNIT=SYSDA
//MFDDWK04 DD SPACE=(CYL,(5,20)),UNIT=SYSDA
//MFDDWK05 DD SPACE=(CYL,(5,20)),UNIT=SYSDA
//SYSOUT   DD SYSOUT=*
//MFDDUMMY DD DUMMY

Step 4. Specify optional DD Statement for the copy ESS DDIO File

The viewing server can optionally include the copy ESS DDIO file (CWPESS). It is a single DDIO source file that holds the listings optionally copied from the ESS listings embedded in the load module when a report is locked. If you want to use this feature review your viewing server JCL to ensure that it contains the copy ESS DDIO file. To add it, perform the following steps:

  1. Run job Abend-AID installation sample library member $65SESS to create the copy ESS DDIO file.
  2. Define the copy ESS DDIO file in your viewing server JCL.

In the step that executes FDBMMPLU, add the following DD statement after the //CWPDDIO statement:

     //CWPESS DD DSN=server.CWPESS,DISP=SHR

         Replace server.CWPESS with the name of the copy ESS DDIO file that you supplied in job $65SESS.

Step 5. Specify Optional DD Statement for Source Support

If you did not specify your complier listings using the configuration and customization dialog, you can do so now in the viewing server JCL by adding the //MFDDLIST DD statement. This DD statement adds to the viewing server start-up JCL PDS data sets that can be selected by the user to be used as a source for unprocessed IBM compiler listings. You can concatenate additional PDS data sets. See Program compiler listing PDS data sets for more information.

Step 6. Stop and Restart the Abend-AID Viewer

To enable source support, you must stop and then restart the Abend-AID Viewer. See Controlling-the-viewing-server-BDCAS-and-TDCAS for more information about starting the viewing server. Alternatively, if you are using CICS viewing access, see Using-supplied-Abend-AID-for-CICS-transactions for information about stopping and starting Abend-AID for CICS.



 

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