Texas Instruments 990 User Manual page 114

Applications Programming
where:
<buffer> is the name of the calling programs's data
buffer into which the subroutine returns the
data that has been found. The data buffer is an
array in FORTRAN tasks and.ei ther an array or a
character string in Pascal tasks.
<buf lng> contains the length in characters (one byte per
character) of the calling program's data buffer.
If this value is less than the data length
(character count), the subroutine returns an
error code 9 in the status code variable and it
returns the length of the data that has been
sent in the character count variable. The
subroutine does not transfer any portion of the
data when the length of the data that has been
sent is too large for the program's data buffer.
<char cnt> is the variable to which the subroutine returns
the character count. This is the number of
characters (one byte per character) in the data
block that the subroutine transferred from a
communications input buffer to the calling
program's data buffer.
<did> contains, after successful completion of the
read call, the network ID of the program or
remote device that sent the data. This variable
always contains the network ID of the remote
program or device. If the calling program
executes in a secondary station, the remote
program would be in the primary station.
<sid> contains, after successful completion of the
read call, the network ID of the calling
program. This is true whether the calling
program (the program that issued the read call)
executes in the primary station or a secondary
station.
<st code> is the variable to which the subroutine returns
the status code. The calling program should
check the sta tus code that is re turned and take
appropriate action. The codes and their
meanings are as follows:
4-28 2270526-9701