Previous Topic: System and CA Common Services Requirements

Next Topic: Mainframe Agent Installation Considerations

Configure Agent Technology

The CA Common Services for z/OS Installation Guide Post-Installation chapter for Agent Technology contains detailed instructions for all files and settings that can be configured. Follow the explicit directions in that chapter to complete the configuration.

Important! The aws_sadmin.cfg file must be changed to enable the sending of SNMP traps to destinations. The ENVFILE file must also be tailored so that mainframe agents can communicate with Agent Technology. Both these files are discussed below.

Configure the aws_sadmin Service

The aws_sadmin service is responsible for sending SNMP traps to the distributed NSM machines. To achieve this goal, the aws_sadmin service must know the DNS name or IP address (and listener port) for the NSM machines. This information is stored within file aws_sadmin.cfg in directory $AGENTWORKS_DIR/services/config/aws_sadmin. You must update this file with the appropriate DNS names or IP addresses of your NSM machines. Using the nodename as defined to the DNS server is the preferred method in lieu of the actual IP address which may change. Be sure to preserve the non-displayable tab characters (x’05) contained within this file.

These characters are used as field delimiters on the SNMP_TRAP lines.

The aws_sadmin.cfg file is also used to define the SNMP community strings for the aws_sadmin SNMP service. By default, these strings are set to public (for read access) and admin (for write access). If your site requires more secure SNMP community strings, these names can be changed to meet your needs.

Important! Be sure to preserve the non-displayable tab characters (x’05) contained within this file. These characters are also used as field delimiters on the SNMP_COMMUNITY lines. Also note that any change to the SNMP community strings must be reflected in the configuration of the NSM machines. Be sure to make your NSM administrator aware of these changes. Note that an agent can have its own community strings specified in a configuration set, which is unique to that agent and which overrides the default community strings specified in the aws_sadmin.cfg file.

Environment File (ENVFILE)

The Common Services CNSMOPTV library contains a member named ENVFILE. This member is used by all of the z/OS-based agents (as well as various Agent Technology utilities) to set environment variables required to communicate with the AT services. The configuration data within this member is created when the AT services are installed, and must be accurate. This data is specific to the current LPAR, TCP/IP stack, and AT zFS’s. Any change to these items must be reflected in the ENVFILE member. In general, the values must match the equivalent values specified in the agentworks.profile script on the ReadWrite zFS.

Important! The Common Services CNSMOPTV library has special DCB attributes that must be maintained.

These attributes are particularly necessary when reading the ENVFILE member.

Communications problems will occur if the ENVFILE member is moved and read out of a standard fixed-block PDS.