Utility Function Summary

You can perform the following functions with DBUTLTY. Each of these functions is documented in detail in the following sections. The functions are discussed in alphabetical order.
datacom151
You can perform the following functions with DBUTLTY. Each of these functions is documented in detail in the following sections. The functions are discussed in alphabetical order.
Functions that have a Y in the SU column can be executed in Single User mode as well as with the MUF active. Any function that does not have a Y in the SU column can therefore only be executed when the MUF is enabled. An asterisk (*) in the SU column indicates one or more exceptions that are explained in the Description column.
 When external security is turned on, most DBUTLTY functions require the MUF to be enabled, even those running in Single User mode, because the MUF is used for authorization purposes.
 
Function
 
 
SU
 
 
Description
 
Allows the ability to restrict access to a table, either from the database level or the area level.
Provides options to edit an accounting database definition, catalog the definition to the Accounting Facility, and request an open, close, or spill of individual Accounting tables.AUTO
Records information in Snapshots of selected Dynamic System Tables in a permanent database to allow you to run reports and analyze the results.
Collects information from memory and certain selected Dynamic System Tables and records the information into a sequential file.
Creates a Snapshot of selected MUFs with their active tasks.
Y
Outputs a sequential data set containing a backup of the area specified. The Directory (CXX), any specific data area, or all areas in a database can be backed up.
Communicates a specific request to the MUF. Only the STATUS, SNAPCSA, and SNAPSVC options can be executed in both Single User mode and with an active MUF.
Verifies that the data in a specific table adheres to SQL-defined integrity constraints. 
Provides functions to maintain the Directory (CXX).
Clones an environment to a new environment that is modeled after an existing environment.
With OPTION=SIZE_AREA - Allows you to find out the extent size needed if the current data ares is to be backed up in physical order and loaded into the area at either the same block size or a different block size.
With OPTION=COUNT_SET_RECORDS - Allows you to recount records.
With OPTION=REBUILD_SPACE_INDEX - Allows you to track the space available in a data area which is defined with space reclamation.
Executes one of the following test or analysis programs:
 
DBTSTPR
 
 
CA Datacom®/DB
 Test Program The DBTSTPR program can run in Single User mode if NO is specified for the MULTUSE= keyword.
 
DBIDCPR
 
Index Area Analysis Program
 
DBIDPPR
 
Index Area Population Analysis Program
Allows you to control the allowed defaults.
Defragments or compresses the DXX, that is, the "lowest" level of the IXX that contains key values and pointers to actual rows.
Y
Validates the syntax and content of the DBUTLTY commands and associated keywords, without invoking the functions.
Facilitates the data encryption feature of 
CA Datacom®/DB
 by using certain designated options.
Reads a backup file and writes extract data to a sequential output data set(s).
Formats additional space to extend an Index Area (IXX) or data area.
Y
Outputs a 
CA Datacom®/DB
 table in expanded form to a sequential data set.
Used to define output data sets, for example to define one or more output data sets used by the EXTBKUP function.
Adds or deletes dynamic data area or Index Area (IXX or DXX) buffers to the system.
Allows you to force the allowed keyword values. (Use with CAUTION).
Allows you to fix gaps that occurred during CDC processing.
 INIT 
Y
Formats the Directory (CXX), Log Area (LXX), Index Area (IXX), Force Area (FXX), or data area for use by 
CA Datacom®/DB
.
Links a data area or Index Area (IXX) to the Directory (CXX).
Y
Reads data from a sequential or VSAM data set and loads this data into the specified area. LOAD only applies to a data area or the Directory (CXX).
Locks a data area when you request a backup while the MUF is updating the data area.
Reads a sequential or VSAM input data set and adds the records to a specified 
CA Datacom®/DB
 table. MASSADD can run in Single User mode if NO is specified for the MULTUSE= keyword.
Reorganizes the database table without having to take it offline.
Pre-formats (pre-initializes) a planned non-existing index area or data area.
Reprocesses maintenance transactions from a Recovery File (RXX) in either forward or backward mode. Forward recovery can be run in an active MUF mode or in a Single User mode while the MUF is up, providing that the database is closed and not being used. Backward recovery must, however, be run with the MUF active.
Deletes a key ID from the Index.
 REORG 
Provides a way to reorganize a large data area into 
nearly 100 percent
 Native Key sequence. The REORG function executes much faster than other reorganization options.
Provides the ability to load one table in a multiple table area with new data, replacing all current data for that table. It executes in the MUF and allows full read and update access to every other table in the same area and database to other applications in the same MUF.
Prints one of the following reports:
Directory (CXX) Report
Summary Space Utilization Report
Index Area (IXX) report
Database History Report
Log Area (LXX) Report
Statistics and Diagnostics Area (PXX) Report
Recovery File (RXX) Analysis Report
Split File Analysis Report
Data Area Space Estimation Report
SVC report
Utility Function History Report (TYPE=H)
Y
Resets the Log Area (LXX) as empty, or resets the Directory (CXX) exclusive control flags and sets database update and read controls to zero.
Reads the area indicated (or all areas in a database) and rebuilds the data space index or the entire Index Area (IXX) information for that area based on the current data area information. You can also use the RETIX function to reset the Transaction Sequence Number (TSN).
Y
Reconstructs log records being spilled to the Recovery File (RXX), if they had no End-of-File or trailer records as a result of an operating system or MUF abend.
Clears cached permissions after making security changes.
 SET
Allows you to establish how you want DBUTLTY to support error handling of functions within a specific execution. SET also allows debugging tools and tuning options to be specified.
Moves transactions that can be spilled from the Log Area (LXX). We recommend you use the SPILLOPT function instead of the SPILL function (see the following). SPILL works the same as SPILLOPT SPILL=MAX.
Allows you to specify MAX or MIN when requesting a spill. Also allows the setting to allow update of a SPILL history table to record SPILL activity.
Unlocks the data area you locked with the LOCK function and allows update access to the area.
Ensures the integrity of the DA Datacom data rows and their correspondins keys in the index.