socktrm

socktrm

Terminates the Socket Library Environment

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 IBM TCP/IP nonintegrated sockets that rely upon IUCV message passing, the IUCV path to IBM TCP/IP is severed and cleared, which results in termination of all socket connections held by the current environment and disestablishes the IUCV connection with IBM TCP/IP.

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

close , shutdown

Chapter Contents
Previous
Next
Top of Page