KN3 Interface Status Attributes

Use the KN3 Interface Status attributes to display status information for all interfaces defined to a z/OS(R) v1r12 or later system.

Notes:

  1. This attribute group is available only on systems running z/OS® v1.12 or later.
  2. A blank in any of these fields means that this attribute does not apply to this interface either at all or at this time.

Actual Dynamic Type The actual dynamic inbound performance type. This value is stored as an integer and displayed as a string. Valid values are:

128 = WORKLOADQ_in_effect

The value for this attribute will be non-zero only when the Actual Inbound Performance Type has a value of DYNAMIC.

This value is specified with the INBPERF optional parameter on the LINK statement in the TCPIP.PROFILE dataset. The DYNAMIC setting causes the host to dynamically signal the OSA-Express feature to change the timer-interrupt value, based on current inbound workload conditions. The DYNAMIC setting is effective only for OSA-Express2 features on an IBM® System z9® EC or z9® BC with the corresponding Dynamic LAN Idle functional support. See the IBM z/OS Communications Server IP Configuration Reference for more information.

Actual Inbound Performance Type The actual inbound performance type. This value is stored as an integer and displayed as a string. Valid values are:

  • 1 = BALANCED
  • 2 = DYNAMIC
  • 3 = MINCPU
  • 4 = MINLATENCY

This value is specified with the INBPERF optional parameter on the LINK statement in the TCPIP.PROFILE dataset and indicates how frequently the OSA adapter should interrupt the host for inbound traffic. See the IBM z/OS Communications Server IP Configuration Reference for more information. The name of this attribute is abbreviated Actual Perf Type in the enhanced 3270 interface.

Actual MTU Value The actual maximum transmission unit (MTU) value. The format is a 2-byte unsigned integer.

Maximum transmission unit (MTU), or maximum packet size in TCP/IP terms is the maximum size for the data field. For a static route, the MTU size for a route is configured using the on either a ROUTE statement in a BEGINROUTES block or on a GATEWAY statement in the TCP/IP profile. For each IPv4 dynamic route added by OMPROUTE over an interface, the configured route MTU comes from the value of the MTU keyword specified on the RIP_INTERFACE, OSPF_INTERFACE or INTERFACE statement in the TCPIP.PROFILE dataset for that interface in the OMPROUTE configuration file. If you do not specify an MTU for an interface, OMPROUTE uses 576. For IPv6, OMPROUTE learns the interface MTU value from TCP/IP, and you cannot specify a configured route MTU in the OMPROUTE configuration file. The name of this attribute is abbreviated Act MTU in the enhanced 3270 interface.

See the IBM z/OS Communications Server IP Configuration Guide for more information about this parameter.

Actual Router Type The actual router type. This value is stored as an integer and displayed as a string. Valid values are:

  • 1 = NONROUTER
  • 2 = PRIROUTER
  • 3 = SECROUTER

These router type values are optional parameters on the z/OS Communications Server DEVICE statement in the TCPIP.PROFILE dataset that control the behavior of a datagram that is received at the subject device from an unknown IP address. See the IBM z/OS Communications Server IP Configuration Reference for more information.

ARP Offload Active Indicates whether the Address Resolution Protocol (ARP) offload function is active for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

The ARP Offload function can be configured to cause all ARP processing to the offloaded to the OSA adapter. See the z/OS Communications Server IP Configuration Guide for more information about this function.

ARP Offload Reported Indicates whether the Address Resolution Protocol (ARP) offload function is being reported to the TCP/IP stack for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

The ARP Offload function can be configured to cause all ARP processing to the offloaded to the OSA adapter. See the IBM z/OS Communications Server IP Configuration Guide for more information about this function.

ARP or ND/VIPA Owner Indicates whether this interface is the owner of the Address Resolution Protocol or the Neighbor Discovery/ Virtual IP Address(ND/VIPA) process for this virtual LAN (VLAN) group. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

See the IBM z/OS Communications Server IPv6 Network and Application Design Guide for more information about this function.

Autorestart Active Indicates whether the autorestart function is active for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

AUTORESTART is a parameter on the z/OS Communications Server DEVICE statement in the TCPIP.PROFILE dataset that controls device failure reactivation behavior. NOAUTORESTART is the default parameter. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter.

Checksum Offload Active Indicates whether the checksum offload function is active for this interface. This value is stored as an integer and displayed as a string. Valid values are:
  • 0 = No
  • 1 = Yes
