User`s guide

3: FMP DLI Functions
DC 900-1339H 47
3.4.1 Commands using Raw dlWrite
Section 3.4.1.1 through Section 3.4.1.6 explain how to issue specific commands to the
FMP software using the
dlWrite function. Call dlRead to receive the command confir-
mation response (the
dlRead pOptArgs.usProtCommand field is set by the DLI).
3.4.1.1 Set Translation Table Command
Use the dlWrite function with the pOptArgs.usProtCommand field set to
DLI_PROT_SET_TRANS_TABLE to set translation table 1 or 2 (translation table 3 cannot be
changed). Use the MSB of the
pOptArgs.usProtCircuitID field to specify the transla-
tion table to be set (1 or 2). Each link can use any of the three tables for character trans-
lation. After Freeway startup, the tables contain the default values shown in
Appendix B. Use the data area of the buffer pointed to by the
pBuf parameter to send the
translation table values. The first 256 bytes of data are the conversion values for the
ASCII-to-new character set translation. The next 256 bytes are the conversion values for
the new character set-to-ASCII translation.
An unsuccessful Set Translation Table command can return one of the following error
codes 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.
DLI_ICP_ERR_BAD_PARMS
The parameter value(s) used for the function call are
illegal.
3.4.1.2 Clear Statistics Command
Use the dlWrite function with the pOptArgs.usProtCommand field set to
DLI_PROT_CLR_STATISTICS to clear the link statistics report. The link statistics are
cleared as soon as this command is received. The statistics are automatically cleared
when a Start Link command (Section 3.4.1.5) is issued.