User`s guide

3: BSC 3270 DLI Functions
DC 900-1340I 79
An unsuccessful dlWrite data transfer request can return one of the following error
codes in the
dlRead pOptArgs.iICPStatus field (see Appendix D for error handling):
DLI_ICP_ERR_LINK_INACTIVE
The link is stopped.
DLI_ICP_ERR_BAD_MODE
The function request is not available for the requested
access mode.
DLI_ICP_ERR_XMIT_TIMEOUT
The protocol software was unable to transmit the data.
This error occurs when some or all of the modem sig-
nals are not present.
3.4.3.1 Send Normal Data
If your application needs to perform a Raw dlWrite, use the dlWrite function with the
pOptArgs.usProtCommand field set to DLI_PROT_SEND_NORM_DATA or
DLI_PROT_SEND_NORM_DATA_EOM to send normal data. The data is code translated to
ASCII or EBCDIC (depending on the Character Set option, Section 4.7 on page 91).
As an example, assuming the ICP message buffer size is 2048 bytes, to send a 4096-byte
normal data block would require two writes, setting the
pOptArgs.usProtCommand field
to
DLI_PROT_SEND_NORM_DATA and DLI_PROT_SEND_NORM_DATA_EOM, respectively. A 2048-
byte message (or less) would require one write transfer setting the
pOptArgs.usProtCommand field to DLI_PROT_SEND_NORM_DATA_EOM.
3.4.3.2 Send Transparent Data
If your application needs to perform a Raw dlWrite, use the dlWrite function with the
pOptArgs.usProtCommand field set to DLI_PROT_SEND_TRANS_DATA or
DLI_PROT_SEND_TRANS_DATA_EOM to send transparent data. The client can send transpar-
ent data in either ASCII or EBCDIC mode. In either mode, the data is not code-con-
verted. The blocks are preceded by DLE STX and terminated with either DLE ETB or
DLE ETX. The DLE characters are not counted in the block size. BSC 3270 performs all
the required DLE insertion and deletion for transparent data streams.