CHECKSUM is a parameter on the LINK statement in the TCPIP.PROFILE dataset. With checksum offloading active, TCP/IP offloads most IPv4 (outbound and inbound) checksum processing (IP header, TCP, and UDP checksums) to the OSA. See IBM z/OS Communications Server IP Configuration Guide for more information about this parameter. The name of this attribute is abbreviated Checksum Offload in the enhanced 3270 interface.

CHPID The Channel Path Identifier (CHPID) value for this interface. This value is set for Hipersockets, active OSA, and inactive OSA OSX interfaces. The format is an unsigned integer.

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)

Where:

  • mm = Month
  • dd = Day of the month
  • yy = Year
  • hh = Hour
  • mm = Minute
  • ss = Seconds

The stored format is a string no longer than 16 characters in the format CYYMMDDHHMMSSmmm (as in 1020315064501000 for 03/15/02 06:45:01) where:

  • C = Century (0 for 20th, 1 for 21st)
  • Y = Year
  • M = Month
  • D = Day
  • H = Hour
  • M = Minute
  • S = Second
  • m = Millisecond

Configured Dynamic Type The configured dynamic type. This value is stored as an integer and displayed as a string. Valid values are:

128 = WORKLOADQ_specified

The value for this attribute will be non-zero only when the Actual Inbound Performance Type has a value of DYNAMIC.

This value is specified with the INBPERF optional parameter on the LINK statement in the TCPIP.PROFILE dataset. The DYNAMIC setting causes the host to dynamically signal the OSA-Express feature to change the timer-interrupt value, based on current inbound workload conditions. The DYNAMIC setting is effective only for OSA-Express2 features on an IBM System z9 EC or z9 BC with the corresponding Dynamic LAN Idle functional support. See the IBM z/OS Communications Server IP Configuration Reference for more information.

Configured Inbound Performance Type The configured inbound performance type. This value is stored as an integer and displayed as a string. Valid values are:

  • 1 = BALANCED
  • 2 = DYNAMIC
  • 3 = MINCPU
  • 4 = MINLATENCY

This value is specified with the INBPERF optional parameter on the LINK statement in the TCPIP.PROFILE dataset and indicates how frequently the OSA adapter should interrupt the host for inbound traffic. See the IBM z/OS Communications Server IP Configuration Reference for more information. The name of this attribute is abbreviated Configured Perf Type in the enhanced 3270 interface.

Configured MTU Value The configured maximum transmission unit (MTU) value. The format is a 2-byte unsigned integer.

Maximum transmission unit (MTU), or maximum packet size in TCP/IP terms, is the maximum size for the data field. For a static route, the MTU size for a route is configured using either a ROUTE statement in a BEGINROUTES block or on a GATEWAY statement in the TCP/IP profile. For each IPv4 dynamic route added by OMPROUTE over an interface, the configured route MTU comes from the value of the MTU keyword specified on the RIP_INTERFACE, OSPF_INTERFACE or INTERFACE statement in the TCPIP.PROFILE dataset for that interface in the OMPROUTE configuration file. If you do not specify an MTU for an interface, OMPROUTE uses 576. For IPv6, OMPROUTE learns the interface MTU value from TCP/IP, and you cannot specify a configured route MTU in the OMPROUTE configuration file.

See the IBM z/OS Communications Server IP Configuration Guide for more information about this parameter.

Configured Router Type The configured router type. This value is stored as an integer and displayed as a string. Valid values are:

  • 1 = NONROUTER
  • 2 = PRIROUTER
  • 3 = SECROUTER

These router type values are optional parameters on the z/OS Communications Server DEVICE statement in the TCPIP.PROFILE dataset that controls the behavior of a datagram that is received at the subject device for an unknown IP address. The default is NONROUTER (do not route the datagram). See the IBM z/OS Communications Server IP Configuration Reference for more information.

Datapath Device Number The datapath device number. This field is valid only for IPAQENET and IPAQENET6 interfaces. The format is an unsigned integer.

Destination Address The routing destination address. The format is an alphanumeric string no longer than 45 characters.

This address only applies to IPv4 multipath channel (MPC) point-to-point device (PTP) interface defined by DEVICE/LINK profile statements. The value is set by the following parameters:

  • BSDROUTINGPARMS profile statement
  • OMPROUTE configuration statement
  • Stack sets default of gateway address or destination addr of a route over the interface.

