NIO CommKit Host Interface Installation and System Administration Manual

DKEPOINT(3X) DKEPOINT(3X)

E-44 CommKit Host Interface, Release 4.0

NAME

dkgetepoint, dksetepoint – AT&T data switch endpoint type detection routines

SYNOPSIS

#include <dkit/dk_unixp.h>

int dkgetepoint(fd, ep_type)

int fd;

char *ep_type;

int dksetepoint(fd, ep_type)

int fd;

char *ep_type;

DESCRIPTION

The host interface subroutine library contains two routines that permit applications to program and retrieve

an endpoint type code for incoming circuit connections when using the dkhs(7) driver. Homogeneous Datakit

II VCS networks supply endpoint type identification in the dialstring allowing dkserver(1M) to program the

endpoint type with dksetepoint() for every incoming call. The endpoint type is set to DKepUNKNOWN

when connections originate from a Datakit VCS region of the network or when the host is connected to a

Datakit VCS node. All endpoint type #define constants are kept in the header file /usr/include/dkit/

dk_unixp.h.

dkgetepoint() retrieves the endpoint type code from the circuit associated with fd and stores the single

character at the location addressed by ep_type. The return value is non-zero for success and zero for failure.

The value of ep_type is undefined on an error return.

dksetepoint() sets the endpoint type code for the circuit associated with fd to the single character value found

at address ep_type. The return value is non-zero for success and zero for failure.

EXAMPLE

The code fragments below illustrate how to retrieve and print the endpoint type code for the circuit associated

with fd:

#include <dkit/dk_unixp.h>

char ep_type;

int ret;

ret = dkgetepoint(fd, &ep_type);

if (ret != 0)

printf("Endpoint type is ’%c’\n", ep_type);

FILES

/usr/include/dkit/dk_unixp.h endpoint type definitions

/usr/lib/libdk.so host interface subroutine library