User`s guide

3: BSC 3270 DLI Functions
DC 900-1340I 59
DLI_ICP_ERR_BAD_MODE
The function request is not available for the requested
access mode.
DLI_ICP_ERR_BAD_PARMS
The parameter value(s) used for the function call are
illegal.
DLI_ICP_ERR_LINK_ACTIVE
The link is already started.
3.4.1.4 Configure Link Command
The DLI can configure the ICP links by setting parameters in the DLI text configuration
file and running the
dlicfg preprocessor program as described in Chapter 7; however, if
your application must perform link configuration, set both the
cfgLink and enable DLI
configuration parameters to “no” for that link and then perform the configuration as
follows:
Use the dlWrite function with the pOptArgs.usProtCommand field set to DLI_PROT_CFG_LINK
to set the link configuration options. The buffer pointed to by the pBuf parameter con-
tains a string of 16-bit words containing link configuration information. The string
consists of a variable number of two-word configuration option/value pairs ending
with a zero word. The
iBufLen field equals the number of bytes in the configuration
string including the zero terminator word. Figure 3–2 gives an example of the link con-
figuration string.