IBM Support

Using API QSSP/QEXCLNCI to Clear Up Unused Object Information Repository Entries

Troubleshooting


Problem

Will API QSSP/QEXCLNCI clear up unused Object Information Repository (OIR) entries? The size of a library will grow as objects are added to the library. This space is internal to the structure of the library and may cause issues.

Resolving The Problem

Will API QSSP/QEXCLNCI clear up unused Object Information Repository (OIR) entries? The size of a library will grow as objects are added to the library. This space is internal to the structure of the library and may cause issues. What are these issues?

The size of a library will grow as objects are added. This space is internal to the structure of the library. Every library has an Object Information Repository (OIR). The OIR is where information is kept about objects contained in the library. When an object is deleted, the OIR entry for that object is not removed. The OIR entry is replaced if the object is subsequently re-created with the same name in the same library. Otherwise, the OIR entry persists. If enough of these unused OIR entries accumulate for a library, users may be prevented from adding new objects to the library. There is an API (QSSP/QEXCLNCI) that cleans up the entries so they can be reused. The cleanup, however, does not free up unused space. This can be done only using the Reclaim Storage (RCLSTG) command or by doing the following:
1. Save the library to a *SAVF.
2. Delete the library.
3. Restore the library from the *SAVF in Step 1.
The Display Object Description (DSPOBJD) command used on a library displays the size of the library plus its OIR. The Display Object Description (DSPOBJD) command does not show the actual size of all objects that are stored in the library. The Display Library (DSPLIB) command with output sent to a spool file (for example, DSPLIB OUTPUT(*PRINT)), provides the sum total of all space associated with the library in addition to objects stored within the library.

[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CHjAAM","label":"Job and Work Management"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]

Historical Number

23401851

Document Information

Modified date:
28 March 2025

UID

nas8N1017353