User`s guide

80 DC 900-1406E

BSCTRAN Programmer’s Guide

Arguments

rdblock This is a pointer to a data structure of type TRANBUF. It receives the

data block from the ICP. See Section 4.8 on page 91 or the

BSCTRAN.INC include file for details of the data structure.

recbuf This is a pointer to a descriptor. It is a character string to receive the

data record from the ICP. The maximum length is 4096 bytes. The

descriptor length ﬁeld should be cleared before calling BSCREAD.

Exception: After a RCUNR return from BSCREAD, the length should

not be cleared, because it may contain a partial record length caused

by the unexpected response.

recl This is a pointer to an integer. It is a longword containing the maxi-

mum record size to be returned. If the record in the current received

block is longer than the maximum length, this record is split into

recl

size records (maximum = 4096).

lastrec This is a pointer to an integer. It is a longword boolean ﬂag returned

indicating whether the current record is the last record in the ﬁle. A

non-zero value is treated as true. If this ﬂag is true, BSCREAD

received an ETX or EOT indication from the ICP. On input, a value of

–1 signiﬁes that the

rdblock contains the ﬁrst block of unexpected

data, thus preventing BSCREAD from reading prematurely from the

ICP. (See the example on page 82.)

ﬁxed This is a pointer to an integer. It is a longword containing the boolean

ﬂag. If the ﬂag is true, received data records are not deblocked using

record separator characters, but by

recl length only. Fixed takes pre-

cedence over

binary for length.

binary This is a pointer to an integer. It is a longword containing the boolean

ﬂag. If the ﬂag is true (and the ﬁxed ﬂag is false), received data records