User`s guide

130 DC 900-1340I
BSC Programmer’s Guide
DLI_ICP_ERR_LINK_INACTIVE
The link is stopped.
5.4.1.12 BSC 2780/3780 Flush Queue Command
Use the dlWrite function with the pOptArgs.usProtCommand field set to
DLI_PROT_FLUSH_QUEUE to send a BSC 2780/3780 Flush Queue command to clear out any
data acknowledgments that might remain when a link is stopped and restarted.
If a transmission is in progress, the Flush Queue command causes any outbound
queued messages to be returned to the client with the
dlRead pOptArgs.usProtCommand
field set to DLI_PROT_RESP_LOCAL_ACK, and the dlRead pOptArgs.iICPStatus field set to
DLI_ICP_ERR_DEVICE_BUSY or DLI_ICP_ERR_USER_ABORT. The transmission is aborted by
sending an EOT instead of the next appropriate response.
The BSC 2780/3780 software responds to a Flush Queue command with a Flush Queue
confirmation with the
dlRead pOptArgs.usProtCommand field set to
DLI_PROT_FLUSH_QUEUE. The client should issue a Flush Queue command and then read
from the BSC 2780/3780 software until the confirmation is received. This makes sure
the BSC 2780/3780 software can begin the next transmission from a known, cleared
state.
The Flush Queue command is a transmit-only function; it does not affect incoming
messages. This is in contrast to the Stop Link command (Section 5.4.1.6) that aborts
both the receive and transmit functions.
An unsuccessful Flush Queue command can return the following error code in the
dlRead pOptArgs.iICPStatus field (see Appendix D for error handling):
DLI_ICP_ERR_BAD_MODE
The function request is not available for the requested
access mode.