Library /sys$common/syshlp/helplib.hlb  —  CONVERT  /RECLAIM
    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
Close Help