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 optional DVS with the Abend-AID viewer

Distributed Viewing Support (DVS) enables users to access Abend-AID source listing files that are on different MVS systems that do not have shared DASD. Users access the files through the Abend-AID online displays as they normally would.

The Abend-AID viewing servers enable DVS by linking MVS systems over VTAM LU 6.2 connections. The server that resides on the remote MVS image that has the source listing files is referred to as the remote source-owning server. The server that resides on the local MVS image that is accessing the remote source listing files is referred to as the local source-viewing server. The local source-viewing server must be configured and active on the user's local system. A remote source-owning server is required on each remote system to be accessed. A local source-viewing server can access source listing files from multiple remote source-owning servers, as shown in the figure below. Multiple local source-viewing servers can access any single remote source-owning server, as shown in the DVS with Multiple Local Source-Viewing Servers figure below. We recommend that you run each server as a started task that is always available.

This configuration procedure assumes that Abend-AID viewing servers already exist on both the remote and local MVS images. If either or both viewing servers do not yet exist, then follow the steps in the “Abend-AID-viewer-configuration-tasks-new-installation” section of the Abend-AID Installation and Configuration Guide to create the necessary viewing servers, and then return here to continue configuring DVS.

DVS with Multiple Remote Source-Owning Servers

DVSM_1.png


DVS with Multiple Local Source-Viewing Servers

DVSM_2.png



Configuring a Remote Source-Owning Server

To configure a remote source-owning server, complete the following steps:

Task 1: Configure the LU 6.2 Application ID

Note

If this remote source-owning server already has a LU 6.2 application ID configured, skip this step and proceed to Configure the Remote Source-Owning Server Parameters.

Define an LU 6.2 application ID (APPLID) for each server before you configure the server's parameters. The APPLID must be defined in the SYS1.VTAMLST library of the system on which you plan to run the 

Abend-AID

 server. Sample parameters for the LU 6.2 APPLID shown here are in member SAMPLU62 of the installation sample library hlq.CTL:

LU 6.2 APPLID Sample

CCFXLU62 APPL  ACBNAME=CCFXLU62,APPC=YES,ATNLOSS=ALL,
               AUTH=(ACQ),AUTOSES=10,DDRAINL=ALLOW,
               DLOGMOD=CCFXLOGM,DMINWNL=10,DMINWNR=10,
               DRESPL=ALLOW,DSESLIM=256,EAS=256,
               LIMQSINT=1440,LMDENT=256,MODETAB=CWHCIMOD,
               OPERCNOS=ALLOW,PARSESS=YES,SECACPT=AVPV,
               SYNCLVL=CONFIRM,VERIFY=NONE,VPACING=7,
               SRBEXIT=YES


Note

Ensure that the VTAM node associated with the APPLID is activated and the cross-domain definitions are correct.

Assemble and Link-Edit Logon Mode Table

Assemble and link-edit a logon mode table entry to support LU 6.2 communications. See the figure below for the required bind image for the logon mode table. This logon mode table is provided in installation sample library hlq.CTL member SAMPMOD.

The logon mode table member must be available in SYS1.VTAMLIB or a library in the SYS1.VTAMLIB concatenation.

Sample Logon Mode Table Entry LU 6.2 Communications

***********************************************************************  
**                                                                   **  
**      CCFXLOGM - THIS IS A BIND IMAGE FOR INDEPENDENT LU 6.2.      **  
**                 IT SPECIFIES PACING AND RU SIZES OF 4096.         **  
**                 ADDITIONALLY, IT SPECIFIES THE FOLLOWING:         **  
**                                                                   **  
**     BYTE 23  X'10' ACCESS SECURITY ACCEPTED                       **  
**              X'02' ALREADY VERIFIED ACCEPTED                      **  
**              X'01' PERSISTENT VERIFICATION ACCEPTED               **  
**                                                                   **  
**     BYTE 24  X'20' CONFIRM SUPPORTED                              **  
**              X'0C' EITHER PARTNER WILL REINITIATE SESSION         **  
**              X'02' PARALLEL SESSIONS SUPPORTED                    **  
**              X'01' CNOS SUPPORTED                                 **  
**                                                                   **  
**     BYTE 25  X'00'                                                **  
**                                                                   **  
***********************************************************************  
DVFLOGM  MODEENT LOGMODE=CCFXLOGM,      APPL PROCESSING ENTRY          *
              TYPE=0,                                                 *
              ENCR=0,                                                 *
              FMPROF=X'13',                                           *
              TSPROF=X'07',                                           *
              PRIPROT=X'B0',                                          *
              SECPROT=X'B0',                                          *
              COMPROT=X'D0B1',                                        *
              PSNDPAC=X'07',                                          *
              RUSIZES=X'8989',                                        *
              SRCVPAC=X'07',                                          *
              SSNDPAC=X'07',                                          *
              PSERVIC=X'060200000000000000132F00'                       
        MODEEND                                                         
        END                                                                                                               

