Invokes the Convert/Reclaim utility (CONVERT/RECLAIM) to make empty buckets in Prolog 3 indexed files available so that new records can be written in them. If all the records in a bucket have been deleted, that bucket is locked until the Convert /Reclaim utility makes it available. Unlike the CONVERT utility, the Convert/Reclaim utility maintains record file addresses (RFAs). The /RECLAIM qualifier is required. For a complete description of the Convert/Reclaim utility, including more inform- ation about the CONVERT/RECLAIM command and its qualifier, see the OpenVMS Record Management Utilities Reference Manual. Format CONVERT/RECLAIM filespec
1 – Parameter
filespec Specifies the Prolog 3 indexed file in which you want to reclaim buckets. When you use the CONVERT/RECLAIM command, the file cannot be opened for shared access.
2 – Usage Summary
Invoke the Convert/Reclaim utility by entering the CONVERT /RECLAIM command at the DCL level. Exit the Convert/Reclaim utility by letting the utility run to successful completion. The Convert/Reclaim utility produces an output file only if you specify the /STATISTICS command qualifier. If you want to execute CONVERT/RECLAIM commands over a network, you need NETMBX privilege.
3 – Qualifiers
3.1 /KEY
The /KEY qualifier lets you reclaim index buckets for specified keys. Format /KEY=key_number[,...] filename If you request statistics and specify the /KEY qualifier, the utility reports the statistics for each key separately. If you do not use the /KEY qualifier, the default is to reclaim all index buckets and to provide a single report.
3.2 /STATISTICS
Determines whether statistics about the completed conversion and reclamation are displayed. If you specify reclamation of index buckets by key, a separate set of statistics is returned for each specified key. Format /STATISTICS /NOSTATISTICS (DEFAULT) The Convert/Reclaim utility provides the following statistics: o Total buckets scanned o Data buckets reclaimed o Index buckets reclaimed o Total buckets reclaimed o Elapsed time o Buffered I/O o Direct I/O o Page faults o CPU time