This command is used to catalog (compile) and store single or multiple Natural objects in the current Natural library.
When you enter the
CATALL command without any
additional options, the Catalog Objects in Library screen
is displayed, which you use to perform the functions described below. You can
also issue the
CATALL command directly using the
command syntax shown above.
CATALL processes all objects in the order in
which the object types are listed on the Catalog Objects in
Library screen (see also the information for
TYPES in the section
Direct Command Syntax).
You can also select functions on the Catalog Objects in
Library screen by default using the subprogram
CATALLU2. In addition you may enable
CATALLU2 to be
called in batch or command mode. The subprogram is delivered as a source object
FNAT). To activate the subprogram,
modify it as described in its source, then catalog it and copy it to
SYSLIB. The subprogram is called before the Catalog
Objects in Library screen is output.
See also Object Naming Conventions in the Using Natural documentation.
This document covers the following topics:
If you wish
CATALL to be performed for
all objects of the selected types in the current library, specify an
asterisk (*) as object name in the from field.
If you wish
CATALL to be performed for a
certain range of objects, you can use asterisk notation (*) and wildcard
notation (?) for the name in the from field, as described
for the system command
You can also specify a start setting and an end setting for a certain range of objects by entering corresponding object names (without asterisk or wildcard notation) in the from and to fields.
Instead of entering settings in these fields, you can also select objects from a selection list.
Moreover, you can use the from field to enter the
name of an object of type text which contains a list of
CATALL commands. The
CATALL commands contained in the text will then be
executed. You can either create such a text manually or have it created
automatically when you use the selection list.
If you wish
CATALL to be performed for the
objects of a Predict set, specify in Predict Set a one- or
two-digit number that identifies the retained set to be used for the names of
the objects to be processed.
CATALL processes all
objects in the order in which they are listed in the Predict set.
If you use a Predict set, the from field and the
to field must not be used. Additionally, you can specify
in Set User the ID of the user who created the Predict
set. If no ID is specified, the value of the system variable
*USER is used.
A retained set is created with the save set option of the
Predict has to be installed. For detailed information on Predict sets, refer to the Predict documentation.
The following applies:
If you mark, only the source objects in the current library that have already been cataloged earlier (a corresponding cataloged object exists) are cataloged.
If you mark, all source objects (with or without corresponding cataloged objects) in the current library are cataloged.
CATALL applies to objects of all
types in the current library (all object types are marked with X).
If you wish objects of a certain type not to be processed by
CATALL, overwrite the respective X with a blank.
Objects of type copycode and text will be saved, even if you select Stow. They will not be saved, if you select Catalog.
You can select one or more of the following options for
|Condition Code in Batch||If you execute
|Renumber Source-Code 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, overwrite the X in this field with a blank.
|Keep Result List||
You can also re-display the result list with another
|Processing Information|| During online processing,
During batch processing,
To suppress this display, overwrite the X in this field with a blank.
|Error Report||At the end of processing,
To suppress this error list, overwrite the X in this field with a blank.
|Extended Error Report||The error report will be output in extended form, with directory
information, error line and error message.
To output the Extended Error Report, mark this field with an X.
Pressing PF4 causes a window to appear in which you can select or enter additional options.
Report Text Object: Enter the name of a Natural text object. An
error report of a
If you wish to use
CATALL only for certain
objects, you can select these objects from a selection list.
To do so, first make the desired specifications under Select Function and Select Options, and then press PF5. A list of the objects stored in the current library is displayed.
The list corresponds to that of the system command
Scrolling the selection list and the specification of new selection criteria on
the list is also done in the same way as with the
On the list, select the desired objects by marking them with a character in the column Cmd. To simultaneously select all objects of the current selection list, press PF5. You can then scroll the list, specify other selection criteria, and select further objects.
When you have selected all objects you wish to process, press PF3.
A window is displayed which allows you to store the selected set of
objects so that you can re-use it in other
If you enter a name in the window, the selected set of objects will
automatically be stored (in the form of
commands) in an object of type text of that name. You can later use that text
name in the field Catalog
Objects from of the Catalog Objects in
If this is not desired, press ENTER without entering anything in the window.
CATALL will then begin to process the
For the various specifications you can make on the Catalog
Objects in Library screen, there are also corresponding options
which you can specify directly with the system command
||Corresponds to the fields Catalog Objects from and to of the Catalog Objects in Library screen, see Catalog Objects from/to.|
||Corresponds to the field Predict Set of the Catalog Objects in Library screen, see Predict Set and Set User.|
||Corresponds to the field Set user of the Catalog Objects in Library screen, see Predict Set and Set User.|
||Corresponds to the options Select cataloged source
objects only (
||Corresponds to the object types listed on the Catalog
Objects in Library screen. Possible types
(processed in the order below) are:
The types have to be specified as
one character string, for example,
||Corresponds to the actions of the same names on the
Catalog Objects in Library screen, see
||Corresponds to specifying a text name in the Catalog Objects from field of the Catalog Objects in Library screen, see Catalog Objects from/to.|
To stow only source objects for which a cataloged object already exist
Enter the following command:
CATALL * STOW KEEP CC NOREN
The above command is with implicit
RECAT and has the
same effect as the following command.
CATALL * RECAT STOW KEEP CC NOREN
To stow all objects
Enter the following command:
CATALL * ALL STOW KEEP CC NOREN
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