User`s guide

3: FMP DLI Functions

DC 900-1339H 49

DLI_ICP_ERR_BAD_MODE

The function request is not available for the requested

access mode; see Table 2–2 on page 33.

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 Conﬁgure Link Command

You can deﬁne the ICP link conﬁguration by setting parameters in the DLI text conﬁg-

uration ﬁle and running the

dlicfg preprocessor program as described in Chapter 5;

however, if your application must perform link conﬁguration, set both the

cfgLink and

enable DLI configuration parameters to “no” for that link and then perform the config-

uration as follows:

Use the

dlWrite function with the pOptArgs.usProtCommand ﬁeld set to

DLI_PROT_CFG_LINK to set the link configuration options. The buffer pointed to by the

pBuf parameter contains a string of 16-bit words containing link configuration infor-

mation. The string consists of a variable number of two-word conﬁguration

option/value pairs ending with a zero word. The

iBufLen ﬁeld equals the number of

bytes in the conﬁguration string including the zero terminator word. Figure 3–2 gives

an example of the link conﬁguration string.

Each option number corresponds to a software-selectable option of the FMP software.

The conﬁguration value is used to set that option. Table 4–1 on page 66 lists the avail-

able options and values for the FMP protocol.

All valid parameters are set by the ICP. If invalid parameters are requested, the ICP lists

them in the data area of the response, but no error code is returned. Customers who

want to know if all their link parameters were set can check the data area of the

response. This approach enables applications to set hardware-dependent options on

startup without being concerned about receiving an error. For example, the Electrical

Leslie — 3/97:

This may not

still be true

about the

Electrical

Interface

option???