IBM Support

New API Retrieve Space User Data



A new API called Retrieve Space User Data (QbnRetrieveSpaceUserData) enhances the usability of the compiler preprocessor APIs for IBM i 7.1 and later releases.


You are in: IBM i Technology Updates > General IBM i Operating System > New API Retrieve Space User Data

The preprocessor APIs provide a method to store *USERDATA with module, program, and service program objects at compile time. Previously, *USERDATA could be retrieved only from program and service program objects active on the call stack. The new API provides a means to retrieve *USERDATA from objects that are not active in the call stack. The API is available as a procedure export of the operating system service program QBNPREPR.

ISV tool developers will find this new API useful to access information that can be stored with an object using the existing QbnAddAssociatedSpaceData API. Combining the new API with the existing compiler preprocessor APIs makes it possible to store data with and retrieve data from the object, rather than keeping the data in a separate location. This can be important to satisfy auditing requirements.

The new API is available with PTFs for releases 7.2 and 7.1.  There are also PTFs available with the updated header file (QSYSINC/H.QBNPREPR) containing the procedure prototype.

Documentation for the new API is available in the PTF coverletters, as well as in the IBM i Knowledge Center API topic.

The PTFs with the new API:

  • IBM i 7.2 PTF:  SI57322
  • IBM i 7.1 PTF:  SI57142

The related PTFs with the QSYSINC/H.QBNPREPR header file updates:

  • IBM i 7.2 PTF:  SI57329
  • IBM i 7.1 PTF:  SI57155

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Component":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]

Document Information

Modified date:
09 January 2020