User`s guide

146 DC 900-1340I
BSC Programmer’s Guide
5.4.2.6 Request Software Version ID
Use the dlWrite function with the pOptArgs.usProtCommand field set to
DLI_PROT_GET_SOFTWARE_VER to request the software version ID. The dlRead software ver-
sion report response (the
pOptArgs.usProtCommand field is set to
DLI_PROT_GET_SOFTWARE_VER by the DLI) is a one-line report such as the following:
@(#) Protogate BSC for Freeway 2000 – V03.0k 02-May-01 OS/Impact Version V1.7
5.4.3 Data Transfer using Raw dlWrite
The BSC 2780/3780 software provides two write types (EOM and non-EOM) for each
data transfer to allow the user to send or receive a single message that is larger than the
configured ICP message buffer size. Each type of data block consists of n bytes of data,
where n is a number from 0 to the maximum data size specified by the Set ICP Message
Buffer Size command (Section 5.4.1.3).
If BSC 2780/3780 is currently receiving data from the line when the client computer
sends a data block, the data block waits in memory until the current operation is com-
plete before attempting to transmit.
If the localAck DLI configuration parameter is set to “no” (see the Freeway Data Link
Interface Reference Guide), the client application must make a
dlRead request to receive
the data acknowledge response for each
dlWrite data transfer request (the dlRead
pOptArgs.usProtCommand
field is set to DLI_PROT_RESP_LOCAL_ACK by the DLI). One
DLI_PROT_RESP_LOCAL_ACK response (with the dlRead pOptArgs.iICPStatus field set to 1,
signifying that one block of data was sent) is sent to the client computer after each data
block has been successfully transmitted to the remote computer, and can be treated by
the client program as the remote acknowledgment. Data acknowledgments are also
used to report transmission errors (as a response to a
dlRead request as described in
Section 5.5.2). The client application can use the data acknowledge response to monitor
the success or failure of transmitted data messages, or for regulating the number of out-
bound messages that the BSC software has pending transmission at any one time.