Attributes for Network adapter lists some key attributes for network adapter.

Table 1. Attributes for Network adapter

Attribute

Description

Allowed values

AdminStatus

Reflects the current administrative status of this network adapter (port or interface) as reported by the instrumentation:

  • UP indicates that this network adapter is administratively enabled.

  • DOWN indicates that this network adapter is administratively disabled.

  • TESTING indicates that this network adapter is in testing mode.

  • OTHER indicates that this network adapter is in an unknown state.

  • NOTPRESENT indicates that the MIB AdminStatus value for this network adapter is missing.

    IP Availability Manager sets a network adapter’s AdminStatus value to NOTPRESENT when receiving one of the following SNMP errors:

    SNMP_EXP_NOSUCHOBJECT

    SNMP_ERR_NOSUCHNAME

    SNMP_EXP_NOSUCHINSTANCE

    SNMP_EXP_ENDOFMIB

  • UNKNOWN indicates that this network adapter has yet to be polled.

    Note:

    IP Availability Manager uses the values of a network adapter’s AdminStatus and OperStatus attributes to determine the state of the adapter. When the value of AdminStatus is UP, the value of OperStatus determines the state of the adapter. Otherwise, the value of AdminStatus determines the state of the adapter.

Enum:

  • UP

  • DOWN

  • TESTING

  • OTHER

  • NOTPRESENT

  • UNKNOWN

CurrentUtilization

Current utilization of this network adapter expressed as a percentage of the bandwidth; for example:

3.7179998E-4

Note:

In IP 9.1, if ports and interfaces do not have instrumentation, then the CurrentUtilization value will be displayed as zero.

Numeric (float)

DeviceID

Address or other identifying information to uniquely name this network adapter. DeviceID refers to the system to which this network adapter belongs.

String

DisplayName

Name, as shown in the Global Console, of this network adapter.

Port example:

PORT-10.9.252.2/1 [Gi1/1]

Interface example:

IF-10.9.1.253/1 [Ethernet] [10.9.1.253]

String

DuplexMode

Indicates whether this network adapter is full-duplex or half-duplex:

  • FULLDUPLEX indicates that this network adapter is full-duplex.

  • HALFDUPLEX indicates that this network adapter is half-duplex.

  • UNSPECIFIED indicates that the duplex mode value is not available for this network adapter.

Enum:

  • FULLDUPLEX

  • HALFDUPLEX

  • UNSPECIFIED

DuplexSource

Indicates the source for setting this network adapter to full-duplex or half-duplex:

  • ENTERPRISE_MIB indicates that duplex mode for this network adapter is set by an enterprise specific MIB.

  • ETHERLIKE_MIB indicates that duplex mode for this network adapter is set by the value of dot3StatsDuplexStatus in the ETHERLIKE MIB.

  • NEIGHBOR_MIB indicates that duplex mode for this network adapter is set by the neighbor MIB (such as the Cisco CDP MIB).

  • USER_CHANGED indicates that duplex mode for this network adapter is set by the user.

  • ASSUMED indicates that duplex mode for this network adapter is set based on the type of network adapter.

  • NONE indicates that duplex mode for this network adapter is not set by any source.

  • OTHER_SOURCE value is a placeholder for future use.

Enum:

  • ENTERPRISE_MIB

  • ETHERLIKE_MIB

  • NEIGHBOR_MIB

  • USER_CHANGED

  • ASSUMED

  • NONE

  • OTHER_SOURCE

InterfaceAlias

An alias name for the network adapter as specified by a network manager; for example:

  • By VPNSC: Job Id# = 77

  • By VPNSC: Job Id# = 82

String

IsFlapping

TRUE if this network adapter is flapping.

(FALSE if this network adapter is not flapping.)

Boolean:

TRUE, FALSE

MaximumUptime

Maximum length of time, in seconds, that a backup or dial-on-demand network adapter may be in the UP state before the event ExceededMaximumUptime is generated.

If this attribute is set to 0, the event is disabled.

Integer

MaxSpeed

Maximum speed, in bits per second (bps), for this network adapter; for example:

10000000 bps

Integer

MaxTransferUnit

Size of the largest datagram, in octets, that can be sent or received on this network adapter; for example:

1500 octets

For a network adapter that is used for transmitting network datagrams, this value is the size of the largest network datagram that can be sent on the adapter.

Integer

Mode

Indicates the intended purpose of this network adapter: normal, backup, or dial-on-demand.

The diagnostics applied to a particular network adapter varies based on its mode. For instance, an event is not generated when a backup or dial-on-demand adapter is down.

Enum:

  • NORMAL

  • BACKUP

  • ONDEMAND

Name

Name, as known in the modeled topology, of this network adapter.

Port example:

PORT-10.9.252.2/1

Interface example:

IF-10.9.1.253/1

String

NumberOfNetworkAdapters

Total number of network adapters for the system containing this network adapter.

Integer

OperStatus

Reflects the current operational status of this network adapter as reported by the instrumentation:

  • UP indicates that this network adapter is operationally up.

  • DOWN indicates that this network adapter is operationally down.

  • TESTING indicates that this network adapter is in testing mode.

  • OTHER indicates that this network adapter is in an unknown state.

  • DORMANT indicates that this network adapter is waiting for an external action to occur before becoming active.

  • NOTPRESENT indicates that the MIB OperStatus value for this network adapter is missing.

    IP Availability Manager sets a network adapter’s OperStatus value to NOTPRESENT when receiving one of the following SNMP errors:

    SNMP_EXP_NOSUCHOBJECT

    SNMP_ERR_NOSUCHNAME

    SNMP_EXP_NOSUCHINSTANCE

    SNMP_EXP_ENDOFMIB

  • UNKNOWN indicates that this network adapter has yet to be polled.

Enum:

  • UP

  • DOWN

  • TESTING

  • OTHER

  • DORMANT

  • NOTPRESENT

  • UNKNOWN

PortType

Applicable to Port only: Type of port represented by this Port.

Enum:

  • TRUNK

  • ACCESS (default)

SystemName

Name of the system containing this network adapter; for example:

10.9.1.108

String

SystemObjectID

System object identifier associated with the vendor of the system containing this network adapter; for example:

.1.3.6.1.4.1.311.1.1.3.1.1

String

SystemType

Type of system containing this network adapter; for example:

SWITCH

Enum:

  • HOST

  • ROUTER

  • SWITCH

  • HUB

  • SERVER

  • BRIDGE

  • REPEATER

  • PROBE

  • OTHER

  • TERMINALSERVER

Type

Type of network adapter, distinguished according to the physical/link protocols immediately “below” the network layer in the protocol stack.

Enum:

ATMFUNI

ARCNET

SONET

HIPPI

MODEM

V36

IEEE1394

IFGSN

ATMVIRTUAL

Note:

The configuration file InterfaceType.conf has the exhaustive list of allowed values. The configuration file is located at:BASEDIR/smarts/conf/discovery