KN3 OSA-Express7S Ports Summary Attributes

Use the KN3 OSA-Express7S Ports Summary attributes to monitor individual ports on an OSA-Express7S feature.

This table represents the data associated with an individual port on an OSA-Express7 feature. This table contains summary data for the OSA-Express7 feature. There can be two physical ports on each OSA CHPID that have different data. When two ports are present, each one is assigned a separate ifIndex by the operating system. Each ifIndex will contain the data for the corresponding port.

Active MAC Address A 6-byte octet string that contains the current MAC address in use on the adapter. The values are in canonical format.

Active Speed Mode The actual speed and mode in which the OSA is running. This value is stored as an integer but displayed as a string. The possible values are:

unknown=0
tenMegabits=1
tenMbFullDuplex=2
oneHundredMbHalfDuplex=3
oneHundredMbFullDuplex=4
oneThousandMbFullDuplex=6
tenGigabitFullDuplex=8
twentyfiveGbFullDuplex=10

Burned In MAC Address A 6-byte octet string that contains the burned-in MAC address on the OSA. The values are in canonical format.

Channel Number The channel path identifier (CHPID) corresponding to this device. The format is a string of two hexadecimal characters. The name of this attribute is abbreviated Chan Num in the enhanced 3270 interface.

Collection Time The time and date of the data sampling. This time is displayed in the following format:

mm/dd/yy hh:mm:ss (Tivoli Enterprise Portal) or yy/mm/dd hh:mm:ss (3270)

Configuration Name The name of the configuration that is on the OSA. This value is set using the Open Systems Adapter/Support Facility (OSA/SF). It is not used by the OSA. The format is a string of up to 34 characters.

Configuration Speed Mode The configured port speed. This field shows the speed that was configured by the user for the OSA-Express Fast Ethernet feature. It is not used by OSA-Express Gigabit or 10 Gigabit Ethernet feature and returns notValidGigabit for these devices. This value is stored as an integer and displayed as a string with the following possible values:

notValidGigabit=-1
autoNegotiate=0
tenMbHalfDuplex=1
tenMbFullDuplex=2
oneHundredMbHalfDuplex=3
oneHundredMbFullDuplex=4
oneThousandMbFullDuplex=6
tenGigabitFullDuplex=8
twentyfiveGbFullDuplex=10

Disabled Status Reasons for the disabled state. When the value of the LAN Traffic State attribute is disabled (5), this attribute explains the reasons for the disabled state. The value for this object may be a combination of the bits shown in the list which follows. This value is stored as a hexadecimal integer and displayed as a 4-digit hexadecimal number mapped by the bit settings below:

reserved0=0
internalPortFailure=1
reserved2=2
reserved3=3
reserved4=4
reserved5=5
portTemporarilyDisabled=6
reserved7=7
reserved8=8
serviceProcessorRequest=9
networkRequest=10
osasfRequest=11
configurationChange=12
linkFailureThresholdExceeded=13
reserved14=14
reserved15=15

Exclusive Usage ID Specifies the exclusive usage ID that, when paired with the corresponding Exclusive Usage MAC, defines one of multiple Ethernet ports that can be used in parallel to increase the link speed beyond the limits of any single port. The format is an 8-character text string

Exclusive Usage MAC Specifies the exclusive usage MAC that, when paired with the corresponding Exclusive Usage ID, defines one of multiple Ethernet ports that can be used in parallel to increase the link speed beyond the limits of any single port. The format is a 12-digit hexadecimal string.

Interface Index The interface index associated with this port. The format is an unsigned integer.

IPv4 Layer 3 VMAC Specifies the MAC address being used if a Layer 3 Virtual MAC is being used for IPv4 on this stack. If the Layer 3 VMAC for IPv4 is not assigned, this field will contain all zeros. The format is a 12-digit hexadecimal string.

IPv6 Layer 3 VMAC Specifies the MAC address being used if a Layer 3 Virtual MAC is being used for IPv6 on this stack. If the Layer 3 VMAC for IPv6 is not assigned, this field will contain all zeros. The format is a 12-digit hexadecimal string.

LAN Traffic State The LAN state, expressed in value ranges from 0 to 8. A value of 5 (disabled) is further explained by the Disabled Status attribute. This value is stored as an integer and displayed as a string. The possible values are:

