Version 4.2.6 for Mainframes (Update)
 —  Utilities  —

Application Programming Interfaces

This section describes the Application Programming Interfaces (APIs) USR0340N, USR0341N and USR4340N, which are used for handling Natural objects currently loaded in the buffer pool and/or BP cache. The APIs are supplied in the Natural system library SYSEXT.

For further information on these APIs, see the following:

Related Topic:

API Functionality
USR0340N
  • Deletes objects from the buffer pool and/or BP cache.

  • Marks objects as resident.

  • Removes the resident flag from objects.

  • Reads object directory information.

  • Retrieves general buffer pool statistics and buffer pool load/locate statistics.

Corresponding SYSBPM functions:

Delete Objects
List Objects
Directory Information
General Buffer Pool Statistics
Buffer Pool Load/Locate Statistics

USR0341N Collects garbage to clean up the buffer pool by removing objects which are no longer needed.

Selection criteria for specified objects are the relative age of an object. Relative age is the time the object has been loaded in the buffer pool which calculates from BP Last Action date. Minimum age is 30 minutes.

See also the SYSBPM function List Objects.

USR4340N We recommend that you use this interface for batch processing instead of using the SYSBPM utility in batch.

Lists objects loaded in the buffer pool and/or BP cache sorted by Object Size (ObjSize), Total Use Count (TotalUC) or BP Last Action. BP Last Action only applies to the buffer pool.

Corresponding SYSBPM functions:

Display Sorted Extract
List Objects

USR4341N Maintains a blacklist of Natural objects, which are not to be executed and loaded into the buffer pool.

See also the SYSBPM function Blacklist Maintenance.

Top of page