NetIPC 3000/XL Programmer's Reference Manual (5958-8600)

Chapter 3 69
NetIPC Intrinsics
IPCCHECK
IPCCHECK
Returns the number of the last applicable error.
Syntax
IPCCHECK ( descriptor [, ipcerr ][, pmerr ][, result ]
Parameters
descriptor (input)
32-bit integer, by value. The call socket or VC socket
descriptor for which the error is to be reported. A zero
value indicates the last call socket or VC socket
descriptor referenced.
ipcerr (output)
32-bit integer, by reference. The error code of the
last recorded NetIPC error.
pmerr (output)
32-bit integer, by reference. The error code of the
last recorded protocol module (i.e., the Transmission
Control Protocol (TCP) or X.25 protocol).
result (output)
32-bit integer, by reference. The error code returned
for this intrinsic call (not the previously recorded
error). A zero value indicates no error.
Description
The IPCCHECK intrinsic returns the last recorded NetIPC and/or
protocol module error for a given call socket or VC socket (that is, the
VC socket descriptor at the calling process’s end). If the descriptor value
is zero, the most recent error applicable to the last call or VC socket
referenced is returned. The descriptor is the only required parameter
(option variable).
Condition codes returned by this intrinsic are:
• CCE — The intrinsic call was successful.
• CCL — Unsuccessful.
• CCG — Unsuccessful. The intrinsic could not return the error code
because the calling process does not have access to the NetIPC data
structure which retains error codes.
This intrinsic can be called in split stack mode.