Write Build Information (QLYWRTBI) API

Required Parameter Group:

1	Buffer	Input	Char(*)
2	Buffer length	Input	Binary(4)
3	Error code	I/O	Char(*)

Default Public Authority: *USE

Threadsafe: No

The Write Build Information (QLYWRTBI) API writes one or more records to the space.

QLYWRTBI writes records to the space concatenated to each other. QLYRDBI later reads them sequentially in the order in which they are written.

QLYWRTBI continues to write records to the API space concatenated to previous records written, until QLYSETS is called. See Record Types for the records that can be written. See Examples of Records Written for examples of the sequence of records written.

Authorities and Locks

None.

Required Parameter Group

Buffer: INPUT; CHAR(*)
A character string containing one or more records of build information.
Buffer length: INPUT; BINARY(4)
The length of the buffer in bytes. The buffer length must be equal to the sum of the lengths of all the concatenated records being passed, otherwise an error occurs.
Error code: I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.

The first field in each record indicates the record length. This allows all the records to be read sequentially using the QLYRDBI API.

Error Messages

Message ID	Error Message Text
LIB9002	Value specified for the buffer length parameter is not valid.
LIB9003	Value specified for the buffer length parameter is too small.
LIB9004	Record not in correct sequence.
LIB9008	Record has a record type that is not valid.
LIB9009	Build information space does not exist, or it is damaged or deleted.
CPF3CF1 E	Error code parameter not valid.
CPF3C90 E	Literal value cannot be changed.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.

API introduced: V2R2

[ Back to top | High-level language APIs | APIs by category ]