Device or Datapath Status The device or datapath status. This value is stored as an integer and displayed as a string. Valid values are:

  • 1 = Starting
  • 2 = Sent_Setup
  • 3 = Enabling
  • 4 = Connecting
  • 5 = Connecting2
  • 6 = Negotiating
  • 7 = Active
  • 8 = Deactivating
  • 9 = Not_Active

The name of this attribute is abbreviated Device or Datapath in the enhanced 3270 interface.

Duplicate Address Count The number of times to attempt duplicate address detection for this interface. The format is a 2-byte unsigned integer.

This value is specified with the optional DUPADDRDET count parameter on the INTERFACE statement in the TCPIP.PROFILE dataset. This parameter is used to specify the number of times to attempt duplicate address detection. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter. The name of this attribute is abbreviated Duplicate Addr Count in the enhanced 3270 interface.

Dynamic VLAN Registration Capable Indicates whether this interface is capable of handling dynamic virtual LAN (VLAN) registration. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

Dynamic VLAN registration is a parameter on the z/OS Communications Server LINK statement in the TCPIP.PROFILE dataset that controls VLAN ID configuration behavior for this link. Dynamic registration of VLAN IDs is handled by the OSA-Express feature and the physical switch on your LAN. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter. The name of this attribute is abbreviated Dynamic VLAN Reg Capable in the enhanced 3270 interface.

Dynamic VLAN Registration Configured Indicates whether this interface is configured for dynamic virtual LAN (VLAN) registration. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

Dynamic VLAN registration is a parameter on the z/OS Communications Server LINK statement in the TCPIP.PROFILE dataset that controls VLAN ID configuration behavior for this link. Dynamic registration of VLAN IDs is handled by the OSA-Express feature and the physical switch on your LAN. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter. The name of this attribute is abbreviated Dynamic VLAN Reg Config in the enhanced 3270 interface.

Dynamic XCF Interface Indicates whether this interface was created by the dynamic cross-system coupling facility (Dynamic XCF). This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

The dynamic cross-system coupling facility (Dynamic XCF) creates a single IP address by which all other stacks in a sysplex can reach a stack. Dynamic XCF support is available for both IPv4 and IPv6, and is enabled with the DYNAMICXCF parameter on the IPCONFIG or IPCONFIG6 statement, respectively. See the IBM z/OS Communications Server IP Configuration Guide for more information about this parameter.

GID The identifier for this RNIC or ISM interface. The value is a hexadecimal number for an ISM interface. The value is an IPv6 link-local address for an RNIC interface. The value is blank for an interface that is not active.

Interface Associated Name The interface Associated Name, when available, is the name of the DEVICE, PORT or TRLE associated with the interface. The format is an alphanumeric string no longer than 16 characters.

Interface Definition The indicator of how this interface is defined. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = Device_Link
  • 1 = Interface

IPv4 interfaces may be defined with either the DEVICE/LINK or INTERFACE statements. IPv6 interface are defined with the INTERFACE statements in the TCPIP.PROFILE dataset.

Interface Description More information about the values shown by the Interface Type attribute. This value is stored as an integer and displayed as a string. Valid values are:

  • 1 = Loopback
  • 2 = OSA-Express_QDIO_Ethernet_OSD
  • 3 = OSA-Express_QDIO_Ethernet_OSM
  • 4 = OSA-Express_QDIO_Ethernet_OSX
  • 5 = HiperSockets
  • 6= Multipath_Channel_Point-to-Point
  • 7= Multipath_Channel_Point-to-Point_Samehost
  • 8= Multipath_Channel_Point-to-Point_XCF
  • 9= Virtual_IP_Address
  • 10 = ATM
  • 11 = IBM_CLAW
  • 12 = Channel_to_Channel_(3088)
  • 13 = Network_Systems_Hyperchannel
  • 14 = LAN_Channel_Station_Ethernet_V2
  • 15 = LAN_Channel_Station_Ethernet_802.3
  • 16 = LAN_Channel_Station_Ethernet_(V2_or_802.3)
  • 17 = LAN_Channel_Station_Token Ring
  • 18 = LAN_Channel_Station_FDDI
  • 19 = OSA-Express_QDIO_Token_RIng
  • 20 = MPC_OSA_Fast_Ethernet
  • 21 = MPC_OSA_FDDI
  • 22 = SNA_LU0
  • 23 = SNA_LU6.2
  • 24 = X.25_NPSI
  • 25 = IP-over-Channel_(CDLC)
  • 26 = Internal_Queued_Direct_I/O_extensions
  • 27 = RDMA_Network_Interface_Card
  • 28 = Internal_Shared_Memory
  • 29 = HiperSockets_Converged_Interface
  • 30 = z/OS Container Extensions

