User`s guide

3: FMP DLI Functions
DC 900-1339H 53
3.4.2 Information Requests using Raw dlWrite
Section 3.4.2.1 through Section 3.4.2.6 explain how to issue specific information
requests to the FMP software using the
dlWrite function. You must then make a Raw
dlRead request to receive the report information (the dlRead pOptArgs.usProtCommand
field is set by the DLI to reflect the type of report, and the iBufLen parameter indicates
the size of the message).
Caution
The dlWrite iBufLen parameter must specify a buffer size large
enough for the requested report; otherwise, the
dlRead function
truncates the text to the size indicated by the
dlWrite iBufLen
parameter.
3.4.2.1 Request Buffer Report
Use the dlWrite function with the pOptArgs.usProtCommand field set to
DLI_PROT_GET_BUF_REPORT to request a buffer report. The dlRead buffer report response
(the
pOptArgs.usProtCommand field is set to DLI_PROT_GET_BUF_REPORT by the DLI) con-
sists of 20 words (40 bytes) of buffer information as described in Table 3–5.
Table 3–5: Buffer Report Definition
Word Parameter
1 ICP message buffer size
2 Number of free ICP message buffers
3 Total number of ICP message buffers
4 Transmission buffer size
5 Number of free transmission buffers
6 Total number of transmission buffers
7 Total number of links
8–20 Reserved for Simpact diagnostics