How to: Configure an autonomous agent to send SNMP events

Customize the autonomous agent parameters in the product-specific WCONFIG(Kpp$PENV) imbed for the agent to send SNMP events. This topic explains how to perform this task using PARMGEN.

1. Add the following parameters to the WCONFIG(Kpp$PENV) imbed.

   *IRA_AUTONOMOUS_MODE=Y                             
   *IRA_AUTONOMOUS_LIMIT=50                           
   *IRA_DEBUG_AUTONOMOUS=N                            
   *IRA_EIF_DEST_CONFIG=ppEVDST.RKANDATV              
   *IRA_EIF_MSG_LOCALE=en_US                          
   *IRA_EVENT_EXPORT_CHECKUSAGE_INTERVAL=180          
   *IRA_EVENT_EXPORT_EIF=Y                            
   IRA_EVENT_EXPORT_SIT_STATS=N                       
   *IRA_EVENT_EXPORT_SIT_STATS_DETAIL=N               
   *IRA_EVENT_EXPORT_SNMP_TRAP=Y                      
   *IRA_EVENT_EXPORT_SNMP_TRAP_CONFIG=ppTRAPS.RKANDATV
   *IRA_LOCALCONFIG_DIR=RKANDATV                            

   You can copy these parameters from the common WCONFIG(KAG$PENV) imbed.
2. Customize and enable the following parameters.

   IRA_AUTONOMOUS_MODE=Y
   IRA_EVENT_EXPORT_SNMP_TRAP=Y
   IRA_EVENT_EXPORT_SNMP_TRAP_CONFIG=ppTRAPS.RKANDATV

3. Create a ppTRAPS member in the RTE_HILEV.RTE_NAME.RKANDATV dataset by using one of the following methods.
   • Create the ppTRAPS member locally by using the following code sample:

     <SNMP>
      <TrapDest name="OMNIONE" Address="hostname"  /> 
      <Situation name="*" Target="OMNIONE" />
     </SNMP>

     By changing the value of the parameter IRA_EVENT_EXPORT_SNMP_TRAP_CONFIG, you can define one member to be shared by multiple agents that have access to the RTE_PLIB_HILEV.RTE_NAME.RKANDATV dataset.
   • Create the ppTRAPS by using the Central Configuration Server (CCS) as described in ITM Administrator's Guide. Specify the following parameters in WCONFIG(Kpp$PENV), uncomment out the parameters, and give values to the parameters accordingly.

     ** ******************************************************************   
     ** Private Situations parameters:                                       
     ** ******************************************************************   
     ** Central Configuration Server (CCS) parameters:                       
     ** Note: Instead of defining RKANDATV(ppTRAPS) locally, customize       
     **       the following variables accordingly:                           
     ** ******************************************************************   
     *IRA_CONFIG_SERVER_URL=xxx                                              
     *IRA_CONFIG_SERVER_USERID=xxx                                           
     *IRA_CONFIG_SERVER_PASSWORD=xxx                                         
     *IRA_CONFIG_SERVER_FILE_PATH=xxx                                        
     *IRA_CONFIG_SERVER_FILE_NAME=xxx                                        
     *IRA_SERVICE_INTERFACE_CONFIG_INTERVAL=xxx                              
     *IRA_PRIVATE_SITUATION_OUTPUT_LOCAL=Y or N      

     Note: The agent downloads the latest configuration files from the CCS during startup to update the RKANDATV members, including ppTRAPS.

   Repeat this step for other agents by updating their product-specific WCONFIG(Kpp$PENV) member so that their corresponding xKANPARU(KppENV) file is updated. If you want all z/OS agents to share this change, update the parameters in the common WCONFIG(KAG$PENV) member. This common imbed is appended in xKANPARU(KppENV) of every z/OS agent in this RTE.
4. Run the WCONFIG($PARSEPR) job to re-create the WKANPARU(KppENV) files of the RTE and update the WCONFIG(Kpp$PENV) user imbed.
5. Run the WKANSAMU(KCIJPCPR) and WKANSAMU(KCIJPW2R) jobs of the RTE to refresh the product execution RKANPARU user dataset.
6. Recycle the agent started task. The task name is the value of the parameter Kpp_AGT_STC in the configuration profile. The default value is IBMpp.