Steps for converting from IPv4 IPAQENET DEVICE, LINK, and HOME definitions to the IPv4 IPAQENET INTERFACE statement

Use the INTERFACE statement to configure IPv4 definitions for OSA-Express QDIO, rather than using the DEVICE, LINK, and HOME statements. The INTERFACE statement improves stack configuration for IPAQENET interfaces, and some functions like multiple VLAN support require that the QDIO interface is defined with the INTERFACE statement.

Procedure

Perform the following steps to convert your TCP/IP profile so that it uses the INTERFACE statement to configure IPv4 definitions for OSA-Express QDIO.

Convert the IPv4 IPAQENET DEVICE, LINK, and HOME statements to an IPv4 IPAQENET INTERFACE statement. The values used in the following sub-steps are based on the sample profile that appears after the sub-steps.
1. Copy the LINK name (QDIO4101L in the example) and specify this name as the interface name on the INTERFACE statement.
  Tip: When you use the original LINK name as the new INTERFACE name, you do not have to make changes to the static route definitions, OMPROUTE definitions, PKTTRACE statement, and PRIMARYINTERFACE statement.
2. Copy the IPAQENET parameter from the LINK statement and specify this parameter after the DEFINE parameter of the INTERFACE statement.
3. Copy the remaining LINK parameters and values (INBPERF DYNAMIC in the example) to the INTERFACE statement.
4. Copy the DEVICE name (QDIO4101 in the example) and specify this name on the PORTNAME parameter of the INTERFACE statement. This PORTNAME value must match the corresponding PORTNAME value in the SNA TRLE definition.
5. Copy the remaining DEVICE parameters (PRIROUTER in the example) to the INTERFACE statement.
6. Copy the HOME list entry IP address (172.16.1.1 in the example) and specify this address on the IPADDR parameter of the INTERFACE statement.
7. Append a value (/24 in the example) to the end of the IP address to define the subnet mask.
8. Remove the HOME list entry.
Example of the profile before conversion:
```
DEVICE QDIO4101  MPCIPA   PRIROUTER
LINK   QDIO4101L IPAQENET      QDIO4101
  INBPERF DYNAMIC
;
HOME
  172.16.1.1     QDIO4101L
```
Example of the profile after conversion:
```
INTERFACE QDIO4101L
  DEFINE IPAQENET
  INBPERF DYNAMIC
  IPADDR 172.16.1.1/24
  PORTNAME QDIO4101
  PRIROUTER
```
Tip: Optionally, you can dump the TCP/IP address space and use the CONVERT parameter on the TCPIPCS PROFILE subcommand to display the configuration information at the time of the dump. The resulting output reflects your IPAQENET DEVICE, LINK, and HOME definitions in INTERFACE statement format, which might be helpful in converting your profile to use INTERFACE statements. You should review the output before you implement any changes. For more information about using the CONVERT parameter on the TCPIPCS PROFILE subcommand, see z/OS Communications Server: IP Diagnosis Guide.

For more information about the IPv4 IPAQENET INTERFACE statement, see z/OS Communications Server: IP Configuration Reference.
Remove any BSDROUTINGPARMS entries for the interface.
If you have configured the SOURCEVIPA parameter on the IPCONFIG statement, perform the following steps:
1. Find the IPAQENET LINK in the original HOME list and search backwards to locate the static VIPA (if any) that is located closest to this link in the HOME list.
2. If you find a static VIPA, add the SOURCEVIPAINTERFACE parameter to the IPv4 INTERFACE statement. Use the static VIPA link name as the SOURCEVIPAINTERFACE value.
If you are using the START statement to start the IPv4 device, change the START statement to specify the name of the IPv4 INTERFACE.
If you are using the GATEWAY statement to configure any static routes over the interface, convert the GATEWAY statement to a BEGINROUTES block.
Tip: Optionally, you can dump the TCP/IP address space and use the CONVERT parameter on the TCPIPCS PROFILE subcommand to display the configuration information at the time of the dump. The resulting output reflects your GATEWAY definitions in the format of a BEGINROUTES block, which might be helpful in converting your profile to use BEGINROUTES. Review the output before you implement any changes. For more information about using the TCPIPCS PROFILE subcommand, see z/OS Communications Server: IP Diagnosis Guide.
If you also have an IPAQENET6 definition for the OSA, perform the following steps:
1. If you configure the same virtual MAC address (VMAC) on both the IPAQENET LINK statement and IPAQENET6 INTERFACE statement, either change one of the VMAC addresses so that they are unique or let OSA generate the VMAC addresses.
2. Ensure that the corresponding TRLE definition has at least two DATAPATH devices available so that one device is available for the IPv4 interface and one device is available for the IPv6 interface.

Results

For information about the TCP/IP profile (PROFILE.TCPIP) and configuration statements, see z/OS Communications Server: IP Configuration Reference.

The following examples show some additional changes that you might need to make to the definitions for OSA-Express QDIO.

Example of the profile before conversion:

IPCONFIG
  SOURCEVIPA
;
DEVICE VIPA4811  VIRTUAL  0
LINK   VIPA4811L VIRTUAL  0    VIPA4811
;
DEVICE QDIO4101  MPCIPA   PRIROUTER
LINK   QDIO4101L IPAQENET      QDIO4101
  INBPERF DYNAMIC
;
HOME
  10.81.1.1      VIPA4811L
  172.16.1.1     QDIO4101L
;
PRIMARYINTERFACE QDIO4101L
;
BSDROUTINGPARMS TRUE
  VIPA4811L 1492 0 255.255.255.0 0
  QDIO4101L 1492 0 255.255.255.0 0
ENDBSDROUTINGPARMS
;
GATEWAY
  172.16  =  QDIO4101L  1492  0
;
START QDIO4101

Example of the profile after conversion:

IPCONFIG
  SOURCEVIPA
;
DEVICE VIPA4811  VIRTUAL  0
LINK   VIPA4811L VIRTUAL  0    VIPA4811
;
; Converted INTERFACE statement
;
;   - QDIO4101L is from the LINK statement
;   - DEFINE IPAQENET is from the LINK statement
;   - INBPERF DYNAMIC is from the LINK statement
;   - IPADDR 172.16.1.1 is from the HOME list entry, /24 is from the
;     BSDROUTINGPARMS entry subnet mask
;   - PORTNAME QDIO4101 is from the DEVICE statement
;   - PRIROUTER is from the DEVICE statement
;   - SOURCEVIPAINTERFACE VIPA4811L is from the order of the HOME list
;     entries
;
INTERFACE QDIO4101L
  DEFINE IPAQENET
  INBPERF DYNAMIC
  IPADDR 172.16.1.1/24
  PORTNAME QDIO4101
  PRIROUTER
  SOURCEVIPAINTERFACE VIPA4811L
;
; QDIO4101L is removed from the HOME list
;
HOME
  10.81.1.1      VIPA4811L
;
PRIMARYINTERFACE QDIO4101L
;
; QDIO4101L is removed from BSDROUTINGPARMS
;
BSDROUTINGPARMS TRUE
  VIPA4811L 1492 0 255.255.255.0 0
ENDBSDROUTINGPARMS
;
; GATEWAY statement is converted to BEGINROUTES
;
BEGINROUTES
  ROUTE 172.16.0.0/16  =  QDIO4101L  MTU 1492
ENDROUTES
;
; START statement uses the interface name
;
START QDIO4101L