Specifications

Using Callable System Routines
10.5 OpenVMS Record Management Services
Table 10–5 (Cont.) User Control Blocks
Control
(Block)
Macro
(Name) Function
$XABxxx_STORE Moves specified values into a previously specified
and allocated XABxxx.
10.5.4 OpenVMS Record Management Services Utilities
The RMS utilities are as follows:
• Analyze/RMS_File utility (ANALYZE/RMS_FILE)
• Convert and Convert/Reclaim utilities (CONVERT and CONVERT/RECLAIM)
• Create/FDL utility (CREATE/FDL)
• Edit/FDL utility (EDIT/FDL)
You can use these independently of RMS, or in conjunction with RMS, to build
data files and to maintain files.
ANALYZE/RMS_FILE
With ANALYZE/RMS_FILE, you can analyze the internal structure of a RMS file
in the following manner:
• Examine the structure of a file, and interactively check the structure to assess
if it is properly designed for the application
• Generate a statistical report on the file’s structure and use
• Generate an FDL file from a data file
• Generate a summary report on the file’s structure and use
The interactive feature of this utility includes several commands to traverse the
structure of an RMS file and examine specific data buckets and bytes of a record.
This utility can also check the file and generate a report listing any errors found
in the file.
ANALYZE/RMS_FILE commands help you move around the RMS file easily. You
can move the structure pointer to the beginning and end of the file structure, up
and down levels, to the first and last nodes, and to a specific bucket (or record) of
an indexed or relative file.
CONVERT and CONVERT/RECLAIM
CONVERT copies one or more records from a file to another file, while changing
the record format and file organization. CONVERT/RECLAIM reclaims empty
bucket space in the file to allow new records to be written to it.
CONVERT/RECLAIM works only with Prolog 3 indexed files. You should use
CONVERT/RECLAIM when new records no longer need a primary key associated
with the deleted record.
In conjunction with changing record format and file organization, you can use
CONVERT to complete the following functions:
• Reformat indexed files where many records have been inserted and deleted.
New record file addresses are established for the records.
• Create a new output file with the same or different file characteristics.
• Add new records to the end of an existing sequential file.
10–18