DISPLAY TCPIP,,OSAINFO

Use the DISPLAY TCPIP,,OSAINFO command to retrieve information for active IPAQENET and IPAQENET6 interfaces. An interface represents a single datapath device of an OSA-Express® feature. The information is retrieved directly from the OSA-Express feature.

Tips:

If you have an INTERFACE and a DEVICE or LINK definition with the same port name and both are active, specifying either the INTERFACE or link name on the command will generate a report with both IPv4 and IPv6 information.
You can use the DISPLAY TCPIP,,OSAINFO command to retrieve information for an active OSAENTA interface although only the base portion of the report is pertinent.

The command output provides the following sections of information:

Base: Contains physical characteristics and attributes for the interface and OSA-Express feature.
Registered addresses: Contains the Layer 2 MAC addresses or Layer 3 unicast and multicast IPv4 and IPv6 addresses registered to the OSA-Express feature.
QDIO inbound workload queueing routing variables: If QDIO inbound workload queueing is in effect for the interface, this section contains the routing variables for the ancillary input queues. Routing variables identify which inbound packets are to be presented on an ancillary input queue. For more information about ancillary input queues, see QDIO inbound workload queueing in z/OS Communications Server: IP Configuration Guide.

Both the modifiers and the MAX parameters can be used to limit the number of output lines.

Format


>>-Display --TCPIP--,--+----------+--,--OSAinfo----------------->
                       '-procname-'               

                            .---------------.       
                            V               | (1)   
>--,--INTFName=--intf_name----+-----------+-+------------------->
                              +-,BASE-----+         
                              +-,BULKdata-+         
                              +-,EE-------+         
                              +-,REGAddrs-+         
                              '-,SYSDist--'         

   .-,MAX=200---.   
>--+------------+----------------------------------------------><
   +-,MAX=*-----+   
   '-,MAX=lines-'

Notes:

If no modifiers are specified, all sections for which information exists are displayed.

Rule: You must specify the parameters in the order that the syntax diagram shows.

Parameters

OSAINFO

Requests OSA information.

INTFNAME = intf_name

Specifies the name of the OSA-Express QDIO interface whose datapath device information is requested. The intf_name value can be one of the following names:

The name that was configured on a LINK IPAQENET profile statement.
The name that was configured on an INTERFACE IPAQENET or IPAQENET6 profile statement.
The name of an OSAENTA trace interface, which is EZANTAportname, where the portname value is the name that is specified on the PORTNAME keyword in the TRLE for the OSA-Express port that is being traced.

Tip: To obtain a list of names to use as the value of the INTFNAME parameter, use the Netstat DEvlinks/-d command.

BASE

Indicates that the physical characteristics and attributes of the interface and OSA-Express feature are to be included in the report.

BULKDATA

Indicates that QDIO inbound workload queueing routing variables for the BULKDATA ancillary queue are to be included in the report. The BULKDATA routing variables are comprised of source and destination IP addresses, source and destination ports, and protocol. That combination uniquely identifies those packets that the OSA-Express will route to the BULKDATA ancillary queue.

EE

Indicates that QDIO inbound workload queueing routing variables for the Enterprise Extender (EE) ancillary queue are to be included in the report. The EE routing variables are comprised of destination IP addresses, destination ports, and protocol. That combination uniquely identifies those packets that the OSA-Express will route to the EE ancillary queue.

REGADDRS

Indicates that registered Layer 2 MAC addresses or Layer 3 unicast and multicast addresses are to be included in the report.

SYSDIST

Indicates that QDIO inbound workload queueing routing variables for the SYSDIST ancillary queue are to be included in the report. The SYSDIST routing variables are comprised of destination IP addresses and protocol. That combination uniquely identifies those packets that the OSA-Express will route to the SYSDIST ancillary queue.

MAX = lines| *

The maximum number of lines to be displayed on the console. Valid lines values are in the range 4 - 65533. Specify an asterisk (*) to allow up to 65533 lines to be displayed.

If MAX=* is specified and the report is truncated as the result of exceeding the multi-line WTO maximum, the following message is displayed:
```
Report truncated due to greater than 65533 lines of output
```
In all other cases, the total number of lines that is displayed and the total number of lines that could have been displayed are shown in the following output line, where n is the number of lines displayed and m is the total number of lines that could have been displayed.
```
n of m lines displayed
```

Examples

DISPLAY TCPIP,,OSAINFO,INTFNAME=LNK29D,MAX=500

Example of IPv4 interface reply