undefined=0
unavailable=1
enabling=2
disabling=3
enabled=4
disabled=5
linkMonitor=6
definitionError=7
configuredOffline=8

For more information about these values, see the zSeries Open Systems Adapter-Express Customer's Guide and Reference.

Origin Node The unique identifier for the TCP/IP stack being displayed. The format is an alphanumeric string no longer than 32 characters.

Octet Rate The average number of octets received or transmitted per minute, during the current collection interval. This count includes octets of all lengths, octets containing errors, and flow-control octets. The format is a long, long integer.

Octets Received The number of octets received during the current collection interval. This count includes octets of all lengths, octets containing errors, and flow-control octets. The format is a long, long integer.

Octets Received or Transmitted The number of octets received or transmitted during the current collection interval. The format is a long, long integer. The name of this attribute is abbreviated Octets Recvd or Xmitd in the enhanced 3270 interface.

Octets Transmitted The number of octets transmitted during the current collection interval. The format is a long, long integer.

Packet Rate The average number of packets received or transmitted, per minute, during the current collection interval. The format is a long, long integer.

Packets Received The number of packets received during the current collection interval. All packets are counted, including packets of all lengths and flow-control packets. The format is a long, long integer. The name of this attribute is abbreviated Packets Recvd in the enhanced 3270 interface.

Packets Received or Transmitted The number of packets received or transmitted during the current collection interval. All packets are counted, including packets of all lengths, packets containing errors, and flow-control packets. The format is a long, long integer. The name of this attribute is abbreviated Packets Recvd or Xmitd in the enhanced 3270 interface.

Packets Transmitted The number of packets transmitted during the current collection interval. All packets are counted, including packets of all lengths, packets containing errors, and flow-control packets. The format is a long, long integer. The name of this attribute is abbreviated Packets Xmitd in the enhanced 3270 interface.

Port Interface Index The OSA-Express QDIO port interface index. For interfaces defined by DEVICE and LINK, this is the DEVICE interface index. For interfaces defined by INTERFACE, this is the dynamically generated interface index for the port. This field only applies to the following interface types:

- NWMIFTOSAETHOSD
- NWMIFTOSAETHOSM
- NWMIFTOSAETHOSX

The format is an unsigned integer. For more information about these interface types, see IBM® z/OS® Communications Server: IP Configuration Guide.

Port Name The name of the port used by TCP/IP. The format is a 32-character alphanumeric string.

Port Number The physical port number for this port. The format is an integer.

Port Type The physical port type. This value is stored as an integer but displayed as a string. Valid values are:

osaexp71000BaseTE=198
osaexp71GbE=199
osaexp710GbE=200
osaexp725GbE=201

Service Mode An indicator of whether the processor is in service mode. This value is stored as an integer but displayed as a string. The possible values are:

NotInServiceMode=0
InServiceMode=1

System ID The SMF system ID. The format is an alphanumeric string no longer than 4 characters.

TCPIP STC Name The name of the TCP/IP job. The format is an alphanumeric string no longer than 8 characters.

Total Octets The number of octets received or transmitted since the last time the OSA port was reset. This count includes octets of all lengths, octets containing errors, and flow-control octets. The format is a long, long integer.

Total Octets Received The number of octets received since the last time the OSA port was reset. This count includes octets of all lengths, octets containing errors, and flow-control octets. The format is a long, long integer. The name of this attribute is abbreviated Tot Octets Recvd in the enhanced 3270 interface.

Total Octets Transmitted The number of octets transmitted since the last time the OSA port was reset. This count includes octets of all lengths, octets containing errors, and flow-control octets. The format is a long, long integer. The name of this attribute is abbreviated Tot Octets Xmitd in the enhanced 3270 interface.

Total Packets The number of packets received or transmitted. All packets are counted, including packets of all lengths and flow-control packets. The format is a long, long integer.

Total Packets Received The number of packets received. All packets are counted, including packets of all lengths, packets containing errors, and flow-control packets. The format is a long, long integer. The name of this attribute is abbreviated Tot Pkts Recvd in the enhanced 3270 interface.

Total Packets Transmitted The number of packets transmitted. All packets are counted, including packets of all lengths and flow-control packets. The format is a long, long integer. The name of this attribute is abbreviated Tot Pkts Xmitd in the enhanced 3270 interface.