Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ setany(1M) — UnixWare 2.01

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

getmany(1M)

getnext(1M)

getone(1M)

snmp(1M)






       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








Typewritten Software • bear@typewritten.org • Edmonds, WA 98026