6
Troubleshooting eSNMP Problems
The eSNMP modules provided with TCP/IP Services include troubleshooting
features that are useful in controlling the way your subagent works.
This chapter describes:
•
How to modify the subagent error limit (Section 6.1)
•
How to modify the default subagent timeout value (Section 6.2)
•
Log files (Section 6.3)
For additional information about troubleshooting SNMP problems, see the
Compaq TCP/IP Services for OpenVMS Tuning and Troubleshooting guide.
6.1 Modifying the Subagent Error Limit
In certain circumstances, some subagent programs might enter a loop where a
select( )
call repeatedly returns a -1 error value. (Note that standard SNMP
subagents and the Chess example provided in TCPIP$EXAMPLES should not
exhibit this behavior.)
You can define the logical name TCPIP$SNMP_SELECT_ERROR_LIMIT to
modify the number of times a -1 error value can be returned from a
select( )
call.
The valid TCPIP$SNMP_SELECT_ERROR_LIMIT values range from 1 to less
than
2
32
0 1
(default 100). When defining the error limit, remember:
•
Do not use commas when defining the number.
•
If you defined the limit as 0, no limit is set.
•
A defined value greater than or equal to 4000000000 triggers warning
messages.
For example, to define TCPIP$SNMP_SELECT_ERROR_LIMIT to limit the
number of times a -1 error value is returned to 1,000, enter the following
command:
$ DEFINE/SYSTEM TCPIP$SNMP_SELECT_ERROR_LIMIT 1000
6.2 Modifying the Subagent Timeout
You can define the logical name TCPIP$ESNMP_DEFAULT_TIMEOUT to modify
the default time allowed (3 seconds) before timeout occurs because of the lack of
response by the subagent to the master agent. The ability to define the timeout is
especially useful for slower systems and systems with heavy network traffic. The
logical name is translated at startup time.
Troubleshooting eSNMP Problems 6–1