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

When you issue this command, the Catalog Objects in Library dialog box appears. In this dialog box, 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 dialog box (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.

See also Cataloging the Objects in a Library in Using Natural Studio.

You can make the following specifications in the dialog box:

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 You can select one of the following actions to be applied to the selected objects:

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, activate this checkbox.

Object types By default, CATALL applies to objects of all types in the current library (all object types are activated). If you wish objects of a certain type not to be affected by CATALL, deactivate the corresponding option.

In addition, command buttons are available to select all options or to clear all check boxes.

Note:
When you are working in a remote mainframe development environment using SPoD, the options DDMs and Generate new map source cannot be used and will be dimmed.

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.

When you are working in a remote mainframe development environment using SPoD, this option cannot be used and will be dimmed.

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 dialog box, 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 dialog box. RECAT is the default.
TYPES types Corresponds to the object types marked in the Catalog Objects in Library dialog box. 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 dialog. 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).