Interface ID The IPv6 interface identifier. The format is an alphanumeric string no longer than 19 characters.

The Interface ID is a number that uniquely identifies the interface among the collection of all OSPF interfaces on this TCP/IP stack It is specified with the option INTFID interface_id parameter on the INTERFACE statement in the TCPIP.PROFILE datase. It is a 64-bit interface identifier in colon-hexadecimal format. If INTFID is not coded, TCP/IP generates a random value to be used to form the link-local address. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter.

Interface ID Specified Indicates whether the interface ID for this interface is active. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

The Interface ID is a number that uniquely identifies the interface among the collection of all OSPF interfaces on this TCP/IP stack It is specified with the option INTFID interface_id parameter on the INTERFACE statement in the TCPIP.PROFILE datase. It is a 64-bit interface identifier in colon-hexadecimal format. If INTFID is not coded, TCP/IP generates a random value to be used to form the link-local address. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter.

Interface Index (not displayed) The interface index. For interfaces defined by DEVICE and LINK, this is the LINK interface index. The format is a 4-byte unsigned integer.

Interface Index Specified The interface index. For interfaces defined by DEVICE and LINK, this is the LINK interface index. The format is a 4-byte unsigned integer.

Interface Name The interface Name. The format is an alphanumeric string no longer than 16 characters.

This value is specified with the intf_name parameter on the INTERFACE statement or the link_name parameter on the LINK statement in the TCPIP.PROFILE dataset. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter.

Interface Speed The interface speed, expressed as million bits per second. The format is a 4-byte unsigned integer.

This field applies to the following interface types only:

  • OSA-Express_QDIO_Ethernet_OSD
  • OSA-Express_QDIO_Ethernet_OSM
  • OSA-Express_QDIO_Ethernet_OSX

The value is specified with the optional IFHSPEED ifhspeed parameter on the LINK statement in the TCPIP.PROFILE dataset and is defined as an estimate of the interface's current bandwidth in one million bits per second units. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter.

Interface Status The status of this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 1 = Active
  • 2 = Not_Active
  • 3 = DAD_Pending

Interface Type The type of interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 1 = Loopback
  • 2 = OSA_QDIO_ethernet_OSD
  • 3 = OSA_QDIO_ethernet_OSM. This is the intranode management network (INMN), a private 1000BASE-T Ethernet network operating at 1 Gbps that is required for the Unified Resource Manager to manage the resources within a single zEnterprise(TM) node. The INMN connects the Support Element (SE) to the z196 and to any attached zBX. This interface is associated with the zEnterprise(TM) mainframe server.
  • 4 = OSA_QDIO_ethernet_OSX. This is the private 10 Gigabit Ethernet network for application data communications within an ensemble. Data communications for workloads can flow over the IEDN within and between nodes of an ensemble. All of the physical and logical resources of the IEDN are configured, provisioned, and managed by the Unified Resource Manager. This interface is associated with the zEnterprise(TM) mainframe server.
  • 5 = Hipersocket
  • 6 = MPC_ptp
  • 7 = MPC_ptp_samehost
  • 8 = MPC_ptp_xcf
  • 9 = Static_virtual
  • 10 = ATM
  • 11 = CLAW
  • 12 = CTC
  • 13 = HCH
  • 14 = LCS_ethernet_V2
  • 15 = LCS_ethernet_8023
  • 16 = LCS_ethernet_V2OR8023
  • 17 = LCS_tokenring
  • 18 = LCS_FDDI
  • 19 = OSA_QDIO_tokenring
  • 20 = MPCOSA_ethernet
  • 21 = MPCOSA_FDDI
  • 22 = SNA_LU0
  • 23 = SNA_LU62
  • 24 = X25_NPSI
  • 25 = CDLC
  • 26 = HiperSockets_IQDX
  • 27 = RNIC
  • 28 = ISM
  • 29 = HiperSockets_IQDC

IP Address Version The version of the IP address used by this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = IPv4
  • 1 = IPv6
