| 1 | Status | Input | Char(10) |
| 2 | Error code | I/O | Char(*) |
The Set Space Status (QLYSETS) API sets the status of the space.
When QLYSETS is first called to create the space (if the space does not exist already) or to initialize the space so the information can be written to it by compilers or preprocessors, the Status parameter should be set to *READY. Then QLYSETS writes a special record (called the HEADER record) at the beginning of the space and initializes a status flag in that record to *READY. Now the space is ready to accept records containing build information. Compilers write to the space using the QLYWRTBI API. QLYWRTBI writes records to the space concatenated to each other. QLYRDBI later reads them sequentially in the order in which they are written.
Use the QLYSETS API to set the status flag in the space to *COMPLETE after the information in the space is processed using the QLYRDBI API. This indicates that the information in the space has been processed and the space can be reused.
None
The status for the space.
The possible status values are:
| *READY | Initialize the space. If the space does not exist, it is created. |
| *COMPLETE | Information in the space has been processed. The space can now be used by setting it to *READY with another call to QLYSETS. |
The structure in which to return error information. For the format of the structure, see Error code parameter.
| Message ID | Error Message Text |
|---|---|
| LIB9001 | Value specified on the Status parameter is not valid. |
| 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. |
[ Back to top | High-level language APIs | APIs by category ]