User guide

8: Client Applications — DLI Overview
DC 900-1338I 143
• transport subsystem interface (TSI) connection configuration
• protocol-specific ICP link configuration
The Freeway server boot configuration file is normally created during the installation
procedures described in the Freeway User Guide. DLI session and TSI connection con-
figurations are defined by specifying parameters in DLI and TSI ASCII configuration
files and then running two preprocessor programs,
dlicfg and tsicfg, to create binary
configuration files. The DLI and TSI configuration process is described in
Section 8.1.1.1 and Section 8.1.1.2.
Protocol-specific ICP link configuration must be performed by the client application
(as described in Section 9.2.7.1 on page 175) after
dlOpen completes the DLI session
establishment process.
8.1.1.1 DLI Configuration for Raw Operation
The application program interface (API) is implemented in two levels: the data link
interface (DLI) and the transport subsystem interface (TSI). These levels are docu-
mented in the Freeway Data Link Interface Reference Guide and the Freeway Transport
Subsystem Interface Reference Guide.
The DLI provides two levels of operation for ICP protocol software, as described in the
Freeway Data Link Interface Reference Guide. Normal operation is not supported by the
SPS. Raw operation means that the application programmer must provide link config-
uration, link enable, and all the other requirements of the ICP protocol software. The
SPS is provided as an example to be modified; however, the DLI supports only Raw
operation for the SPS. The DLI optional arguments data structure
(DLI_OPT_ARGS),
which is central to Raw operation, is described in Section 9.1 on page 157. The embed-
ded DLITE interface also supports only Raw operation.
The configuration files for the client application are relatively simple. However, you
must specify the DLI configuration parameters whose values differ from the defaults.
11/14/97:
Figure 8-1 is
not what is
really in the
software, but
Eric said to use
it! The real file
doesn’t have
Cfglink and
Enable.