o To use the RMU Analyze Placement command for a database, you
must have the RMU$ANALYZE privilege in the root file ACL for
the database or the OpenVMS SYSPRV or BYPASS privilege.
o When the RMU Analyze Placement command is issued for a closed
database, the command executes without other users being able
to attach to the database.
o The following RMU Analyze Placement command directs
the results into an RMS record definition file called
placement.rrd that is compatible with the data dictionary:
$ RMU/ANALYZE/PLACEMENT/BINARY_OUTPUT=RECORD_DEFINITION=PLACEMENT.RRD -
_$ MF_PERSONNEL
$!
$! Display the placement.rrd file created by the previous command:
$ TYPE PLACEMENT.RRD
DEFINE FIELD RMU$DATE DATATYPE IS DATE.
DEFINE FIELD RMU$INDEX_NAME DATATYPE IS TEXT SIZE IS 32.
DEFINE FIELD RMU$RELATION_NAME DATATYPE IS TEXT SIZE IS 32.
DEFINE FIELD RMU$LEVEL DATATYPE IS SIGNED WORD.
DEFINE FIELD RMU$FLAGS DATATYPE IS SIGNED WORD.
DEFINE FIELD RMU$COUNT DATATYPE IS F_FLOATING.
DEFINE FIELD RMU$DUPLICATE_COUNT DATATYPE IS F_FLOATING.
DEFINE FIELD RMU$KEY_COUNT DATATYPE IS F_FLOATING.
DEFINE FIELD RMU$DUPLICATE_KEY_COUNT DATATYPE IS F_FLOATING.
DEFINE FIELD RMU$DATA_COUNT DATATYPE IS F_FLOATING.
DEFINE FIELD RMU$DUPLICATE_DATA_COUNT DATATYPE IS F_FLOATING.
DEFINE FIELD RMU$TOTAL_KEY_PATH DATATYPE IS F_FLOATING.
DEFINE FIELD RMU$TOTAL_PAGE_PATH DATATYPE IS F_FLOATING.
DEFINE FIELD RMU$TOTAL_BUFFER_PATH DATATYPE IS F_FLOATING.
DEFINE FIELD RMU$MAX_KEY_PATH DATATYPE IS F_FLOATING.
DEFINE FIELD RMU$MAX_PAGE_PATH DATATYPE IS F_FLOATING.
DEFINE FIELD RMU$MIN_BUF_PATH DATATYPE IS F_FLOATING.
DEFINE RECORD RMU$ANALYZE_PLACEMENT.
o The following list describes each of the fields in the
placement.rrd record definition:
- RMU$DATE
Contains the date that the analyze operation was done
- RMU$INDEX_NAME
Contains the name of the index that was analyzed
- RMU$RELATION_NAME
Contains the name of the table for which the index is
defined
- RMU$LEVEL
Contains the maximum number of index levels
- RMU$FLAGS
The six possible values in this field have the following
meanings:
* 0-Index is a sorted and not unique index
* 1-Index is sorted and unique
* 2-Index is hashed and not unique
* 3-Index is hashed and unique
* 4-Index is ranked sorted and not unique
* 5-Index is ranked sorted and unique
The RMU Analyze Placement command uses the RMU$FLAGS bits
shown in RMU$FLAGS Bits Used by the RMU Analyze Placement
Command for describing specific index information.
Table 3 RMU$FLAGS Bits Used by the RMU Analyze Placement Command
Bit Offset Meaning
0 Unique index if true
1 Hashed index if true
2 Ranked sorted index if true
- RMU$COUNT
Contains the number of index nodes
- RMU$DUPLICATE_COUNT
Contains the number of duplicate records
- RMU$KEY_COUNT
Contains the number of keys
- RMU$DUPLICATE_KEY_COUNT
Contains the number of duplicate keys
- RMU$DATA_COUNT
Contains the number of records
- RMU$DUPLICATE_DATA_COUNT
Contains the number of duplicate records
- RMU$TOTAL_KEY_PATH
Contains the total number of keys touched to access all the
records
- RMU$TOTAL_PAGE_PATH
Contains the total number of pages touched to access all
the records
- RMU$TOTAL_BUFFER_PATH
Contains the total number of buffers touched to access all
the records
- RMU$MAX_KEY_PATH
Contains the largest number of keys touched to access any
of the records
- RMU$MAX_PAGE_PATH
Contains the largest number of pages touched to access any
of the records
- RMU$MIN_BUF_PATH
Contains the smallest number of buffers touched to access
any of the records