Installation guide

46 DC 900-1564A

Synchronous Link Control (SLC) Programmer’s Guide

4.4 Report Category

The Report category is used to request speciﬁc reports from the ICP.

4.4.1 Get Buffer Report

The DLI_PROT_GET_BUF_REPORT command requests the current ICP buffer usage. The

ICP

DLI_PROT_GET_BUF_REPORT response contains the requested buffer usage informa-

tion.

The header formats are detailed in Section 5.6 on page 68.

When the application writes a

DLI_PROT_GET_BUF_REPORT command to the ICP, it does

so with a zero-length data area. The ICP

DLI_PROT_GET_BUF_REPORT response data area

contains a report of current buffer usage for the entire ICP using the “C” structure for-

mat shown in Figure 4–1, where “

UINT32” is a 32-bit unsigned integer data type.

typedef struct slc_buf_report_struct

{

UINT32 available_icp_block_buffers;

UINT32 available_icp_message_buffers;

UINT32 queued_rcv_empty_blocks;

UINT32 queued_rcv_link_control_blocks;

UINT32 queued_rcv_normal_blocks;

UINT32 queued_rcv_priority_blocks;

UINT32 queued_rcv_normal_message;

UINT32 queued_rcv_priority_message;

UINT32 queued_xmt_link_control_blocks;

UINT32 queued_xmt_normal_blocks;

UINT32 queued_xmt_priority_blocks;

UINT32 queued_xmt_normal_message;

UINT32 queued_xmt_priority_message;

} SLC_BUF_REPORT_TYPE;

Figure 4–1: SLC Buffer Report “C” Structure