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.
- 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.
- Copy the IPAQENET parameter from the LINK statement and specify
this parameter after the DEFINE parameter of the INTERFACE statement.
- Copy the remaining LINK parameters and values (INBPERF DYNAMIC
in the example) to the INTERFACE statement.
- 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.
- Copy the remaining DEVICE parameters (PRIROUTER in the example)
to the INTERFACE statement.
- 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.
- Append a value (/24 in the example) to the end
of the IP address to define the subnet mask.
- 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:
- 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.
- 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:
- 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.
- 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