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.

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.