Version 6.3.8 for Windows
 —  System Commands  —

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 processes in the order in which the object types are listed in the dialog box. 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 object modules already exist in the current library will be cataloged again; objects that exist only in source form 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 also renumbered.

If you wish no automatic renumbering of lines, deactivate 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 in source and object form.

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

Top of page

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:
G Global data areas
A Parameter data areas
L Local data areas
D DDM
S Subroutine
N Subprogram
H Helproutine
M Map
P Program
3 Dialog
4 Class
7 Function
8 Adapter
* All types (this is the default)

The types have to be specified as one character string, for example, LAG for local, parameter and global 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).

Top of page