User`s guide

140 DC 900-1340I
BSC Programmer’s Guide
5.4.2 Information Requests using Raw dlWrite
Section 5.4.2.1 through Section 5.4.2.6 explain how to issue specific information
requests to the BSC 2780/3780 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
5.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 Tab le 5 –8.
Table 5–8: Buffer Report Definition
Wo rd 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 Protogate diagnostics