Agent Technology Commands › awset-Set the Value of a MIB Attribute

awset-Set the Value of a MIB Attribute

Valid on UNIX/Linux, Windows, z/OS

awset sets the value of a MIB attribute. If you use the -o option, the attribute OID is printed followed by the OID value.

UNIX/Linux, z/OS

Many UNIX/Linux nodes have a MIB II-compliant SNMP agent built into the operating system. These agents are hard-coded to listen for manager requests on UDP port number 161. To prevent port conflicts between the operating system agent and your agent, the SNMP Administrator defaults to listening for requests on UDP port number 6665.

Windows

install-path\services\bin

UNIX/Linux, z/OS

install-path/services/bin

z/OS JCL

&CAI.MFNSM.CAW0JCL(AWSET)

Note: Your set request fails if the attribute is write-protected.

This command has the following format:

awset [-h hostname] -c community [-p service] [-o] OID type value [-t timeout]

-h hostname

Specifies the host name or IP address of the system on which the agent is running.

Default: local node

-c community

Specifies the name of any community supported for write access in the agent configuration.

If you want to retrieve the MIB attribute value from a specific instance of an agent, then you need to postfix the community string with the @ sign, followed by the specific agent's instance name.

Default: public

-p service

Specifies the name in the /etc/services file that translates to a port number, or the number of the UDP port where the agent listens for incoming requests. This value must match the one used by the SNMP Administrator, which is normally 6665.

Default: 161

-o OID

Specifies the object identifier of a specific instance of any attribute in the agent MIB.

type

Specifies one of the following options indicating the type of the specified attribute:

-i integer value

-o octet value

-s string value

-d object identifier (OID)

-a IP address

-c counter

-g gauge

-t time ticks

value

Specifies the new value of the attribute instance.

-t timeout

Specifies the maximum time value (in seconds) this program waits for a response to an SNMP request before exiting.

Default: 10 seconds