vorax 0.4.2 → 5.0

data/spec/sql/dbms_stats.spc

@@ -1,4097 +0,0 @@
-create or replace package sys.dbms_stats authid current_user is
-
---
--- This package provides a mechanism for users to view and modify
--- optimizer statistics gathered for database objects.
--- The statistics can reside in two different locations:
---  1) in the dictionary
---  2) in a table created in the user's schema for this purpose
--- Only statistics stored in the dictionary itself will have an
--- impact on the cost-based optimizer.
---
--- This package also facilitates the gathering of some statistics
--- in parallel.
---
--- The package is divided into three main sections:
---  1) procedures which set/get individual stats.
---  2) procedures which transfer stats between the dictionary and
---     user stat tables.
---  3) procedures which gather certain classes of optimizer statistics
---     and have improved (or equivalent) performance characteristics as
---     compared to the analyze command.
---
--- Most of the procedures include the three parameters: statown,
--- stattab, and statid.
--- These parameters are provided to allow users to store statistics in
--- their own tables (outside of the dictionary) which will not affect
--- the optimizer.  Users can thereby maintain and experiment with "sets"
--- of statistics without fear of permanently changing good dictionary
--- statistics.  The stattab parameter is used to specify the name of a
--- table in which to hold statistics and is assumed to reside in the same
--- schema as the object for which statistics are collected (unless the
--- statown parameter is specified).  Users may create
--- multiple such tables with different stattab identifiers to hold separate
--- sets of statistics.  Additionally, users can maintain different sets of
--- statistics within a single stattab by making use of the statid
--- parameter (which can help avoid cluttering the user's schema).
---
--- For all of the set/get procedures, if stattab is not provided (i.e., null),
--- the operation will work directly on the dictionary statistics; therefore,
--- users need not create these statistics tables if they only plan to
--- modify the dictionary directly.  However, if stattab is not null,
--- then the set/get operation will work on the specified user statistics
--- table, not the dictionary.
---
--- lock_*_stats/unlock_*_stats procedures: When statistics on a table is
--- locked, all the statistics depending on the table, including table
--- statistics, column statistics, histograms and statistics on all
--- dependent indexes, are considered to be locked.
--- set_*, delete_*, import_*, gather_* procedures that modify statistics
--- in dictionary of an individual table/index/column will raise an error
--- if statistics of the object is locked. Procedures that operates on
--- multiple objects (eg: gather_schema_stats) will skip modifying the
--- statistics of an object if it is locked. Most of the procedures have
--- force argument to override the lock.
---
--- Whenever statistics in dictionary are modified, old versions of statistics
--- are saved automatically for future restoring. Statistics can be restored
--- using RESTORE procedures. These procedures use a time stamp as an argument
--- and restore statistics as of that time stamp.
--- There are dictionary views that display the time of statistics
--- modifications. These views are useful in determining the time stamp to
--- be used for statistics restoration.
---
---     Catalog view DBA_OPTSTAT_OPERATIONS contain history of
---     statistics operations performed at schema and database level
---     using DBMS_STATS.
---
---     The views *_TAB_STATS_HISTORY views (ALL, DBA, or USER) contain
---     history of table statistics modifications.
---
--- The old statistics are purged automatically at regular intervals based on
--- the statistics history retention setting and the time of the recent
--- analyze of the system. Retention is configurable using the
--- ALTER_STATS_HISTORY_RETENTION procedure. The default value is 31 days,
--- which means that you would be able to restore the optimizer statistics to
--- any time in last 31 days.
--- Automatic purging is enabled when STATISTICS_LEVEL parameter is set
--- to TYPICAL or ALL. If automatic purging is disabled, the old versions
--- of statistics need to be purged manually using the PURGE_STATS procedure.
---
--- Other related functions:
---   GET_STATS_HISTORY_RETENTION: This function can be used to get the
---     current statistics history retention value.
---   GET_STATS_HISTORY_AVAILABILITY: This function gets the oldest time stamp
---     where statistics history is available. Users cannot restore statistics
---     to a time stamp older than the oldest time stamp.
---
---
--- When a dbms_stats subprogram modifies or deletes the statistics
--- for an object, all the dependent cursors are invalidated by
--- default and corresponding statements are subject to recompilation
--- next time so that new statistics have immediate effects.  This
--- behavior can be altered with the no_invalidate argument when
--- applicable.
---
--- Extended Statistics: This package allows you to collect statistics for
--- column groups and expressions (known as "statistics extensions"). The
--- statistics collected for column groups and expressions are called
--- "extended statistics". Statistics on Column groups are used by optimizer for
--- accounting correlation between columns. For example, if query has predicates
--- c1=1 and c2=1 and if there are statistics on (c1, c2), optimizer will use
--- this statistics for estimating the combined selectivity of the predicates.
--- The expression statistics are used by optimizer for estimating selectivity
--- of predicates on those expressions. The extended statistics are similar to
--- column statistics and the procedures that take columns names will accept
--- extension names in place of column names.
---
--- The following procedures can be used for managing extensions.
---      create_extended_stats    - create extensions manually or based on
---                                 groups of columns seen in workload.
---      drop_extended_stats      - drop an extension
---      show_extended_stats_name - show name of an extension
---
---      seed_col_usage           - record usage of column (group)s in a
---                                 workload
---      reset_col_usage          - delete recorded column (group)s usage
---                                 information
---      report_col_usage         - generate a report of column group(s)
---                                 usage.
---
--- Comparing statistics:
---
--- diff_table_stats_* functions can be used to compare statistics for a table
--- from two different sources. The statistics can be from
---
---   - two different user statistics tables
---   - a single user statistics table containing two sets of
---     statistics that can be identified using statid's
---   - a user statistics table and dictionary
---   - history
---   - pending statistics
-
--- The functions also compares the statistics of the dependent objects
--- (indexes, columns, partitions).
--- They displays statistics of the object(s) from both sources if the
--- difference between those statistics exceeds a certain threshold (%).
--- The threshold can be specified as an argument to the function, with
--- a default of 10%.
--- The statistics corresponding to the first source (stattab1 or time1)
--- will be used as basis for computing the diff percentage.
---
--- Pending Statistics:
---
--- Optimizer statistics are gathered and saved in a pending state for tables
--- that have FALSE value for the PUBLISH preference (see set_*_prefs()).
--- The default value of the PUBLISH preference is TRUE.
--- Pending statistics can be published, exported, or deleted.
--- See the section corresponding to each of these procedures for details.
---
--- Pending statistics are not used by the Query Optimizer unless parameter
--- optimizer_use_pending_statistics is set to TRUE (system or session level).
--- The default value of this parameter is FALSE.
--- Pending statistics provide a mechanism to verify the impact of the new
--- statistics on query plans before making them available for general use.
---
--- There are two scenarios to verify the query plans:
--- 1. export the pending statistics (use export_pending_stats) to a test
---    system, then run the query workload and check the performance or plans.
--- 2. set optimizer_use_pending_statistics to TRUE in a session on the system
---    where pending statistics have been gathered, run the workload, and
---    check the performance or plans.
---
--- Once the performance or query plans have been verified, the pending
--- statistics can be published (run publish_pending_stats) if the performance
--- are acceptable or delete (run delete_pending_stats) if not.
---
--- Related procedures:
---   publish_pending_stats
---   export_pending_stats
---   delete_pending_stats
---
---
--- Nearly all the procedures in this package (more specifically, the
--- set_*, delete_*, export_*, import_*, gather_*, and *_stat_table
--- procedures) commit the current transaction, perform the operation,
--- and then commit again.
---
-
--- types for minimum/maximum values and histogram endpoints
-type numarray is varray(256) of number;
-type datearray is varray(256) of date;
-type chararray is varray(256) of varchar2(4000);
-type rawarray is varray(256) of raw(2000);
-type fltarray is varray(256) of binary_float;
-type dblarray is varray(256) of binary_double;
-
-type StatRec is record (
-  epc    number,
-  minval raw(2000),
-  maxval raw(2000),
-  bkvals numarray,
-  novals numarray,
-  chvals chararray,
-  eavs   number);
-
--- type for objects whose statistics may be gathered
--- make sure to maintain satisfy_obj_filter when ObjectElem type
--- is changed
-type ObjectElem is record (
-  ownname     varchar2(32),     -- owner
-  objtype     varchar2(6),      -- 'TABLE' or 'INDEX'
-  objname     varchar2(32),     -- table/index
-  partname    varchar2(32),     -- partition
-  subpartname varchar2(32)      -- subpartition
-);
-type ObjectTab is table of ObjectElem;
-
-
--- type for displaying stats difference report
-type DiffRepElem is record (
-  report     clob,              -- stats difference report
-  maxdiffpct number);           -- max stats difference (percentage)
-type DiffRepTab is table of DiffRepElem;
-
--- type for gather_table_stats context -- internal only
-type CContext is varray(10) of varchar2(100);
-
--- oracle decides whether to collect stats for indexes or not
-AUTO_CASCADE CONSTANT BOOLEAN := null;
-
--- oracle decides when to invalidate dependend cursors
-AUTO_INVALIDATE CONSTANT BOOLEAN := null;
-
--- constant used to indicate auto sample size algorithms should
--- be used.
-AUTO_SAMPLE_SIZE        CONSTANT NUMBER := 0;
-
--- constant to indicate use of the system default degree of
--- parallelism determined based on the initialization parameters.
-DEFAULT_DEGREE          CONSTANT NUMBER := 32767;
--- force serial execution if the object is relatively small.
--- use the system default degree of parallelism otherwise.
-AUTO_DEGREE             CONSTANT NUMBER := 32768;
-
---
--- Default values for key parameters passed to dbms_stats procedures
--- These values are specified in the DEFAULT clause when declaring the
--- corresponding parameter in any of the dbms_stats procedures.
---
-DEFAULT_CASCADE          CONSTANT BOOLEAN  := null;
-DEFAULT_DEGREE_VALUE     CONSTANT NUMBER   := 32766;
-DEFAULT_ESTIMATE_PERCENT CONSTANT NUMBER   := 101;
-DEFAULT_METHOD_OPT       CONSTANT VARCHAR2(1) := 'Z';
-DEFAULT_NO_INVALIDATE    CONSTANT BOOLEAN     := null;
-DEFAULT_GRANULARITY      CONSTANT VARCHAR2(1) := 'Z';
-DEFAULT_PUBLISH          CONSTANT BOOLEAN     := true;
-DEFAULT_INCREMENTAL      CONSTANT BOOLEAN     := false;
-DEFAULT_STALE_PERCENT    CONSTANT NUMBER      := 10;
-DEFAULT_AUTOSTATS_TARGET CONSTANT VARCHAR2(1) := 'Z';
-DEFAULT_STAT_CATEGORY    CONSTANT VARCHAR2(20) := 'OBJECT_STATS';
-
--- Constant which is used as an indicator that purge_stats should
--- purge everything (i.e., truncate) in stats history tables.
-PURGE_ALL CONSTANT TIMESTAMP WITH TIME ZONE :=
- TO_TIMESTAMP_TZ('1001-01-0101:00:00-00:00','YYYY-MM-DDHH:MI:SSTZH:TZM');
-
---
--- This set of procedures enable the storage and retrieval of
--- individual column-, index-, table- and system-  related statistics
---
--- The procedures are:
---
---  prepare_column_values*
---
---  set_column_stats
---  set_index_stats
---  set_table_stats
---  set_system_stats
---
---  convert_raw_value*
---
---  get_column_stats
---  get_index_stats
---  get_table_stats
---  get_system_stats
---
---  delete_column_stats
---  delete_index_stats
---  delete_table_stats
---  delete_schema_stats
---  delete_database_stats
---  delete_system_stats
---  delete_fixed_objects_stats
---  delete_dictionary_stats
---
-
-
-  procedure prepare_column_values(
-        srec in out StatRec, charvals chararray);
-  pragma restrict_references(prepare_column_values, WNDS, RNDS, WNPS, RNPS);
-  procedure prepare_column_values(
-        srec in out StatRec, datevals datearray);
-  pragma restrict_references(prepare_column_values, WNDS, RNDS, WNPS, RNPS);
-  procedure prepare_column_values(
-        srec in out StatRec, numvals numarray);
-  pragma restrict_references(prepare_column_values, WNDS, RNDS, WNPS, RNPS);
-  procedure prepare_column_values(
-        srec in out StatRec, fltvals fltarray);
-  pragma restrict_references(prepare_column_values, WNDS, RNDS, WNPS, RNPS);
-  procedure prepare_column_values(
-        srec in out StatRec, dblvals dblarray);
-  pragma restrict_references(prepare_column_values, WNDS, RNDS, WNPS, RNPS);
-  procedure prepare_column_values(
-        srec in out StatRec, rawvals rawarray);
-  pragma restrict_references(prepare_column_values, WNDS, RNDS, WNPS, RNPS);
-  procedure prepare_column_values_nvarchar(
-        srec in out StatRec, nvmin nvarchar2, nvmax nvarchar2);
-  pragma restrict_references(prepare_column_values, WNDS, RNDS, WNPS, RNPS);
-  procedure prepare_column_values_rowid(
-        srec in out StatRec, rwmin rowid, rwmax rowid);
-  pragma restrict_references(prepare_column_values, WNDS, RNDS, WNPS, RNPS);
---
--- Convert user-specified minimum, maximum, and histogram endpoint
--- datatype-specific values into Oracle's internal representation
--- for future storage via set_column_stats.
---
--- Generic input arguments:
---   srec.epc - The number of values specified in charvals, datevals,
---      numvals, or rawvals.  This value must be between 2 and 256 inclusive.
---      Should be set to 2 for procedures which don't allow histogram
---      information (nvarchar and rowid).
---      The first corresponding array entry should hold the minimum
---      value for the column and the last entry should hold the maximum.
---      If there are more than two entries, then all the others hold the
---      remaining height-balanced or frequency histogram endpoint values
---      (with in-between values ordered from next-smallest to next-largest).
---      This value may be adjusted to account for compression, so the
---      returned value should be left as is for a call to set_column_stats.
---   srec.bkvals - If a frequency distribution is desired, this array contains
---      the number of occurrences of each distinct value specified in
---      charvals, datevals, numvals, or rawvals.  Otherwise, it is merely an
---      output argument and must be set to null when this procedure is
---      called.
---
--- Datatype specific input arguments (one of these):
---   charvals - The array of values when the column type is character-based.
---      Up to the first 32 bytes of each string should be provided.
---      Arrays must have between 2 and 256 entries, inclusive.
---      If the datatype is fixed char, the strings must be space padded
---      to 15 characters for correct normalization.
---   datevals - The array of values when the column type is date-based.
---   numvals - The array of values when the column type is numeric-based.
---   rawvals - The array of values when the column type is raw.
---      Up to the first 32 bytes of each strings should be provided.
---   nvmin,nvmax - The minimum and maximum values when the column type
---      is national character set based (NLS).  No histogram information
---      can be provided for a column of this type.
---      If the datatype is fixed char, the strings must be space padded
---      to 15 characters for correct normalization.
---   rwmin,rwmax - The minimum and maximum values when the column type
---      is rowid.  No histogram information can be provided for a column
---      of this type.
---
--- Output arguments:
---   srec.minval - Internal representation of the minimum which is
---      suitable for use in a call to set_column_stats.
---   srec.maxval - Internal representation of the maximum which is
---      suitable for use in a call to set_column_stats.
---   srec.bkvals - array suitable for use in a call to set_column_stats.
---   srec.novals - array suitable for use in a call to set_column_stats.
---
--- Exceptions:
---   ORA-20001: Invalid or inconsistent input values
---
-
-  procedure set_param(
-    pname in varchar2,
-    pval  in varchar2);
---
---  WARNING ** WARNING ---> obsoleted <--- WARNING  ** WARNING
---     Please use SET_GLOBAL_PREFS() instead.
---  WARNING ** WARNING ---> obsoleted <--- WARNING  ** WARNING
---
--- This procedure can be used to set default value for parameters
--- of dbms_stats procedures.
---
--- The function get_param can be used to get the current
--- default value of a parameter.
---
--- To run this procedure, you must have the SYSDBA OR
--- both ANALYZE ANY DICTIONARY and ANALYZE ANY system privilege.
---
--- Input arguments:
---   pname   - parameter name
---             The default value for following parameters can be set.
---                CASCADE - The default value for CASCADE set by set_param
---                          is not used by export/import procedures.
---                          It is used only by gather procedures.
---                DEGREE
---                ESTIMATE_PERCENT
---                METHOD_OPT
---                NO_INVALIDATE
---                GRANULARITY
---                AUTOSTATS_TARGET
-                        -- This parameter is applicable only for auto stats
---                         collection. The value of this parameter controls
---                         the objects considered for stats collection
---                         It takes the following values
---                         'ALL'    -- statistics collected
---                                     for all objects in system
---                         'ORACLE' -- statistics collected
---                                     for all oracle owned objects
---                         'AUTO'   -- oracle decide which objects
---                                     to collect stats
---   pval    - parameter value.
---             if null is specified, it will set the oracle default value
---
--- Notes:
---   Both arguments are of type varchar2 and values are enclosed in quotes,
---   even when they represent numbers
---
--- Examples:
---        dbms_stats.set_param('CASCADE','DBMS_STATS.AUTO_CASCADE');
---        dbms_stats.set_param('ESTIMATE_PERCENT','5');
---        dbms_stats.set_param('DEGREE','NULL');
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Invalid or Illegal input values
---
-
-  function get_param(
-    pname   in varchar2)
-  return varchar2;
---
---  WARNING ** WARNING ---> obsoleted <--- WARNING  ** WARNING
---     Please use GET_PREFS() instead.
---  WARNING ** WARNING ---> obsoleted <--- WARNING  ** WARNING
---
--- Get default value of parameters of dbms_stats procedures
---
--- Input arguments:
---   pname   - parameter name
---
--- Exceptions:
---   ORA-20001: Invalid input values
---
-
-  procedure reset_param_defaults;
---
---  WARNING ** WARNING ---> obsoleted <--- WARNING  ** WARNING
---     Please use RESET_GLOBAL_PREF_DEFAULTS() instead.
---  WARNING ** WARNING ---> obsoleted <--- WARNING  ** WARNING
---
--- This procedure resets the default of parameters to ORACLE
--- recommended values.
---
-
-  procedure reset_global_pref_defaults;
---
--- This procedure resets the global preference to the default values
---
-
-  procedure set_global_prefs(
-    pname   varchar2,
-    pvalue  varchar2);
---
--- This procedure is used to set the global statistics preferences.
--- This setting is honored only of there is no preference specified
--- for the table to be analyzed.
---
--- To run this procedure, you need to have the SYSDBA OR
--- both ANALYZE ANY DICTIONARY and ANALYZE ANY system privilege.
---
--- Input arguments:
---   pname   - preference name
---             The default value for following preferences can be set.
---                CASCADE
---                DEGREE
---                ESTIMATE_PERCENT
---                METHOD_OPT
---                NO_INVALIDATE
---                GRANULARITY
---                PUBLISH
---                INCREMENTAL
---                STALE_PERCENT
---                AUTOSTATS_TARGET
---                CONCURRENT
---
---   pvalue  - preference value.
---             if null is specified, it will set the oracle default value.
---
---
---  CASCADE: Please see CASCADE in gather_table_stats
---
---  DEGREE: Please see DEGREE in gather_table_stats
---
---  ESTIMATE_PERCENT: Please see ESTIMATE_PERCENT in gather_table_stats
---
---  METHOD_OPT: Please see METHOD_OPT in gather_table_stats
---
---  NO_INVALIDATE: Please see NO_INVALIDATE in gather_table_stats
---
---  GRANULARITY: Please see GRANULARITY in gather_table_stats
---
---  PUBLISH: The "PUBLISH" value determines whether or not newly gathered
---    statistics will be published once the gather job has completed.
---    Prior to 11g, once a statistic gathering job completed, the new
---    statistics were automatically published into the dictionary tables.
---    The user now has the ability to gather statistics but not publish
---    them immediately. This allows the DBA to test the new statistics
---    before publishing them.
---
---  INCREMENTAL: The "INCREMENTAL" value determines whether or not the global
---    statistics of a partitioned table will be maintained without doing a
---    full table scan. With partitioned tables it is very common to load new
---    data into a new partition. As new partitions are added and data loaded,
---    the global table statistics need to be kept up to date.  Oracle will
---    update the global table statistics by scanning only the partitions that
---    have been changed instead of the entire table if the following conditions
---    hold: (1) the INCREMENTAL value for the partitioned table is set to TRUE;
---    (2) the PUBLISH value for the partitioned table is set to TRUE; and
---    (3) the user specifies AUTO_SAMPLE_SIZE for estimate_percent and AUTO for
---    granularity when gathering statistics on the table.
---    If the INCREMENTAL value for the partitioned table was set to FALSE
---    (default value), then a full table scan would be used to maintain the
---    global statistics.
---
---  STALE_PERCENT: The "STALE_PERCENT" value determines the percentage of rows
---    in a table that have to change before the statistics on that table are
---    deemed stale and should be regathered. The default value is 10%.
---
---  AUTOSTATS_TARGET
---    This preference is applicable only for auto stats collection. The value
---    of this parameter controls the objects considered for stats collection.
---    It takes the following values
---    'ALL'    -- statistics collected  for all objects in system
---    'ORACLE' -- statistics collected  for all oracle owned objects
---    'AUTO'   -- oracle decide which objects   to collect stats
---
---  CONCURRENT
---    This preference determines whether the statistics of tables or
---    (sub)partitions of tables to be gathered concurrently when user issues
---    gather_*_stats procedures. DBMS_STATS has the ability to collect
---    statistics for a single object (table, (sub)partition) in parallel
---    based on the value of degree parameter. However the parallelism is
---    limited to one object. CONCURRENT preference extends the scope of
---    "parallelization" to multiple database objects by enabling users to
---    concurrently gather statistics for multiple tables in a schema/database
---    and multiple (sub)partitions within a table. Note that this is primarily
---    intented for multi cpu systems and it may not be suitable for small
---    databases on single cpu machines.
-
---    To gather statistics concurrently, the user must have DBA role or have
---    the following privileges in addition to privileges that are required for
---    gathering statistics.
---      CREATE JOB, MANAGE SCHEDULER, MANAGE ANY QUEUE
---
---    The preference takes the following values.
---    'TRUE'  - Gather statistics concurrently
---    'FALSE' - Gather statistics in non concurrent fasion. This is the
---              default.
---
--- Notes:
---   Both arguments are of type varchar2 and values are enclosed in quotes,
---   even when they represent numbers
---
--- Examples:
---        dbms_stats.set_global_prefs('ESTIMATE_PERCENT','9');
---        dbms_stats.set_global_prefs('DEGREE','99');
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Invalid or Illegal input values
---
-
-  function get_prefs(
-    pname   in varchar2,
-    ownname in varchar2 default null,
-    tabname in varchar2 default null)
-  return varchar2;
---
---
--- Get default value of the specified preference.
--- If the ownname and tabname are provided and a preference has been entered
--- for the table then it returns the preference as specified for the table.
--- In all other cases it returns the global preference, in case it has been
--- specified, otherwise the default value is returned.
---
--- Input arguments:
---   pname   - preference name
---             The default value for following preferences can be retrieved.
---                CASCADE
---                DEGREE
---                ESTIMATE_PERCENT
---                METHOD_OPT
---                NO_INVALIDATE
---                GRANULARITY
---                PUBLISH
---                INCREMENTAL
---                STALE_PERCENT
---                AUTOSTATS_TARGET
---   ownname - owner name
---   tabname - table name
---
---
--- Exceptions:
---   ORA-20001: Invalid input values
---
-
-  procedure set_table_prefs(
-    ownname varchar2,
-    tabname varchar2,
-    pname   varchar2,
-    pvalue  varchar2);
---
--- This procedure is used to set the statistics preferences of the
--- specified table in the specified schema.
---
--- To run this procedure, you need to connect as owner of the table
--- or be granted ANALYZE ANY system privilege.
---
--- Input arguments:
---   ownname - owner name
---   tabname - table name
---   pname   - preference name
---             The default value for following preferences can be set.
---                CASCADE
---                DEGREE
---                ESTIMATE_PERCENT
---                METHOD_OPT
---                NO_INVALIDATE
---                GRANULARITY
---                PUBLISH
---                INCREMENTAL
---                STALE_PERCENT
---   pvalue  - preference value.
---             if null is specified, it will set the oracle default value.
---
--- Notes:
---   All arguments are of type varchar2 and values are enclosed in quotes,
---   even when they represent numbers
---
--- Examples:
---        dbms_stats.set_table_prefs('SH', 'SALES', 'CASCADE',
---                                   'DBMS_STATS.AUTO_CASCADE');
---        dbms_stats.set_table_prefs('SH', 'SALES', 'ESTIMATE_PERCENT','9');
---        dbms_stats.set_table_prefs('SH', 'SALES', 'DEGREE','99');
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Invalid or Illegal input values
---
-
-  procedure delete_table_prefs(
-    ownname varchar2,
-    tabname varchar2,
-    pname   varchar2);
---
--- This procedure is used to delete the statistics preferences of the
--- specified table in the specified schema.
---
--- To run this procedure, you need to connect as owner of the table
--- or be granted ANALYZE ANY system privilege.
---
--- Input arguments:
---   ownname - owner name
---   tabname - table name
---   pname   - preference name
---             The default value for following preferences can be deleted.
---                CASCADE
---                DEGREE
---                ESTIMATE_PERCENT
---                METHOD_OPT
---                NO_INVALIDATE
---                GRANULARITY
---                PUBLISH
---                INCREMENTAL
---                STALE_PERCENT
---
--- Notes:
---   All arguments are of type varchar2 and values are enclosed in quotes.
---
--- Examples:
---        dbms_stats.delete_table_prefs('SH', 'SALES', 'CASCADE');
---        dbms_stats.delete_table_prefs('SH', 'SALES', 'DEGREE');
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Invalid or Illegal input values
---
-
-
-  procedure export_table_prefs(
-    ownname varchar2,
-    tabname varchar2,
-    stattab varchar2,
-    statid  varchar2 default null,
-    statown varchar2 default null);
---
--- This procedure is used to export the statistics preferences of the
--- specified table in the specified schema into the specified statistics
--- table.
---
--- To run this procedure, you need to connect as owner of the table
--- or be granted ANALYZE ANY system privilege.
---
--- Input arguments:
---   ownname - owner name
---   tabname - table name
---   stattab - statistics table name where to export the statistics
---   statid  - (optional) identifier to associate with these statistics
---             within stattab.
---   statown - The schema containing stattab (if different then ownname)
---
--- Notes:
---   All arguments are of type varchar2 and values are enclosed in quotes.
---
--- Examples:
---        dbms_stats.export_table_prefs('SH', 'SALES', 'MY_STAT_TAB');
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---
-
-
-  procedure import_table_prefs(
-    ownname varchar2,
-    tabname varchar2,
-    stattab varchar2,
-    statid  varchar2 default null,
-    statown varchar2 default null);
---
--- This procedure is used to set the statistics preferences of the
--- specified table in the specified schema.
---
--- To run this procedure, you need to connect as owner of the table
--- or be granted ANALYZE ANY system privilege.
---
--- Input arguments:
---   ownname - owner name
---   tabname - table name
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.
---   statid  - (optional) identifier to associate with these statistics
---             within stattab.
---   statown - The schema containing stattab (if different then ownname)
---
--- Notes:
---   All arguments are of type varchar2 and values are enclosed in quotes.
---
--- Examples:
---        dbms_stats.import_table_prefs('SH', 'SALES', 'MY_STAT_TAB');
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20000: Schema "<schema>" does not exist
---
-
-
-  procedure set_schema_prefs(
-    ownname varchar2,
-    pname   varchar2,
-    pvalue  varchar2);
---
--- This procedure is used to set the statistics preferences of all
--- the tables owned by the specified owner name.
---
--- To run this procedure, you need to connect as owner, have the SYSDBA
--- privilege, OR have the ANALYZE ANY system privilege
---
--- Input arguments:
---   ownname - owner name
---   pname   - preference name
---             The default value for following preferences can be set.
---                CASCADE
---                DEGREE
---                ESTIMATE_PERCENT
---                METHOD_OPT
---                NO_INVALIDATE
---                GRANULARITY
---                PUBLISH
---                INCREMENTAL
---                STALE_PERCENT
---   pvalue  - preference value.
---             if null is specified, it will set the oracle default value.
--- Notes:
---   All arguments are of type varchar2 and values are enclosed in quotes,
---   even when they represent numbers
---
--- Examples:
---        dbms_stats.set_schema_prefs('SH', 'CASCADE',
---                                    'DBMS_STATS.AUTO_CASCADE');
---        dbms_stats.set_schema_prefs('SH' 'ESTIMATE_PERCENT','9');
---        dbms_stats.set_schema_prefs('SH', 'DEGREE','99');
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20000: Schema "<schema>" does not exist
---   ORA-20001: Invalid or Illegal input values
---
-
-
-  procedure delete_schema_prefs(
-    ownname varchar2,
-    pname   varchar2);
---
--- This procedure is used to delete the statistics preferences of all
--- the tables owned by the specified owner name.
---
--- To run this procedure, you need to connect as owner, have the SYSDBA
--- privilege, OR have the ANALYZE ANY system privilege
---
--- Input arguments:
---   ownname - owner name
---   pname   - preference name
---             The default value for following preferences can be deleted.
---                CASCADE
---                DEGREE
---                ESTIMATE_PERCENT
---                METHOD_OPT
---                NO_INVALIDATE
---                GRANULARITY
---                PUBLISH
---                INCREMENTAL
---                STALE_PERCENT
---
--- Notes:
---   All arguments are of type varchar2 and values are enclosed in quotes.
---
--- Examples:
---        dbms_stats.delete_schema_prefs('SH', 'CASCADE');
---        dbms_stats.delete_schema_prefs('SH', 'ESTIMATE_PERCENT');
---        dbms_stats.delete_schema_prefs('SH', 'DEGREE');
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20000: Schema "<schema>" does not exist
---   ORA-20001: Invalid or Illegal input values
---
-
-
-  procedure export_schema_prefs(
-    ownname varchar2,
-    stattab varchar2,
-    statid  varchar2 default null,
-    statown varchar2 default null);
---
--- This procedure is used to export the statistics preferences of all
--- the tables owner by the specified owner name.
---
--- To run this procedure, you need to connect as owner, have the SYSDBA
--- privilege, OR have the ANALYZE ANY system privilege
---
--- Input arguments:
---   ownname - owner name
---   stattab - statistics table name where to export the statistics
---   statid  - (optional) identifier to associate with these statistics
---             within stattab.
---   statown - The schema containing stattab (if different then ownname)
---
--- Notes:
---   All arguments are of type varchar2 and values are enclosed in quotes.
---
--- Examples:
---        dbms_stats.export_schema_prefs('SH', 'MY_STAT_TAB');
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20000: Schema "<schema>" does not exist
---
-
-
-  procedure import_schema_prefs(
-    ownname varchar2,
-    stattab varchar2,
-    statid  varchar2 default null,
-    statown varchar2 default null);
---
--- This procedure is used to import the statistics preferences of all
--- the tables owner by the specified owner name.
---
--- To run this procedure, you need to connect as owner, have the SYSDBA
--- privilege, OR have the ANALYZE ANY system privilege
---
--- Input arguments:
---   ownname - owner name
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.
---   statid  - (optional) identifier to associate with these statistics
---             within stattab.
---   statown - The schema containing stattab (if different from ownname)
---
--- Notes:
---   All arguments are of type varchar2 and values are enclosed in quotes.
---
--- Examples:
---        dbms_stats.import_schema_prefs('SH', 'MY_STAT_TAB');
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20000: Schema "<schema>" does not exist
---
-
-
-  procedure set_database_prefs(
-    pname   varchar2,
-    pvalue  varchar2,
-    add_sys boolean default false);
---
--- This procedure is used to set the statistics preferences of all
--- the tables, excluding the tables owned by Oracle. These tables
--- can by included by passing TRUE for the add_sys parameter.
---
--- To run this procedure, you need to have the SYSDBA role OR both
--- ANALYZE ANY DICTIONARY and ANALYZE ANY system privileges.
---
--- Input arguments:
---   pname   - preference name
---             The default value for following preferences can be set.
---                CASCADE
---                DEGREE
---                ESTIMATE_PERCENT
---                METHOD_OPT
---                NO_INVALIDATE
---                GRANULARITY
---                PUBLISH
---                INCREMENTAL
---                STALE_PERCENT
---   pvalue  - preference value.
---             if null is specified, it will set the oracle default value.
---   add_sys - value TRUE will include the Oracle-owned tables
---
--- Notes:
---   All arguments are of type varchar2 and values are enclosed in quotes,
---   even when they represent numbers.
---
--- Examples:
---        dbms_stats.set_database_prefs('CASCADE', 'DBMS_STATS.AUTO_CASCADE');
---        dbms_stats.set_database_prefs('ESTIMATE_PERCENT','9');
---        dbms_stats.set_database_prefs('DEGREE','99');
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Invalid or Illegal input values
---
-
-
-  procedure delete_database_prefs(
-    pname   varchar2,
-    add_sys boolean default false);
---
--- This procedure is used to delete the statistics preferences of
--- all the tables, excluding the tables owned by Oracle. These
--- tables can by included by passing TRUE for the add_sys parameter.
---
--- To run this procedure, you need to have the SYSDBA role OR both
--- ANALYZE ANY DICTIONARY and ANALYZE ANY system privileges.
---
--- Input arguments:
---   pname   - preference name
---             The default value for following preferences can be deleted.
---                CASCADE
---                DEGREE
---                ESTIMATE_PERCENT
---                METHOD_OPT
---                NO_INVALIDATE
---                GRANULARITY
---                PUBLISH
---                INCREMENTAL
---                STALE_PERCENT
---   add_sys - value TRUE will include the Oracle-owned tables
---
--- Notes:
---   All arguments are of type varchar2 and values are enclosed in quotes.
---
--- Examples:
---        dbms_stats.delete_database_prefs('CASCADE', false);
---        dbms_stats.delete_database_prefs('ESTIMATE_PERCENT',true);
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Invalid or Illegal input values
---
-
-
-  procedure export_database_prefs(
-    stattab varchar2,
-    statid  varchar2 default null,
-    statown varchar2 default null,
-    add_sys boolean  default false);
---
--- This procedure is used to export the statistics preferences of
--- all the tables, excluding the tables owned by Oracle. These
--- tables can by included by passing TRUE for the add_sys parameter.
---
--- To run this procedure, you need to have the SYSDBA role OR both
--- ANALYZE ANY DICTIONARY and ANALYZE ANY system privileges.
---
--- Input arguments:
---   stattab - statistics table name where to export the statistics
---   statid  - (optional) identifier to associate with these statistics
---             within stattab.
---   statown - The schema containing stattab (if different then ownname)
---   add_sys - value TRUE will include the Oracle-owned tables
---
--- Examples:
---        dbms_stats.export_database_prefs('MY_STAT_TAB', statown=>'SH');
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---
-
-
-  procedure import_database_prefs(
-    stattab varchar2,
-    statid  varchar2 default null,
-    statown varchar2 default null,
-    add_sys boolean  default false);
---
--- This procedure is used to import the statistics preferences of
--- all the tables, excluding the tables owned by Oracle. These
--- tables can by included by passing TRUE for the add_sys parameter.
---
--- To run this procedure, you need to have the SYSDBA role OR both
--- ANALYZE ANY DICTIONARY and ANALYZE ANY system privileges.
---
--- Input arguments:
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.
---   statid  - (optional) identifier to associate with these statistics
---             within stattab.
---   statown - The schema containing stattab
---   add_sys - value TRUE will include the Oracle-owned tables
--- Examples:
---        dbms_stats.import_database_prefs('MY_STAT_TAB', statown=>'SH');
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---
-
-
--- THE FOLLOWING PROCEDURES ARE FOR INTERNAL USE ONLY.
-  function to_cascade_type(cascade varchar2) return boolean;
-  function to_estimate_percent_type(estimate_percent varchar2) return number;
-  function to_degree_type(degree varchar2) return number;
-  function to_no_invalidate_type(no_invalidate varchar2) return boolean;
-  function to_publish_type(publish varchar2) return boolean;
-  procedure init_package;
--- THE ABOVE PROCEDURES ARE FOR INTERNAL USE ONLY.
-
-
-  procedure publish_pending_stats(
-    ownname varchar2 default USER,
-    tabname varchar2,
-    no_invalidate boolean default
-      to_no_invalidate_type(get_param('NO_INVALIDATE')),
-    force   boolean default FALSE);
---
--- This procedure is used to publish the statistics gathered and stored
--- as pending.
--- If the parameter TABNAME is null then publish applies to all tables
--- of the specified schema.
--- The default owner/schema is the user who runs the procedure.
---
--- To run this procedure, you need to have the privilge to collect stats
--- for the tables that will be touched by this procedure.
---
--- Input arguments:
---   ownname - owner name
---   tabname - table name
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force   - to override the lock (TRUE will override the lock).
---
--- Notes:
---   All arguments are of type varchar2 and values are enclosed in quotes.
---
--- Examples:
---        dbms_stats.publish_pending_stats('SH', null);
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---
-
-  procedure export_pending_stats(
-    ownname varchar2 default USER,
-    tabname varchar2,
-    stattab varchar2,
-    statid  varchar2 default null,
-    statown varchar2 default USER);
---
--- This procedure is used to export the statistics gathered and stored
--- as pending.
---
--- If the parameter TABNAME is null then export applies to all tables
--- of the specified schema.
--- The default owner/schema is the user who runs the procedure.
---
--- To run this procedure, you need to have the SYSDBA role OR both
--- ANALYZE ANY DICTIONARY and ANALYZE ANY system privileges.
---
--- Input arguments:
---   ownname - owner name
---   tabname - table name
---   stattab - statistics table name where to export the statistics
---   statid  - (optional) identifier to associate with these statistics
---             within stattab.
---   statown - The schema containing stattab (if different from ownname)
---
--- Notes:
---   All arguments are of type varchar2 and values are enclosed in quotes.
---
--- Examples:
---        dbms_stats.export_pending_stats(null, null, 'MY_STAT_TAB');
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---
-
-  procedure delete_pending_stats(
-    ownname varchar2 default USER,
-    tabname varchar2 default null);
---
--- This procedure is used to delete the pending statistics that have
--- been gathered but not published yet, i.e, stored as pending.
---
--- If the parameter TABNAME is null then delete applies to all tables
--- of the specified schema.
--- The default owner/schema is the user who runs the procedure.
---
--- To run this procedure, you need to have the SYSDBA role OR both
--- ANALYZE ANY DICTIONARY and ANALYZE ANY system privileges.
---
--- Input arguments:
---   ownname - owner name
---   tabname - table name
---
--- Notes:
---   All arguments are of type varchar2 and values are enclosed in quotes.
---
--- Examples:
---        dbms_stats.delete_pending_stats('SH', 'SALES');
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---
-
-  procedure resume_gather_stats;
---
--- This procedure is used to resume statistics gathering at the point
--- where it was interrupted. Statistics gathering can be interrupted
--- as a result of a user action or a system event.
---
--- To run this procedure, you need to have the SYSDBA role OR both
--- ANALYZE ANY DICTIONARY and ANALYZE ANY system privileges.
---
--- Input arguments:
---   None.
---
--- Examples:
---        dbms_stats.resume_gather_stats();
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---
-
-  procedure set_column_stats(
-        ownname varchar2, tabname varchar2, colname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null, statid varchar2 default null,
-        distcnt number default null, density number default null,
-        nullcnt number default null, srec StatRec default null,
-        avgclen number default null, flags number default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        force boolean default FALSE);
-
-  procedure set_column_stats(
-        ownname varchar2, tabname varchar2, colname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null, statid varchar2 default null,
-        ext_stats raw,
-        stattypown varchar2 default null,
-        stattypname varchar2 default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        force boolean default FALSE);
---
--- Set column-related information
---
--- Input arguments:
---   ownname - The name of the schema
---   tabname - The name of the table to which this column belongs
---   colname - The name of the column or extension
---   partname - The name of the table partition in which to store
---      the statistics.  If the table is partitioned and partname
---      is null, the statistics will be stored at the global table
---      level.
---   stattab - The user stat table identifier describing where
---      to store the statistics.  If stattab is null, the statistics
---      will be stored directly in the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab (Only pertinent if stattab is not NULL).
---   distcnt - The number of distinct values
---   density - The column density.  If this value is null and distcnt is
---      not null, density will be derived from distcnt.
---   nullcnt - The number of nulls
---   srec - StatRec structure filled in by a call to prepare_column_values
---      or get_column_stats.
---   avgclen - The average length for the column (in bytes)
---   flags - For internal Oracle use (should be left as null)
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force - set the values even if statistics of the object is locked
---
--- Input arguments for user-defined statistics:
---   ext_stats - external (user-defined) statistics
---   stattypown - owner of statistics type associated with column
---   stattypname - name of statistics type associated with column
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20001: Invalid or inconsistent input values
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20005: object statistics are locked
---
-
-
-  procedure set_index_stats(
-        ownname varchar2, indname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null, statid varchar2 default null,
-        numrows number default null, numlblks number default null,
-        numdist number default null, avglblk number default null,
-        avgdblk number default null, clstfct number default null,
-        indlevel number default null, flags number default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        guessq number default null,
-        cachedblk number default null,
-        cachehit number default null,
-        force boolean default FALSE);
-
-  procedure set_index_stats(
-        ownname varchar2, indname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null, statid varchar2 default null,
-        ext_stats raw,
-        stattypown varchar2 default null,
-        stattypname varchar2 default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        force boolean default FALSE);
---
--- Set index-related information
--- Input arguments:
---   ownname - The name of the schema
---   indname - The name of the index
---   partname - The name of the index partition in which to store
---      the statistics.  If the index is partitioned and partname
---      is null, the statistics will be stored at the global index
---      level.
---   stattab - The user stat table identifier describing where
---      to store the statistics.  If stattab is null, the statistics
---      will be stored directly in the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab (Only pertinent if stattab is not NULL).
---   numrows - The number of rows in the index (partition)
---   numlblks - The number of leaf blocks in the index (partition)
---   numdist - The number of distinct keys in the index (partition)
---   avglblk - Average integral number of leaf blocks in which each
---      distinct key appears for this index (partition).  If not provided,
---      this value will be derived from numlblks and numdist.
---   avgdblk - Average integral number of data blocks in the table
---      pointed to by a distinct key for this index (partition).
---      If not provided, this value will be derived from clstfct
---      and numdist.
---   clstfct - See clustering_factor column of the all_indexes view
---      for a description.
---   indlevel - The height of the index (partition)
---   flags - For internal Oracle use (should be left as null)
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   guessq - IOT guess quality.  See pct_direct_access column of the
---      all_indexes view for a description.
---   force - set the values even if statistics of the object is locked
---
--- Input arguments for user-defined statistics:
---   ext_stats - external (user-defined) statistics
---   stattypown - owner of statistics type associated with index
---   stattypname - name of statistics type associated with index
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20001: Invalid input value
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20005: object statistics are locked
---
-
-  procedure set_table_stats(
-        ownname varchar2,
-        tabname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null,
-        statid varchar2 default null,
-        numrows number default null,
-        numblks number default null,
-        avgrlen number default null,
-        flags number default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        cachedblk number default null,
-        cachehit number default null,
-        force boolean default FALSE);
---
--- Set table-related information
---
--- Input arguments:
---   ownname - The name of the schema
---   tabname - The name of the table
---   partname - The name of the table partition in which to store
---      the statistics.  If the table is partitioned and partname
---      is null, the statistics will be stored at the global table
---      level.
---   stattab - The user stat table identifier describing where
---      to store the statistics.  If stattab is null, the statistics
---      will be stored directly in the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab (Only pertinent if stattab is not NULL).
---   numrows - Number of rows in the table (partition)
---   numblks - Number of blocks the table (partition) occupies
---   avgrlen - Average row length for the table (partition)
---   flags - For internal Oracle use (should be left as null)
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force - set the values even if statistics of the object is locked
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20001: Invalid input value
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20005: object statistics are locked
---
-
-
-  procedure convert_raw_value(
-        rawval raw, resval out varchar2);
-  pragma restrict_references(convert_raw_value, WNDS, RNDS, WNPS, RNPS);
-  procedure convert_raw_value(
-        rawval raw, resval out date);
-  pragma restrict_references(convert_raw_value, WNDS, RNDS, WNPS, RNPS);
-  procedure convert_raw_value(
-        rawval raw, resval out number);
-  pragma restrict_references(convert_raw_value, WNDS, RNDS, WNPS, RNPS);
-  procedure convert_raw_value(
-        rawval raw, resval out binary_float);
-  pragma restrict_references(convert_raw_value, WNDS, RNDS, WNPS, RNPS);
-  procedure convert_raw_value(
-        rawval raw, resval out binary_double);
-  pragma restrict_references(convert_raw_value, WNDS, RNDS, WNPS, RNPS);
-  procedure convert_raw_value_nvarchar(
-        rawval raw, resval out nvarchar2);
-  pragma restrict_references(convert_raw_value_nvarchar,
-                             WNDS, RNDS, WNPS, RNPS);
-  procedure convert_raw_value_rowid(
-        rawval raw, resval out rowid);
-  pragma restrict_references(convert_raw_value_rowid, WNDS, RNDS, WNPS, RNPS);
---
--- Convert the internal representation of a minimum or maximum value
--- into a datatype-specific value.  The minval and maxval fields
--- of the StatRec structure as filled in by get_column_stats or
--- prepare_column_values are appropriate values for input.
---
--- Input argument
---   rawval - The raw representation of a column minimum or maximum
---
--- Datatype specific output arguments:
---   resval - The converted, type-specific value
---
--- Exceptions:
---   None
---
-
-
-  procedure get_column_stats(
-        ownname varchar2, tabname varchar2, colname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null, statid varchar2 default null,
-        distcnt out number, density out number,
-        nullcnt out number, srec out StatRec,
-        avgclen out number,
-        statown varchar2 default null);
-
-  procedure get_column_stats(
-        ownname varchar2, tabname varchar2, colname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null, statid varchar2 default null,
-        ext_stats out raw,
-        stattypown out varchar2, stattypname out varchar2,
-        statown varchar2 default null);
---
--- Gets all column-related information
---
--- Input arguments:
---   ownname - The name of the schema
---   tabname - The name of the table to which this column belongs
---   colname - The name of the column or extension
---   partname - The name of the table partition from which to get
---      the statistics.  If the table is partitioned and partname
---      is null, the statistics will be retrieved from the global table
---      level.
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.  If stattab is null, the statistics
---      will be retrieved directly from the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab (Only pertinent if stattab is not NULL).
---   statown - The schema containing stattab (if different then ownname)
---
--- Output arguments:
---   distcnt - The number of distinct values
---   density - The column density
---   nullcnt - The number of nulls
---   srec - structure holding internal representation of column minimum,
---      maximum, and histogram values
---   avgclen - The average length of the column (in bytes)
---
--- Output arguments for user-defined column statistics:
---   ext_stats - external (user-defined) statistics
---   stattypown - owner of statistics type associated with column
---   stattypname - name of statistics type associated with column
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges or
---              no statistics have been stored for requested object
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-  procedure get_index_stats(
-        ownname varchar2, indname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null, statid varchar2 default null,
-        numrows out number, numlblks out number,
-        numdist out number, avglblk out number,
-        avgdblk out number, clstfct out number,
-        indlevel out number,
-        statown varchar2 default null,
-        guessq out number,
-        cachedblk out number,
-        cachehit out number);
-
-  procedure get_index_stats(
-        ownname varchar2, indname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null, statid varchar2 default null,
-        numrows out number, numlblks out number,
-        numdist out number, avglblk out number,
-        avgdblk out number, clstfct out number,
-        indlevel out number,
-        statown varchar2 default null,
-        guessq out number);
-
-  procedure get_index_stats(
-        ownname varchar2, indname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null, statid varchar2 default null,
-        numrows out number, numlblks out number,
-        numdist out number, avglblk out number,
-        avgdblk out number, clstfct out number,
-        indlevel out number,
-        statown varchar2 default null);
-
-  procedure get_index_stats(
-        ownname varchar2, indname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null, statid varchar2 default null,
-        ext_stats out raw,
-        stattypown out varchar2, stattypname out varchar2,
-        statown varchar2 default null);
---
--- Gets all index-related information
---
--- Input arguments:
---   ownname - The name of the schema
---   indname - The name of the index
---   partname - The name of the index partition for which to get
---      the statistics.  If the index is partitioned and partname
---      is null, the statistics will be retrieved for the global index
---      level.
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.  If stattab is null, the statistics
---      will be retrieved directly from the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab (Only pertinent if stattab is not NULL).
---   statown - The schema containing stattab (if different then ownname)
---
--- Output arguments:
---   numrows - The number of rows in the index (partition)
---   numlblks - The number of leaf blocks in the index (partition)
---   numdist - The number of distinct keys in the index (partition)
---   avglblk - Average integral number of leaf blocks in which each
---      distinct key appears for this index (partition).
---   avgdblk - Average integral number of data blocks in the table
---      pointed to by a distinct key for this index (partition).
---   clstfct - The clustering factor for the index (partition).
---   indlevel - The height of the index (partition).
---   guessq - IOT guess quality of the index (partition).
---
--- Output arguments for user defined statistics:
---   ext_stats - external (user-defined) statistics
---   stattypown - owner of statistics type associated with index
---   stattypname - name of statistics type associated with index
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges or
---              no statistics have been stored for requested object
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-  procedure get_table_stats(
-        ownname varchar2, tabname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null, statid varchar2 default null,
-        numrows out number, numblks out number,
-        avgrlen out number,
-        statown varchar2 default null);
-
-  procedure get_table_stats(
-        ownname varchar2,
-        tabname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null,
-        statid varchar2 default null,
-        numrows out number,
-        numblks out number,
-        avgrlen out number,
-        statown varchar2 default null,
-        cachedblk out number,
-        cachehit out number);
---
--- Gets all table-related information
---
--- Input arguments:
---   ownname - The name of the schema
---   tabname - The name of the table to which this column belongs
---   partname - The name of the table partition from which to get
---      the statistics.  If the table is partitioned and partname
---      is null, the statistics will be retrieved from the global table
---      level.
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.  If stattab is null, the statistics
---      will be retrieved directly from the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab (Only pertinent if stattab is not NULL).
---   statown - The schema containing stattab (if different then ownname)
---
--- Output arguments:
---   numrows - Number of rows in the table (partition)
---   numblks - Number of blocks the table (partition) occupies
---   avgrlen - Average row length for the table (partition)
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges or
---              no statistics have been stored for requested object
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-
-  procedure delete_column_stats(
-        ownname varchar2, tabname varchar2, colname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null, statid varchar2 default null,
-        cascade_parts boolean default true,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        force boolean default FALSE,
-        col_stat_type varchar2 default 'ALL');
---
--- Deletes column-related statistics
---
--- Input arguments:
---   ownname - The name of the schema
---   tabname - The name of the table to which this column belongs
---   colname - The name of the column or extension
---   partname - The name of the table partition for which to delete
---      the statistics.  If the table is partitioned and partname
---      is null, global column statistics will be deleted.
---   stattab - The user stat table identifier describing from where
---      to delete the statistics.  If stattab is null, the statistics
---      will be deleted directly from the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab (Only pertinent if stattab is not NULL).
---   cascade_parts - If the table is partitioned and partname is null,
---      setting this to true will cause the deletion of statistics for
---      this column for all underlying partitions as well.
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force - delete statistics even if it is locked
---   col_stat_type - Type of column statitistics to be deleted.
---                   This argument takes the following values:
---                   'HISTOGRAM' - delete column histogram only
---                   'ALL' - delete base column stats and histogram
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20005: object statistics are locked
---
-
-
-  procedure delete_index_stats(
-        ownname varchar2, indname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null, statid varchar2 default null,
-        cascade_parts boolean default true,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        stattype varchar2 default 'ALL',
-        force boolean default FALSE);
---
--- Deletes index-related statistics
---
--- Input arguments:
---   ownname - The name of the schema
---   indname - The name of the index
---   partname - The name of the index partition for which to delete
---      the statistics.  If the index is partitioned and partname
---      is null, index statistics will be deleted at the global level.
---   stattab - The user stat table identifier describing from where
---      to delete the statistics.  If stattab is null, the statistics
---      will be deleted directly from the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab (Only pertinent if stattab is not NULL).
---   cascade_parts - If the index is partitioned and partname is null,
---      setting this to true will cause the deletion of statistics for
---      this index for all underlying partitions as well.
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force - delete the statistics even if it is locked
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20005: object statistics are locked
---
-
-
-  procedure delete_table_stats(
-        ownname varchar2, tabname varchar2,
-        partname varchar2 default null,
-        stattab varchar2 default null, statid varchar2 default null,
-        cascade_parts boolean default true,
-        cascade_columns boolean default true,
-        cascade_indexes boolean default true,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        stattype varchar2 default 'ALL',
-        force boolean default FALSE);
---
--- Deletes table-related statistics
---
--- Input arguments:
---   ownname - The name of the schema
---   tabname - The name of the table to which this column belongs
---   partname - The name of the table partition from which to get
---      the statistics.  If the table is partitioned and partname
---      is null, the statistics will be retrieved from the global table
---      level.
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.  If stattab is null, the statistics
---      will be retrieved directly from the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab (Only pertinent if stattab is not NULL).
---   cascade_parts - If the table is partitioned and partname is null,
---      setting this to true will cause the deletion of statistics for
---      this table for all underlying partitions as well.
---   cascade_columns - Indicates that delete_column_stats should be
---      called for all underlying columns (passing the cascade_parts
---      parameter).
---   cascade_indexes - Indicates that delete_index_stats should be
---      called for all underlying indexes (passing the cascade_parts
---      parameter).
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force - delete the statistics even if it is locked
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20005: object statistics are locked
---
-
-
-  procedure delete_schema_stats(
-        ownname varchar2,
-        stattab varchar2 default null, statid varchar2 default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        stattype varchar2 default 'ALL',
-        force boolean default FALSE);
---
--- Deletes statistics for a schema
---
--- Input arguments:
---   ownname - The name of the schema
---   stattab - The user stat table identifier describing from where
---      to delete the statistics.  If stattab is null, the statistics
---      will be deleted directly in the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab (Only pertinent if stattab is not NULL).
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   stattype - The type of statistics to be deleted
---     ALL   - both data and cache statistics will be deleted
---     CACHE - only cache statistics will be deleted
---   force - Ignores the statistics lock on objects and delete
---           the statistics if set to TRUE.
---
---
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-  procedure delete_database_stats(
-        stattab varchar2 default null, statid varchar2 default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        stattype varchar2 default 'ALL',
-        force boolean default FALSE);
---
--- Deletes statistics for an entire database
---
--- Input arguments:
---   stattab - The user stat table identifier describing from where
---      to delete the statistics.  If stattab is null, the statistics
---      will be deleted directly in the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab (Only pertinent if stattab is not NULL).
---   statown - The schema containing stattab.
---      If stattab is not null and statown is null, it is assumed that
---      every schema in the database contains a user statistics table
---      with the name stattab.
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   stattype - The type of statistics to be deleted
---     ALL   - both data and cache statistics will be deleted
---     CACHE - only cache statistics will be deleted
---   force - Ignores the statistics lock on objects and delete
---           the statistics if set to TRUE.
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-
-
-
-
---
--- This set of procedures enable the transferrance of statistics
--- from the dictionary to a user stat table (export_*) and from a user
--- stat table to the dictionary (import_*).
---
--- The procedures are:
---
---  create_stat_table
---  drop_stat_table
---  upgrade_stat_table
---
---  export_column_stats
---  export_index_stats
---  export_table_stats
---  export_schema_stats
---  export_database_stats
---  export_system_stats
---  export_fixed_objects_stats
---  export_dictionary_stats
---
---  import_column_stats
---  import_index_stats
---  import_table_stats
---  import_schema_stats
---  import_database_stats
---  import_system_stats
---  import_fixed_objects_stats
---  import_dictionary_stats
---
---  Notes:
---    We do not support export/import of stats across databases of
---    different character sets.
---
-
-
-  procedure create_stat_table(
-        ownname varchar2, stattab varchar2,
-        tblspace varchar2 default null,
-        global_temporary boolean default false);
---
--- Creates a table with name 'stattab' in 'ownname's
--- schema which is capable of holding statistics.  The columns
--- and types that compose this table are not relevant as it
--- should be accessed solely through the procedures in this
--- package.
---
--- Input arguments:
---   ownname - The name of the schema
---   stattab - The name of the table to create.  This value should
---      be passed as the 'stattab' argument to other procedures
---      when the user does not wish to modify the dictionary statistics
---      directly.
---   tblspace - The tablespace in which to create the stat tables.
---      If none is specified, they will be created in the user's
---      default tablespace.
---   table_options - Whether or not the table should be created as a global
---      temporary table.
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Tablespace does not exist
---   ORA-20002: Table already exists
---
-
-
-  procedure drop_stat_table(
-        ownname varchar2, stattab varchar2);
---
--- Drops a user stat table
---
--- Input arguments:
---   ownname - The name of the schema
---   stattab - The user stat table identifier
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Table is not a statistics table
---   ORA-20002: Table does not exist
---
-
-
-  procedure upgrade_stat_table(
-        ownname varchar2, stattab varchar2);
---
--- Upgrade a user stat table from an older version
---
--- Input arguments:
---   ownname - The name of the schema
---   stattab - The user stat table identifier
---
--- Exceptions:
---   ORA-20000: Unable to upgrade table
---
-
-
-  procedure export_column_stats(
-        ownname varchar2, tabname varchar2, colname varchar2,
-        partname varchar2 default null,
-        stattab varchar2, statid varchar2 default null,
-        statown varchar2 default null);
---
--- Retrieves statistics for a particular column and stores them in the user
--- stat table identified by stattab
---
--- Input arguments:
---   ownname - The name of the schema
---   tabname - The name of the table to which this column belongs
---   colname - The name of the column or extension
---   partname - The name of the table partition.  If the table is
---      partitioned and partname is null, global and partition column
---      statistics will be exported.
---   stattab - The user stat table identifier describing where
---      to store the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-  procedure export_index_stats(
-        ownname varchar2, indname varchar2,
-        partname varchar2 default null,
-        stattab varchar2, statid varchar2 default null,
-        statown varchar2 default null);
---
--- Retrieves statistics for a particular index and stores them
--- in the user stat table identified by stattab
---
--- Input arguments:
---   ownname - The name of the schema
---   indname - The name of the index
---   partname - The name of the index partition.  If the index is
---      partitioned and partname is null, global and partition index
---      statistics will be exported.
---   stattab - The user stat table identifier describing where
---      to store the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-  procedure export_table_stats(
-        ownname varchar2, tabname varchar2,
-        partname varchar2 default null,
-        stattab varchar2, statid varchar2 default null,
-        cascade boolean default true,
-        statown varchar2 default null,
-        stat_category varchar2 default DEFAULT_STAT_CATEGORY
-);
---
--- Retrieves statistics for a particular table and stores them
--- in the user stat table.
--- Cascade will result in all index and column stats associated
--- with the specified table being exported as well.
---
--- Input arguments:
---   ownname - The name of the schema
---   tabname - The name of the table
---   partname - The name of the table partition.  If the table is
---      partitioned and partname is null, global and partition table
---      statistics will be exported.
---   stattab - The user stat table identifier describing where
---      to store the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   cascade - If true, column and index statistics for this table
---      will also be exported.
---   statown - The schema containing stattab (if different then ownname)
---   stat_category - what statistics to export. It accepts multiple values
---   separated by comma. The values we support now are 'OBJECT_STATS'
---   (i.e., table statistics, column statistics and index statistics) and
---   'SYNOPSES'
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-  procedure export_schema_stats(
-        ownname varchar2,
-        stattab varchar2, statid varchar2 default null,
-        statown varchar2 default null,
-        stat_category varchar2 default DEFAULT_STAT_CATEGORY);
---
--- Retrieves statistics for all objects in the schema identified
--- by ownname and stores them in the user stat table identified
--- by stattab
---
--- Input arguments:
---   ownname - The name of the schema
---   stattab - The user stat table identifier describing where
---      to store the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---   stat_category - what statistics to export. It accepts multiple values
---   separated by comma. The values we support now are 'OBJECT_STATS'
---   (i.e., table statistics, column statistics and index statistics) and
---   'SYNOPSES'
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-  procedure export_database_stats(
-        stattab varchar2, statid varchar2 default null,
-        statown varchar2 default null,
-        stat_category varchar2 default DEFAULT_STAT_CATEGORY);
---
--- Retrieves statistics for all objects in the database
--- and stores them in the user stat tables identified
--- by statown.stattab
---
--- Input arguments:
---   stattab - The user stat table identifier describing where
---      to store the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab.
---      If statown is null, it is assumed that every schema in the database
---      contains a user statistics table with the name stattab.
---   stat_category - what statistics to export. It accepts multiple values
---   separated by comma. The values we support now are 'OBJECT_STATS'
---   (i.e., table statistics, column statistics and index statistics) and
---   'SYNOPSES'
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-  procedure import_column_stats(
-        ownname varchar2, tabname varchar2, colname varchar2,
-        partname varchar2 default null,
-        stattab varchar2, statid varchar2 default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        force boolean default FALSE);
---
--- Retrieves statistics for a particular column from the user stat table
--- identified by stattab and stores them in the dictionary
---
--- Input arguments:
---   ownname - The name of the schema
---   tabname - The name of the table to which this column belongs
---   colname - The name of the column or extension
---   partname - The name of the table partition.  If the table is
---      partitioned and partname is null, global and partition column
---      statistics will be imported.
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force - import statistics even if it is locked
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20001: Invalid or inconsistent values in the user stat table
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20005: object statistics are locked
---
-
-
-  procedure import_index_stats(
-        ownname varchar2, indname varchar2,
-        partname varchar2 default null,
-        stattab varchar2, statid varchar2 default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        force boolean default FALSE);
---
--- Retrieves statistics for a particular index from the user
--- stat table identified by stattab and stores them in the
--- dictionary
---
--- Input arguments:
---   ownname - The name of the schema
---   indname - The name of the index
---   partname - The name of the index partition.  If the index is
---      partitioned and partname is null, global and partition index
---      statistics will be imported.
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force - import the statistics even if it is locked
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20001: Invalid or inconsistent values in the user stat table
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20005: object statistics are locked
---
-
-
-  procedure import_table_stats(
-        ownname varchar2, tabname varchar2,
-        partname varchar2 default null,
-        stattab varchar2, statid varchar2 default null,
-        cascade boolean default true,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        force boolean default FALSE,
-        stat_category varchar2 default DEFAULT_STAT_CATEGORY);
---
--- Retrieves statistics for a particular table from the user
--- stat table identified by stattab and stores them in the dictionary.
--- Cascade will result in all index and column stats associated
--- with the specified table being imported as well.
--- The statistics will be imported as pending in case PUBLISH preference
--- is set to FALSE.
---
--- Input arguments:
---   ownname - The name of the schema
---   tabname - The name of the table
---   partname - The name of the table partition.  If the table is
---      partitioned and partname is null, global and partition table
---      statistics will be imported.
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   cascade - If true, column and index statistics for this table
---      will also be imported.
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force - import even if statistics of the object is locked
---   stat_category - what statistics to import. It accepts multiple values
---   separated by comma. The values we support now are 'OBJECT_STATS'
---   (i.e., table statistics, column statistics and index statistics) and
---   'SYNOPSES'
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20001: Invalid or inconsistent values in the user stat table
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20005: object statistics are locked
---
-
-
-  procedure import_schema_stats(
-        ownname varchar2,
-        stattab varchar2, statid varchar2 default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        force boolean default FALSE,
-        stat_category varchar2 default DEFAULT_STAT_CATEGORY);
---
--- Retrieves statistics for all objects in the schema identified
--- by ownname from the user stat table and stores them in the
--- dictionary
--- The statistics will be imported as pending in case PUBLISH preference
--- is set to FALSE.
---
--- Input arguments:
---   ownname - The name of the schema
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force - Override statistics lock.
---     TRUE- Ignores the statistics lock on objects and import
---           the statistics.
---     FALSE-The statistics of an object will be imported only if it
---           is not locked.
---           ie if both DATA and CACHE statistics is locked, it will not
---           import anything. If CACHE statistics of an object is locked,
---           only DATA statistics will be imported and vice versa.
---   stat_category - what statistics to import. It accepts multiple values
---   separated by comma. The values we support now are 'OBJECT_STATS'
---   (i.e., table statistics, column statistics and index statistics) and
---   'SYNOPSES'
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges.
---              if ORA-20000 shows "no statistics are imported", several
---              possible reasons are: (1) no statistics exist for the specified
---              ownname or statid in the stattab; (2) statistics are locked; (3)
---              objects in the stattab no longer exist in the current database
---   ORA-20001: Invalid or inconsistent values in the user stat table
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-  procedure import_database_stats(
-        stattab varchar2, statid varchar2 default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        force boolean default FALSE,
-        stat_category varchar2 default DEFAULT_STAT_CATEGORY
-        );
---
--- Retrieves statistics for all objects in the database
--- from the user stat table(s) and stores them in the
--- dictionary
--- The statistics will be imported as pending in case PUBLISH preference
--- is set to FALSE.
---
--- Input arguments:
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab.
---      If statown is null, it is assumed that every schema in the database
---      contains a user statistics table with the name stattab.
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force - Override statistics lock.
---     TRUE- Ignores the statistics lock on objects and import
---           the statistics.
---     FALSE-The statistics of an object will be imported only if it
---           is not locked.
---           ie if both DATA and CACHE statistics is locked, it will not
---           import anything. If CACHE statistics of an object is locked,
---           only DATA statistics will be imported and vice versa.
---   stat_category - what statistics to import. It accepts multiple values
---   separated by comma. The values we support now are 'OBJECT_STATS'
---   (i.e., table statistics, column statistics and index statistics) and
---   'SYNOPSES'
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---              if ORA-20000 shows "no statistics are imported", several
---              possible reasons are: (1) user specified statid does not
---              exist; (2) statistics are locked; (3) objects in the
---              stattab no longer exist in the current database
---   ORA-20001: Invalid or inconsistent values in the user stat table
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-
-
-
-
-
-
---
--- This set of procedures enable the gathering of certain
--- classes of optimizer statistics with possible performance
--- improvements over the analyze command.
---
--- The procedures are:
---
---  gather_index_stats
---  gather_table_stats
---  gather_schema_stats
---  gather_database_stats
---  gather_system_stats
---  gather_fixed_objects_stats
---  gather_dictionary_stats
---
--- We also provide the following procedure for generating some
--- statistics for derived objects when we have sufficient statistics
--- on related objects
---
--- generate_stats
---
-
-  procedure gather_index_stats
-    (ownname varchar2, indname varchar2, partname varchar2 default null,
-     estimate_percent number default DEFAULT_ESTIMATE_PERCENT,
-     stattab varchar2 default null, statid varchar2 default null,
-     statown varchar2 default null,
-     degree number default to_degree_type(get_param('DEGREE')),
-     granularity varchar2 default DEFAULT_GRANULARITY,
-     no_invalidate boolean default
-       to_no_invalidate_type(get_param('NO_INVALIDATE')),
-     stattype varchar2 default 'DATA',
-     force boolean default FALSE);
---
--- This procedure gathers index statistics.
--- It attempts to parallelize as much of the work as possible.
--- are some restrictions as described in the individual parameters.
--- This operation will not parallelize with certain types of indexes,
--- including cluster indexes, domain indexes and bitmap join indexes.
--- The "granularity" and "no_invalidate" arguments are also not pertinent to
--- these types of indexes.
---
---   ownname - schema of index to analyze
---   indname - name of index
---   partname - name of partition
---   estimate_percent - Percentage of rows to estimate (NULL means compute).
---      The valid range is [0.000001,100].  Use the constant
---      DBMS_STATS.AUTO_SAMPLE_SIZE to have Oracle determine the
---      appropriate sample size for good statistics. This is the default.
---      The default value can be changed using set_param procedure.
---   degree - degree of parallelism (NULL means use of table default value
---      which was specified by DEGREE clause in CREATE/ALTER INDEX statement)
---      Use the constant DBMS_STATS.DEFAULT_DEGREE for the default value
---      based on the initialization parameters.
---      default for degree is NULL.
---      The default value can be changed using set_param procedure.
---   granularity - the granularity of statistics to collect (only pertinent
---      if the table is partitioned)
---     'AUTO' - the procedure determines what level of statistics to collect
---     'GLOBAL AND PARTITION' - gather global- and partition-level statistics
---     'SUBPARTITION' - gather subpartition-level statistics
---     'PARTITION' - gather partition-level statistics
---     'GLOBAL' - gather global statistics
---     'ALL' - gather all (subpartition, partition, and global) statistics
---     default for granularity is AUTO.
---     The default value can be changed using set_param procedure.
---   stattab - The user stat table identifier describing where to save
---      the current statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force - gather statistics of index even if it is locked.
---
--- Exceptions:
---   ORA-20000: Index does not exist or insufficient privileges
---   ORA-20001: Bad input value
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20005: object statistics are locked
---
-
-  procedure gather_table_stats
-    (ownname varchar2, tabname varchar2, partname varchar2 default null,
-     estimate_percent number default DEFAULT_ESTIMATE_PERCENT,
-     block_sample boolean default FALSE,
-     method_opt varchar2 default DEFAULT_METHOD_OPT,
-     degree number default to_degree_type(get_param('DEGREE')),
-     granularity varchar2 default  DEFAULT_GRANULARITY,
-     cascade boolean default DEFAULT_CASCADE,
-     stattab varchar2 default null, statid varchar2 default null,
-     statown varchar2 default null,
-     no_invalidate boolean default
-       to_no_invalidate_type(get_param('NO_INVALIDATE')),
-     stattype varchar2 default 'DATA',
-     force boolean default FALSE,
-     -- the context is intended for internal use only.
-     context dbms_stats.CContext default null);
-
---
--- This procedure gathers table and column (and index) statistics.
--- It attempts to parallelize as much of the work as possible, but there
--- are some restrictions as described in the individual parameters.
--- This operation will not parallelize if the user does not have select
--- privilege on the table being analyzed.
---
--- Input arguments:
---   ownname - schema of table to analyze
---   tabname - name of table
---   partname - name of partition
---   estimate_percent - Percentage of rows to estimate (NULL means compute).
---      The valid range is [0.000001,100].  Use the constant
---      DBMS_STATS.AUTO_SAMPLE_SIZE to have Oracle determine the
---      appropriate sample size for good statistics. This is the default.
---      The default value can be changed using set_param procedure.
---   block_sample - whether or not to use random block sampling instead of
---      random row sampling.  Random block sampling is more efficient, but
---      if the data is not randomly distributed on disk then the sample values
---      may be somewhat correlated.  Only pertinent when doing an estimate
---      statistics.
---   method_opt - method options of the following format
---
---         method_opt  := FOR ALL [INDEXED | HIDDEN] COLUMNS [size_clause]
---                        FOR COLUMNS [size_clause]
---                        column|attribute [size_clause]
---                        [,column|attribute [size_clause] ... ]
---
---         size_clause := SIZE [integer | auto | skewonly | repeat],
---                        where integer is between 1 and 254
---
---         column      := column name | extension name | extension
---
---      default is FOR ALL COLUMNS SIZE AUTO.
---      The default value can be changed using set_param procedure.
---      Optimizer related table statistics are always gathered.
---
---      If an extension is provided, the procedure create the extension if it
---      does not exist already. Please refer to create_extended_stats for
---      description of extension.
---
---   degree - degree of parallelism (NULL means use of table default value
---      which was specified by DEGREE clause in CREATE/ALTER TABLE statement)
---      Use the constant DBMS_STATS.DEFAULT_DEGREE for the default value
---      based on the initialization parameters.
---      default for degree is NULL.
---      The default value can be changed using set_param procedure.
---   granularity - the granularity of statistics to collect (only pertinent
---      if the table is partitioned)
---     'AUTO' - the procedure determines what level of statistics to collect
---     'GLOBAL AND PARTITION' - gather global- and partition-level statistics
---     'APPROX_GLOBAL AND PARTITION' - This option is similar to
---        'GLOBAL AND PARTITION'. But the global statistics are aggregated
---         from partition level statistics. It will aggregate all statistics except number of
---         distinct values for columns and number of distinct keys of indexes.
---         The existing histograms of the columns at the table level
---         are also aggregated.The global statistics are  gathered
---         (i.e., going back to GLOBAL AND PARTITION behaviour)
---         if partname argument is null. The aggregation will use only
---         partitions with statistics, so to get accurate global statistics,
---         user has to make sure to have statistics for all partitions.
---
---
---         This option is useful when you collect statistics for a new partition added
---         into a range partitioned table (for example, a table  partitioned by month).
---         The new data in the partition makes the global statistics stale (especially
---         the min/max values of the partitioning column). This stale global statistics
---         may cause suboptimal plans.  In this scenario, users can collect statistics
---         for the newly added partition with 'APPROX_GLOBAL AND PARTITION'
---         option so that the global statistics will reflect the newly added range.
---         This option will take less time than 'GLOBAL AND PARTITION' option since the
---         global statistics are aggregated from underlying partition level statistics.
---         Note that, if you are using APPROX_GLOBAL AND PARTITION,
---         you still  need to collect global statistics (with granularity = 'GLOBAL' option)
---         when there is substantial amount of change at the table level.
---         For example you added 10% more data to the table.  This is needed to get the
---         correct number of distinct values/keys statistic at table level.
---     'SUBPARTITION' - gather subpartition-level statistics
---     'PARTITION' - gather partition-level statistics
---     'GLOBAL' - gather global statistics
---     'ALL' - gather all (subpartition, partition, and global) statistics
---     default for granularity is AUTO.
---     The default value can be changed using set_param procedure.
---   cascade - gather statistics on the indexes for this table.
---      Use the constant DBMS_STATS.AUTO_CASCADE to have Oracle determine
---      whether index stats to be collected or not. This is the default.
---      The default value can be changed using set_param procedure.
---      Using this option is equivalent to running the gather_index_stats
---      procedure on each of the table's indexes.
---   stattab - The user stat table identifier describing where to save
---      the current statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---     The procedure invalidates the dependent cursors immediately
---     if set to FALSE.
---     Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---     invalidate dependend cursors. This is the default. The default
---     can be changed using set_param procedure.
---     When the 'cascade' argument is specified, not pertinent with certain
---     types of indexes described in the gather_index_stats section.
---   force - gather statistics of table even if it is locked.
---   context - internal use only.
---
--- Exceptions:
---   ORA-20000: Table does not exist or insufficient privileges
---   ORA-20001: Bad input value
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20005: object statistics are locked
---
- procedure gather_schema_stats
-    (ownname varchar2,
-     estimate_percent number default DEFAULT_ESTIMATE_PERCENT,
-     block_sample boolean default FALSE,
-     method_opt varchar2 default  DEFAULT_METHOD_OPT,
-     degree number default to_degree_type(get_param('DEGREE')),
-     granularity varchar2 default DEFAULT_GRANULARITY,
-     cascade boolean default DEFAULT_CASCADE,
-     stattab varchar2 default null, statid varchar2 default null,
-     options varchar2 default 'GATHER', objlist out ObjectTab,
-     statown varchar2 default null,
-     no_invalidate boolean default
-       to_no_invalidate_type(get_param('NO_INVALIDATE')),
-     gather_temp boolean default FALSE,
-     gather_fixed boolean default FALSE,
-     stattype varchar2 default 'DATA',
-     force boolean default FALSE,
-     obj_filter_list ObjectTab default null);
-  procedure gather_schema_stats
-    (ownname varchar2,
-     estimate_percent number default DEFAULT_ESTIMATE_PERCENT,
-     block_sample boolean default FALSE,
-     method_opt varchar2 default DEFAULT_METHOD_OPT,
-     degree number default to_degree_type(get_param('DEGREE')),
-     granularity varchar2 default DEFAULT_GRANULARITY,
-     cascade boolean default DEFAULT_CASCADE,
-     stattab varchar2 default null, statid varchar2 default null,
-     options varchar2 default 'GATHER', statown varchar2 default null,
-     no_invalidate boolean default
-       to_no_invalidate_type(get_param('NO_INVALIDATE')),
-     gather_temp boolean default FALSE,
-     gather_fixed boolean default FALSE,
-     stattype varchar2 default 'DATA',
-     force boolean default FALSE,
-     obj_filter_list ObjectTab default null);
---
--- Input arguments:
---   ownname - schema to analyze (NULL means current schema)
---   estimate_percent - Percentage of rows to estimate (NULL means compute).
---      The valid range is [0.000001,100].  Use the constant
---      DBMS_STATS.AUTO_SAMPLE_SIZE to have Oracle determine the
---      appropriate sample size for good statistics. This is the default.
---      The default value can be changed using set_param procedure.
---   block_sample - whether or not to use random block sampling instead of
---      random row sampling.  Random block sampling is more efficient, but
---      if the data is not randomly distributed on disk then the sample values
---      may be somewhat correlated.  Only pertinent when doing an estimate
---      statistics.
---   method_opt - method options of the following format
---
---         method_opt  := FOR ALL [INDEXED | HIDDEN] COLUMNS [size_clause]
---
---         size_clause := SIZE [integer | auto | skewonly | repeat],
---                        where integer is between 1 and 254
---
---      default is FOR ALL COLUMNS SIZE AUTO.
---      The default value can be changed using set_param procedure.
---      This value will be passed to all of the individual tables.
---   degree - degree of parallelism (NULL means use table default value which
---      is specified by DEGREE clause in CREATE/ALTER TABLE statement)
---      Use the constant DBMS_STATS.DEFAULT_DEGREE for the default value
---      based on the initialization parameters.
---      default for degree is NULL.
---      The default value can be changed using set_param procedure.
---   granularity - the granularity of statistics to collect (only pertinent
---      if the table is partitioned)
---     'AUTO' - the procedure determines what level of statistics to collect
---     'GLOBAL AND PARTITION' - gather global- and partition-level statistics
---     'SUBPARTITION' - gather subpartition-level statistics
---     'PARTITION' - gather partition-level statistics
---     'GLOBAL' - gather global statistics
---     'ALL' - gather all (subpartition, partition, and global) statistics
---     default for granularity is AUTO.
---     The default value can be changed using set_param procedure.
---   cascade - gather statistics on the indexes as well.
---      Use the constant DBMS_STATS.AUTO_CASCADE to have Oracle determine
---      whether index stats to be collected or not. This is the default.
---      The default value can be changed using set_param procedure.
---      Using this option is equivalent to running the gather_index_stats
---      procedure on each of the indexes in the schema in addition to
---      gathering table and column statistics.
---   stattab - The user stat table identifier describing where to save
---      the current statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   options - further specification of which objects to gather statistics for
---      'GATHER' - gather statistics on all objects in the schema
---      'GATHER AUTO' - gather all necessary statistics automatically.  Oracle
---        implicitly determines which objects need new statistics, and
---        determines how to gather those statistics.  When 'GATHER AUTO' is
---        specified, the only additional valid parameters are ownname, stattab,
---        statid, objlist and statown; all other parameter settings will be
---        ignored.  Also, return a list of objects processed.
---      'GATHER STALE' - gather statistics on stale objects as determined
---        by looking at the *_tab_modifications views.  Also, return
---        a list of objects found to be stale.
---      'GATHER EMPTY' - gather statistics on objects which currently
---        have no statistics.  also, return a list of objects found
---        to have no statistics.
---      'LIST AUTO' - return list of objects to be processed with 'GATHER AUTO'
---      'LIST STALE' - return list of stale objects as determined
---        by looking at the *_tab_modifications views
---      'LIST EMPTY' - return list of objects which currently
---        have no statistics
---   objlist - list of objects found to be stale or empty
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---     The procedure invalidates the dependent cursors immediately
---     if set to FALSE.
---     Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---     invalidate dependend cursors. This is the default. The default
---     can be changed using set_param procedure.
---     When 'cascade' option is specified, not pertinent with certain types
---     of indexes described in the gather_index_stats section.
---   gather_temp - gather stats on global temporary tables also.  The
---     temporary table must be created with "on commit preserve rows" clause,
---     and the statistics being collected are based on the data in the session
---     which this procedure is run but shared across all the sessions.
---   gather_fixed - Gather statistics on fixed tables also.
---     Statistics for fixed tables can be collected only by user SYS.
---     Also the ownname should be SYS or NULL.
---     Specified values for the following arguments will be ignored while
---     gathering statistics for fixed tables.
---       estimate_percent, block_sample, stattab, statid, statown
---     It will not invalidate the dependent cursors on fixed table
---     on which stats is collected.
---     This option is meant for internal use only.
---   force - gather statistics of objects even if they are locked.
---   obj_filter_list - a list of object filters. When provided, gather_schema_stats
---     will only gather statistics on the objects which satisfy at least one
---     object filter in the list as needed. Please refer to obj_filter_list
---     in  gather_database_stats.
--- Exceptions:
---   ORA-20000: Schema does not exist or insufficient privileges
---   ORA-20001: Bad input value
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-  procedure gather_database_stats
-    (estimate_percent number default DEFAULT_ESTIMATE_PERCENT,
-     block_sample boolean default FALSE,
-     method_opt varchar2 default DEFAULT_METHOD_OPT,
-     degree number default to_degree_type(get_param('DEGREE')),
-     granularity varchar2 default DEFAULT_GRANULARITY,
-     cascade boolean default DEFAULT_CASCADE,
-     stattab varchar2 default null, statid varchar2 default null,
-     options varchar2 default 'GATHER', objlist out ObjectTab,
-     statown varchar2 default null,
-     gather_sys boolean default TRUE,
-     no_invalidate boolean default
-       to_no_invalidate_type(get_param('NO_INVALIDATE')),
-     gather_temp boolean default FALSE,
-     gather_fixed boolean default FALSE,
-     stattype varchar2 default 'DATA',
-     obj_filter_list ObjectTab default null);
-  procedure gather_database_stats
-    (estimate_percent number default DEFAULT_ESTIMATE_PERCENT,
-     block_sample boolean default FALSE,
-     method_opt varchar2 default DEFAULT_METHOD_OPT,
-     degree number default to_degree_type(get_param('DEGREE')),
-     granularity varchar2 default DEFAULT_GRANULARITY,
-     cascade boolean default DEFAULT_CASCADE,
-     stattab varchar2 default null, statid varchar2 default null,
-     options varchar2 default 'GATHER', statown varchar2 default null,
-     gather_sys boolean default TRUE,
-     no_invalidate boolean default
-       to_no_invalidate_type(get_param('NO_INVALIDATE')),
-     gather_temp boolean default FALSE,
-     gather_fixed boolean default FALSE,
-     stattype varchar2 default 'DATA',
-     obj_filter_list ObjectTab default null);
---
--- Input arguments:
---   estimate_percent - Percentage of rows to estimate (NULL means compute).
---      The valid range is [0.000001,100].  Use the constant
---      DBMS_STATS.AUTO_SAMPLE_SIZE to have Oracle determine the
---      appropriate sample size for good statistics. This is the default.
---      The default value can be changed using set_param procedure.
---   block_sample - whether or not to use random block sampling instead of
---      random row sampling.  Random block sampling is more efficient, but
---      if the data is not randomly distributed on disk then the sample values
---      may be somewhat correlated.  Only pertinent when doing an estimate
---      statistics.
---   method_opt - method options of the following format
---
---         method_opt  := FOR ALL [INDEXED | HIDDEN] COLUMNS [size_clause]
---
---         size_clause := SIZE [integer | auto | skewonly | repeat],
---                        where integer is between 1 and 254
---
---      default is FOR ALL COLUMNS SIZE AUTO.
---      The default value can be changed using set_param procedure.
---      This value will be passed to all of the individual tables.
---   degree - degree of parallelism (NULL means use table default value which
---      is specified by DEGREE clause in CREATE/ALTER TABLE statement)
---      Use the constant DBMS_STATS.DEFAULT_DEGREE for the default value
---      based on the initialization parameters.
---      default for degree is NULL.
---      The default value can be changed using set_param procedure.
---   granularity - the granularity of statistics to collect (only pertinent
---      if the table is partitioned)
---     'AUTO' - the procedure determines what level of statistics to collect
---     'GLOBAL AND PARTITION' - gather global- and partition-level statistics
---     'SUBPARTITION' - gather subpartition-level statistics
---     'PARTITION' - gather partition-level statistics
---     'GLOBAL' - gather global statistics
---     'ALL' - gather all (subpartition, partition, and global) statistics
---     default for granularity is AUTO.
---     The default value can be changed using set_param procedure.
---   cascade - gather statistics on the indexes as well.
---      Use the constant DBMS_STATS.AUTO_CASCADE to have Oracle determine
---      whether index stats to be collected or not. This is the default.
---      The default value can be changed using set_param procedure.
---      Using this option is equivalent to running the gather_index_stats
---      procedure on each of the indexes in the database in addition to
---      gathering table and column statistics.
---   stattab - The user stat table identifier describing where to save
---      the current statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   options - further specification of which objects to gather statistics for
---      'GATHER' - gather statistics on all objects in the schema
---      'GATHER AUTO' - gather all necessary statistics automatically.  Oracle
---        implicitly determines which objects need new statistics, and
---        determines how to gather those statistics.  When 'GATHER AUTO' is
---        specified, the only additional valid parameters are stattab,
---        statid, objlist and statown; all other parameter settings will be
---        ignored.  Also, return a list of objects processed.
---      'GATHER STALE' - gather statistics on stale objects as determined
---        by looking at the *_tab_modifications views.  Also, return
---        a list of objects found to be stale.
---      'GATHER EMPTY' - gather statistics on objects which currently
---        have no statistics.  also, return a list of objects found
---        to have no statistics.
---      'LIST AUTO' - return list of objects to be processed with 'GATHER AUTO'
---      'LIST STALE' - return list of stale objects as determined
---        by looking at the *_tab_modifications views
---      'LIST EMPTY' - return list of objects which currently
---        have no statistics
---   objlist - list of objects found to be stale or empty
---   statown - The schema containing stattab.  If null, it will assume
---      there is a table named stattab in each relevant schema in the
---      database if stattab is specified for saving current statistics.
---   gather_sys - Gather statistics on the objects owned by the 'SYS' user
---      as well.
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---     The procedure invalidates the dependent cursors immediately
---     if set to FALSE.
---     Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---     invalidate dependend cursors. This is the default. The default
---     can be changed using set_param procedure.
---     When 'cascade' option is specified, not pertinent with certain types
---     of indexes described in the gather_index_stats section.
---   gather_temp - gather stats on global temporary tables also.  The
---     temporary table must be created with "on commit preserve rows" clause,
---     and the statistics being collected are based on the data in the session
---     which this procedure is run but shared across all the sessions.
---   gather_fixed - Gather stats on fixed tables also.
---     Statistics for fixed tables can be collected only by user SYS.
---     Specified values for the following arguments will be ignored while
---     gathering statistics for fixed tables.
---     gathering statistics for fixed tables.
---       estimate_percent, block_sample, stattab, statid, statown
---     It will not invalidate the dependent cursors on fixed table
---     on which stats is collected.
---     This option is meant for internal use only.
---   obj_filter_list - a list of object filters. When provided, gather_database_
---     stats will only gather statistics on the objects which satisfy at least
---     one of the object filters as needed.
---
---     In one single object filter, we can specify the constraints on the object
---     attributes. The attribute values specified in the object filter are case-
---     insensitive unless double-quoted. Wildcard is allowed in the attribute values.
---     Suppose non-null values s1, s2, ... are specified for attributes a1, a2, ... in
---     one object filter. An object o is said to satisfy this object filter if
---     (o.a1 like s1) and (o.a2 like s2) and ... is true.
---     The following example specifies that any table with a "SALES" prefix in the
---     SH schema and any table in the SYS schema, if stale, will be gathered.
---     Note that the statistics for the partitions of the tables also will be
---     gathered if they are stale.
---   Example:
---     declare
---       filter_lst  dbms_stats.objecttab := dbms_stats.objecttab();
---     begin
---       filter_lst.extend(2);
---       filter_lst(1).ownname := 'sh';
---       filter_lst(1).objname := 'sales%';
---       filter_lst(2).ownname := 'sys';
---       dbms_stats.gather_schema_stats(null, obj_filter_list => filter_lst,
---                                      options => 'gather_stale');
---     end;
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Bad input value
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-  procedure generate_stats
-    (ownname varchar2, objname varchar2,
-     organized number default 7,
-     force boolean default FALSE);
---
--- This procedure generates object statistics from previously collected
--- statistics of related objects.  For fully populated
--- schemas, the gather procedures should be used instead when more
--- accurate statistics are desired.
--- The currently supported objects are b-tree and bitmap indexes.
---
---   ownname - schema of object
---   objname - name of object
---   organized - the amount of ordering associated between the index and
---     its undelrying table.  A heavily organized index would have consecutive
---     index keys referring to consecutive rows on disk for the table
---     (the same block).  A heavily disorganized index would have consecutive
---     keys referencing different table blocks on disk.  This parameter is
---     only used for b-tree indexes.
---     The number can be in the range of 0-10, with 0 representing a completely
---     organized index and 10 a completely disorganized one.
---   force - generate statistics even if it is locked
--- Exceptions:
---   ORA-20000: Unsupported object type of object does not exist
---   ORA-20001: Invalid option or invalid statistics
---   ORA-20005: object statistics are locked
---
-
-
-
-
---
--- This procedure enables the flushing of in-memory monitoring
--- information to the dictionary.  Corresponding entries in the
--- *_tab_modifications views are updated immediately, without waiting
--- for Oracle to flush it periodically.  Useful for the users who need
--- up-to-date information in those views.
--- The gather_*_stats procedures internally flush the monitoring information
--- accordingly, and it is NOT necessary to run this procedure before
--- gathering the statistics.
---
---
--- The procedure is:
---
---  flush_database_monitoring_info
---
--- The modification monitoring mechanism is now controlled by the
--- STATISTICS_LEVEL initialization parameter, and the following
--- procedures no longer have any effect:
---
---  alter_schema_tab_monitoring
---  alter_database_tab_monitoring
---
-
-procedure flush_database_monitoring_info;
---
--- Flush in-memory monitoring information for all the tables to the dictionary.
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---
-
-procedure alter_schema_tab_monitoring
-  (ownname varchar2 default NULL, monitoring boolean default TRUE);
-procedure alter_database_tab_monitoring
-  (monitoring boolean default TRUE, sysobjs boolean default FALSE);
-
-
-
-procedure gather_system_stats (
-  gathering_mode  varchar2 default 'NOWORKLOAD',
-  interval  integer  default 60,
-  stattab   varchar2 default null,
-  statid    varchar2 default null,
-  statown   varchar2 default null);
---
--- This procedure gathers system statistics.
---
--- Input arguments:
---   mode - Allowable values: INTERVAL, START, STOP.
---     INTERVAL:
---       In INTERVAL mode user can provide interval parameter. After <interval>
---       minutes elapsed system statistics in dictionary or stattab will be
---       updated or created. This statistics captures system activity during
---       specified interval.
---     START | STOP:
---       START will initiate gathering statistics. STOP will calculate
---       statistics for elapsed period of time (since START) and refresh
---       dictionary or stattab. Interval in these modes is ignored.
---   interval - Specifies period of time in minutes for gathering statistics
---      in INTERVAL mode.
---   stattab - The user stat table identifier describing where to save
---      the current statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20001: Bad input value
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20003: Unable to gather system statistics
---   ORA-20004: Error in "INTERVAL" mode :
---              system parameter job_queue_processes must be > 0
---
-
-procedure get_system_stats (
-   status     out   varchar2,
-   dstart     out   date,
-   dstop      out   date,
-   pname            varchar2,
-   pvalue     out   number,
-   stattab          varchar2 default null,
-   statid           varchar2 default null,
-   statown          varchar2 default null);
-
---
--- Input arguments:
---   stattab - The user stat table identifier describing from where to get
---      the current statistics info. If stattab is null, the statistics info
---      will be obtained directly from the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---   pname - parameter name to get
---
--- Output arguments:
---   status - returns one of the following: COMPLETED, AUTOGATHERING,
---   MANUALGATHERING, BADSTATS
---   dstart - date when system stats gathering has been started
---   dstop - date when gathering was finished if status =  COMPLETE,
---   will be finished if status = AUTOGATHERING,
---   had to be finished if status = BADSTATS,
---   dstarted if status = MANUALGATHERING,
---   the following parameters defined only if status = COMPLETE
---   pvalue   - parameter value to get
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20003: Unable to get system statistics
---   ORA-20004: Parameter doesn't exist
---
-
-procedure set_system_stats (
-   pname            varchar2,
-   pvalue           number,
-   stattab          varchar2 default null,
-   statid           varchar2 default null,
-   statown          varchar2 default null);
-
---
--- Input arguments:
---   pname - parameter name to set
---   pvalue   - parameter value to set
---   stattab - The user stat table identifier describing from where to get
---      the current statistics info. If stattab is null, the statistics info
---      will be obtained directly from the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20001: Invalid input value
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20003: Unable to set system statistics
---   ORA-20004: Parameter doesn't exist
---
-
-
-procedure delete_system_stats (
-   stattab         varchar2  default nulL,
-   statid          varchar2  default nulL,
-   statown         varchar2  default null);
-
---
--- Deletes system statistics
---
--- Input arguments:
---   stattab - The user stat table identifier describing from where
---      to delete the statistics.  If stattab is null, the statistics
---      will be deleted directly from the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab (Only pertinent if stattab is not NULL).
---   statown - The schema containing stattab (if different then ownname)
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-procedure import_system_stats (
-   stattab  varchar2,
-   statid   varchar2 default null,
-   statown  varchar2 default null);
-
---
--- Retrieves system statistics from the user
--- stat table identified by stattab and stores it in the
--- dictionary
---
--- Input arguments:
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---              if ORA-20000 shows "no statistics are imported", several
---              possible reasons are: (1) user specified statid does not
---              exist; (2) statistics are locked; (3) objects in the
---              stattab no longer exist in the current database
---   ORA-20001: Invalid or inconsistent values in the user stat table
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20003: Unable to import system statistics
---
-
-
-procedure export_system_stats (
-   stattab  varchar2,
-   statid   varchar2 default null,
-   statown  varchar2 default null);
-
---
--- Retrieves system statistics and stores it
--- in the user stat table identified by stattab
---
--- Input arguments:
---   stattab - The user stat table identifier describing where
---      to store the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---   ORA-20003: Unable to export system statistics
---
-
-
-  procedure gather_fixed_objects_stats
-    (stattab varchar2 default null, statid varchar2 default null,
-     statown varchar2 default null,
-     no_invalidate boolean default
-       to_no_invalidate_type(get_param('NO_INVALIDATE')));
---
--- Gather statistics for fixed tables.
--- To run this procedure, you must have the SYSDBA or ANALYZE ANY DICTIONARY
--- system privilege.
---
--- Input arguments:
---   stattab - The user stat table identifier describing where to save
---      the current statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
--- Exceptions:
---   ORA-20000: insufficient privileges
---   ORA-20001: Bad input value
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-  procedure delete_fixed_objects_stats(
-        stattab varchar2 default null, statid varchar2 default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-        to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        force boolean default FALSE);
---
--- Deletes statistics for fixed tables
--- To run this procedure, you must have the SYSDBA or ANALYZE ANY DICTIONARY
--- system privilege.
---
--- Input arguments:
---   stattab - The user stat table identifier describing from where
---      to delete the statistics.  If stattab is null, the statistics
---      will be deleted directly in the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab (Only pertinent if stattab is not NULL).
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force - Ignores the statistics lock on objects and delete
---           the statistics if set to TRUE.
---
--- Exceptions:
---   ORA-20000: insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-  procedure export_fixed_objects_stats(
-        stattab varchar2, statid varchar2 default null,
-        statown varchar2 default null);
---
--- Retrieves statistics for fixed tables and stores them in the user
--- stat table identified by stattab
--- To run this procedure, you must have the SYSDBA or ANALYZE ANY DICTIONARY
--- system privilege.
---
--- Input arguments:
---   stattab - The user stat table identifier describing where
---      to store the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---
--- Exceptions:
---   ORA-20000: insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-
-  procedure import_fixed_objects_stats(
-        stattab varchar2, statid varchar2 default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-           to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        force boolean default FALSE);
---
--- Retrieves statistics for fixed tables from the user stat table and
--- stores them in the dictionary
--- To run this procedure, you must have the SYSDBA or ANALYZE ANY DICTIONARY
--- system privilege.
--- The statistics will be imported as pending in case PUBLISH preference
--- is set to FALSE.
---
--- Input arguments:
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different then ownname)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force - Override statistics lock.
---     TRUE- Ignores the statistics lock on objects and import
---           the statistics.
---     FALSE-The statistics of an object will be imported only if it
---           is not locked.
---
--- Exceptions:
---   ORA-20000: insufficient privileges
---              if ORA-20000 shows "no statistics are imported", several
---              possible reasons are: (1) user specified statid does not
---              exist; (2) statistics are locked; (3) objects in the
---              stattab no longer exist in the current database
---   ORA-20001: Invalid or inconsistent values in the user stat table
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-  procedure gather_dictionary_stats
-    (comp_id varchar2 default null,
-     estimate_percent number default DEFAULT_ESTIMATE_PERCENT,
-     block_sample boolean default FALSE,
-     method_opt varchar2 default DEFAULT_METHOD_OPT,
-     degree number default to_degree_type(get_param('DEGREE')),
-     granularity varchar2 default DEFAULT_GRANULARITY,
-     cascade boolean default DEFAULT_CASCADE,
-     stattab varchar2 default null, statid varchar2 default null,
-     options varchar2 default 'GATHER AUTO', objlist out ObjectTab,
-     statown varchar2 default null,
-     no_invalidate boolean default
-       to_no_invalidate_type(get_param('NO_INVALIDATE')),
-     stattype varchar2 default 'DATA',
-     obj_filter_list ObjectTab default null);
-  procedure gather_dictionary_stats
-    (comp_id varchar2 default null,
-     estimate_percent number default DEFAULT_ESTIMATE_PERCENT,
-     block_sample boolean default FALSE,
-     method_opt varchar2 default DEFAULT_METHOD_OPT,
-     degree number default to_degree_type(get_param('DEGREE')),
-     granularity varchar2 default DEFAULT_GRANULARITY,
-     cascade boolean default DEFAULT_CASCADE,
-     stattab varchar2 default null, statid varchar2 default null,
-     options varchar2 default 'GATHER AUTO', statown varchar2 default null,
-     no_invalidate boolean default
-       to_no_invalidate_type(get_param('NO_INVALIDATE')),
-     stattype varchar2 default 'DATA',
-     obj_filter_list ObjectTab default null);
-
---
--- Gather statistics for dictionary schemas 'SYS', 'SYSTEM' and schemas of
--- RDBMS components.
--- To run this procedure, you must have the SYSDBA OR
--- both ANALYZE ANY DICTIONARY and ANALYZE ANY system privilege.
---
--- Input arguments:
---   comp_id - component id of the schema to analyze (NULL means schemas
---             of all RDBMS components).
---             Please refer to comp_id column of dba_registry view.
---             The procedure always gather stats on 'SYS' and 'SYSTEM' schemas
---             regardless of this argument.
---   estimate_percent - Percentage of rows to estimate (NULL means compute).
---      The valid range is [0.000001,100].  Use the constant
---      DBMS_STATS.AUTO_SAMPLE_SIZE to have Oracle determine the
---      appropriate sample size for good statistics. This is the default.
---      The default value can be changed using set_param procedure.
---   block_sample - whether or not to use random block sampling instead of
---      random row sampling.  Random block sampling is more efficient, but
---      if the data is not randomly distributed on disk then the sample values
---      may be somewhat correlated.  Only pertinent when doing an estimate
---      statistics.
---   method_opt - method options of the following format
---
---         method_opt  := FOR ALL [INDEXED | HIDDEN] COLUMNS [size_clause]
---
---         size_clause := SIZE [integer | auto | skewonly | repeat],
---                        where integer is between 1 and 254
---
---      default is FOR ALL COLUMNS SIZE AUTO.
---      The default value can be changed using set_param procedure.
---      This value will be passed to all of the individual tables.
---   degree - degree of parallelism (NULL means use table default value which
---      is specified by DEGREE clause in CREATE/ALTER TABLE statement)
---      Use the constant DBMS_STATS.DEFAULT_DEGREE for the default value
---      based on the initialization parameters.
---      default for degree is NULL.
---      The default value can be changed using set_param procedure.
---   granularity - the granularity of statistics to collect (only pertinent
---      if the table is partitioned)
---     'AUTO' - the procedure determines what level of statistics to collect
---     'GLOBAL AND PARTITION' - gather global- and partition-level statistics
---     'SUBPARTITION' - gather subpartition-level statistics
---     'PARTITION' - gather partition-level statistics
---     'GLOBAL' - gather global statistics
---     'ALL' - gather all (subpartition, partition, and global) statistics
---     default for granularity is AUTO.
---     The default value can be changed using set_param procedure.
---   cascade - gather statistics on the indexes as well.
---      Use the constant DBMS_STATS.AUTO_CASCADE to have Oracle determine
---      whether index stats to be collected or not. This is the default.
---      The default value can be changed using set_param procedure.
---      Using this option is equivalent to running the gather_index_stats
---      procedure on each of the indexes in the schema in addition to
---      gathering table and column statistics.
---   stattab - The user stat table identifier describing where to save
---      the current statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   options - further specification of which objects to gather statistics for
---      'GATHER' - gather statistics on all objects in the schema
---      'GATHER AUTO' - gather all necessary statistics automatically.  Oracle
---        implicitly determines which objects need new statistics, and
---        determines how to gather those statistics.  When 'GATHER AUTO' is
---        specified, the only additional valid parameters are comp_id, stattab,
---        statid and statown; all other parameter settings will be
---        ignored. Also, return a list of objects processed.
---      'GATHER STALE' - gather statistics on stale objects as determined
---        by looking at the *_tab_modifications views.  Also, return
---        a list of objects found to be stale.
---      'GATHER EMPTY' - gather statistics on objects which currently
---        have no statistics.  also, return a list of objects found
---        to have no statistics.
---      'LIST AUTO' - return list of objects to be processed with 'GATHER AUTO'
---      'LIST STALE' - return list of stale objects as determined
---        by looking at the *_tab_modifications views
---      'LIST EMPTY' - return list of objects which currently
---        have no statistics
---   objlist - list of objects found to be stale or empty
---   statown - The schema containing stattab (if different from current schema)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---     The procedure invalidates the dependent cursors immediately
---     if set to FALSE.
---     Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---     invalidate dependend cursors. This is the default. The default
---     can be changed using set_param procedure.
---     When 'cascade' option is specified, not pertinent with certain types
---     of indexes described in the gather_index_stats section.
---   obj_filter_list - a list of object filters. When provided, gather_dictionary_
---     stats will only gather statistics on the objects which satisfy at least
---     one of the object filters as needed. Please refer to obj_filter_list in
---     gather_database_stats
--- Exceptions:
---   ORA-20000: Schema does not exist or insufficient privileges
---   ORA-20001: Bad input value
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-  procedure delete_dictionary_stats(
-        stattab varchar2 default null, statid varchar2 default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        stattype varchar2 default 'ALL',
-        force boolean default FALSE);
---
--- Deletes statistics for all dictionary schemas ('SYS', 'SYSTEM' and
--- RDBMS component schemas)
---
--- To run this procedure, you must have the SYSDBA OR
--- both ANALYZE ANY DICTIONARY and ANALYZE ANY system privilege.
---
--- Input arguments:
---   stattab - The user stat table identifier describing from where
---      to delete the statistics.  If stattab is null, the statistics
---      will be deleted directly in the dictionary.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab (Only pertinent if stattab is not NULL).
---   statown - The schema containing stattab (if different from current schema)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   stattype - The type of statistics to be deleted
---     ALL   - both data and cache statistics will be deleted
---     CACHE - only cache statistics will be deleted
---   force - Ignores the statistics lock on objects and delete
---           the statistics if set to TRUE.
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-  procedure export_dictionary_stats(
-        stattab varchar2, statid varchar2 default null,
-        statown varchar2 default null,
-        stat_category varchar2 default DEFAULT_STAT_CATEGORY);
---
--- Retrieves statistics for all dictionary schemas ('SYS', 'SYSTEM' and
--- RDBMS component schemas) and stores them in the user stat table
--- identified by stattab
---
--- To run this procedure, you must have the SYSDBA OR
--- both ANALYZE ANY DICTIONARY and ANALYZE ANY system privilege.
---
--- Input arguments:
---   stattab - The user stat table identifier describing where
---      to store the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different from current schema)
---   stat_category - what statistics to export. It accepts multiple values
---   separated by comma. The values we support now are 'OBJECT_STATS'
---   (i.e., table statistics, column statistics and index statistics) and
---   'SYNOPSES'
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-  procedure import_dictionary_stats(
-        stattab varchar2, statid varchar2 default null,
-        statown varchar2 default null,
-        no_invalidate boolean default
-          to_no_invalidate_type(get_param('NO_INVALIDATE')),
-        force boolean default FALSE,
-        stat_category varchar2 default DEFAULT_STAT_CATEGORY);
---
--- Retrieves statistics for all dictionary schemas ('SYS', 'SYSTEM' and
--- RDBMS component schemas) from the user stat table and stores them in
--- the dictionary
--- The statistics will be imported as pending in case PUBLISH preference
--- is set to FALSE.
----
--- To run this procedure, you must have the SYSDBA OR
--- both ANALYZE ANY DICTIONARY and ANALYZE ANY system privilege.
---
--- Input arguments:
---   stattab - The user stat table identifier describing from where
---      to retrieve the statistics.
---   statid - The (optional) identifier to associate with these statistics
---      within stattab.
---   statown - The schema containing stattab (if different from current schema)
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---   force - Override statistics lock.
---     TRUE- Ignores the statistics lock on objects and import
---           the statistics.
---     FALSE-The statistics of an object will be imported only if it
---           is not locked.
---           ie if both DATA and CACHE statistics is locked, it will not
---           import anything. If CACHE statistics of an object is locked,
---           only DATA statistics will be imported and vice versa.
---   stat_category - what statistics to import. It accepts multiple values
---   separated by comma. The values we support now are 'OBJECT_STATS'
---   (i.e., table statistics, column statistics and index statistics) and
---   'SYNOPSES'
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---              if ORA-20000 shows "no statistics are imported", several
---              possible reasons are: (1) user specified statid does not
---              exist; (2) statistics are locked; (3) objects in the
---              stattab no longer exist in the current database
---   ORA-20001: Invalid or inconsistent values in the user stat table
---   ORA-20002: Bad user statistics table, may need to upgrade it
---
-
-  procedure lock_table_stats(
-    ownname varchar2,
-    tabname varchar2,
-    stattype varchar2 default 'ALL');
---
--- This procedure enables the user to lock the statistics on the table
---
--- Input arguments:
---   ownname  - schema of table to lock
---   tabname  - name of the table
---   stattype - type of statistics to be locked
---     'CACHE'  - lock only caching statistics
---     'DATA'   - lock only data statistics
---     'ALL'    - lock both data and caching statistics. This is the default
-
-
-  procedure lock_partition_stats(
-    ownname varchar2,
-    tabname varchar2,
-    partname varchar2);
-
---
--- This procedure enables the user to lock statistics for a partition
---
--- Input arguments:
---   ownname   - schema of the table to lock
---   tabname   - name of the table
---   partname  - name of the partition
---
-
-
-  procedure lock_schema_stats(
-    ownname varchar2,
-    stattype varchar2 default 'ALL');
-
---
--- This procedure enables the user to lock the statistics of all
--- tables of a schema
---
--- Input arguments:
---   ownname  - schema of tables to lock
---   stattype - type of statistics to be locked
---     'CACHE'  - lock only caching statistics
---     'DATA'   - lock only data statistics
---     'ALL'    - lock both data and caching statistics. This is the default
-
-
-  procedure unlock_table_stats(
-    ownname varchar2,
-    tabname varchar2,
-    stattype varchar2 default 'ALL');
---
--- This procedure enables the user to unlock the statistics on the table
---
--- Input arguments:
---   ownname  - schema of table to unlock
---   tabname  - name of the table
---   stattype - type of statistics to be unlocked
---     'CACHE'  - unlock only caching statistics
---     'DATA'   - unlock only data statistics
---     'ALL'    - unlock both data and caching statistics. This is the default
-
-
-  procedure unlock_partition_stats(
-    ownname varchar2,
-    tabname varchar2,
-    partname varchar2);
-
---
--- This procedure enables the user to unlock statistics for a partition
---
--- Input arguments:
---   ownname   - schema of table to unlock
---   tabname   - name of the table
---   partname  - name of the partition
---
-
-
-  procedure unlock_schema_stats(
-    ownname varchar2,
-    stattype varchar2 default 'ALL');
---
--- This procedure enables the user to unlock the statistics of all
--- tables of a schema
---
--- Input arguments:
---   ownname  - schema of tables to unlock
---   stattype - type of statistics to be unlocked
---     'CACHE'  - unlock only caching statistics
---     'DATA'   - unlock only data statistics
---     'ALL'    - unlock both data and caching statistics. This is the default
-
-  procedure restore_table_stats(
-    ownname varchar2,
-    tabname varchar2,
-    as_of_timestamp timestamp with time zone,
-    restore_cluster_index boolean default FALSE,
-    force boolean default FALSE,
-    no_invalidate boolean default
-      to_no_invalidate_type(get_param('NO_INVALIDATE')));
---
--- This procedure enables the user to restore statistics of a table as of
--- a specified timestamp (as_of_timestamp). The procedure will restore
--- statistics of associated indexes and columns as well. If the table
--- statistics were locked at the specified timestamp the procedure will
--- lock the statistics.
--- Note:
---   The procedure may not restore statistics correctly if analyze interface
---   is used for computing/deleting statistics.
---   Old statistics versions are not saved when SYSAUX tablespace is
---   offline, this affects restore functionality.
---   The procedure may not restore statistics if the table defn is
---   changed (eg: column added/deleted, partition exchanged etc).
---   Also it will not restore stats if the object is created after
---   the specified timestamp.
---   The procedure will not restore user defined statistics.
--- Input arguments:
---   ownname  - schema of table for which statistics to be restored
---   tabname  - table name
---   as_of_timestamp - statistics as of this timestamp will be restored.
---   restore_cluster_index - If the table is part of a cluster,
---     restore statistics of the cluster index if set to TRUE.
---   force - restore statistics even if the table statistics are locked.
---           if the table statistics were not locked at the specified
---           timestamp, it will unlock the statistics
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20001: Invalid or inconsistent values
---   ORA-20006: Unable to restore statistics , statistics history not available
-
-  procedure restore_schema_stats(
-    ownname varchar2,
-    as_of_timestamp timestamp with time zone,
-    force boolean default FALSE,
-    no_invalidate boolean default
-      to_no_invalidate_type(get_param('NO_INVALIDATE')));
---
--- This procedure enables the user to restore statistics of all tables of
--- a schema as of a specified timestamp (as_of_timestamp).
-
--- Input arguments:
---   ownname  - schema of tables for which statistics to be restored
---   as_of_timestamp - statistics as of this timestamp will be restored.
---   force - restore statistics of tables even if their statistics are locked.
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---
--- Exceptions:
---   ORA-20000: Object does not exist or insufficient privileges
---   ORA-20001: Invalid or inconsistent values
---   ORA-20006: Unable to restore statistics , statistics history not available
-
-  procedure restore_database_stats(
-    as_of_timestamp timestamp with time zone,
-    force boolean default FALSE,
-    no_invalidate boolean default
-      to_no_invalidate_type(get_param('NO_INVALIDATE')));
---
--- This procedure enables the user to restore statistics of all tables of
--- the database as of a specified timestamp (as_of_timestamp).
-
--- Input arguments:
---   as_of_timestamp - statistics as of this timestamp will be restored.
---   force - restore statistics of tables even if their statistics are locked.
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Invalid or inconsistent values
---   ORA-20006: Unable to restore statistics , statistics history not available
-
-  procedure restore_fixed_objects_stats(
-    as_of_timestamp timestamp with time zone,
-    force boolean default FALSE,
-    no_invalidate boolean default
-      to_no_invalidate_type(get_param('NO_INVALIDATE')));
---
--- This procedure enables the user to restore statistics of all fixed tables
--- as of a specified timestamp (as_of_timestamp).
--- To run this procedure, you must have the SYSDBA or ANALYZE ANY DICTIONARY
--- system privilege.
---
--- Input arguments:
---   as_of_timestamp - statistics as of this timestamp will be restored.
---   force - restore statistics of tables even if their statistics are locked.
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Invalid or inconsistent values
---   ORA-20006: Unable to restore statistics , statistics history not available
-
-  procedure restore_dictionary_stats(
-    as_of_timestamp timestamp with time zone,
-    force boolean default FALSE,
-    no_invalidate boolean default
-      to_no_invalidate_type(get_param('NO_INVALIDATE')));
---
--- This procedure enables the user to restore statistics of all dictionary
--- tables (tables of 'SYS', 'SYSTEM' and RDBMS component schemas)
--- as of a specified timestamp (as_of_timestamp).
---
--- To run this procedure, you must have the SYSDBA OR
--- both ANALYZE ANY DICTIONARY and ANALYZE ANY system privilege.
---
--- Input arguments:
---   as_of_timestamp - statistics as of this timestamp will be restored.
---   force - restore statistics of tables even if their statistics are locked.
---   no_invalidate - Do not invalide the dependent cursors if set to TRUE.
---      The procedure invalidates the dependent cursors immediately
---      if set to FALSE.
---      Use DBMS_STATS.AUTO_INVALIDATE to have oracle decide when to
---      invalidate dependend cursors. This is the default. The default
---      can be changed using set_param procedure.
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Invalid or inconsistent values
---   ORA-20006: Unable to restore statistics , statistics history not available
-
-  procedure restore_system_stats(
-    as_of_timestamp timestamp with time zone);
---
--- This procedure enables the user to restore system statistics
--- as of a specified timestamp (as_of_timestamp).
---
--- Input arguments:
---   as_of_timestamp - statistics as of this timestamp will be restored.
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Invalid or inconsistent values
---   ORA-20006: Unable to restore statistics , statistics history not available
-
-  procedure purge_stats(
-    before_timestamp timestamp with time zone);
---
--- This procedure enables the user to purge old versions of statistics
--- saved in dictionary
---
--- To run this procedure, you must have the SYSDBA OR
--- both ANALYZE ANY DICTIONARY and ANALYZE ANY system privilege.
---
--- Input arguments:
---   before_timestamp - versions of statistics saved before this timestamp
---             will be purged. if null, it uses the purging policy
---             used by automatic purge. The automatic purge deletes all
---             history older than
---               min(current time - stats history retention,
---                   time of recent analyze in the system - 1).
---             stats history retention value can be changed using
---             alter_stats_history_retention procedure.
---             The default is 31 days.
---
---   When before_timestamp is specified as DBMS_STATS.PURGE_ALL, all stats
---   history tables are truncated. Please note that interrupting
---   (e.g., hitting Ctrl-C) purge_stats while it is running with PURGE_ALL
---   option may lead to inconsistencies. Hence, please avoid interrupting
---   purge_stats manually.
---
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Invalid or inconsistent values
-
-  procedure alter_stats_history_retention(
-    retention in number);
---
--- This procedure enables the user to change stats history retention
--- value.  Stats history retention is used by both the automatic
--- purge and purge_stats procedure.
---
---
--- To run this procedure, you must have the SYSDBA OR
--- both ANALYZE ANY DICTIONARY and ANALYZE ANY system privilege.
---
--- Input arguments:
---   retention - The retention time in days. The stats history will be
---               ratained for at least these many number of days.
---               The valid range is [1,365000].  Also the following
---               values can be used for special purposes.
---                 0 - old stats are never saved. The automatic purge will
---                     delete all stats history
---                -1 - stats history is never purged by automatic purge.
---                null -  change stats history retention to default value
-
---
-
-  function get_stats_history_retention return number;
-
--- This function returns the current retention value.
-
-  function get_stats_history_availability
-             return timestamp with time zone;
-
---  This function returns oldest timestamp where stats history
---  is available.
---  Users can not restore stats to timestamp older than  this one.
-
-
-  procedure copy_table_stats(
-        ownname varchar2,
-        tabname varchar2,
-        srcpartname varchar2,
-        dstpartname varchar2,
-        scale_factor number DEFAULT 1,
-        flags number DEFAULT null,
-        force boolean DEFAULT FALSE);
-
---
--- This procedure copies the stats of the source [sub] partition to the
--- dst [sub] partition after scaling (the number of blks, number of rows etc.).
--- It sets the high bound partitioning value as the max value of the first
--- partitioning col and high bound partitioning value of the previous partition
--- as the min value of the first partitioning col for range partitioned table.
--- It finds the max and min from the list of values for the list partitioned table.
--- It also sets the normalized max and min values. If the destination partition
--- is the first partition then min values are equal to max values. It also copies
--- statistics of all dependent object such as columns and local indexes. If the
--- statistics for source are not available then nothing is copied.
---
---   ownname - schema of index to analyze
---   tabname - table name of source and destination [sub]partitions
---   srcpartname - source [sub]partition
---   dstpartname - destination [sub]partition
---   scale_factor - scale factor to scale nblks, nrows etc. in dstpart
--- Exceptions:
---   ORA-20000: Invalid partition name
---   ORA-20001: Bad input value
---
-
-
-  function diff_table_stats_in_stattab(
-      ownname      varchar2,
-      tabname      varchar2,
-      stattab1     varchar2,
-      stattab2     varchar2 default null,
-      pctthreshold number   default 10,
-      statid1      varchar2 default null,
-      statid2      varchar2 default null,
-      stattab1own  varchar2 default null,
-      stattab2own  varchar2 default null)
-   return DiffRepTab pipelined;
-
--- Input arguments:
---   ownname  - owner of the table. Specify null for current schema.
---   tabname  - table for which statistics are to be compared.
---   stattab1 - user stats table 1.
---   stattab2 - user stats table 2. If null, statistics in stattab1
---              is compared with current statistics in dictionary.
---              This is the default.
---              Specify same table as stattab1 to compare two sets
---              within the stats table (Please see statid below).
---   pctthreshold - The function report difference in statistics
---                  only if it exceeds this limit. The default value is 10.
---   statid1  - (optional) identifies statistics set within stattab1.
---   statid2  - (optional) identifies statistics set within stattab2.
---   stattab1own - The schema containing stattab1 (if different than ownname)
---   stattab2own - The schema containing stattab2 (if different than ownname)
---
-
-  function diff_table_stats_in_history(
-      ownname      varchar2,
-      tabname      varchar2,
-      time1        timestamp with time zone,
-      time2        timestamp with time zone default null,
-      pctthreshold number   default 10)
-    return DiffRepTab pipelined;
-
--- Input arguments:
---   ownname  - owner of the table. Specify null for current schema.
---   tabname  - table for which statistics are to be compared.
---   time1    - first time stamp
---   time2    - second time stamp
---
---   pctthreshold - The function report difference in statistics
---                  only if it exceeds this limit. The default value is 10.
---
---   NOTE:
---   If the second timestamp is null, the function compares the current
---   statistics in dictionary with the statistics as of the other timestamp.
-
-  function diff_table_stats_in_pending(
-      ownname      varchar2,
-      tabname      varchar2,
-      time_stamp   timestamp with time zone default null,
-      pctthreshold number   default 10)
-    return DiffRepTab pipelined;
-
--- Input arguments:
---   ownname  - owner of the table. Specify null for the current schema.
---   tabname  - table for which statistics are to be compared.
---   time_stamp - time stamp to get statistics from the history
---
---   pctthreshold - The function report difference in statistics
---                  only if it exceeds this limit. The default value is 10.
---
---   NOTE:
---   If the time_stamp parameter is null, the function compares the current
---   statistics in the dictionary with the pending statistics.  This is the
---   default
-
-
-
-  function create_extended_stats(
-      ownname    varchar2,
-      tabname    varchar2,
-      extension  varchar2)
-    return varchar2;
-
--- This function creates a column stats entry in the system for a user specified
--- column group or an expression in a table. Statistics for this extension will
--- be gathered when user or auto statistics gathering job gathers statistics for
--- the table. We call statistics for such an extension, "extended statistics".
--- This function returns the name of this newly created entry for the extension.
--- If the extension already exists then this function  throws an error.
-
---
---  Parameters:
---      ownname       -- owner name of a table
---      tabname       -- table name
---      extension     -- can be either a column group or an expression. Suppose
---                       the specified table has two column c1, c2. An example
---                       column group can be '(c1, c2)', an example expression
---                       can be '(c1 + c2)'.
---
---  Notes:
---
---      1. An extension cannot contain a virtual column.
---
---      2. You can not create extensions on tables owned by SYS.
---
---      3. You can not create extensions on cluster tables, index organized
---         tables, temporary tables, external tables.
---
---      4. Total number of extensions in a table cannot be greater than
---         maximum of (20, 10 % of number of non-virtual columns in the table).
---
---      5. Number of columns in a column group must be in the range [2, 32].
---
---      6. A column can not appear more than once in a column group.
---
---      7. Column group can not contain expressions.
---
---      8. An expression must contain at least one column.
---
---      9. An expression can not contain subquery.
---
---     10. COMPATIBLE parameter needs to be 11.0.0.0.0 or greater.
---
--- Exceptions:
---
---   ORA-20000: Insufficient privileges / creating extension is not supported
---
---   ORA-20001: Error when processing extension
---
---   ORA-20007: Extension already exist
---
---   ORA-20008: Reached the upper limit on number of extensions
---
-
-  function create_extended_stats(
-      ownname    varchar2,
-      tabname    varchar2)
-    return clob;
-
--- This function is very similar to the function above but creates statistics
--- extension based on the column group usage recorded by seed_col_usage
--- procedure. This function returns a report of extensions created.
---
---
---  Parameters:
---      ownname       -- owner name of a table. If null, all schemas in the
---                       database.
---      tabname       -- table name. If null, creates statistics extensions
---                       for all tables of ownname.
-
-  function show_extended_stats_name(
-      ownname    varchar2,
-      tabname    varchar2,
-      extension  varchar2)
-    return varchar2;
-
---  This function returns the name of the statistics entry that is created for
---  the user specified extension. It raises error if no extension is created
---  yet
---
---
---  Parameters:
---      ownname      -- owner name of a table
---      tabname      -- table name
---      extension    -- can be either a column group or an expression
---                      (see description in create_extended_stats)
--- Exceptions:
---   ORA-20000: Insufficient privileges or extension does not exist.
---   ORA-20001: Error when processing extension
-
-  procedure drop_extended_stats(
-      ownname    varchar2,
-      tabname    varchar2,
-      extension  varchar2);
-
--- This function drops the statistics entry that is created for the user
--- specified extension. This cancels the effects of created_extended_stats.
--- If no extension is created for the extension, this function
--- throws an error.
---
---
---  Parameters:
---      ownname      -- owner name of a table
---      tabname      -- table name
---      extension    -- can be either a column group or an expression
---                      (see description in create_extended_stats)
--- Exceptions:
---   ORA-20000: Insufficient privileges or extension does not exist.
---   ORA-20001: Error when processing extension
---
--- The following procedure is for internal use only.
---
---  gather_database_stats_job_proc
---  cleanup_stats_job_proc
---
-
-
-  procedure merge_col_usage(
-      dblink varchar2);
-
---
--- This procedure merges column usage information from a source database,
--- specified via a dblink, into the local database.
--- If the column usage information already exists for a given table and
--- column then it will combine both the local and the remote information
--- otherwise it will insert the remote information as new.
--- This procedure is allowed is executed as SYS only, otherwise you will
--- an error message 'Insufficient privileges'.
--- In addition the user specified during the creation of the dblink is
--- expected to have privileges to select from tables in the SYS schema.
---
--- Parameters:
---     dblink     - dblink name
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---   ORA-20001: Parameter dblink cannot be null
---   ORA-20002: Unable to create a temp table
---
-
-
-  procedure seed_col_usage(
-      sqlset_name IN         VARCHAR2,
-      owner_name  IN         VARCHAR2,
-      time_limit  IN         POSITIVE DEFAULT NULL);
-
---
--- This procedure seeds column usage information from a statements in
--- the specified sql tuning set.
--- The procedure will iterate over the SQL statements in the SQL tuning
--- set and compile them in order to seed column usage information for
--- the columns that appear in these statements. This procedure records
--- group of columns as well. Extensions for the recorded group of columns
--- can be created using create_extended_stats procedure.
---
--- Parameters:
---     sqlset_name     - sqlset name
---     owner_name      - owner name
---     time_limit      - time limit (in seconds)
---
--- If sqlset_name and owner_name is null, it records the column (group) usage
--- information for the statements executed in the system in next time_limit
--- seconds.
---
--- Exceptions:
---   ORA-20000: Insufficient privileges
---
-
-  procedure reset_col_usage(
-      ownname      varchar2,
-      tabname      varchar2);
-
--- This procedure deletes the recorded column (group) usage information
--- from dictionary. Column (group) usage information is used by gather
--- procedures to automatically determine the columns that require histograms.
--- Also this information is used by create_extended_stats to create extensions
--- for the group of columns seen in the workload. So resetting column usage
--- will affect these functionalities. This procedure should be used only in very
--- rare cases where you need to start from scratch and need to seed
--- column usage all over again.
---
--- Parameters:
---     ownname         - owner name. If null it resets column usage information
---                       for tables in all schemas in the database.
---     tabname         - table name. If null, resets column usage information
---                       for all tables of ownname.
--- If ownname and tabname is null, it will stop seeding column usage, if
--- currently seeding column usage using seed_col_usage.
-
-  function report_col_usage(
-      ownname      varchar2,
-      tabname      varchar2)  return clob;
-
--- This procedure reports the recorded column (group) usage information.
---
--- Parameters:
---     ownname         - owner name. If null it reports column usage information
---                       for tables in all schemas in the database.
---     tabname         - table name. If null, it reports column usage information
---                       for all tables of ownname.
--- Examples:
---     The following example shows column usage information for customers table
---     in SH schema.
---
---SQL> set long 100000
---SQL> set lines 120
---SQL> set pages 0
---SQL>
---SQL> -- Display column usage
---SQL> select dbms_stats.report_col_usage('sh', 'customers') from dual;
---LEGEND:
---.......
---
---EQ         : Used in single table EQuality predicate
---RANGE      : Used in single table RANGE predicate
---LIKE       : Used in single table LIKE predicate
---NULL       : Used in single table is (not) NULL predicate
---EQ_JOIN    : Used in EQuality JOIN predicate
---NONEQ_JOIN : Used in NON EQuality JOIN predicate
---FILTER     : Used in single table FILTER predicate
---JOIN       : Used in JOIN predicate
---GROUP_BY   : Used in GROUP BY expression
---...............................................................................
---
---###############################################################################
---
---COLUMN USAGE REPORT FOR SH.CUSTOMERS
---....................................
---
---1. COUNTRY_ID                          : EQ
---2. CUST_CITY                           : EQ
---3. CUST_STATE_PROVINCE                 : EQ
---4. (CUST_CITY, CUST_STATE_PROVINCE,
---    COUNTRY_ID)                        : FILTER
---5. (CUST_STATE_PROVINCE, COUNTRY_ID)   : GROUP_BY
---###############################################################################
-
-
-
-procedure gather_database_stats_job_proc;
-
-procedure cleanup_stats_job_proc(
-      ctx number, job_owner varchar2, job_name varchar2,
-      sesid number, sesser number);
-
-end;
-/