Troubleshooting eSNMP Problems
6.2 Modifying the Subagent Timeout
The TCPIP$ESNMP_DEFAULT_TIMEOUT value is from 0 to 60 seconds. (You should use 0 only for testing purposes, such as simulating problems on a heavily loaded host or network.) If the value you specify contains nonnumeric digits or is outside the allowed range, the default value of 3 seconds is used.
For example, to define TCPIP$ESNMP_DEFAULT_TIMEOUT to time out after 6 seconds of inactivity between the master agent and subagents, enter the following command:
$ DEFINE/SYSTEM TCPIP$ESNMP_DEFAULT_TIMEOUT 6
When a subagent registers with the master agent, it can specify a value that overrides the value you set with logical name TCPIP$ESNMP_DEFAULT_ TIMEOUT. The standard MIB II and Host Resources MIB subagents use the default value of 3 seconds. Refer to the description of the esnmp_register routine for more information.
6.3 Log Files
All output redirected from SYS$OUTPUT for the SNMP agent process is logged to *.LOG files in the SYS$SYSDEVICE:[TCPIP$SNMP] directory. Output redirected from SYS$ERROR is logged to *.ERR files in the same directory.
Output redirected from SYS$OUTPUT for the agent process is logged to the following files:
•TCPIP$ESNMP.LOG (for the master agent)
•TCPIP$OS_MIBS.LOG (for the MIB II)
•TCPIP$HR_MIB.LOG (for the Host Resources MIB)
Output redirected from SYS$ERROR is logged to the following files:
•TCPIP$ESNMP.ERR (for the master agent)
•TCPIP$OS_MIBS.ERR (for the MIB II)
•TCPIP$HR_MIB.ERR (for the Host Resources MIB)
Data is flushed to the log files when the corresponding process terminates. Each invocation of the TCPIP$SNMP_RUN.COM procedure purges these files, retaining at least the last seven versions (the exact number depends on the value of the CLUSTER_NODES system parameter).
The log files are located in the SYS$SYSDEVICE:[TCPIP$SNMP] directory along with the TCPIP$SNMP_CONF.DAT file, which is a text representation of the SNMP configuration data generated by the master agent during startup.
The contents of the SNMP log files are written to
SYS$SYSDEVICE:[TCPIP$SNMP] when the process stops or when you stop
it (for example, by entering the STOP/ID=xxx command). After a process restarts, it creates a new version of the files. If a process executes without errors, *.ERR files might not be created.
Writing to SYS$OUTPUT and SYS$ERROR from custom subagents is controlled by qualifiers on the RUN command in the TCPIP$EXTENSION_MIB_RUN.COM procedure. See Chapter 3 for information about including extension subagent commands in the startup procedure.
Custom subagents that do not write to SYS$OUTPUT and SYS$ERROR might not produce a .LOG or .ERR file.