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