HP 3000 Manuals

IPCGET [ Net IPC 3000/XL Programmer's Reference Manual ] MPE/iX 5.0 Documentation


Net IPC 3000/XL Programmer's Reference Manual

IPCGET 

Obtains a VC socket or call socket descriptor that has been given away by
another process.

Syntax 
___________________________________________________________
|                                                         |
|                                                         |
|      IPCGET ( givename, nlen, flags, descriptor, result)|
|                                                         |
___________________________________________________________

Parameters 

 givename (input) 

Character array, by reference.  The temporary name assigned to the socket
when it was given away.  It is up to 16 characters long.

 nlen (input) 

32-bit integer, by value.  The length in bytes of the specified name.

 flags 

32 bits, by reference.  A bit representation of various options.  No
flags are currently defined for this intrinsic.

 descriptor (output) 

32-bit integer, by reference.  The VC socket or call socket descriptor
that was given away via the IPCGIVE command.

 result (output) 

32-bit integer, by reference.  The error code returned; zero if no error.

Description 

The IPCGET intrinsic allows a process to obtain ownership of a VC socket
or call socket descriptor that has been relinquished by another process
through the IPCGIVE intrinsic.  A temporary name identifies the socket
for the process which wishes to acquire it.  All the parameters are
required.

Condition codes returned by this intrinsic are:

 *  CCE--Succeeded.

 *  CCL--Failed.

 *  CCG--Not returned by this intrinsic.

This intrinsic cannot be called in split stack mode.



MPE/iX 5.0 Documentation