Chapter Contents |
Previous |
Next |
socktrm |
Portability: | SAS/C extension |
SYNOPSIS | |
DESCRIPTION | |
IMPLEMENTATION | |
CAUTIONS | |
PORTABILITY | |
RELATED FUNCTIONS |
SYNOPSIS |
#include <sys/socket.h> void socktrm(void)
DESCRIPTION |
socktrm
terminates the current SAS/C Socket Library environment and
returns it to an uninitialized state without requiring termination of the
general SAS/C Library environment.
IMPLEMENTATION |
For integrated sockets, calling
socktrm
has no effect since socket status is
controlled by USS rather than by the SAS/C Library. Any open sockets remain
open.
For CICS sockets, the effect of calling
socktrm
is to close all open socket connections
and mark the socket library state as uninitialized. For CICS, since no IBM
TCP/IP CICS call is provided to directly undo the libraries', internal CICS
socket initialization INITAPI call, further socket calls by the application
may result in errors indicating that a second INITAPI was attempted with a
duplicate name. Note that the current IBM CICS TCP/IP behavior is to free
up the name for reuse after a duplicate INITAPI is attempted; however, the
library does not take advantage of this behavior.
CAUTIONS |
All outstanding socket connections are closed and lost upon completion of this function call.
PORTABILITY |
socktrm
is specific to the SAS/C sockets implementation for use with
IBM TCP/IP and, therefore, is not portable. Other TCP/IP vendors and socket
implementations, at their discretion, may provide an equivalent function call
or different functionality.
RELATED FUNCTIONS |
Chapter Contents |
Previous |
Next |
Top of Page |
Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.