User`s guide

16 DC 900-1406E
BSCTRAN Programmer’s Guide
1.1 Freeway Server versus Embedded ICP Version
The Freeway server version of BSCTRAN uses the Freeway data link interface (DLI)
application program interface (API). Its execution requires both a DLI configuration
file (
dlitrancfg) and a transport subsystem interface (TSI) configuration file
(
tsitrancfg). When BSCTRAN is executed, binary versions of dlitrancfg and
tsitrancfg are read and the information used to manage the session(s) with Freeway.
The
dlicfg program is used to compile the DLI configuration text into binary form.
The
tsicfg program is used to compile the TSI configuration text into binary form.
The binary versions of the configuration files are called
dlitrancfg.bin and
tsitrancfg.bin, respectively. These compilations take place prior to executing
BSCTRAN. The binary files reside in the same directory as the BSCTRAN executable
image. Refer to the Freeway Data Link Interface Reference Guide for more information.
The embedded ICP interface to DLI is called DLITE. The embedded ICP version is sim-
ilar to the Freeway server version except that all ICPs are embedded on the client pro-
cessor, the DLI configuration file is named
dlitetrancfg, and there is no TSI
configuration file. The DLITE interface is described in the user’s guide for your ICP and
operating system (for example, the ICP2432 User’s Guide for OpenVMS Alpha (DLITE
Interface)).
1.2 BSCTRAN Modules
The BSCTRAN program contains five modules that represent different levels of inter-
face. The modular nature of the interfaces allows the user to develop special applica-
tions linked with a subset of these modules to provide either a file-oriented or a record-
oriented interface. All five modules are written in the C programming language and
source code is provided so that the user can make modifications if needed. Two include
files (
BSC.H and BSCTRAN.INC) are provided for compilation. This document describes
the top three BSC interfaces: BSCTRAN, BSCFTI, and BSCRTI.