setany(ADMN)

setany -- retrieve and set objects in an SNMP entity

Synopsis

setany [-f defn_file] [-T timeout] entity_addr community_string
object_name -{i | o | d | a|c | g | t | s | n} value] ...

Description

The setany command does a GET request to get the current values of the objects to be set, then performs a SET request on the objects.

Options

The options and arguments are:

entity_addr: The entity address can be either an IP address or entity name (if name-to-address resolution is enabled).
community_string: The community string used must be valid on the given entity. Community strings are kept in /etc/netmgt/snmpd.comm.
-f defn_file: The argument is used to specify a file containing the mosy(ADMN) and post_mosy(ADMN) compiled list of object names and their numeric Object Identifiers, in addition to the objects in the standard MIB. This allows the user to dynamically augment the number of objects that can be recognized by the management utility.
-T timeout: Specifies the number of seconds the command will wait for a response from the entity specified by address. If not specified, this defaults to 20 seconds.
object_name -{i|o|d|a|c|g|t|s|n} value: One or more triplets for each object to be set, consisting of the object name, followed by a dash and a flag, followed by a value.

Object names must refer to a valid SNMP object or class of objects. Object names can be in the form of an identifier or the equivalent SNMP dot-notation. Identifiers for SNMP objects are listed in ``Group and object descriptions'' in Configuring and administering SNMP. Equivalent SNMP dot-notation for these objects is defined in the files /etc/netmgt/nwumpsd.defs, /etc/netmgt/snmpd.defs, and /etc/netmgt/unixwared.defs. (For a general explanation of SNMP dot-notation, see RFC 1213.)

The available flags are:

-a: The object is an IP address (in dot notation); value is specified in decimal number in IP address format (xxx.xxx.xxx.xxx).
-c: The object is a counter; value is specified as a decimal integer.
-d: The object is an object identifier (in dot notation); value is specified as a decimal OID (see RFC 1213).
-g: The object is a gauge; value is specified as a decimal integer.
-i: The object is an integer; value is specified as a decimal integer.
-n: The object is a null value; value is specified as 0.
-o: The object is an octet string; value is specified as a hexadecimal number.
-s: The object is a string; value is specified as a character string enclosed within double quotes.
-t: The object is in clock-ticks (hundredths of a second); value is specified as a decimal integer.

NOTE: The range of allowable values for a particular object depends on how the specified object_name is defined. The object definitions in the files /etc/netmgt/nwumpsd.defs, /etc/netmgt/snmpd.defs, and /etc/netmgt/unixwared.defs define the allowable values for SNMP objects as well as the type of the object (which tells you what flag to use when setting the object).

The actions that take place during a SET request are that a GET request is issued for the object. The object name returned from this request is used in the SET request.

Examples

The following request

setany suzzy suranet0 "ifAdminStatus.2" -i 3

would set the administrative status of interface 2 to 3 (down).

References

getmany(ADMN), getnext(ADMN), getone(ADMN), mosy(ADMN), post_mosy(ADMN), snmp(ADMN)

RFC 1156, RFC 1157, RFC 1213