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.

Configuring TSO/ISPF access

Note

You may require the assistance of your MVS system programmer to install TSO/ISPF viewing access.

The Abend-AID Viewer can be accessed from a TSO CLIST and/or an ISPF panel. This section describes the steps required for both methods.

The Abend-AID Viewer uses cross-memory services to support viewing access from TSO/ISPF, so ISPF access is supported only when the viewing server and the TSO/ISPF user are running on the same MVS image. If you require cross-system viewing, install VTAM viewing access.

Allocating Libraries for TSO/ISPF-Only Viewing Access Facilities

Installation sample library hlq.CTL member $65SCPY contains JCL to allocate and populate libraries for the following TSO/ISPF-only viewing access facilities:

  • CLIST library for access to the Abend-AID Viewer
  • HOTKEY command access to Abend-AID reports
  • Link to File-AID
  • Link to the BMC AMI Common Shared Services Utilities.

Note

In order for your site’s users to perform “on-the-fly” source listing processing in the Abend-AID Viewer, besides generating and executing the $65SCPY job as described here and in the Abend-AID Installation and Configuration Guide , you must also configure access to the BMC AMI Common Shared Services (CSS) Utilities. See BMC AMI Enterprise Common Components and the BMC AMI Enterprise Common Components for more information.

If you are using the CMSC to provide BMC data set names using the DDSNnnnn members, then the member does not need to be edited.

Job $65SCPY is generated automatically, using the Abend-AID Configuration and Customization dialog, as described in the Abend-AID Installation and Configuration Guide. Ensure that the data set names that are created conform to your site’s data set naming conventions before you run the job. Ensure that these libraries are made available to users when accessing the Abend-AID Viewer from TSO/ISPF.

Ensure that the //FDBDCLST DD statement in the viewing server start-up JCL ($65SRVR) points to these libraries. See Abend-AID data sets verification for more information.

Task 1: Access File-AID from the Abend-AID Viewer

Users can invoke File-AID/MVS, File-AID for DB2, or File-AID for IMS, to browse or edit files directly from the Abend-AID Viewer only when using ISPF access. To enable accessing File-AID in this manner, complete the following steps:

  1. Ensure that File-AID and the Abend-AID Viewer are installed. 

    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, skip to step 3.

  2. 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.
  3. The FDBDCLST data set created during the Abend-AID Viewer installation process contains the CLIST members that are needed to access File-AID from the Abend-AID Viewer. Update the following CLIST members according to the comments in each member: 
    1. To access File-AID MVS, update member MFDCFMVS.
    2. To access File-AID for DB2, update members MFDCCFD2 and MFDCFDB2.
    3. To access File-AID for IMS, update member MFDCFIMS.
  4. Make the FDBDCLST data set available to the Abend-AID viewing server. See The Abend-AID datasets verification for more information.

Configuring Access Via a TSO CLIST/ISPF Panel

If you want to provide TSO/ISPF access to an Abend-AID viewing server using a TSO CLIST and/or an ISPF panel, perform the following steps.

Task 1: Copy the Sample CLIST to a CLIST Library via $65SCPY

Installation sample library hlq.CTL member $65SCPY copies installation sample library (hlq.CTL) member $66CLST to a CLIST library. The default library member name is FDBDCLST. You can rename the CLIST to conform to site standards.

Task 2: Review External Security Considerations

If you specify YES for the EXTERNAL_SECURITY_ENABLED viewing server configuration parameter, review the information described in the “ TSO/ISPF Requirements ” section of the “ Security-planning ” section in the Abend-AID Installation and Configuration Guide to ensure that you provide appropriate data set access to your TSO/ISPF users.

Task 3: Review Viewing Server Configuration Parameters

When you customize the viewing server as described in Abend-AID  Viewing Server Advanced Configuration, you must specify the MVS_SUBSYSTEM_* viewing server parameters to indicate the MVS subsystem name chosen for this viewing server and whether this viewing server is the owner or a user of the subsystem. 

Installation sample library hlq.CTL members AAVWxxx contain sample parameters for configuring TSO/ISPF viewing access. Add the required TSO/ISPF parameters to the Abend-AID PARMLIB member you or your site’s CMSC administrator copy to the BMC PARMLIB CMSC concatenation.

Task 4: Add an Abend-AID Option to an ISPF panel (optional)

If, in addition to TSO CLIST access, you want to provide Abend-AID Viewer access from an ISPF panel, add the Abend-AID option to your ISR@PRIM panel or, if you prefer, an ISPF submenu. A sample ISR@PRIM panel is shown below. Installation sample library hlq.CTL member SAMPPRIM contains only the ISR@PRIM statements that apply to Abend-AID. You can use any unique letter or number. The remainder of this step assumes that AA is chosen.

Sample ISR@PRIM Panel

The statement used for Abend-AID Viewer access is:

AA,’CMD(%$66CLST)’

Note

Change AA to the letter or number you have chosen, if applicable. Also, if you renamed $66CLST, ensure that you reflect the correct name in the CMD string.

&ZTRAIL = .TRAIL
You must also code the following statement on the ISPF panel you choose, and place it after the &ZSEL variable:

Note

  • Begin the &ZTRAIL statement in column 1.
  • If you receive message ERWIN0006 trying to access Abend-AID, make sure that the variables reserved by ISPF (that is, ZCMD, ZSEL, and ZTRAIL) are used correctly.
  • You must exit and reaccess ISPF for the newly added options to be usable.
  • The data set names must be in uppercase.



 

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