User`s guide

5: BSC 2780/3780 DLI Functions
DC 900-1340I 123
vated. If you are using non-blocking I/O, you must also make a dlPoll request to read the
completion status of the command.
An unsuccessful Stop Link command can return one of the following error codes 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.
DLI_ICP_ERR_BAD_PARMS
The parameter value(s) used for the function call are
illegal.
5.4.1.7 Safe Store Acknowledge Command
Use the dlWrite function with the pOptArgs.usProtCommand field set to
DLI_PROT_SAFE_STORE_ACK to acknowledge a stored message. When the safe store option
is enabled, this command must be sent to the BSC software after each end-of-message
data block is received by the client (see the data transfer EOM codes listed in Tabl e 5 –4 ).
Safe store provides the ability to acknowledge a received data message after it has been
examined by the client application program or stored on disk. Safe store is often used
by financial institutions where a line acknowledge constitutes acceptance of a sale or
trade.
Normally, the BSC software automatically acknowledges each received data block. With
the safe store option enabled, the BSC software continues to acknowledge received
intermediate blocks (ETB); however, when the last block (ETX) is received, the BSC
software does not send an automatic acknowledgment on the line. Instead, the BSC
software waits for the client to either accept the message by issuing a Safe Store
Acknowledge command or reject the message by issuing a Send EOT command
(Section 5.4.1.8).
The Safe Store Acknowledge command causes the BSC software to transmit a positive
acknowledgment (ACK0 or ACK1) in response to the last block (ETX) received from