EZD0031I TCP/IP CS V2R2  TCPIP Name: TCPCS     15:14:15                 
Display OSAINFO results for IntfName: LNK29D               
PortName: DEV29D    PortNum: 01  Datapath: 3902   RealAddr: 0002      
PCHID: 0451         CHPID: 29    CHPID Type: OSD  OSA code level: 6760     
Gen: OSA-E3         Active speed/mode: 1000 mb/sec full duplex          
Media: Singlemode Fiber        Jumbo frames: Yes  Isolate: No 
PhysicalMACAddr: 643B88F30000  LocallyCfgMACAddr: 000000000000
Queues defined Out: 4  In: 3   Ancillary queues in use: 2
Connection Mode: Layer 3       IPv4: Yes  IPv6: No
SAPSup: 00010293               SAPEna: 00010293
IPv4 attributes:                                           
  VLAN ID: N/A             VMAC Active: No 
  Defined Router: Non      Active Router: No                     
  AsstParmsEna: 00215C66   OutCkSumEna: 00000000  InCkSumEna: 00000000 
Registered Addresses:                    
  IPv4 Unicast Addresses:                          
    ARP: Yes  Addr: 10.10.10.10            
    Total number of IPv4 addresses:      1  
  IPv4 Multicast Addresses:                
    MAC: 01005E000001  Addr: 224.0.0.1     
    Total number of IPv4 addresses:      1 
Ancillary Input Queue Routing Variables:         
  Queue Type: BULKDATA  Queue ID:  2  Protocol: TCP
    Src: 11.1.1.11..100                            
    Dst: 12.12.12.12..100                          
    Src: 13.3.3.13..101                            
    Dst: 14.14.14.14..101                          
    Total number of IPv4 connections:      2        
  Queue Type: SYSDIST   Queue ID:  3  Protocol: TCP 
    Addr: 10.10.10.10 
    Total number of IPv4 addresses:      1 
33 OF 33 Lines Displayed
End of report

Example of IPv6 interface reply

EZD0031I TCP/IP CS V2R2  TCPIP Name: TCPCS     15:14:15                 
Display OSAINFO results for IntfName: LNK29D               
PortName: DEV29D    PortNum: 01  Datapath: 3902   RealAddr: 0002      
PCHID: 0451         CHPID: 29    CHPID Type: OSD  OSA code level: 6760     
Gen: OSA-E3         Active speed/mode: 1000 mb/sec full duplex          
Media: Singlemode Fiber        Jumbo frames: Yes  Isolate: No 
PhysicalMACAddr: 643B88F30000  LocallyCfgMACAddr: 000000000000
Queues defined Out: 4  In: 3   Ancillary queues in use: 2
Connection Mode: Layer 3       IPv4: No   IPv6: Yes
SAPSup: 00010293               SAPEna: 00010293
IPv6 attributes:                                    
  VLAN ID: N/A             VMAC Active: Yes
  VMAC Addr: 643B88F30001  VMAC Origin: Cfg       VMAC Router: All
  AsstParmsEna: 00215C66   OutCkSumEna: 00000000  InCkSumEna: 00000000
Registered Addresses:                    
  IPv6 Unicast Addresses:                            
    Addr: 2001:1:1::1                   
    Addr: 2001:2:1::1                   
    Total number of IPv6 addresses:      2
  IPv6 Multicast Addresses:                
    MAC: 3333FF280300  Addr: FF02::1:FF28:300   
    Total number of IPv6 addresses:      1  
Ancillary Input Queue Routing Variables:         
  Queue Type: BULKDATA  Queue ID:  2  Protocol: TCP     
    Src: 2004:1:11::1..200                              
    Dst: 2001:1:3::1..200                               
    Total number of IPv6 connections:      1             
  Queue Type: SYSDIST   Queue ID:  3  Protocol: TCP     
    Addr: 2001:1:3::1                                   
    Total number of IPv6 addresses:      1             
32 OF 32 Lines Displayed
End of report

Example of dual definition interface reply

EZD0031I TCP/IP CS V2R2  TCPIP Name: TCPCS     15:14:15                 
Display OSAINFO results for IntfName: LNK29D               
PortName: DEV29D    PortNum: 01  Datapath: 3902   RealAddr: 0002      
PCHID: 0451         CHPID: 29    CHPID Type: OSD  OSA code level: 6760     
Gen: OSA-E3         Active speed/mode: 1000 mb/sec full duplex          
Media: Singlemode Fiber        Jumbo frames: Yes  Isolate: No 
PhysicalMACAddr: 643B88F30000  LocallyCfgMACAddr: 000000000000
Queues defined Out: 4  In: 1   Ancillary queues in use: 0
Connection Mode: Layer 3       IPv4: Yes  IPv6: Yes
SAPSup: 00010293               SAPEna: 00010293
IPv4 attributes:                                           
  VLAN ID: N/A             VMAC Active: No
  Defined Router: Non      Active Router: No                     
  AsstParmsEna: 00215C66   OutCkSumEna: 00000000  InCkSumEna: 00000000  
