User guide

180 DC 900-1338I
Protocol Software Toolkit Programmer Guide
PROT_HDR
command = DLI_PROT_GET_STATISTICS_REPORT
session = session ID
At the ICP, the fields of the ICP and protocol headers that the ICP sends to the client
application contain the following values:
ICP_HDR
count = size of protocol header (16 bytes) plus size of data
command = DLI_ICP_CMD_READ
status = 0 (success) or an error code
PROT_HDR
command = DLI_PROT_GET_STATISTICS_REPORT
modifier = 0 (success) or an error code
session = session ID
DATA AREA = statistics report
The ICP copies the link control table’s statistics data structure to the data area that fol-
lows the protocol header and writes error codes to the
status and modifier fields (or zero
to indicate success). The ICP always returns a report, even if that link has not yet been
enabled. The client receives the statistics report by issuing a
read command. (Note that
this statistics report serves as an acknowledgment to the
write command.)
The client’s expected response is a
DLI_PROT_GET_STATISTICS_REPORT message
with the
iICPStatus field set to DLI_ICP_ERR_NO_ERR, as shown in Figure9–16. If the
ICP discovers an error in the message, it returns the statistics request message with the
iICPStatus field set to an error code.
The data area for the link statistics report contains the structure
SPS_STATS_REPORT
as shown in Figure9–17.