Task 2: Configure the Remote Source-Owning Server Parameters

Add any of the following parameters that are not already specified for this remote source-owning server to the AAVwxxxx PARMLIB member you or your CMSC administrator copy to the CMSC BMC PARMLIB.

The parameters listed below must always be specified for the remote source-owning server.

  • MVS_SUBSYSTEM_NAME=CWSS 
  • MVS_SUBSYSTEM_TYPE=OWNER
  • LU62_APPLID= 
  • LOGMODE=CCFXLOGM
  • DISTRIBUTED_VIEWING_FACILITY=YES

Task 3: Configure a Local Source-Viewing Server

Note

If this remote source-owning server already has a LU 6.2 application ID configured, skip this task and proceed to Configure the Local Source-Viewing Server Parameters.

Define an LU 6.2 application ID (APPLID) for each server before you configure the server’s parameters. The APPLID must be defined in the SYS1.VTAMLST library of the system on which you plan to run the Abend-AID server.

Sample parameters for the LU 6.2 APPLID shown here are in member SAMPLU62 of the installation sample library hlq.CTL:

LU 6.2 APPLID Sample

CCFXLU62 APPL  ACBNAME=CCFXLU62,APPC=YES,ATNLOSS=ALL,
               AUTH=(ACQ),AUTOSES=10,DDRAINL=ALLOW,
               DLOGMOD=CCFXLOGM,DMINWNL=10,DMINWNR=10,
               DRESPL=ALLOW,DSESLIM=256,EAS=256,
               LIMQSINT=1440,LMDENT=256,MODETAB=CWHCIMOD,
               OPERCNOS=ALLOW,PARSESS=YES,SECACPT=AVPV,
               SYNCLVL=CONFIRM,VERIFY=NONE,VPACING=7,
               SRBEXIT=YES

Note

Ensure that the VTAM node associated with the APPLID is activated and the cross-domain definitions are correct.

Ensure that the VTAM node associated with the APPLID is activated and the cross-domain definitions are correct.

Assemble and Link-Edit Logon Mode Table

Assemble and link-edit a logon mode table entry to support LU 6.2 communications. See the figure Sample Logon Mode Table Entry LU 6.2 Communications for the required bind image for the logon mode table. This logon mode table is provided in installation sample library hlq.CTL member SAMPMOD.

The logon mode table member must be available in SYS1.VTAMLIB or a library in the SYS1.VTAMLIB concatenation.

Task 4: Configure the Local Source-Viewing Server Parameters

Add any of the following parameters that are not already specified for this local source-viewing server to the AAVwxxxx PARMLIB member you or your CMSC administrator copy to the CMSC BMC PARMLIB. 

HCI_SIT_ENTRY Parameter Set

The HCI_SIT_ENTRY parameter precedes a parameter set that defines a communication link to a remote source-owning server. Conclude the parameter set with the END parameter. Each HCI_SIT_ENTRY set defines a single Side Information Table Entry and a single communication link to a single remote source-owning server. It is required for connecting from the local source-viewing server to the remote source-owning server. It plays no part in connecting from the remote server to the local one. Create one as HCI_SIT_ENTRY for each remote source-owning server to be accessed by this local source-viewing server. The following parameters comprise a set.

HCI_SIT_ENTRY parameter set

HCI_SIT_ENTRY
SYMNAME=xxxxxxxx
TPNAME=xxxxxxxx
PLUNAME=xxxxxxxx
LUTYPE=LU62
MODNAME=xxxxxxxx
MAXS=nnn
MINCL=nnn
MINCW=nnn
END