IPv6 attributes:                                           
  VLAN ID: N/A             VMAC Active: Yes
  VMAC Addr: 643B88F30001  VMAC Origin: Cfg       VMAC Router: All
  AsstParmsEna: 00215C66   OutCkSumEna: 00000000  InCkSumEna: 00000000
Registered Addresses:                    
  IPv4 Unicast Addresses:                          
    ARP: Yes  Addr: 10.10.10.10            
    Total number of IPv4 addresses:      1  
  IPv4 Multicast Addresses:                
    MAC: 01005E000001  Addr: 224.0.0.1     
    Total number of IPv4 addresses:      1 
  IPv6 Unicast Addresses:                            
    Addr: 2001:1:1::1                   
    Addr: 2001:2:1::1                   
    Total number of IPv6 addresses:      2
  IPv6 Multicast Addresses:                
    MAC: 3333FF280300  Addr: FF02::1:FF28:300   
    Total number of IPv6 addresses:      1  
30 OF 30 Lines Displayed
End of report

Example of Layer 2 reply

EZD0031I TCP/IP CS V2R2  TCPIP Name: TCPCS     15:14:15              
Display OSAINFO results for IntfName: EZ6OSM01                        
PortName: IUTMP0CB  PortNum: 00  Datapath: 3902   RealAddr: 0002      
PCHID: 0451         CHPID: 29    CHPID Type: OSM  OSA code level: 6760
Gen: OSA-E3         Active speed/mode: 1000 mb/sec full duplex        
Media: Singlemode Fiber        Jumbo frames: Yes  Isolate: Yes         
PhysicalMACAddr: 643B88F30000  LocallyCfgMACAddr: 000000000000        
Queues defined Out: 4  In: 1   Ancillary queues in use: 0             
Connection Mode: Layer 2                                              
SAPSup: 00010293               SAPEna: 00010293                       
Layer 2 attributes:                                                   
  VLAN ID: N/A             VMAC Active: Yes                           
  VMAC Addr: 820001AA0E2A  VMAC Origin: OSA                           
Registered Addresses:                                                 
  Layer 2 Multicast MAC Addresses:                                    
    MAC: 3333FF010003                                                 
    MAC: 3333FF010002                                                 
    MAC: 3333FF010001                                                 
    MAC: 3333FFAA0E2A                                                 
    MAC: 333300000001                                                 
    Total number of Layer 2 MAC addresses:      5                     
23 of 23 lines displayed                                              
End of report

Reply field descriptions

Interface

Interface name from the display command.

Base section:

The Base section of the report is displayed if the BASE modifier is specified or none of the modifiers are specified.

PortName

Portname specified on the INTERFACE definition, specified as the device name, or both when the datapath device is shared by both definitions. This name also matches portname on the VTAM® TRLE definition.

PortNum

Physical port on the OSA-Express that is used for the interface.

Datapath

Hexadecimal datapath device address on the OSA-Express that is used for the interface.

RealAddr

Hexadecimal logical address and unit address of the interface.

PCHID

Physically installed channel path that is used by this QDIO datapath device.

CHPID

Channel path identifier that is used by this QDIO datapath device.

CHPID Type

The CHPID type of the interface, which can have the following values:

OSD: External network
OSM: Intra node management network
OSX: Intra ensemble data network

OSA code level

OSA-Express processor code level of the QDIO datapath device.

Gen

Generation of the OSA-Express feature. The following values are supported:

OSA-E3: OSA-Express3
OSA-E4S: OSA-Express4S
OSA-E5S: OSA-Express5S

Active speed/mode

Switch speed and duplex mode of the interface. The following values are supported:

10 mb/sec half duplex
10 mb/sec full duplex
100 mb/sec half duplex
100 mb/sec full duplex
1000 mb/sec half duplex
1000 mb/sec full duplex
10 gigabit full duplex
Unknown

Media

Transmission media (copper or fiber). If fiber is the transmission media, it can be single-mode fiber (LR/LX) or multimode (SR/SX). The following values are supported:

Copper
Multimode Fiber
Single-mode Fiber

Jumbo frames

Indicates whether jumbo frames are supported.

Isolate

Indicates whether this TCP/IP stack is prohibited from communicating directly through the interface with other TCP/IP stacks that are sharing the OSA-Express feature.

