Configuring and Installing Optional Components › Tasks for Separately Licensed Components › Customize the CA NSM SSM CA OPS/MVS Option › Define the CA OPS/MVS Option to Agent Services

Define the CA OPS/MVS Option to Agent Services

Take the following steps to ensure that the CA NSM SSM CA OPS/MVS Option is properly defined to Agent Services. Those responsible for installing and customizing CCS for z/OS should be familiar with the utilities discussed in this section.

To define CA OPS/MVS Option to Agent Services

1. Make sure that CA NSM Agent Services is installed and running.
2. Load the STATEMAN MIB into Object Store using the LDMIB utility provided in the OPS CCLXCNTL(LDMIB) member. Be sure to customize the environment variables to point to the appropriate Agent and Agent Services data sets and to the STATEMAN MIB. The STATEMAN MIB is distributed with CCS for z/OS and can be found in the CCLXMIB directory. A copy can also be found in the OPS.CCLXMIB(STATEMAN) member.
3. Create the Agent Configuration file. A sample has been provided in the CA OPS/MVS CCLXCNTL(CFGSSMO) member. The configuration file is used to:
   • Override the default community definitions or trap destinations for a specific agent.

     For example, the following specifications, taken from the agents sample configuration file in CCLXCNTL(CFGSSMO), sets the destination address, community name, and port for traps issued by the agent. The #SNMPTRAP host and port information must correspond to the IP address and port of the CA OPS/MVS and CA NSM SSM CA OPS/MVS Option workstation. The port number specified should be validated by TCP/IP configuration personnel to avoid conflicts with other SNMP agents that may already be using the same port number.

     In addition, CA OPS/MVS and CA NSM SSM CA OPS/MVS Option must use the community name of public to retrieve information from the STATEMAN MIB and the community name of admin to modify fields defined in the MIB.

     #SNMPTRAP 
     host          141.202.42.253
     community     public 
     port          162
     #SNMPCOMMUNITY
     access        read
     community     public
     host          0.0.0.0
     #SNMPCOMMUNITY
     access       write
     community    admin
     host         0.0.0.0
     

   • Set initial startup values for an agent.

     Only the community name and trap destination specifications of the CA OPS/MVS and CA NSM SSM CA OPS/MVS Option workstation should be customized to conform to the requirements of your site. All other settings should be left as distributed in this sample.

   • If your installation is running multiple CA agents that also require #SNMPTRAP and #SNMPCOMMUNITY specifications, then these specified values must be coordinated. Assigning these values in the OPSCNFG configuration set overrides the corresponding values assigned in the CA NSM Agent Technologies aws_sadmin.cfg default configuration set. The values for these two parameters can be specified in either configuration set, but the OPSCNFG configuration set values take precedence after it is successfully loaded. At the very least, the OPSCNFG configuration set must contain all the supplied #SNMPGROUP specifications.
4. After the Configuration settings for Community name and Trap destinations have been customized, load the Configuration file into object store using the LDCONFIG utility provided in OPS CCLXCNTL(LDCFG). If Agent Services and the CA OPS/MVS and CA NSM SSM CA OPS/MVS Option are running, then be sure to stop CA OPS/MVS and CA NSM SSM CA OPS/MVS Option before the running the utility. If Agent Services is running, aws_sadmin must be recycled before the new configuration file takes effect. For additional information, see the CA NSM Working with Agents guide distributed on the CA NSM CD. Be sure to customize the environment variables in the LDCONFIG JCL to point to the appropriate Agent and Agent Services data sets and the modified Configuration file. In addition, make sure the community name specification corresponds to what the UCA OPS/MVS and CA NSM SSM CA OPS/MVS Option uses and that traps are routed to the CA OPS/MVS and CA NSM SSM CA OPS/MVS Option workstation.

   For additional information, see the CA NSM Working with Agents guide distributed on the CA NSM CD. For information on the CCS for z/OS component required to install the CA OPS/MVS and CA NSM SSM CA OPS/MVS Option, see the appendix “CCS for z/OS Component Requirements.”