SYMNAME

Specifies the one- to eight-character symbolic name of the remote source-owning server. A user enters this name in the Remote Server field of the Abend-AID Source Directory or in the Server field of the Remote Data set Access pop-up window on the Abend-AID Directory to access a data set on that system.

TPNAME

Specifies the one- to eight-character name of the remote source-owning server. This parameter is the server name that was specified in the parameter on the execute statement of the remote source-owning server.

Note

Remember, each server name must be unique. See Viewing-server-name for more information.


PLUNAME

Identifies the remote LU 6.2 partner. This is the one- to eight-character LU 6.2 APPLID of the Abend-AID remote source-owning server. This parameter must be the same value as specified for the LU62_APPLID parameter in the remote source-owning server.

LUTYPE

Specifies the communications type. LU 6.2 is the only option.

LU62 

LU62 must be used, specified in 4 characters.

MODNAME

Specifies the one- to eight-character logon mode table entry that defines the sessions between this Abend-AID local source-viewing server and the remote source-owning server. This parameter is the name that was specified for the DLOGMOD parameter when defining the LU 6.2 application ID for this server. This name may be the same value as specified for the LOGMODE parameter in the remote source-owning server if definitions are consistent across MVS images.

MAXS

Specifies the maximum number of sessions that can exist between the Abend-AID local source-viewing server and the remote source-owning server. We recommend that you specify 0 here as well as at MINCW and MINCL. VTAM then applies values to these parameters from the APPL definition statement in the VTAMLST for this server.

0 to 250:

Maximum number of sessions. Installation default: 0.

MINCL

Specifies the minimum number of contention loser sessions that can exist between the Abend-AID local source-viewing server and the remote source-owning server. We recommend that you specify 0 here as well as at MAXS and MINCW. VTAM then applies values to these parameters from the APPL definition statement in the VTAMLST for this server.

0 to 250:

Minimum number of sessions. Installation default: 0.

MINCW

Specifies the minimum number of contention winner sessions that can exist between the Abend-AID local source-viewing server and the remote source-owning server. We recommend that you specify 0 here as well as at MAXS and MINCL. VTAM then applies values to these parameters from the APPL definition statement in the VTAMLST for this server.

0 to 255:

Minimum number of sessions. Installation default: 0.

END

Concludes the HCI_SIT_ENTRY parameter set.

Optional Parameter

You can also specify the following optional parameter for the local source-viewing server.

DVS_USE_TERMINAL_ID=NO

Specifies whether the local source-viewing server is to pass the user’s terminal ID to the remote source-owning server instead of the local source-viewing server’s job name. The default is NO.

This parameter applies only to TSO, CICS, or VTAM remote source-owning access. Abend-AID Web Browser interface access has no terminal ID; therefore, the local source-viewing job name is always used. To take advantage of this parameter’s functionality, specify YES and ensure that Enterprise Common Components (ECC) Release 17.02 or more current is installed with all current maintenance applied.

Configuring CICS Access

Note

  • You will be able to configure CICS access only if your site is also licensed for and has installed Abend-AID for CICS.
  •   To directly access Abend-AID for CICS from BMC AMI DevX Code Debug for CICS product, you must install CICS viewing access.

Abend-AID for CICS provides two methods of CICS viewing access:

  • local: If the viewing server and the CICS region are on the same MVS image, Abend-AID for CICS uses cross-memory services. This method requires a simple configuration.
  • remote: If the viewing server and the CICS region are on different MVS images, Abend-AID for CICS uses LU 6.2 communication to support access from CICS. This viewing access method is the most complex to configure. See Viewing Access Method Requirements for a summary of all the items required to configure CICS remote viewing access.

If CICS access is installed, users can issue the AADF transaction from CICS to directly access the viewing server that is processing dumps for that CICS region. You indicate which viewing servers process dumps for specific CICS regions on the CICS Region Configuration screen, as described in Configure Regions with Abend-AID for CICS Installed.

Configuring CICS Local Viewing Access

Perform the following steps for CICS local viewing access.

Task 1: Review CICS Transaction Dump Global Option

