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
Top | High-level language APIs | APIs by category