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

Chapter 3 119
NetIPC Intrinsics
IPCSHUTDOWN
IPCSHUTDOWN
Releases a descriptor and any resources associated with it.
Syntax
IPCSHUTDOWN ( descriptor [, flags ][, opt ][, result ]
Parameters
descriptor (input)
32-bit integer, by value. The socket to be released.
May be a call socket, destination, or VC socket
descriptor.
flags
32 bits, by reference. A bit representation of various
options. The following flag is defined:
flag [17] — (TCP only.) graceful release of connection.
opt
Record or byte array, by reference. A list of options,
with associated information. The following option is
defined:
• clear user data (code=2, length=n, n bytes) (input).
(X.25 only.) If the fast select facility was used in the
connection request, and the connection was
accepted, you can include a clear user data field
which can contain up to 128 bytes of data. For more
information, see the discussion of the fast select
facility in Chapter 1 , “NetIPC Fundamentals,” of
this manual.
• reason code (code=143, length=2) (input). (X.25
only.) This option allows you to include cause and
diagnostic values in the X.25 clear packets when a
connection is closed down. The first byte contains
the cause and the second byte contains the
diagnostic code. A list of cause and diagnostic codes
used with NS X.25 protocol access is contained in
Appendix B , “Cause and Diagnostic Codes.” If DTE
originated, the cause code will always be zero.
result (output)
32-bit integer, by reference. The error code
returned; zero if no error.