User`s guide

44 DC 900-1343D

DDCMP Programmer’s Guide

2.5.2 Information Requests using Raw dlWrite

Section 2.5.2.1 through Section 2.5.2.3 explain how to issue protocol-speciﬁc informa-

tion requests to the DDCMP 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.

2.5.2.1 Request Buffer Report

Use the dlWrite function with the pOptArgs.usProtCommand ﬁeld set to

DLI_PROT_GET_BUF_REPORT to request a buffer report. The dlRead buffer report response

(the

pOptArgs.usProtCommand ﬁeld is set to DLI_PROT_GET_BUF_REPORT by the DLI) con-

sists of 7 words (14 bytes) of buffer information as described in Table 2–8.

Table 2–8: Buffer Report Deﬁnition

Word Description

1 ICP message buffer size

2 Number of free ICP message buffers

3 Number of buffers in general client queue

4 Number of buffers in client input queue

5 Number of buffers in link input queue

6 Number of buffers in link output queue

7 Number of buffers in fak queue