The agent communicates with a UTM application via UPIC (BS2000). UPIC requires a side information file (upicfile) to link the agent to the UTM application. This file must be named "upicfile" and be cataloged in BS2000.
Note that the agent can only monitor one UTM application at a time.
Normally, there are four parts to the entry in the upicfile:
An identifier; in this case, HD as the identifier for a link between UPIC(BS2000) and UTM(BS2000).
The communication partner of the application, which should be set to SNMP4UTM for the currently selected UTM application.
The partner name presented by the main BCAM name of the application. It is recommended to specify application's host machine, separated from the name by ".".
The transaction code; this entry is not necessary in this case because as the agent specifies the transaction code with the Set_TP_Name call.
The file upicfile can be edited under BS2000. The end-of-line character is represented in BS2000 by a semicolon (";") as there is no <newline> character in BS2000 (see example). This means that if an edited line contains a semicolon, UPIC interprets this as the end of the line and puts the remainder on the next line (up to the next semicolon). This also applies to comment lines.
Example
Side Information file:
*symbolic destination names for (BS2000) application ZENTRBS2; ;*application is running on BSENGINE; HDSNMP4UTM ZENTRBS2.BSENGINE;
The UTM agent reports to the UPIC communication system with the local name SNMPUPIC. The name SNMP4UTM should be defined as the communication partner of the application with the KDCDEF PTERM or TPOOL statement.
Since the UTM agent requires the appropriate authorization to issue UTM administration commands, a UTM user ID must be defined with STATUS=ADMIN or PERMIT=ADMIN and passed to the UTM agent with help of respective job variables, see section “Runtimeenvironment”. If no JVs will be created, agent will use default credentials from SNMP-AGENTS.
openUTM uses the following TACs for monitoring with SNMP:
KDCWADMI for reading information
KDCLPAP, KDCLTAC, KDCSHUT, KDCPOOL, KDCSWITCH, KDCPTERM, KDCTCL, KDCLTAC, KDCUSER for setting and modifying object parameters.
Please ensure that these TACs are generated in the UTM application with the required administration authorization.