Specify LOCAL for the CICSACCESS transaction dump global option, as described in Task 14.7 Modify CICS Transaction Dump Global Options. This value is the default.

Note

If LOCAL is specified for this transaction dump global option but the CICS region is not running on the same MVS image as the viewing server, Abend-AID for CICS checks for the presence of the appropriate CICS remote configuration.

Task 2: 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_* 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. The MVS_SUBSYSTEM_* viewing server configuration parameters are described on TDCAS PARMLIB Member AATDALL Parameters.

Installation sample library hlq.CTL members AAVWxxxx contain sample parameters for configuring CICS local viewing access. Uncomment in the member any parameters your site requires. Ensure that you provide the CMSC team the appropriate member for the viewing server and that the JCL has been properly updated.

Configuring CICS Remote Viewing Access

Perform the following steps for CICS remote viewing access.

Task 1: Add APPLIDs to SYS1.VTAMLST

If a viewing server is supporting CICS remote viewing access, you must define one LU 2 and one LU 6.2 APPLID for the viewing server. Both APPLIDs must be defined in SYS1.VTAMLST. The attributes of the LU 2 APPLID and LU 6.2 APPLID are described below.

LU 2 APPLID

Do not specify any parameters on the LU 2 APPLID (that is, the attributes as defined to SYS1.VTAMLST are applid APPL). For example:

CCFXAPPL  APPL

Installation sample library hlq.CTL member SAMPLU2 contains this example. You must also ensure that the VTAM node associated with the APPLID is activated, and the cross-domain resource definitions are correct.

LU 6.2 APPLID

Installation sample library hlq.CTL member SAMPLU62 contains the LU 6.2 APPLID required parameters:

CCFXLU62 APPL  ACBNAME=CCFXLU62,APPC=YES,ATNLOSS=ALL,                 *
               AUTH=(ACQ),AUTOSES=10,DDRAINL=ALLOW,                   *
               DLOGMOD=CCFXLOGM,DMINWNL=10,DMINWNR=10,                *
               DRESPL=ALLOW,DSESLIM=256,EAS=256,                      *
               LIMQSINT=1440,LMDENT=256,MODETAB=CWHCIMOD,             *
               OPERCNOS=ALLOW,PARSESS=YES,SECACPT=AVPV,               *
               SYNCLVL=CONFIRM,VERIFY=NONE,VPACING=7,                 *
               SRBEXIT=YES

Note

  • Specify the LU 6.2 APPLID for the viewing server that owns the Abend-AID for CICS subsystem.
  • Ensure that the VTAM node associated with the APPLID is activated and the cross-domain definitions are correct.

Assemble and link-edit a logon mode table entry to support LU 6.2 communications. The figure below shows the required bind image for the logmode table. This logmode table is provided in installation sample library hlq.CTL member SAMPMOD.

The logon mode table member must be available in SYS1.VTAMLIB or a library in the SYS1.VTAMLIB concatenation.

Sample Logon Mode Table Entry LU 6.2 Communications

***********************************************************************  
**                                                                   **  
**      CCFXLOGM - THIS IS A BIND IMAGE FOR INDEPENDENT LU 6.2.      **  
**                 IT SPECIFIES PACING AND RU SIZES OF 4096.         **  
**                 ADDITIONALLY, IT SPECIFIES THE FOLLOWING:         **  
**                                                                   **  
**     BYTE 23  X'10' ACCESS SECURITY ACCEPTED                       **  
**              X'02' ALREADY VERIFIED ACCEPTED                      **  
**              X'01' PERSISTENT VERIFICATION ACCEPTED               **  
**                                                                   **  
**     BYTE 24  X'20' CONFIRM SUPPORTED                              **  
**              X'0C' EITHER PARTNER WILL REINITIATE SESSION         **  
**              X'02' PARALLEL SESSIONS SUPPORTED                    **  
**              X'01' CNOS SUPPORTED                                 **  
**                                                                   **  
**     BYTE 25  X'00'                                                **  
**                                                                   **  
***********************************************************************  
CCFXLOGM MODEENT LOGMODE=CCFXLOGM,      APPL PROCESSING ENTRY          *
              TYPE=0,                                                 *
              ENCR=0,                                                 *
              FMPROF=X'13',                                           *
              TSPROF=X'07',                                           *
              PRIPROT=X'B0',                                          *
              SECPROT=X'B0',                                          *
              COMPROT=X'D0B1',                                        *
              PSNDPAC=X'07',                                          *
              RUSIZES=X'8989',                                        *
              SRCVPAC=X'07',                                          *
              SSNDPAC=X'07',                                          *
              PSERVIC=X'060200000000000000132F00'                       
        MODEEND                                                         
        END                                                             

