Read Build Information (QLYRDBI) API

The Read Build Information (QLYRDBI) API reads one or more records from the space.

QLYRDBI reads the space starting at the first location after the last record was read. If this is the first time QLYRDBI is called, the first record following the header record is read.

After QLYRDBI has read the final record, the next call to QLYRDBI starts reading the space from the beginning again.

QLYRDBI reads one or more records depending on the value specified on the Read mode parameter. QLYRDBI does not read more records than can fit in the buffer. The buffer is determined by the Maximum-size parameter.

Authorities and Locks

None.

Required Parameter Group

Buffer

OUTPUT; CHAR(*)

A character string to contain one or more records of build information.

Maximum size

INPUT; BINARY(4)

The maximum size of the data that is expected to be returned to this call. Maximum size should be large enough to fit at least one record. If it is too small for one record, an error occurs.

Read mode

INPUT; CHAR(10)

The mode of reading.

The possible read mode values are:

*SINGLE	Read only one record.
*MULTIPLE	Read more than one record. The maximum number of records that are read is determined by the size of Maximum size.

Buffer length

OUTPUT; BINARY(4)

The length of the data returned. If records are not read, 0 is returned.

Number of records

OUTPUT; BINARY(4)

The number of records read. Number of records is 0 if no records were read, 1 if one record was read or greater than 1 if *MULTIPLE was specified on read mode and more than one record could fit in the buffer.

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error Code Parameter.

Error Messages

The LIBxxxx error messages are located in the message file QLIBMSG in the QSYS library.