NAME

snmpxtree − SNMP application that displays the structure of MIB variables and allows interactive querying and setting of values. 

SYNOPSIS

snmpxtree [options]

DESCRIPTION

snmpxtree displays the structure (tree structure) of MIB variables and can display and set variable values.  And also, it can be used as a front end for other applications.  snmpxtree displays the nodes and leaves of MIB variables separately.  For example, in the case of the MIB variable “_iso_org_dod_internet_mgmt_mib_system_sysDescr”, each portions of iso, org, dod, ..., system would be displayed as nodes in “Gray77”, and sysDescr would be displayed as a leaf in “Blue”.  The MIB variable tree is displayed up to a specific (user-definable) depth.  Under the default settings, clicking on a node with Button1 (normally the left mouse button) changes to a display of the subtree of which the selected node forms the root.  If the node clicked on is the root of the currently displayed subtree, the display changes to one of the subtree of which the parent node of the selected node forms the root.  Clicking on a leaf pops up the window for querying MIB values.  Menu bar in the snmpxtree window permits the user to search for MIB variables, display the online manual, etc.  The following selections are available from this menu bar.  File

Control...
This item is used to pop up the control panel to set the number of timeouts and retries. The timeout value specifies the number of seconds which must elapse after an SNMP query with no response before the agent is judged to be not responding. The number of retries value specifies how many times queries to the agent ending in no response should be reattempted.

Exit
Exits snmpxtree. 

View

Search...
Pops up a window for keying in the MIB variable to be searched for. The search key input is interpreted as a regular expression.

Next
Searches for the MIB variable in the forward direction.

Prev
Searches for the MIB variable in the reverse direction.

Home position
Moves to the root of the currently displayed subtree.

Go Root
Moves to the root of the entire MIB tree.

Help

Version...
Displays version information.

Manual...
Displays the online manual.

When the user clicks on a leaf, a window for querying MIB variables pops up (the title of the window is “MIB query”).  The agent to be queried and the community name should then be entered.  The MIB query window has its own menu bar, allowing the user to launch applications, display brief explanations of MIB variables, etc.  The following selections are available from this menu bar.  Execute

MIB variable overview...
Displays the MIB variable definition corresponding to the RFC files.

Interface monitor
Invokes snmpxperfmon. 

telnet
Invokes telnet. 

ping
Invokes ping. 

After inputting the agent and community name for the query using the window for querying MIB variables (window title: “MIB query”) and clicking on the “OK” button, a new window (window title: “MIB variables”) pops up to display the values of MIB variables.  The window also has a menu bar, which can be used to launch applications.  In order to launch an application from this menu bar, it is first necessary to select an MIB variable.  The following selections are available from this menu bar.  Execute

Bar graph
Invokes snmpxbar. 

X-Y graph
Invokes snmpxperf. 

Set MIB variable
Invokes snmpset. 

OPTIONS

In addition to the standard X Toolkit options, snmpxtree also supports the following.  −snmpVarsFile varfile
−f varfile

Specifies the MIB database. The default is /etc/snmp.variables.

−treeDepth integer
−d integer

Specifies the displayable tree depth. The default is 4. 

−lineWidth width
−lw width

Specifies the width of the lines linking nodes with other nodes (or leaves).  The default is 1. 

−hSpace pixel
−hs pixel

Specifies the horizontal distance between nodes (or leaves).  The default is 50. 

−vSpace pixel
−vs pixel

Specifies the vertical distance between nodes (or leaves).  The default is 0. 

−timeOut seconds
−t seconds

Specifies the timeout when querying MIB variables.  The default is 10. 

−maxRetry times
−m times

Specifies the number of times a MIB query should be reattempted after an initial failure.  The default is 3 times. 

−bell on/off

Specifies whether or not the bell should sound when errors are generated.  The default is “on”. 

−help

Displays a description of the options unique to snmpxtree. 

RESOURCES

snmpxtree supports all of the standard resource names and class names included in X Toolkit.  In addition, the following application resources may be used.  The default values are shown below. 

Snmpxtree.treeDepth: 4
Snmpxtree.lineWidth: 1
Snmpxtree.hSpace: 50
Snmpxtree.vSpace: 0
Snmpxtree.pickRfc: /usr/sony/doc/SNMP/pickRfc
Snmpxtree.timeOut: 3
Snmpxtree.maxTimeOut: 10
Snmpxtree.maxRetry: 3
Snmpxtree.maxMaxRetry: 10
Snmpxtree.bell: on
Snmpxtree.unmapWhenFound: on

BUGS

Due to limitations on the size of windows that can be handled by X Window System, the display may become scrambled if the tree depth is set to too high a value.  The MIB database (file: /etc/snmp.variables) cannot be used with previous versions of NEWS-OS Release 4.1. The MIB variable overview takes a comparatively long time to display. It is also necessary to be careful regarding the format of the RFC file defining the MIB variables, otherwise search attempts may end in failure. There may be cases in which changes to the display may not be clear on monochrome displays. The use of a color display is recommended.

FILES

/etc/snmp.variables
/usr/sony/doc/SNMP
/usr/sony/doc/SNMP/pickRfc∗
/usr/lib/X11/app-defaults/Snmpxtree
/usr/lib/X11/ja_JP.SJIS/app-defaults/Snmpxtree
/usr/lib/X11/ja_JP.EUC/app-defaults/Snmpxtree

SEE ALSO

snmpxperfmon(1), telnet(1C), ping(8), snmpxbar(1), snmpxperf(1), snmpset(1)

REFERENCES

J.D. Case, J.R. Davin, M.S. Fedor, M.L. Schoffstall, Simple Network Management Protocol, Request for Comments 1157, Network Information Center, SRI International, Menlo Park, California, May, 1990.  M.T. Rose, K. McCloghrie, Structure of Management Information, Request for Comments 1155, Network Information Center, SRI International, Menlo Park, California, May, 1990.  K. McCloghrie, M.T. Rose, Management Information Base, Request for Comments 1156, Network Information Center, SRI International, Menlo Park, California, May, 1990.  M.T. Rose, Editor Management Information Base: MIB-II, Request for Comments 1158, Network Information Center, SRI International, Menlo Park, California, May, 1990. 

NEWS-OSRelease 4.2.1R