Task 3: Review CICS Transaction Dump Global Options

Review the following two transaction dump global options. You can read about these options now at the pages indicated below. After you complete the basic Abend-AID for CICS and Abend-AID Viewer installation procedures, if you want to change the defaults, you can do so only after you have started the viewing server and by using the Abend-AID Viewer online installation customization facility, as described in Modify CICS Transaction Dump Global Options .

CICS Access

Specify REMOTE for the CICSACCESS transaction dump global option, as described in Task 14.7 Modify CICS Transaction Dump Global Options. LOCAL is the default.

Note

If LOCAL is specified for this transaction dump global option but the CICS region is not running on the same MVS image as the viewing server, Abend-AID for CICS checks for the presence of the appropriate CICS remote configuration.

CICS Connection Name

Abend-AID for CICS requires that an APPC connection be defined for every CICS region from which CICS viewing access is supported.

The default connection name used by Abend-AID for CICS is CCFX. It is specified by the CONNECTION transaction dump global option. If you need to change the connection name, update the transaction dump global option member used by the CICS region, as described in Task 14.7 Modify CICS Transaction Dump Global Options.

Task 4: Review APPC Connection in CICS

The Abend-AID for CICS transaction dump RDO members contain sample RDO definitions for defining an APPC connection and sessions. These are required if you are using CICS remote viewing access.

Using Resource Definition Online or the CSD Utility DFHCSDUP describes the RDO members distributed with Abend-AID for CICS. Review the values specified in the RDO members for the following values:

CONNECTION

The APPC connection name. The default value is CCFX. If you changed this value in Review CICS Transaction Dump Global Options, ensure that the value you specified for the CONNECTION transaction dump global option is reflected here.

NETNAME

The LU 6.2 APPLID defined for the viewing server in LU 6.2 APPLID  or the VTAM generic resource name. See VTAM_GRNAME= for more information.

MODENAME

The logon mode table name you defined for the viewing server in Assemble and Link-Edit Logon Mode Table .

Task 5: Specify PARSESS=YES on CICS VTAM APPL Definition

The VTAM APPL definition for every CICS region from which viewing access is supported must be defined to support parallel sessions. Ensure that PARSESS=YES is specified for each CICS region’s VTAM APPL definition.

Task 6: Code DFHSIT ISC=YES Parameter

For every CICS region from which CICS viewing access is supported, code the DFHSIT parameter ISC=YES to enable intersystem communication.

Task 7: Review External Security Considerations

If you specified YES for the EXTERNAL_SECURITY_ENABLED viewing server configuration parameter, review the CICS Requirements subsection of the Viewing Access Requirements section in the Abend-AID Installation and Configuration Guide for information about CICS viewing access and external security.

Task 8: Review Viewing Server Configuration Parameters

When you customize the viewing server as described in Abend-AID-viewing-server-advanced-configuration, you must specify the following parameters:

Installation sample library hlq.CTL members AAVWxxxx contain sample parameters for configuring CICS remote viewing access. Uncomment in the member any parameters your site requires. Add any additional viewing server parameters your site requires. Ensure that you provide the CMSC team the appropriate member for the viewing server and that the JCL has been properly updated.

Task 9: Access AADF from a User Program

Review the following information if you want to access AADF from a user program. You can link to AADF by a user CICS program using the COMMAREA or TWA. This facility allows you to invoke Abend-AID for CICS viewing from your own menu programs.

The figure here shows a sample COBOL program to link to AADF from a user program.

Sample COBOL Program to Link to AADF

ENVIRONMENT DIVISION
DATA DIVISION
WORKING-STORAGE SECTION
77TWALENGPIC S9(4) COMP.

