User`s guide

48 DC 900-1339H

FMP Programmer’s Guide

An unsuccessful Clear Statistics command can return the following error code in the

dlRead pOptArgs.iICPStatus field (see Appendix C for error handling):

DLI_ICP_ERR_BAD_MODE

The function request is not available for the requested

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

3.4.1.3 Set ICP Message Buffer Size Command

The ICP message buffer size applies to all links on the ICP. The DLI sets the ICP mes-

sage buffer size as part of the conﬁguration process during the

dlOpen command. The

default ICP message buffer size of 1024 is used in the following situations:

• If the buffer size is not changed when the very ﬁrst dlOpen is issued, immediately

after the FMP software is downloaded (the

dlOpen function uses the value speci-

ﬁed in the

msgBlkSize parameter value, page 104)

• If you specify an invalid buffer size for the Set ICP Message Buffer Size command

If your application must set the ICP message buffer size itself (see the caution previ-

ously mentioned in Section 3.1.4), it must set the

cfgLink and enable DLI conﬁgura-

tion parameters to “no” (Section 5.2 on page 102) and perform the following

procedure:

First, download the FMP software and send a

dlOpen request for one link on the ICP.

Second, send a

dlWrite function with the pOptArgs.usProtCommand ﬁeld set to

DLI_PROT_SET_BUF_SIZE. Set the iBufLen parameter to 2, and set the write buffer to the

maximum data size (in bytes) for any single transfer to or from the ICP. The valid range

is 256 to 8192 bytes and must be less than or equal to the

maxBufSize parameter in the

TSI conﬁguration ﬁle (the default value is 1024).

An unsuccessful Set ICP Message Buffer Size command can return one of the following

error codes in the

dlRead pOptArgs.iICPStatus ﬁeld (see Appendix C for error han-

dling):