Specifying additional viewing server advanced configuration parameters

Starting with Abend-AID 17.02, the //FDBDPARM DD statement is no longer used. Abend-AID configuration parameters are provided by the BMC AMI Common Mainframe Services Controller (CMSC), which is a component of the BMC AMI Enterprise Common Components or more current single-image installation. The parameters that control the viewing server configuration are specified in the following installation library hlq.CTL members:

AAVW00 (formerly, $64ISPF or $64VTAM): A sample configuration of core parameters to support basic viewing server customization. We recommend you use this member. You can add parameters to it from AAVWALL.
AAVWALL: A sample configuration of comprehensive parameters to function as a reference for additional optional viewing server customization.

Once you have updated this member, depending on the security enforced at your site, add the edited AAVWV00 or AAVWALL PARMLIB member to the //CWPARM concatenation in the CMSC BMC PARMLIB, or ask your CMSC administrator to do so. Use the z/OS MODIFY command to update the CMSC BMC PARMLIB with your changes to the PARMLIB member, or ask your CMSC administrator to do so. You can either provide the updated member or you can provide a PDS containing the member. If you provide a PDS, it must have the following attributes:

LRECL=80
BLKSIZE=any multiple of 80
RECFM=FB

Choose the sample member for the viewing access support you are configuring for the viewing server and modify it according to the instructions in this section. You may want to create a copy of the member and modify it, so you have a template to refer to later.

See Configuring Viewing Access for information about the viewing access methods and which viewing server configuration parameters are required for the methods you choose.

Note

Both sample members contain every required viewing server configuration parameter, but the optional parameters that do not pertain to the viewing access method (either TSO/ISPF and/or CICS local, or VTAM) are commented out. You can configure any combination of viewing access methods by uncommenting and specifying the parameters appropriate to the viewing method. For example, you can configure both VTAM, and TSO/ISPF and/or CICS local viewing access using AAVW00 by uncommenting and specifying the additional parameters required to support VTAM viewing access.

Edit either AAVW00 or AAVWALL to configure Abend-AID Web Browser Interface access by uncommenting the viewing server parameters that are required for the Abend-AID Web Browser Interface. In order to use the Abend-AID Web Browser Interface, the viewing server must be configured and active on the host. If you have not already done so, see Define the Abend-AID Web Browser Interface URL for information about the URL that you must define for Abend-AID Web Browser Interface access at your site. When you have specified all applicable parameters, save the parameter member.
If you add or change a parameter while the viewing server is active, you must stop and restart the viewing server for the new value to take effect.

Review the following additional advanced viewing server configuration parameters. Add any that are desired and relevant to your site to the AAVWxxxx member that you or your CMSC administrator copy to the CMSC, as described in Configuring Parameters controlled by the CMSC.

Note

The required and recommended viewing server configuration parameters are in the Abend-AID installation sample library hlq.CTL member AAVWALL. See Configuration-parameters-controlled-by-the-CMSC for the complete list of configuration parameters controlled by the BMC AMI Common Mainframe Services Controller (CMSC) and their descriptions.

If you add or change a parameter while the viewing server is active, you must stop and restart the viewing server for the new/changed value to take effect.

Optional Advanced Viewing Server Configuration Parameters for the Abend-AID Web Browser Interface and TSO ISPF Viewing Access via TCP/IP

SMARTCARD_REQUIRED=NO|yes

Description:	Optional for the Abend-AID Web Browser Interface only. When X.509 certificate support (Smart Card support) is used in the BMC AMI DevX Workbench for Eclipse, specifies what actions to take if the certificate is missing or invalid. If the certificate is missing or invalid and this parameter is set to YES, the user is presented with an error message and not allowed to continue signing on. If the certificate is missing or invalid and this parameter is set to NO, the user is presented with both, an error message and the Abend-AID sign-on page. The user can then continue with the sign-on process.
Values:	NO\|yes
Default:	NO

XE_HTTPS= NO|yes

Description:	Optional for the Abend-AID Web Browser Interface only. When the Code Debug/BMC AMI DevX Workbench for Eclipse interface is used, specifies whether the URL for the Abend-AID report is created with the HTTP or HTTPS prefix. If the URL is created with the HTTPS prefix, the TCP/IP port that is defined to the Abend-AID server must be a secured port using AT-TLS (also see TCP_PORT). When setting XE_HTTPS to YES, HTTP_ENABLE needs to be set NO.
Values:	NO\|yes
Default:	NO

Parameters to Enable External Security for Viewing Servers

If your site intends to use your external security software with Abend-AID/Abend-AID for CICS viewing servers, change the EXTERNAL_SECURITY_ENABLED=NO parameter to YES. Review the defaults for the other six EXTERNAL_SECURITY_* parameters to determine if you need to change them for your site. Also review the Security-planning section in the Abend-AID Installation and Configuration Guide for the recommended authorizations and rules for using your security software with Abend-AID/Abend-AID for CICS.

Optional Viewing Server Tuning Parameter

TRACE=size

Description:	Specifies the size of the internal trace buffer in K-bytes.
Values:	256 – 32768
Default:	1024

Optional Parameter for CICS Remote Viewing Access

VTAM_GRNAME=

Description:	Specifies the one- to eight-character VTAM generic resource name. This is an optional parameter that can be used with the required LU62_APPLID and LOGMODE viewing server parameters for CICS remote viewing access. There is no default value for this parameter. This parameter is ignored if you do not specify the LU62_APPLID parameter. If you want to use the VTAM generic resource name instead of the VTAM LU6.2 APPLID for CICS remote viewing access, specify the grname for the NETNAME value in the CICS connection definition. See Review APPC Connection in CICS for more information.
Values:	Valid one- to eight-character VTAM generic resource name defined for your site
Default:	None