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 ]