ISM Associated Indicates whether or not this ISM interface is associated with OSA or HiperSockets interfaces. An associated ISM interface can be used for SMC-D links. Valid values are:
  • 1 = Yes
  • 2 = No

ISOLATE Specified Indicates whether the ISOLATE parameter is being specified on the INTERFACE statement in the TCPIP PROFILE dataset for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

The NOISOLATE and ISOLATE are parameters for the IPAQENET and IPAQENET6 OSA-Express queued direct input/output (QDIO) interfaces on the INTERFACE statement in the TCPIP.PROFILE dataset. They are used to disable and enable connection isolation. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter.

LAN ARP or ND Owner The name of the interface that owns Address Resolution Protocol (ARP) or Neighbor Discovery (ND) responsibility for this interface. The format is an alphanumeric string no longer than 16 characters.

The IPv4 networking layer uses the Address Resolution Protocol (ARP) to map an IP address into a hardware address. In the IPv6 networking layer, this mapping is performed by the Neighbor Discovery (ND function). On local area networks (LANs), such an address is called a media access control (MAC) address. See the IBM z/OS Communications Server IPv6 Network and Application Design Guide for more information about this function.

LAN Group Number The number of the LAN group to which this interface belongs. The format is a 2-byte unsigned integer.

Last Status Change The z/OS time and date of the last time that the interface status values changed. 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)

Where:

  • mm = Month
  • dd = Day of the month
  • yy = Year
  • hh = Hour
  • mm = Minute
  • ss = Seconds

The stored format is a string no longer than 16 characters in the format CYYMMDDHHMMSSmmm (as in 1020315064501000 for 03/15/02 06:45:01) where:

  • C = Century (0 for 20th, 1 for 21st)
  • Y = Year
  • M = Month
  • D = Day
  • H = Hour
  • M = Minute
  • S = Second
  • m = Millisecond

LPAR Name The LPAR name. The format is an alphanumeric string not longer than 8 characters.

MONSYSPLEX Active Indicates whether MONSYSPLEX is ACTIVE for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

MONSYSPLEX is a parameter on the INTERFACE statement in the TCPIP.PROFILE dataset. It specifies that sysplex autonomics should monitor the interface's status. This parameter can be modified dynamically using the VARY TCPIP,,OBEYFILE command. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter.

MONSYSPLEX Configured Indicates whether the indicator for MONSYSPLEX has been configured for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

MONSYSPLEX is a parameter on the INTERFACE statement in the TCPIP.PROFILE dataset. It specifies that sysplex autonomics should monitor the interface's status. This parameter can be modified dynamically using the VARY TCPIP,,OBEYFILE command. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter.

MPCPTP Checksum An indicator of whether the CHECKSUM parameter was specified on the LINK statement in the TCPIP PROFILE dataset for this multipath channel (MPC) point-to-point device (PTP) interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter.

Multicast Capable An indicator of whether this interface is capable of handling multicast packets. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

Multicast capability is a characteristic of a number of IP commands. Use the NETSTAT command to determine if the interface is multicast capable. See the IBM z/OS Communications Server IP Configuration Reference for more information about commands with multicast dependencies.

Multiwrite Status The hipersockets multiwrite status when the interface is in the ACTIVE state. This value is stored as an integer and displayed as a string. Valid values are:

  • 1 = Enabled
  • 2 = Enabled_ZIIP
  • 3 = Disabled
  • 4 = Unsupported

Multiwrite status is determined with the IQDMULTIWRITE and NOIQDMULTIWRITE parameters on the GLOBALCONFIG command. HiperSockets multiple write might reduce CPU usage and might provide a performance improvement for large outbound messages that are typically generated by traditional streaming workloads such as file transfer, and interactive web-based services workloads such as XML or SOAP. This parameter applies to all HiperSockets interfaces See the IBM z/OS Communications Server IP Configuration Guide for more information about HiperSockets multiple write support.

OLM Active Indicates whether optimized latency mode (OLM) function is ACTIVE for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

To configure an OSA-Express3 feature to operate in optimized latency mode, use the INTERFACE statement in the TCPIP.PROFILE dataset with the OLM parameter. Because optimized latency mode affects both inbound and outbound interrupts, it supersedes other inbound performance settings set by the INBPERF parameter. For more information about optimized latency mode and the OLM and INBPERF parameters on the INTERFACE statement for IPAQENET and IPAQENET6, see the IBM z/OS Communications Server IP Configuration Reference .

