User`s guide

3: BSC 3270 DLI Functions
DC 900-1340I 55
3.4 Overview of BSC 3270 Requests using dlWrite
For BSC 3270 the dlWrite function supports three dlWrite categories: commands, infor-
mation requests, and data transfer, which are discussed in detail in Section 3.4.1
through Section 3.4.3. Whether you use blocking or non-blocking I/O, each
dlWrite
request must be followed by a dlRead request to receive the command confirmation,
information requested, or acknowledgment of the data transfer. Section 3.5 discusses
these different responses received using
dlRead.
In a typical BSC 3270 application, ALL dlWrite requests use Raw operation; that is, the
optional arguments structure (page 54) is required to specify protocol-specific informa-
tion.
Ta ble 3 –4 shows the BSC 3270 DLI request codes for different categories of the dlWrite
function. Each request is explained in the following sections.
In addition to the command-specific error codes listed in the following sections, an
unsuccessful
dlWrite function can return one of the following error codes in the dlRead
pOptArgs.iICPStatus
field (see Appendix D for error handling):
DLI_ICP_ERR_INBUF_OVERFLOW
Input buffer overflow
DLI_ICP_ERR_OUTBUF_OVERFLOW
Output buffer overflow