gtpo1mcoOperations

ZOSAE-Manage an OSA-Express Connection

Use this command to do the following:

Requirements and Restrictions

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

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.