LINKAGE SECTION
01 DFHCOMMAREA
05COM-CMMDPIC X(7).

01BLL-CELLS.
05FILLERPIC S9(8) COMP.
05TWAPTRPIC S9(8) COMP.
01WORKAREA.
05TWA-AADFPIC X(7).

PROCEDURE DIVISION.
IF FROM COMMAREA
MOVE ‘AADF’ TO COM-CMMD
PERFORM LINK-AADF-COMMAREA UNTIL
COM-CMMD EQUAL ‘EXIT’.
IF FROM TWA
MOVE ‘AADF’ TO TWA-AADF
PERFORM LINK-AADF-TWA UNTIL
TWA-AADF EQUAL ‘EXIT’.

LINK-AADF-COMMAREA.
EXEC CICS LINK PROGRAM(‘CTCCJAAD’)
COMMAREA(DFHCOMMAREA)
LENGTH(?)
EXEC CICS SYNCPOINT
END-EXEC.

LINK-AADF-TWA.
EXEC CICS LINK PROGRAM(‘CTCCJAAD’)
END-EXEC

Instead of linking to AADF, you can issue the EXEC CICS RETURN command with the TRANSID option set to AADF.

Configuring Abend-AID Web Browser Interface Access


Note

Your site can directly access complete batch and transaction abend reports and SVC dump diagnostics on the mainframe viewing server using the Abend-AID Web Browser Interface viewing access method. No data is downloaded to the personal computer using this method. Complete the steps below to install Abend-AID Web Browser Interface viewing access.

Task 1: Review Viewing Server Configuration Parameters

When you customize the viewing server as described in Abend-AID-viewing-server-advanced-configuration, review the following viewing server parameters for Abend-AID Web Browser Interface access:


  • HTTP_ENABLE=YES and XE_HTTPS=NO when using a non-secure port or HTTP_ENABLE=NO and XE_HTTPS=YES when using a secure port
  • MVS_SUBSYSTEM_NAME=CWSS 
  • MVS_SUBSYSTEM_TYPE=OWNER 
  • TCP_JOBNAME= 
  • TCP_PORT=48228 
  • HTML_SUBTASKS=2 
    For more details, see Configuration-parameters-controlled-by-the-CMSC.

The first five viewing server parameters are required. The sixth is optional. Installation sample library hlq.CTL members AAVWxxxx contain sample parameters for configuring Abend-AID Web Browser Interface viewing access. Uncomment in either member the parameters your site requires. Ensure that you provide the CMSC team the appropriate member for the viewing server and that the JCL has been properly updated.

Task 2: Define the Abend-AID Web Browser Interface URL

Based on the options specified for the above viewing server parameters, define a site-specific URL for Abend-AID Web Browser Interface access that you make known to your site’s users in the following format:

Example

When using a secure port, select either https://cw01:48228/AAVIEW.HTML or https://nn.nn.nn.nnn:48228/AAVIEW.HTML

When using a non-secure port, select either http://cw01:48228/AAVIEW.HTML or http://nn.nn.nn.nnn:48228/AAVIEW.HTML


Abend-AID Plug-in for Eclipse Considerations


Note

  • The Abend-AID viewing server associated with this Abend-AID Web Browser Interface must be active on the mainframe in order for you to access reports and diagnostics. See Configuring Abend-AID Web Browser Interface Access for more information.
  • Refer to the BMC AMI DevX Workbench for Eclipse Installation Guide for the minimum Eclipse system requirements.

Using the Abend-AID plug-in for Eclipse allows you to start the Abend-AID Web Browser Interface from within Eclipse. If you do not have Eclipse installed, you can continue to start the Abend-AID Web Browser Interface using your site-defined URL. See Define the Abend-AID Web Browser Interface URL for more information. Refer to the Abend-AID online help or the BMC AMI DevX Workbench for Eclipse Abend-AID User Guide for detailed information about using this interface for viewing Abend-AID reports and SVC dump diagnostics.

The Abend-AID plug-in for Eclipse has been removed from the Abend-AID product media and is now available on the BMC AMI DevX Workbench for Eclipse product media. For the most current Abend-AID plug-in for Eclipse installation and user information, refer to the BMC AMI DevX Workbench for Eclipse Support Center.


 

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