PhysicalMACAddr

Physical Medium Access Control (MAC) LAN address for the interface.

LocallyCfgMACAddr

Local Medium Access Control (MAC) LAN address for the interface.

Queues defined

Out: Number of output priority queues that are defined for this interface.
In: Number of input queues that are defined for this interface. A value of 1 indicates only the primary queue is defined. A value larger than 1 indicates that QDIO inbound workload queueing ancillary queues are defined and the number of ancillary queues is 1 less than the value reported.

Ancillary queues in use

Number of QDIO inbound workload queueing ancillary input queues (SYSDIST, BULKDATA, and so on) in use by this interface.

Connection Mode

Connection mode of the interface. The following values are supported:

Layer 2
Layer 3

IPv4

Indicates whether an IPv4 interface is active for the datapath device.

IPv6

Indicates whether an IPv6 interface is active for the datapath device.

SAPSup

Information used for problem analysis by IBM® support.

SAPEna

Information used for problem analysis by IBM support.

IPv4, IPv6, or Layer 2 attributes

This section displays the attributes for the interface.

VLAN ID

Decimal virtual LAN identification number that is defined on this interface.

VMAC Active

Indicates whether the interface is using a virtual MAC address.

Defined Router

The defined router attribute. This field is displayed for Layer 3 only when VMAC is not active. The following values are supported:

Pri: The interface is a primary router.
Sec: The interface is a secondary router.
Non: The interface is not a router.

Active Router

Indicates whether this interface is the active router for the OSA-Express feature. This field is displayed for Layer 3 only when VMAC is not active and is applicable only for PRIROUTER and SECROUTER interface configurations.

VMAC Addr

Displays the virtual MAC address in use for this interface. This field is displayed only when VMAC is active.

VMAC Origin

Indicates the origin of the virtual MAC address. This field is displayed only when VMAC is active. The following values are supported:

Cfg: The virtual MAC address was configured in the TCP/IP stack PROFILE
OSA: The virtual MAC address was assigned by the OSA-Express

VMAC Router

This field is displayed for Layer 3 only when VMAC is active. The following values are supported:

All: Indicates that the OSA-Express is routing everything that was received on the virtual MAC address to the interface without regard for registered addresses.
Local: Indicates that the OSA-Express is routing everything that is received on the virtual MAC address, and to a registered IP address, to the interface.

AsstParms

This field is displayed only for Layer 3. It is information used for problem analysis by IBM support.

OutCkSumEna

This field is displayed only for Layer 3. It is information used for problem analysis by IBM support.

InCkSumEna

This field is displayed only for Layer 3. It is information used for problem analysis by IBM support.

Registered Addresses

This is the registered addresses section of the report and is displayed if the REGADDRS modifier is specified or none of the modifiers are specified and only if there are registered addresses.

For Layer 3, there are four subsections that are included only if there are addresses to report:

IPv4 Unicast Addresses
IPv4 Multicast Addresses
IPv6 Unicast Addresses
IPv6 Multicast Addresses

For Layer 2, there is only one subsection which is included only if there are addresses to report:

Layer 2 Multicast MAC Addresses

ARP: Indicates whether the OSA-Express is providing address resolution for the corresponding registered IPv4 address.
Addr: IPv4 or IPv6 address.
Total number of IPv4 addresses or Total number of IPv6 addresses: Shows the cumulative number of IPv4 or IPv6 addresses immediately preceding this message.
MAC: The Medium Access Control (MAC) LAN address corresponding to the Layer 2 or registered multicast IP address.
Total number of Layer 2 MAC addresses: Shows the cumulative number of MAC addresses immediately preceding this message.

Ancillary Input Queue Routing Variables

The Ancillary Input Queue Routing Variables section of the report is displayed if any of the following modifiers were specified, or none were specified:

BULKDATA
SYSDIST

Queue Type

Displays the workload name for an ancillary queue. The following values are supported:

BULKDATA: Specifies that the input queue is used for streaming workloads.
EE: Specifies that the input queue is used for enterprise extender workloads.
SYSDIST: Specifies that the input queue is used for sysplex distributor workloads.; Specifies that the input queue is used for IP security workloads.

Queue ID

Ancillary queue number.

Protocol

TCP

Src

Source address and port. This information is displayed only for the BULKDATA queue.

Dst

Destination address and port. This information is displayed only for the BULKDATA queue.

Total number of IPv4 connections or Total number of IPv6 connections

Displays the cumulative number of BULKDATA IPv4 or IPv6 Src/Dst combinations immediately preceding this message.