User`s guide

3: ADCCP NRM DLI Functions
DC 900-1317J 45
The Freeway server is normally configured only once, during the installation proce-
dures described in the Freeway User’s Guide. DLI session and TSI connection configu-
rations are defined by modifying text configuration files and running the
dlicfg and
tsicfg preprocessor programs. Refer to Chapter 5 of this document, as well as the
Freeway Data Link Interface Reference Guide and the Freeway Transport Subsystem Inter-
face Reference Guide.
Either of the following methods can be used to configure an ICP link for ADCCP NRM:
• You can specify ICP link parameters in the DLI text configuration file and then
run the
dlicfg preprocessor program (Chapter 5). The dlOpen function uses the
resulting DLI binary configuration file to perform the link configuration during
the DLI session establishment process.
• You can perform ICP link configuration within the client application (described
in Section 3.4.20). This method is useful if you need to change link configuration
without exiting the application.
3.1.2 Normal versus Raw Operation
There are two types of DLI operation:
• A session is opened for Normal operation if you set protocol to a specific protocol
(for example,
“NRM”); then the DLI software configures the ICP links using the
values in the DLI configuration file and transparently handles all headers and I/O.
• A session is opened for Raw operation if you set protocol to “raw”; then your appli-
cation must handle all configuration, headers, and I/O details. Refer to the
Freeway Data Link Interface Reference Guide if you need to use Raw operation.
To read and write using Normal operation, your client application typically interacts
with Freeway only for the purpose of exchanging data with the remote application.
However, if your client application needs to interact with Freeway to obtain status or
reports, or to provide Freeway with protocol-specific information relating to the data