OLM Configured Indicates whether optimized latency mode (OLM) parameter was configured for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

To configure an OSA-Express3 feature to operate in optimized latency mode, use the INTERFACE statement in the TCPIP.PROFILE dataset with the OLM parameter. Because optimized latency mode affects both inbound and outbound interrupts, it supersedes other inbound performance settings set by the INBPERF parameter. For more information about optimized latency mode and the OLM and INBPERF parameters on the INTERFACE statement for IPAQENET and IPAQENET6, see the IBM z/OS Communications Server IP Configuration Reference.

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

OSA Code Level The OSA code level. The format is a 2-byte unsigned integer that is displayed in hexadecimal format.

To determine the OSA-Express microcode level, use the DISPLAY TRL command. If a specific OSA-Express function is documented with a minimum microcode level, you can use this command to determine whether that function is supported. IBM service might request the microcode level for problem diagnosis. For more information about the DISPLAY TRL command, see IBM z/OS Communications Server SNA Operation.

Outbound Hop Limit The outbound hop limit for IPAQENET6 interface type. The value is either provided by a router advertisement or, if IGNOREROUTERHOPLIMIT was specified on IPCONFIG6, it is the global HOPLIMIT value from IPCONFIG6. The format is a 2-byte unsigned integer.

The IPv6 header contains a hop limit field that controls the number of hops over which a datagram can be sent before being discarded. This field is similar to the TTL field in the IPv4 header. The IPAQENET6 interface specifies IPv6 OSA-Express queued direct input/output (QDIO) interfaces. See the IBM z/OS Communications Server IP Network and Application Design Guide for more information about this parameter.

PFID The PCI Express Function ID (PFID) value for the RDMA Network Interface Card (RNIC) or Internal Shared Memory (ISM) device represented by this interface. The format is an integer.

PFID Port Port used for the associated PFID. The format is an integer.

Physical MAC Address The physical MAC address. The format is an alphanumeric string no longer than 17 characters in colon-hexadecimal format.

Physical Network ID The physical network ID.

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

  • OSA-Express_QDIO_Ethernet_OSD (external data network type, which is the default value)
  • OSA-Express_QDIO_Ethernet_OSM (intra-node management network, which requires IPv6)
  • OSA-Express_QDIO_Ethernet_OSX (intra-ensemble data network)

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

Read Storage Size The actual amount of storage currently allocated to READSTORAGE, expressed as 64K blocks. The format is a 2-byte unsigned integer.

This value is specified with the READSTORAGE optional parameter on the LINK statement in the TCPIP.PROFILE dataset. It indicates the amount of fixed storage that z/OS Communications Server should keep available for read processing for this OSA adapter. The READSTORAGE parameter is also available on INTERFACE statements for certain types of interfaces. See the IBM z/OS Communications Server IP Configuration Guide for more information about this parameter.

Read Storage Type The read storage type. This value is stored as an integer and displayed as a string. Valid values are:

  • 1 = GLOBAL
  • 2 = MAX
  • 3 = AVG
  • 4 = MIN

This value is specified with the READSTORAGE optional parameter on the LINK statement in the TCPIP.PROFILE dataset. It indicates the amount of fixed storage that z/OS Communications Server should keep available for read processing for this OSA adapter. See the IBM z/OS Communications Server IP Configuration Guide for more information about this parameter.

RNIC Associated Indicates whether or not an RNIC is associated with this interface. An associated RNIC can be used for SMC-R links and load balancing. Valid values are:
  • 1 = Yes
  • 2 = No

Routing Mask Bits The routing subnet number of mask bits for IPv4 interfaces. The format is a 2-byte unsigned integer.

The number of mask bits (num_mask_bits parameter on a number of IP commands) is an integer in the range 1 - 32 that represents the number of bits, counting from left to right, of the network and subnet portion of the IPv4 address mask. The value may be set using any of the following methods:

  • INTERFACE profile statement
  • BSDROUTINGPARMS profile statement
  • DYNAMICXCF parm on the IPCONFIG profile statement
  • OMPROUTE configuration statement
  • IP address class mask

See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter.

Routing Metric The routing metric or hop count for this interface. The format is a 2-byte unsigned integer.

