gtpo1mh1Operations

ZVIPA-Manage a Virtual IP Address

Use this command to do the following:

Requirements and Restrictions

Format




DISplay
displays statistical information for a particular Internet Protocol (IP) address, a set of IP addresses on a CPU, or specific types of IP addresses on a particular CPU or complex.

IP-ipaddr
specifies the OSA IP address, where ipaddr is a numeric IP address.

CPU-cpuid
specifies the processor ID of a TPF processor, where cpuid is a valid TPF processor ID defined in the complex.

ACTIVE
displays only active IP addresses.

INACTive
displays only inactive IP addresses.

TYPE-type
displays the type of IP addresses, where type is one of the following:

MOVABLE
displays only VIPAs that are defined as movable.

STATIC
displays only VIPAs that are defined as static.

REAL
displays only real Open Systems Adapter (OSA) IP addresses.

VIPA
displays all VIPAs.

ALL
displays all OSA IP addresses in the TPF complex.

MOVE
moves a VIPA from one processor to another in the same loosely coupled complex.

VIPA-vipaddr
moves the VIPA, where vipaddr is a numeric IP address.

SUMmary
displays system and VIPA statistics.

Additional Information

Online help information is available for this command. To display the help information, enter one of the following:

ZVIPA HELP

ZVIPA ?

Examples

The following example displays system and OSA IP address statistics, where:

 CPU 
is the processor.

 PACKETS/SEC 
indicates the number of messages sent and received per second as determined by the traffic for the previous minute.

 CPU UTIL 
shows the immediate CPU utilization averaged over the I-streams for the designated processor.
+--------------------------------------------------------------------------------+
|User:   ZVIPA SUM                                                               |
|                                                                                |
|System: VIPA0003I 15.18.32 OSA IP ADDRESS SUMMARY DISPLAY BEGINS                |
|                                                                                |
|          CPU PACKETS/SEC CPU UTIL                                              |
|          --- ----------- --------                                              |
|           A         2300   76.9                                                |
|           B          290   12.1                                                |
|           C          650    1.2                                                |
|           E          122   21.2                                                |
|                                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The following example displays information about OSA IP addresses defined on CPU B, where:

 CPU 
is the processor that currently owns the IP address.

 IP 
is the IP address.

 TYPE 
is the type of IP address, where type is one of the following:

 MOVABLE 
specifies an IP address that is defined as a movable VIPA.

 STATIC 
specifies an IP address that is defined as a static VIPA.

 REAL 
specifies a real OSA IP address.

 MOVING TO CPU 
is the CPU to which the movable VIPA is in the process of moving.

 ACTIVE 
indicates whether the IP address is active.

 PACKETS/SEC 
indicates the number of messages sent and received per second as determined by the traffic for the previous minute.
+--------------------------------------------------------------------------------+
|User:   ZVIPA DISPLAY TYPE-VIPA CPU-B                                           |
|                                                                                |
|System: VIPA0002I 15.18.34 OSA IP ADDRESS DISPLAY BEGINS                        |
|                                               MOVING                           |
|          CPU       IP              TYPE       TO CPU   ACTIVE  PACKETS/SEC     |
|          ---  --------------     ---------    ------   ------- -----------     |
|           B     9.117.249.68     MOVABLE                YES            234     |
|           B     9.117.249.69     REAL                   YES             42     |
|           B     9.117.249.70     MOVABLE                YES            534     |
|           B     9.117.249.71     STATIC                 YES             75     |
|           B     8.100.200.22     MOVABLE                 NO              0     |
|           B     8.100.200.24     STATIC                  NO              0     |
|                                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The following example displays information about an OSA IP address and which CPU the IP address is currently defined on, where:

 CPU 
is the processor that currently owns the IP address.

 IP 
is the IP address.

 TYPE 
is the type of IP address, where type is one of the following:

 MOVABLE 
specifies an IP address that is defined as a movable VIPA.

 STATIC 
specifies an IP address that is defined as a static VIPA.

 REAL 
specifies a real OSA IP address.

 MOVING TO CPU 
is the CPU to which the movable VIPA is in the process of moving.

 ACTIVE 
indicates if the IP address is active.

 PACKETS/SEC 
indicates the number of messages sent and received per second as determined by the traffic for the previous minute.

 DEFINED TO CPU 
is the processor or processors to which the movable VIPA is defined.
+--------------------------------------------------------------------------------+
|User:   ZVIPA DISPLAY IP-9.117.249.68                                           |
|                                                                                |
|System: VIPA0010I 15.18.34 OSA IP ADDRESS DISPLAY BEGINS                        |
|                                               MOVING                           |
|          CPU       IP              TYPE       TO CPU   ACTIVE  PACKETS/SEC     |
|          ---  --------------     ---------    ------   ------- -----------     |
|           B     9.117.249.68     MOVABLE                YES            234     |
|                                                                                |
|           DEFINED TO CPU - B C                                                 |
|                                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The following example moves a VIPA from one processor to another in the same loosely coupled complex.

+--------------------------------------------------------------------------------+
|User:   ZVIPA MOVE VIPA-9.117.249.70 CPU-C                                      |
|                                                                                |
|System: VIPA0004I 19:39:58 VIPA-9.117.249.70 MOVING FROM CPU B TO CPU C         |
|        VIPA0001I 19:39:59 VIPA-9.117.249.70 MOVED FROM CPU B TO CPU C          |
|                                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Related Information

See TPF Transmission Control Protocol/Internet Protocol for more information about OSA-Express support.