Integrating
This section describes the tasks necessary to configure Abend-AID for integration with BMC AMI DevX Workbench for Eclipse.
Configure BMC AMI DevX Workbench for Eclipse integration
If your site is not licensed to use BMC AMI DevX Workbench for Eclipse with Abend-AID, go to Verify Abend-AID configuration.
The following roles are involved for this milestone:
- Abend-AID installer/Abend-AID for CICS installer
- CMSC administrator
- Network administrator
Task 1: Review the Abend-AID prerequisites
Abend-AID integration with BMC AMI DevX Workbench for Eclipse requires installation and configuration of the following Abend-AID components:
- Abend-AID Viewer
- Batch Abend-AID and/or Abend-AID for CICS
- Abend-AID Web Browser Interface.
Perform the following steps to review the Abend-AID prerequisites:
- Ensure the Abend-AID Viewer has been installed and configured as described in either Abend-AID Viewer Configuration Tasks - new installation or Abend-AID Viewer Configuration Tasks - upgrade, depending on whether you are installing Abend-AID for the first time or performing an upgrade.
- Ensure batch Abend-AID has been installed and configured.
Task 2: Copy additional required parameters to the AAVW00 PARMLIB member
In addition to the parameters described in Task 6: Implement the Abend-AID viewer PARMLIB under CMSC (new installation) or Implement the Abend-AID viewer PARMLIB under CMSC (upgrade), specify the following additional required parameters:
HTTP_ENABLE=NO
Required for the Abend-AID Web Browser Interface only. Specifies whether HTTP (Web) access to the server is required. The default is NO. Change this parameter to YES.
HTML_SUBTASKS=2
Optional for the Abend-AID Web Browser Interface only. Specifies the number of subtasks to be activated to format information to be displayed on users' Web browsers. This parameter applies only if HTTP_ENABLE=YES is specified. Valid values are in the range from 1 to 32. We recommend an initial value of 2. If users are indicating that they are receiving slow response to requests for Web pages from the server, then you can increase this value. The default of 2 is used unless you specify a different value.
MVS_SUBSYSTEM_NAME=name
Required for the Abend-AID Web Browser Interface and TSO ISPF viewing access via TCP/IP. Specifies the name of the Abend-AID MVS viewing subsystem. Abend-AID uses the viewing subsystem to handle task and address space termination to ensure proper session outage notification. The subsystem name must be unique on the MVS image unless you are sharing the subsystem with other Abend-AID viewing servers on the image (see below). There is no default.
MVS_SUBSYSTEM_TYPE=OWNER
Required for the Abend-AID Web Browser Interface and TSO ISPF viewing access via TCP/IP. Specifies whether this viewing server is an OWNER or a USER of the subsystem.
Abend-AID requires only one MVS viewing subsystem per MVS image, regardless of how many viewing servers you are running on the image. To share a single subsystem, one viewing server must be defined as the subsystem owner, and the other Abend-AID viewing servers on the image are defined as users of the subsystem. The viewing server that owns the MVS subsystem must be active to process communication requests for viewing servers that are users of the subsystem. Alternatively, you may instead define each viewing server on the MVS image as the owner and with its unique name.
For ease of configuration, we recommend that you define each viewing server on an MVS image as the owner of a subsystem and with its own unique name, and that you do not share a subsystem between viewing servers.
TCP_HOSTNAME=
Required for the Abend-AID Web Browser Interface and TSO ISPF viewing access via TCP/IP only. This parameter is used to pass the MVS system's TCP/IP Domain Name System (DNS) host name or TCP/IP address to the Abend-AID Web Browser Interface or the Abend-AID Viewer (when configured for TSO ISPF access via TCP/IP) when a dump is captured or imported. There is no default.
TCP_JOBNAME=name
Required for the Abend-AID Web Browser Interface only. Specifies the job name of the TCP/IP region on this MVS system. Consult your VTAM (TCP/IP) system programmer regarding this job name at your site. There is no default.
TCP_PORT=nnnnn
Required for the Abend-AID Web Browser Interface and TSO ISPF viewing access via TCP/IP. Specifies the TCP/IP port number this server should listen on for requests for services from users’ web browsers. The value specified must be a valid, currently unused TCP/IP port on your MVS system. Valid values range from 1024 to 65535. The suggested port is 48228. There is no default. Consult your VTAM (TCP/IP) system programmer regarding an available port number to use at your site.
Refer to the Abend-AID Advanced configuration for a complete description of installation parameters that control Abend-AID functions.
Task 3: Add parameters to the AAVW00 member in the BMC PARMLIB
Copy these parameters to the Abend-AID Viewer AAVW00 member in the data set in the //CWPARM DD concatenation in the CMSC JCL, or ask your CMSC administrator to do so.
Task 4: 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
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.