NIO CommKit Host Interface Installation and System Administration Manual

DKDIAL(3X) DKDIAL(3X)
E-41 CommKit Host Interface, Release 4.0
NAME
dkdial – create an AT&T data switch connection to a remote destination
SYNOPSIS
#include <dkit/dk.h>
#include <dkit/sysexits.h>
dkitdial (cmd, dialp)
int cmd;
struct dkit_dial ∗dialp;
dkdial (dialstring)
char ∗dialstring;
dkndial (dialstring, intf)
char ∗dialstring;
int intf;
dktdial (dialstring)
char ∗dialstring;
dkntdial (dialstring, intf)
char ∗dialstring;
int intf;
extern int dk_verbose, dk_errno;
DESCRIPTION
dkitdial obtains an available data switch channel and places a call to the destination. It is a general-purpose
routine incorporating all of the dialing functions provided by dkdial, dkndial, dktdial and dkntdial plus
additional functionality. cmd is the command for dkitdial. The value of cmd is constructed by or-ing the
following flags:
DK_DIAL Do a regular dial. This flag is required.
DK_SELINTF Select an interface board number.
DK_PUSHTTY Push the dkty, ldterm and ttcompat STREAM modules.
DK_USEENV Use the environment variable, DKINTF, for the interface number.
dialp points to the structure dkit_dial. The structure dkit_dial includes the following members:
char *dest; /* destination string */
int intf; /* interface board number */
char *baud; /* baud rate string to be added to dialstring */
/* baud should be set to NULL if there */
/* is no baud rate string */
dest is the pointer to the destination string. intf is the interface board number. If the DK_SELINTF flag is set in
cmd, the hardware interface number chosen is taken from intf. Otherwise, if the DK_USEENV flag is set, (
DK_SELINTF overrides DK_USEENV ), the hardware interface chosen is set by the environment variable
DKINTF. (See the section below on "Multiple Interfaces" for more information.) If neither DK_SELINTF nor
DK_USEENV are set, an interface with an available channel is chosen automatically. baud is the pointer to the
baud rate string. The valid baud rate string format is ’BD=’ followed by five digits. For example, the string
’BD=09600’ is a valid string. baud should be set to NULL except for special purpose applications.
If the DK_PUSHTTY flag is set in cmd, dkitdial will automatically push the dkty, ldterm, and ttcompat
STREAMS modules in anticipation that the connection will be used for a terminal session. The dkitdial call
will fail if the dkty or ldterm STREAMS module cannot be pushed. The call will succeed if the ttcompat
STREAMS module cannot be pushed, as its functions are generally optional.