Use this command to do the following:
- Define the definitions for Open Systems Adapter (OSA)-Express connections
- Modify the definitions for an OSA-Express connection
- Delete the definition for an OSA-Express connection
- Define a virtual IP address (VIPA) and associate it with a specific
OSA-Express connection
- Delete a VIPA definition and disassociate it from the OSA-Express
connection
- Display the definition and status of an OSA-Express connection
- Display the number of packets sent and received across each OSA-Express
connection in a 5-second interval
- Swing all the VIPAs associated with a primary OSA-Express connection to
its alternate OSA-Express connection, or from the alternate OSA-Express
connection to its primary OSA-Express connection.
Requirements and Restrictions
- You can enter this command only in 1052 state or higher.
- You can enter this command only from the basic subsystem (BSS).
- To define an OSA-Express connection, you must first enter the ZOSAE
command with the DEFINE parameter specified with an OSA-Express connection
name that has not been defined previously.
- A primary OSA-Express connection and its alternate OSA-Express connection
cannot be connected to the same OSA-Express card if you are using virtual IP
addresses (VIPAs).
- To eliminate single points of failure, connect primary OSA-Express
connections and alternate OSA-Express connections through different
OSA-Express cards to different Ethernets.
Format
- DEFine
- defines an OSA-Express connection.
- MODify
- changes the definitions for an OSA-Express connection. The name of
the OSA-Express connection must already exist.
- OSA-osaname
- specifies the name of the OSA-Express connection, where osaname
is a 3- to 8-character alphanumeric connection name.
- DELETE
- deletes an inactive OSA-Express connection.
- DISplay
- displays the defined parameters for a specific OSA-Express
connection.
- SWING
- specifies that all the VIPAs associated with a specific OSA-Express
connection can be moved to its alternate OSA-Express connection. You
must specify the name of the active OSA-Express connection where VIPAs will be
moved.
- ADD
- defines a VIPA for a primary OSA-Express connection and its associated
alternate OSA-Express connection if an alternate is defined. The name
that you specify for the OSA-Express connection must be the primary
connection.
The real IP address and subnet mask of the OSA-Express connection must be
defined before any VIPAs can be defined to that OSA-Express connection.
The VIPA cannot reside in the same subnet as the networks to which the
OSA-Express cards (primary and alternate) are connected.
- VIPA-vipaddr
- specifies a VIPA, where vipaddr is the numeric virtual IP
address.
- DEFAULT
- specifies that the Internet Protocol (IP) address or VIPA being defined
will be the default local IP address of the TPF system.
- STATIC
- specifies that the VIPA cannot be moved between processors. If you
do not specify this parameter, the VIPA is movable.
- REMOVE
- removes the association of a specified VIPA from an OSA-Express connection
and removes the VIPA definition from the TPF system. Both the primary
OSA-Express connection and its associated alternate OSA-Express connection, if
defined, must be inactive to remove a VIPA.
- DATAFLOW
- displays the number of packets sent and received across each OSA-Express
connection in a 5-second interval .
- READ-readsda
- specifies the read control device of the OSA-Express connection, where
readsda is the symbolic device address (SDA) of the read control
device. The READ parameter also implicitly specifies the write control
device, which is defined as the read control SDA plus 1.
- DATA-datasda
- specifies the data control device of the OSA-Express connection, where
datasda is the SDA of the data control device.
- PORT-osaport
- specifies the name of the port on the OSA-Express card, where
osaport is a 3- to 8-character alphanumeric port name. The
name of the port must be the same for all hosts that have connections to the
same OSA-Express card.
- LINK-link
- specifies the logical link number of the OSA-Express connection, where
link is the logical link number. The default logical link is
zero and is the only value that is supported.
- NET-net
- specifies the type of network to which the OSA-Express card is connected,
where net is one of the following:
- GENET
- specifies a Gigabit Ethernet network.
- FENET
- specifies a Fast Ethernet network.
- MTU-mtusize
- specifies the maximum transmission unit (MTU) of the OSA-Express
connection, where mtusize is a 576- to 3840-decimal value. The
MTU parameter is ignored when defining or modifying an alternate OSA-Express
connection. The MTU size for the alternate OSA-Express connection is
automatically set to the same value as the MTU size of its associated primary
OSA-Express connection. If the primary OSA-Express connection MTU size
is changed, the alternate OSA-Express connection MTU size is also
automatically changed to the same value.
- MASK-subnetmask
- defines the subnet mask of the network to which the OSA-Express card is
connected, where subnetmask is the numeric subnet mask
address. The subnet mask cannot be modified once it has been
defined.
- IP-ipaddr
- defines the real IP address of the TPF host associated with the
OSA-Express connection, where ipaddr is the numeric local IP
address. The IP address cannot be modified once it has been
defined.
- GATEWAY1-gate1
- specifies one of the two possible default gateways to be used as the first
hop of the route for outbound packets that are sent by the TPF system across
this OSA-Express connection, where:
- gate1
- is the numeric IP address of the gateway.
- NONE
- deletes previously defined information for the gateway.
- GATEWAY2-gate2
- specifies one of the two possible default gateways to be used as the first
hop of the route for outbound packets that are sent by the TPF system across
this OSA-Express connection, where:
- gate2
- is the numeric IP address of the gateway.
- NONE
- deletes previously defined information for the gateway.
- PRIMary-primosaname
- specifies the name of the primary OSA-Express connection for which this
OSA-Express connection is the alternate, where primosaname is the
primary OSA-Express connection name. Each primary connection can have
only one alternate connection. You cannot modify the primary
OSA-Express connection name once it has been defined.
Additional Information
- Online help information is available for this command. To display
the help information, enter one of the following:
ZOSAE HELP
ZOSAE ?
- New or changed definitions can be used immediately; an IPL is not
required.
- To accommodate long ZOSAE command entries, you can first enter the ZOSAE
command with the DEFINE parameter specified with some of the parameters;
you can specify additional parameters on subsequent entries of the ZOSAE
command with the MODIFY parameter specified.
- The only definitions you can change while the OSA-Express connection is
active are MTU size and gateways.
- You must delete an alternate OSA-Express connection before you can delete
its associated primary OSA-Express connection.
- If you define both the GATEWAY1 and GATEWAY2 parameters, these parameters
alternate as the default gateway if both are active. You must define
the IP address and subnet mask of the OSA-Express connection before you can
define the default gateway. The IP address of the gateway must be in
the same subnet as the network to which the OSA-Express card is
connected.
- You must define the following parameters before you can activate an
OSA-Express connection:
- OSA
- READ
- DATA
- PORT
- MASK
- IP.
Examples
In the following example, an OSA-Express connection is defined.
+--------------------------------------------------------------------------------+
|User: ZOSAE DEF OSA-OSA1PRIM READ-E00 DATA-E02 PORT-OSAPORT1 |
| |
|System: OSAE0001I 08:14:31 OSA-OSA1PRIM DEFINED |
| |
+--------------------------------------------------------------------------------+
In the following example, an IP address and subnet mask is defined to
primary OSA-Express connection OSA1PRIM.
+--------------------------------------------------------------------------------+
|User: ZOSAE MOD OSA-OSA1PRIM IP-9.117.241.30 MASK-255.255.255.0 |
| |
|System: OSAE0002I 08:14:31 OSA-OSA1PRIM MODIFIED |
| |
+--------------------------------------------------------------------------------+
In the following example, an alternate OSA-Express definition OSA1BACK is
defined to the primary OSA-Express connection OSA1PRIM.
+--------------------------------------------------------------------------------+
|User: ZOSAE DEF OSA-OSA1BACK PRIMARY-OSA1PRIM |
| |
|System: OSAE0001I 08:14:31 OSA-OSA1BACK DEFINED |
| |
+--------------------------------------------------------------------------------+
In the following example, an OSA-Express definition is deleted.
+--------------------------------------------------------------------------------+
|User: ZOSAE DELETE OSA-OSA1PRIM |
| |
|System: OSAE0003I 08:14:31 OSA-OSA1PRIM DELETED |
| |
+--------------------------------------------------------------------------------+
In the following example, a static VIPA is added to an OSA-Express
definition.
+--------------------------------------------------------------------------------+
|User: ZOSAE ADD OSA-OSA1PRIM VIPA-9.117.251.40 STATIC |
| |
|System: OSAE0004I 08:14:31 VIPA-9.117.251.40 DEFINED TO OSA-OSA1PRIM |
| |
+--------------------------------------------------------------------------------+
In the following example, a VIPA is removed from the TPF system.
+--------------------------------------------------------------------------------+
|User: ZOSAE REMOVE VIPA-9.117.251.40 |
| |
|System: OSAE0005I 08:14:31 VIPA-9.117.251.40 DELETED |
| |
+--------------------------------------------------------------------------------+
In the following example, VIPAs swing from a primary OSA-Express connection
OSA1PRIM to its alternate OSA-Express connection OSA1BACK.
+--------------------------------------------------------------------------------+
|User: ZOSAE SWING OSA-OSA1BACK |
| |
|System: OSAE0006I 08:14:31 VIPAS ON OSA-OSA1PRIM SWUNG TO OSA-OSA1BACK |
| |
+--------------------------------------------------------------------------------+
In the following example, information is displayed for a primary
OSA-Express connection.
+---------------------------------------------------------------------------------------------+
|User: ZOSAE DISPLAY OSA-OSAPRIM1 |
| |
|System: OSAE0007I 15.18.32 BEGIN OSA DISPLAY |
| |
| NAME - OSAPRIM1 REAL IP - 111.111.111.050 READ - 0200 |
| TYPE - PRIMARY MASK - 255.255.255.000 WRITE - 0201 |
| ALT - OSABACK1 GATEWAY1 - 111.111.111.032 DATA - 0205 |
| PORT - OSAPORT1 GATEWAY2 - 111.111.111.033 |
| LINK - 0 |
| NET - GENET CURRENT STATUS - ACTIVE |
| MTU - 1492 DESIRED STATUS - ACTIVE |
| |
| VIPAS CURRENTLY ASSIGNED TO OSAPRIM1: |
| 111.117.249.050 MOVABLE |
| 111.117.249.053 STATIC |
| 111.117.249.088 MOVABLE, NOT OWNED BY THIS CPU |
| |
| END OF DISPLAY |
+---------------------------------------------------------------------------------------------+
In the following example, information is displayed for the alternate
OSA-Express connection.
+---------------------------------------------------------------------------------------------+
|User: ZOSAE DISPLAY OSA-OSABACK1 |
| |
|System: OSAE0007I 15.18.32 BEGIN OSA DISPLAY |
| |
| NAME - OSABACK1 REAL IP - 111.111.117.033 READ - 0420 |
| TYPE - ALTERNATE MASK - 255.255.255.000 WRITE - 0421 |
| PRIM - OSAPRIM1 GATEWAY1 - 111.111.117.050 DATA - 0426 |
| PORT - OSAPORT2 GATEWAY2 - NONE |
| LINK - 0 |
| NET - GENET CURRENT STATUS - ACTIVE |
| MTU - 1492 DESIRED STATUS - ACTIVE |
| |
| VIPAS CURRENTLY ASSIGNED TO OSAPRIM1: |
| 111.117.249.050 MOVABLE |
| 111.117.249.053 STATIC |
| 111.117.249.088 MOVABLE, NOT OWNED BY THIS CPU |
| |
| END OF DISPLAY |
+---------------------------------------------------------------------------------------------+
In the following example, OSA data flow statistics are displayed.
+--------------------------------------------------------------------------------+
|User: ZOSAE DATAFLOW |
| |
|System: OSAE0008I 17.25.49 BEGIN PROCESSING OSA DATAFLOW STATISTICS |
| CSMP0097I 17.25.54 CPU-B SS-BSS SSU-HPN IS-01 |
| OSAE0009I 17.25.54 OSA DATAFLOW STATISTICS FOR A 5-SECOND INTERVAL |
| |
| OSA PACKETS PACKETS |
| SENT RECEIVED |
| -------- --------- ---------- |
| OSA1B 262 263 |
| OSA2B 284 285 |
| OSA3B 0 1 |
| END OF ZOSAE DATAFLOW DISPLAY |
| |
+--------------------------------------------------------------------------------+
Related Information
See the TPF Transmission Control Protocol/Internet
Protocol for more information about IP routers, TCP/IP native stack
support, and OSA-Express support.