This attribute applies only to IPv4 interfaces defined by DEVICE/LINK profile statements or by the DYNAMICXCF parm on IPCONFIG profile statement. This value may be set using one of the following methods:

  • BSDROUTINGPARMS profile statement
  • DYNAMICXCF parm on IPCONFIG profile statement
  • OMPROUTE configuration statement

See the IBM z/OS Communications Server IP Configuration Guide for more information about defining this parameter.

Routing MTU Size The routing maximum transmission unit (MTU) size. The format is a 2-byte unsigned integer.

Maximum transmission unit (MTU), or maximum packet size in TCP/IP terms is the maximum size for the data field. For a static route, the MTU size for a route is configured using the on either a ROUTE statement in a BEGINROUTES block or on a GATEWAY statement in the TCP/IP profile. For each IPv4 dynamic route added by OMPROUTE over an interface, the configured route MTU comes from the value of the MTU keyword specified on the RIP_INTERFACE, OSPF_INTERFACE or INTERFACE statement in the TCPIP.PROFILE datasetfor that interface in the OMPROUTE configuration file. If you do not specify an MTU for an interface, OMPROUTE uses 576. For IPv6, OMPROUTE learns the interface MTU value from TCP/IP, and you cannot specify a configured route MTU in the OMPROUTE configuration file.

See the IBM z/OS Communications Server IP Configuration Guide for more information about this parameter.

SECCLASS Value The SECCLASS (security class) value for this interface. The format is a 2-byte unsigned integer.

The SECCLASS value is a parameter on the LINK or INTERFACE statements used to associate a security class for IP filtering with this interface. See the IBM z/OS Communications Server IP Configuration Guide for more information about this parameter.

Send Receive Broadcast Packets Indicates whether this interface is capable of sending and receiving broadcast packets. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

The ability to send and receive broadcast packets is specified on many IP commands with the IPBCAST parameter, which specifies that the interface both sends and receives IP broadcast packets. If this parameter is not specified, no IP broadcast packets are sent or received on this interface. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter. The name of this attribute is abbreviated Send Recv Broadcast Pkts in the enhanced 3270 interface.

SMC-D Status The SMC-D status. Valid values are:
  • 1 = SMC-D supported
  • 2 = Disabled (No PNETID)
  • 3 = Disabled (GLOBALCONFIG NOSMCD)
  • 4 = No Subnet Mask
  • 5 = Disabled (PNETID_misconfigured)
SMC-D Specified Indicates whether or not SMC-D was specified. SMC-D status indicates when SMC-D is active. Valid values are:
  • 1 = Yes
  • 2 = No
SMC-R Specified Indicates whether or not SMC-R was specified. SMC-R status indicates when SMC-R is active. Valid values are:
  • 1 = Yes
  • 2 = No
SMC-R Status The SMC-R status. Valid values are:
  • 1 = SMC-R supported
  • 2 = Disabled (No PNETID)
  • 3 = Disabled (GLOBALCONFIG NOSMCR)
  • 4 = Obsolete
  • 5 = Disabled (No Subnet Mask)

SMC-Rv2 IP Address The configured SMC-Rv2 IP Address.

SMC-Rv2 MTU The configured SMC-Rv2 MTU.

SMC-Rv2 PFID The configured RNIC PFID for SMC-Rv2.

Source VIPA Name The name of the source virtual IP address (VIPA) interface. The format is an alphanumeric string no longer than 16 characters.

This value is specified with the optional SOURCEVIPAINTERFACE vipa_name parameter on the INTERFACE command. It specifies which previously defined static VIPA interface is to be used for SOURCEVIPA (when IPCONFIG6 SOURCEVIPA is specified). For more information, see the default source address selection algorithm information in the IBM z/OS Communications Server in z/OS IPv6 Network and Application Design Guide or the z/OS Communications Server IP Configuration Reference.

Source VIPA Specified Indicates whether the source virtual IP address (VIPA) interface name is specified for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

This value is specified with the optional SOURCEVIPAINTERFACE vipa_name parameter on the INTERFACE command. It specifies which previously defined static VIPA interface is to be used for SOURCEVIPA (when IPCONFIG6 SOURCEVIPA is specified). For more information, see the default source address selection algorithm information in the IBM z/OS Communications Server in z/OS IPv6 Network and Application Design Guide or the IBM z/OS Communications Server IP Configuration Reference.

System ID The SMF system ID. The format is a string up to 4 characters in length.

Sysplex Name The name of the Sysplex that this LPAR is a member of. The format is a string up to 8 characters in length.

