gtpc2m8pC/C++ Language Support User's Guide

tpf_vipac-Move a VIPA to Another Processor

This function moves a virtual IP address (VIPA) to another processor in the same loosely coupled complex.

Format

#include  <socket.h>
int    tpf_vipac(unsigned long *vipa, char *cpu);
   

vipa
A pointer to a 4-byte virtual IP address.

cpu
A pointer to the 1-byte TPF processor ID.

Normal Return

A value of 0. This value indicates that the TPF system was able to start moving the VIPA to the specified processor.

Error Return

One of the following values, indicating the respective error:

1
Incorrect VIPA.

2
VIPA not defined as movable.

3
Incorrect CPU.

4
CPU not active.

5
System not in 1052 state or above.

6
OSA-Express support is not defined.

7
VIPA not defined on the specified processor.

8
VIPA already moving.

9
CPU already owns the VIPA.

10
Internal system error.

Programming Considerations

Examples

The following example attempts to move VIPA 9.155.155.155 (0x99B9B9B) to CPU C.

#include <socket.h>
 
int rc
unsigned long vipa=0x99B9B9B;
char cpu='c';
 
rc= tpf_vipac(&vipa,&cpu);
 
 

Related Information

See TPF Migration Guide: Program Update Tapes, TPF Operations, and TPF Transmission Control Protocol/Internet Protocol for more information about moving VIPAs.