Home | Previous Page | Next Page   IBM Informix Implementation of SNMP > Using SNMP on Windows >

Windows Subagent

On Windows, OnSNMP comprises the following files. The table also lists the directories in which the IBM Informix installation procedure installs each file.

File Description Directory
infxsnmp.dll Library that provides the interface between onsnmp.exe and the master agent. The IBM Informix installation procedure installs one infxsnmp.dll on each workstation. The initialization process for the master agent loads infxsnmp.dll. %Windows%\system32
onsnmp.exe Subagent program. The IBM Informix installation procedure installs an onsnmp.exe file for each database server or coserver. %INFORMIXDIR%\bin
onsrvapd.exe Server discovery process, which starts onsnmp.exe for each database server or coserver that starts. The IBM Informix installation procedure performs the following tasks for onsrvapd.exe:
  • Installs one onsrvapd.exe on each workstation
  • Creates the Informix Server Discovery Process for SNMP in the control panel and configures it to start automatically when the system reboots
%Windows%\system32

When you install an Informix database server or coserver, the installation procedure automatically installs OnSNMP. When you start an Informix database server or coserver that is on a network that uses SNMP, onsrvapd.exe detects this event and starts OnSNMP for the database server or coserver. When the database server or coserver halts, onsrvapd.exe stops OnSNMP for that database server or coserver.

Starting and Stopping OnSNMP

Under normal circumstances, you do not need to start or stop OnSNMP explicitly. If you are experiencing abnormal circumstances and need to start or stop OnSNMP explicitly, contact Technical Support. For contact information, refer to your IBM Informix: Installation Guide.

Configuring OnSNMP

The Informix installation procedure creates a new registry key, OnSnmpSubagent, under HKEY_LOCAL_MACHINE\SOFTWARE\Informix.

The following table describes the OnSnmpSubagent arguments that you can change.

Argument Value Description
Environment\
LINGER_TIME
lingermnts Number of minutes that the master agent waits after a database server or coserver goes down before the master agent kills the corresponding OnSNMP. If lingermnts is 0, the master agent waits indefinitely.
Environment\
LOGDIR
pathname Complete path of the OnSNMP error-log file, including filename
Environment\
REFRESH_TIME
pollsecs Frequency, in seconds, with which OnSNMP polls the database server or coserver
Environment
LOGLEVEL
loglevel Logging level to which OnSNMP logs debugging information. The default value is 3. The onsrvapd daemon passes this value to OnSNMP.

The following table describes the OnSnmpSubagent arguments that you should not change.

Argument Value Description
Pathname pathname Complete path of infxsnmp.dll, including filename
MIBS\APPLMIB apploid OID for the Application MIB
MIBS\ONMIB onoid OID for the Online MIB
MIBS\RDBMSMIB rdbmsoid OID for the RDBMS MIB
MIBS\XPSMIB (XPS) xpsoid OID for the XPS MIB

The Informix installation procedure also creates a new argument, INFXSNMP, under HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
\SNMP\Parameters\ExtensionAgents
. This new argument specifies the location of the OnSnmpSubagent registry key, including the name of the key.

To change the OnSNMP configuration, change the values for these arguments.

Home | [ Top of Page | Previous Page | Next Page | Contents | Index ]