User`s guide

3: BSC 3270 DLI Functions
DC 900-1340I 57
3.4.1 Commands using Raw dlWrite
Section 3.4.1.1 through Section 3.4.1.12 explain how to issue specific commands to the
BSC 3270 software using the
dlWrite function. Call dlRead to receive the command con-
firmation response (the
dlRead pOptArgs.usProtCommand field is set by the DLI).
3.4.1.1 Set Translation Table Command
Use the dlWrite function with the pOptArgs.usProtCommand field set to
DLI_PROT_SET_TRANS_TABLE to set translation table 1 or 2. Use the MSB of the
pOptArgs.usProtCircuitID field to specify the translation table to be set (1 or 2). Each link
can use either of the two tables for character translation. After Freeway startup, the
tables contain the default values shown in Appendix C. Use the data area of the buffer
pointed to by the
pBuf parameter to send the translation table values. The first 256 bytes
of data are the conversion values for the ASCII-to-new character set translation. The
next 256 bytes are the conversion values for the new character set-to-ASCII translation.
An unsuccessful Set Translation Table 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.
3.4.1.2 Clear Statistics Command
Use the dlWrite function with the pOptArgs.usProtCommand field set to
DLI_PROT_CLR_STATISTICS to clear the link statistics report. The link statistics are cleared as
soon as this command is received. The statistics are automatically cleared when a Start
Link command (Section 3.4.1.5) is issued. The last four fields of the statistics report
(Section 3.4.2.3) are CU-specific. Use the MSB of the
pOptArgs.usProtCircuitID field to