TCP Segmentation Offload Active Indicates whether the TCP segmentation offload function is active for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

The TCP/IP stack can offload most IPv4 outbound TCP segmentation processing to an OSA-Express feature in queued direct input/output (QDIO) mode using TCP segmentation offload support. You can configure this function by specifying the SEGMENTATIONOFFLOAD parameter on the GLOBALCONFIG profile statement. See the IBM z/OS Communications Server IP Configuration Guide for more information about this parameter. The name of this attribute is abbreviated TCP Seg Offload in the enhanced 3270 interface.

TCPIP STC Name The TCP/IP job name. The format is a string up to 8 characters in length.

Temporary IP Address Prefix Indicates whether the temporary IP address prefix is being specified for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

This value is specified with the ADDTEMPPREFIX parameter of the IPAQENET6 interface statement. This prefix represents the number of unmasked leading bits in the ipaddress value. The prefix length value can be in the range 0 - 127 for IPv6 addresses. An IP packet matches this condition if its unmasked bits are identical to the unmasked bits defined. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter. The name of this attribute is abbreviated Temp IP Address Prefix in the enhanced 3270 interface.

Temporary Prefix Type The temporary prefix type. This value is stored as an integer and displayed as a string. Valid values are:

  • 1 = ALL
  • 2 = Prefix_specified
  • 3 = NONE
  • 4 = Disabled_DAD_failures

This value is specified with the ADDTEMPPREFIX parameter of the IPAQENET6 interface statement. This prefix represents the number of unmasked leading bits in the ipaddress value. The prefix length value can be in the range 0 - 127 for IPv6 addresses. An IP packet matches this condition if its unmasked bits are identical to the unmasked bits defined. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter.

VLAN ID The virtual LAN (VLAN) identifier. The format is a 2-byte unsigned integer.

The VLAN ID is an optional parameter followed by a decimal number indicating the Virtual LAN identifier to be assigned to the OSA-Express INTERFACE. See the IBM z/OS Communications Server IP Configuration Reference for more information.

VLAN ID Specified Indicates whether a virtual LAN (VLAN) identifier is specified for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

The VLAN ID is an optional parameter followed by a decimal number indicating the Virtual LAN identifier to be assigned to the OSA-Express INTERFACE. See the IBM z/OS Communications Server IP Configuration Reference for more information.

VLAN Priority Tagging Active Indicates whether the virtual LAN (VLAN) priority tagging function is active for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

VLAN priority tagging extends the capabilities of priority queuing beyond the server to include LAN bridges and switches, providing a way to manage consistent QoS traffic prioritization and service differentiation end-to-end, across switched LAN and WAN networks. See the IBM z/OS Communications Server IP Configuration Guide and the IBM System z9 and zSeries Open Systems Adapter-Express Customer's Guide and Reference for more information about this attribute. The name of this attribute is abbreviated VLAN Priority Tag Active in the enhanced 3270 interface.

VMAC Active Indicates whether the Virtual MAC (VMAC) address function is ACTIVE for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

VMAC is a parameter on the INTERFACE statement. VMAC specifies the virtual MAC address, which can be represented by 12 hexadecimal characters. The OSA-Express device uses this address rather than the physical MAC address of the device for all IPv4 packets sent to and received from this TCP/IP stack. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter.

VMAC Address Specified Indicates whether the Virtual MAC (VMAC) address is specified for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

VMAC is a parameter on the INTERFACE statement. VMAC specifies the virtual MAC address, which can be represented by 12 hexadecimal characters. The OSA-Express device uses this address rather than the physical MAC address of the device for all IPv4 packets sent to and received from this TCP/IP stack. See the IBM z/OS Communications Server IP Configuration Reference for more information about this parameter.

VMAC ROUTELCL Active Indicates whether the ROUTELCL parameter (meaning route only packets that come from registered IP addresses to the VMAC) is active in the Virtual MAC (VMAC) address definition for this interface. This value is stored as an integer and displayed as a string. Valid values are:

  • 0 = No
  • 1 = Yes

ROUTELCL is a parameter on the INTERFACE statement. It specifies that only traffic destined for the virtual MAC and whose destination IP address is registered with the OSA-Express device by this TCP/IP stack is forwarded by the OSA-Express. See the router information in the IBM z/OS Communications Server IP Configuration Guide for more information about this parameter.

FILLER1 FILLER1