Set Space Status (QLYSETS) API

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.

Authorities and Locks

None

Required Parameter Group

Status

INPUT; CHAR(10)

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.

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