1 – Binary Output
Binary_output=file-option-list
Nobinary_Output
Specifying the Binary_Output qualifier allows you to store
the summary results in a binary file, and to create a record
definition file that is compatible with the data dictionary for
the binary output file. The binary output can be loaded into
an Oracle Rdb database by using the RMU Load command with the
Record_Definition qualifier for use by a user-written management
application or procedure. The binary output can also be used
directly by the user-written application or procedure.
The valid file options are:
o File=file-spec
The File option causes the RMU Analyze Indexes command data to
be stored in an RMS file that contains a fixed-length binary
record for each index analyzed.
The default file extension for the binary output file is .unl.
The following command creates the binary output file analyze_
out.unl:
$ RMU/ANALYZE/INDEXES -
_$ /BINARY_OUTPUT=FILE=ANALYZE_OUT MF_PERSONNEL.RDB
o Record_Definition=file-spec
The Record_Definition option causes the RMU Analyze Indexes
command data record definition to be stored in an RMS file.
The output file contains the record definition in a subset of
the data dictionary command format. The default file extension
for the record definition output file is .rrd. Refer to the
rrd_file_syntax help topic for a description of the .rrd
files. The following command creates the output file analyze_
out.rrd:
$ RMU/ANALYZE/INDEXES -
_$ /BINARY_OUTPUT=RECORD_DEFINITION=ANALYZE_OUT MF_PERSONNEL.RDB
You can specify both file options in one command by separating
them with a comma and enclosing them within parentheses, as
follows:
$ RMU/ANALYZE/INDEXES/BINARY_OUTPUT= -
_$ (FILE=ANALYZE_OUT,RECORD_DEFINITION=ANALYZE_OUT) -
_$ MF_PERSONNEL.RDB
If you specify the Binary_Output qualifier, you must specify
at least one of the options. The default is the Nobinary_Output
qualifier, which does not create an output file.
2 – Exclude
Exclude=Metadata
Excludes information from the RMU Analyze Indexes command output.
When you specify the Exclude=Metadata qualifier, information on
the Oracle Rdb indexes (for example, the RDB$NDX_REL_NAME_NDX and
RDB$COLLATIONS_NDX indexes) is excluded from the RMU Analyze
Indexes command output. When you do not specify the Exclude
qualifier, data is provided for all indexes in the database.
Data is accumulated for the indexes excluded with the Exclude
qualifier, but the data is excluded from the RMU Analyze Indexes
command output.
You cannot specify the Exclude qualifier and one or more index
names in the same RMU Analyze Indexes command.
3 – Option
Option=type
Specifies the type of information and the level of detail the
analysis will include. Three types of output are available:
o Normal
Output includes only summary information. The Normal option is
the default.
o Full
Output includes histograms and summary information. This
option displays a summary line for each sorted index level.
o Debug
Output includes internal information about the data,
histograms, and summary information. Note the following when
using this option to analyze compressed index keys:
- The key lengths are from the compressed index keys.
- The hexadecimal output for the keys is that of the
uncompressed index keys.
- The output includes summary statistics about the compressed
index keys.
In general, use the Debug option for diagnostic support
purposes. You can also use the Debug option to extract data
and perform an independent analysis.
4 – Output
Output=file-name
Specifies the name of the file where output will be sent. The
default is SYS$OUTPUT. The default output file extension is .lis,
if you specify a file name.
5 – Transaction Type
Transaction_Type=option
Allows you to specify the transaction mode for the transactions
used to perform the analyze operation. Valid options are:
o Automatic
o Read_Only
o Noread_Only
You must specify an option if you use this qualifier.
If you do not use any form of this qualifier, the Transaction_
Type=Automatic qualifier is the default. This qualifier specifies
that Oracle RMU is to determine the transaction mode used for the
analyze operation. If any storage area in the database (including
those not accessed for the analyze operation) has snapshots
disabled, the transactions used for the analyze operation are
set to read/write mode. Otherwise, the transactions are set to
read-only mode.
The Transaction_Type=Read_Only qualifier specifies the
transactions used to perform the analyze operation be set to
read-only mode. When you explicitly set the transaction type to
read-only, snapshots need not be enabled for all storage areas
in the database, but must be enabled for those storage areas that
are analyzed. Otherwise, you receive an error and the analyze
operation fails.
You might select this option if not all storage areas have
snapshots enabled and you are analyzing objects that are stored
only in storage areas with snapshots enabled. In this case, using
the Transaction_Type=Read_Only qualifier allows you to perform
the analyze operation and impose minimal locking on other users
of the database.
The Transaction_Type=Noread_Only qualifier specifies that
the transactions used to for the analyze operation be set to
read/write mode. You might select this option if you want to
eradicate the growth of snapshot files that occurs during a read-
only transaction and are willing to incur the cost of increased
locking that occurs during a read/write transaction.