NIO CommKit Host Interface Installation and System Administration Manual

DKSPLWAIT(3X) DKSPLWAIT(3X)
E-62 CommKit Host Interface, Release 4.0
NAME
dksplwait – wait for an AT&T data switch circuit to be reconnected
SYNOPSIS
int dksplwait(fd);
int fd;
extern int dk_splwtime;
DESCRIPTION
dksplwait allows the target of a splice to wait for the splice to complete. The fd argument indicates the circuit
to be waited on.
Normally the following actions are taken to maintain synchronization in a splicing scenario:
1 Call Originator: Makes call to splice application.
2 Splicing Host: Makes call to target via dkdial(3X). Waits on read.
3 Target Host: Writes to splicing host. Waits for splice to complete with dksplwait(3X).
4 Splicing Host: Splices circuits with dksplice(3X). Exits.
5 Call Originator: Continues conversation with target.
Target Host: Continues conversation with call originator.
dksplwait will return immediately if the reconnection has already taken place.
The parameter, dk_splwtime, if set to a positive integer by the user, causes dksplwait to time out after the
specified number of seconds. Setting dk_splwtime to -1 will cause dksplwait to wait indefinitely for the
splice to complete. By default, dk_splwtime is set to -1. It is recommended that dk_splwtime be used to
guarantee recovery from the error case where, for some reason, the splice does not take place.
FILES
/usr/lib/libdk.so host interface subroutine library
SEE ALSO
dksplice(3X), dkhs(7), dkux(7)
DIAGNOSTICS
On successful completion, a value of zero is returned. Otherwise, a value of -1 is returned and errno is set to
indicate the error. An errno value of EINVAL indicates that dk_splwtime has been set to a value less than -
1. An errno value of ENOENT means that the interface is not available. An errno value of ETIME indicates
that dksplwait timed out before the splice completed.