setany(1M) setany(1M)
NAME
setany - retrieve and set objects in an SNMP entity
SYNOPSIS
setany [-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.
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. On UnixWare, community strings are kept in
/etc/netmgt/snmpd.comm.
-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 UnixWare
SNMP objects are listed in the section ``SNMP Objects'' in the
chapter ``Network Management Using SNMP'' of part ``TCP/IP
Administration'' of the book Network Administration.
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.)
Copyright 1994 Novell, Inc. Page 1
setany(1M) setany(1M)
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 that 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.
EXAMPLE
The following request
setany suzzy suranet0 "ifAdminStatus.2" -i 3
Copyright 1994 Novell, Inc. Page 2
setany(1M) setany(1M)
would set the administrative status of interface 2 to 3
(down).
REFERENCES
getmany(1M), getnext(1M), getone(1M), snmp(1M), RFC 1155, RFC
1156, RFC 1157, RFC 1213.
Copyright 1994 Novell, Inc. Page 3