1

OVERVIEW
This chapter gives an overview of the ADABAS utilities, which provide all of the functions necessary to manage an ADABAS database. Utility Name ADABCK ADACLP ADACMP ADADBA ADADBM ADADCU ADADEV ADAERR ADAFDU ADAFIN ADAFRM ADAINV ADAMUP ADANUC ADAOPR ADAORD ADAPLP ADAPRI ADAREC ADAREP ADATST ADAULD ADAVFY Purpose Backup and restore database or files Command log report Compression of data DBA Workbench Database modification Decompression of data Disk space management Error file report File definition File information report Format and create a new database Creating, removing and verifying inverted lists Mass add and delete Starting the database, defining nucleus parameters Operator utility Reorder database or files, export/import files Protection log printout Print ADABAS blocks Recovery of database or files Database report Issuing ADABAS commands File unloading Database consistency check

ADABCK Backup and Restore Database or Files

The ADABAS backup utility dumps/restores the contents of the database (or a specific file or files) to/from a sequential data file. The utility can also be used to copy an ADABAS backup copy.

ADABAS Utilities Manual

ADACLP Command Log Report

This utility prints the command log.

ADACMP Compression of Data

The compression utility compresses user data. The compressed data is used as input for the mass update utility ADAMUP. The input for this utility is the raw data together with the data definitions that describe the structure of the data provided.

ADADBA DBA Workbench

This utility provides functionality for operating and maintaining ADABAS databases and files via a graphical user interface.

ADADBM Database Modification

The ADADBM utility consists of the following functions which can be used to make modifications to the database: S S S S S S S The ADD_CONTAINER function adds a new container file to the Associator, Data Storage or WORK data set. The ADD_FIELDS function appends one or more new fields to the end of a files FDT. The ALLOCATE functions NI, UI, AC and DS increase the Normal Index, Upper Index, Address Converter or Data Storage space assigned to a file; The [NO]AUTOMATIC_ALLOCATION option enables/disables the automatic extension of a file if additional space is required. The CHANGE function changes the standard length of a field in the Field Definition Table (FDT). The DBID parameter selects the database to be used. The DEALLOCATE functions are the inverse functions of ALLOCATE. The DEALLOCATE NI, UI, AC and DS function returns the Normal Index, Upper Index, Address Converter or Data Storage space no longer needed by a file to the Free Space Table (FST); The DELCP function deletes old checkpoint records from the checkpoint file in the specified range of dates.

Overview

S S S S S S S S S S

The DELETE function deletes an ADABAS file or a range of files from the database. The DISPLAY function displays the Block of Unreadable Blocks (BUB) and the Utility Communication Block (UCB). The NEWWORK function allocates and formats a new ADABAS WORK data set. The [NO]PLOG option enables/disables PLOG journaling for the selected file. The RECOVER function returns lost space to the Free Space Table (FST). The REFRESH function resets a file or a range of files to the state of zero records loaded. The REMOVE_CONTAINER function deletes a container file. The RENAME function changes the database name or the name of a loaded file. The RESET function removes entries from the UCB or BUB. The REUSE function controls the reuse of data storage space or ISNs by ADABAS.

ADADCU Decompression of Data

The ADADCU utility decompresses records to be used with a nonADABAS application program, or as input for the compression utility ADACMP. The file to be decompressed must be unloaded from the database (unload utility ADAULD) before it can be used as input for this utility. With ADADCU, complete records can be decompressed, fields can be rearranged within a record, default lengths can be changed, some types of fields can be truncated, formats can be changed and space can be allocated for the addition of new fields.

ADADEV Disk Space Management

This utility consists of several functions for managing the disk space to be used by ADABAS. It can be used to preallocate space for a database.

ADAERR Error File Report

The ADAERR utility displays the contents of the error files generated by various utilities.

ADAFDU File Definition Utility

The file definition utility ADAFDU defines a file in the database. It only loads the FCB and the FDT into the database and allocates the requested space for ASSO and DATA for the specified file.

ADABAS Utilities Manual

ADAFIN File Information Report

The ADAFIN utility displays information about one or more files, e.g. FDT, descriptor statistics and the fill percentage of blocks in the Data Storage, Normal Index and Upper/Main Index.

ADAFRM Format and Create a New Database

The formatting utility ADAFRM allocates and formats the files that are used by ADABAS (Associator, Data Storage, WORK, TEMP and SORT). It can also format files which have been preallocated by ADADEV.

ADAINV Creating, Removing and Verifying Inverted Lists

The invert utility ADAINV creates, re-inverts or removes inverted lists for a loaded file in a database or validates specified descriptors.

ADAMUP Mass Add and Delete

The ADAMUP utility adds or deletes large numbers of records to/from a file in the database.

ADANUC Start the database, define nucleus parameters

The ADANUC utility is used to start the database for online operations.

ADAOPR Operator Utility

The operator utility is used to operate the ADABAS nucleus.

ADAORD Reorder Database or Files, Export/Import Files

The reorder utility ADAORD provides functions to reorganize a database or files within a database (REORDER function) and to migrate files between databases (EXPORT and IMPORT functions).

ADAPLP Protection Log Printout

This utility prints the protection log.

Overview

ADAPRI Print ADABAS Blocks

The ADAPRI utility prints the contents of a block or a range of blocks in the Associator, Data Storage, WORK, TEMP or SORT for maintenance or auditing purposes.

ADAREC Recovery of Database or Files

This utility S Reapplies updates made to the database (REGENERATE function).

ADAREP Database Report

The ADAREP utility produces the database status report. This report contains information about the current physical layout and logical contents of the database. The information in this report includes: S S S S S The amount and location of the space currently allocated for the Associator and Data Storage; The amount and location of unused space available for Associator and Data Storage; Database file summary; Checkpoint information; Information about each file in the database (space allocation, space available, number of records loaded, MAXISN setting, field definitions).

ADASCR ADABAS Security Functions

The security utility ADASCR creates, modifies and deletes file protection levels and user passwords, and enables the record locking capabilities of individual passwords (by using value criteria for individual database files) to be set or modified. Additionally, the utility is used to display file and password security information.

ADATST Issuing ADABAS Commands

This utility issues commands to an ADABAS nucleus.

ADABAS Utilities Manual

ADAULD File Unloading

The unload utility ADAULD unloads a file from a database, an ADABAS backup copy or an export copy and produces compressed records with the same format as those produced by the compression utility ADACMP. Unloaded records may be used as input for the decompression utility ADADCU or with the mass update utility ADAMUP. Records can be unloaded from a database in the sequence in which they are currently stored in Data Storage, in the sequence of a descriptor or in ISN sequence. However, records can only be unloaded from a backup copy or an export copy in the order in which they were stored by the utility.

ADAVFY Database Consistency Check

This utility checks the consistency of the database. The General Control Block (GCB) is validated together with each File Control Block (FCB) and each Field Definition Table (FDT) of the loaded files. The index structure and Data Storage are validated. If specified, ADAVFY also looks for lost RABNs.

10