CATALL

#### Search Results

Search

# CATALL

This command is used to catalog, check, save or stow all objects or selected objects in the current library.

The following topics are covered:

- CATALL in Interactive Mode

- CATALL in Batch Mode

## CATALL in Interactive Mode

`CATALL`

When you issue this command, the Catalog Objects in Library window appears. In this window, you specify which types of objects are to be processed. Objects are processed in the order in which the object types are listed in the window (see also the information for `TYPES` in the section CATALL in Batch Mode). Additionally, you can choose which action is to be performed and which objects are to be processed.

You can make the following specifications in the window:

Starting from | Enter an asterisk (*) if you want to process all objects of the selected types in the current library. If you want to restrict the number of objects to a certain range, you can use asterisk notation for the name.
Apply action only to existing modules | If you mark this option, only those objects for which cataloged objects exist in the current library will be cataloged again; source objects for which no cataloged objects exist will not be processed.
Apply action to all sources | If you mark this option, all selected objects will be processed.
Action | After pressing PF2, you can select one of the following actions to be applied to the selected objects: Catalog Check Save Stow These actions correspond to the system commands of the same names. Note Under Natural Security, certain actions may be disallowed.
Renumber source lines | By default, the source-code lines of sources that were saved or stowed are not renumbered. If you wish automatic renumbering of lines, write an X in this field.
Object types | By default, `CATALL` applies to objects of all types in the current library (all object types are marked with an X). If you wish objects of a certain type not to be affected by `CATALL`, overwrite the corresponding X with a blank.
Generate new map source | Maps created with previous Natural versions are not necessarily compatible with Natural Version 3.1 and above. Mark this option to ensure that maps are converted during the catalog operation. This option converts and stores maps as source objects and as cataloged objects.

During `CATALL` processing, a statistics window appears and the objects being cataloged are listed.

Caution
If you press any key while `CATALL` processing is in progress, `CATALL` will be stopped.

Upon successful completion of processing, an information message is displayed.

If an object was not cataloged successfully, a window showing the object name, error number and error line is displayed.

If the `CATALL` command is called from within a Natural program with stacked parameters, Natural assumes batch mode and does not display the error dialog in case of compilation errors. Instead of the dialog a file will be created in Natural's temporary directory (`TMP_PATH`) with name library.CTL. This file is empty if no errors are found, otherwise it contains the failed objects with line number and error code.

## CATALL in Batch Mode

`CATALL` object-name |  | `RECAT` `ALL` |  | [`TYPES` types] |  | `CATALOG` `CHECK` `SAVE` `STOW` |  | [options ...]

For the various specifications you can make in the Catalog Objects in Library window, there are also corresponding options which you can specify directly with the system command `CATALL`:

`object-name` | The name of the object to be cataloged. Enter an asterisk (*) if you want to catalog all objects of the specified types in the current library. If you want to restrict the number of objects to a certain range, you can use asterisk notation for the name.
`RECAT / ALL` | Corresponds to the options Apply action only to existing modules, or Apply action to all sources of the Catalog Objects in Library screen. `RECAT` is the default.
`TYPES types` | Corresponds to the object types marked in the Catalog Objects in Library screen. Possible types are (objects are processed in the order in which the object types are listed below):
D | DDMs
G | Global data areas
L | Local data areas
A | Parameter data areas
C | Copycodes
T | Texts
7 | Functions
N | Subprograms
S | Subroutines
H | Helproutines
M | Maps
8 | Adapters
P | Programs
4 | Classes
3 | Dialogs
* | All types (this is the default)
The types have to be specified as one character string, for example, `GLA` for global, local and parameter data areas. By default, `CATALL` applies to objects of all types in the current library.
`CATALOG / CHECK / SAVE / STOW` | Corresponds to the actions of the same names on the Catalog Objects in Library screen. `CATALOG` is the default.
`options` | `NOREN` | No automatic renumbering of source-code lines of source objects.

Note
The individual command components must be separated from one another either by a blank or by the input delimiter character (as defined with the session parameter `ID`).

### On this page

- CATALL in Interactive Mode
- CATALL in Batch Mode