Content-type: text/html Man page of GETMANY

GETMANY

Section: Misc. Reference Manual Pages (SR_CMDMAN)
Updated: 23 July 1993
Index Return to Main Contents
 

NAME

getmany - retrieve classes of variables from a SNMP entity.  

SYNOPSIS

getmany agent_addr clustername variable_class ...
 

DESCRIPTION

The getmany utility is a SNMP application to retrieve classes of variables from a SNMP entity.

The arguments to getmany are

agent_addr:
address of machine running SNMP agent.
clustername:
either a SNMPv1 community string or a SNMPv2 party clustername.
variable_name:
MIB variable class name(s) expressed as object identifiers in either dot-notation or as the MIB variables from the MIB document.
 

EXAMPLES

The getmany utility retrieves the variable class by calling the SNMP entity with the variable_class to get the first variable in the class, and then calling the entity again using the variable name returned in the previous call to retrieve the next variable in the class, utilizing the get-next aspect of the variable retrieval system. For instance, running the following:

getmany myagent public system

or

getmany myagent Mgr1Agt1 system

will traverse the network entity's system variable class. The traversing of the variable space stops when all of the classes being polled return a variable of a class different than what was requested. Note that a network entity's entire variable tree can be traversed with a call of

getmany myagent public iso

or

getmany myagent Mgr1Agt1 iso  

FILES


 /etc/srconf/mgr/acl.pty
 /etc/srconf/mgr/context.pty
 /etc/srconf/mgr/acl.pty
 /etc/srconf/mgr/mgr.cnf
 /etc/srconf/mgr/mgr.pty
 /etc/srconf/mgr/snmpinfo.dat
 /etc/srconf/mgr/view.pty  

SEE ALSO

getnext(SR_CMDMAN), getbulk(SR_CMDMAN), gettab(SR_CMDMAN), SNMP RFCs (RFC1155 RFC1157 RFC1212 RFC1213 RFC1215, RFCs 1441-1452)  

KNOWN BUGS

If more than one variable class is requested, odd effects may be seen. Specifically, since "The traversing of the variable space stops when all of the classes being polled return a variable of a class different than what was requested," once the first variable class completes, everything quits whether all the variables were returned or not. Another side-effect of this behavior is if the first variable class is "large," the other variable classes will continue to be retrieved whether they're finished or not. This can result in "End of MIB" or other errors being displayed within the values from other requests.  

LIMITATIONS

If more than one variable class is requested and any one of the classes does not exist, nothing will be returned for any of the classes.


 

Index

NAME
SYNOPSIS
DESCRIPTION
EXAMPLES
FILES
SEE ALSO
KNOWN BUGS
LIMITATIONS

This document was created by man2html, using the manual pages.
Time: 02:42:51 GMT, October 02, 2010