|
|
|
|
|
|
|
|
|
||||||
CATALL |
object-name
[ |
[TYPES
types]
|
[options ...] | ||||||||||
| text-name |
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
in library SYSTEM (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 LIST.
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
LIST XREF
command.
Note:
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.
By default, 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.
You can select one of the following functions to be applied to the
selected objects: SAVE,
CATALOG,
STOW or
CHECK. The functions
correspond to the system commands of the same names.
Note:
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
CATALL processing:
| Condition Code in Batch | If you execute CATALL in batch mode
and mark this option with a character, Condition Code 55 will be returned
either if a syntax error is detected during CATALL
execution or if no objects are found within the specified range of objects to
be processed (applies to CATALOG and
STOW
only).
|
| 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 | CATALL generates a result list. If
you wish to keep this list for further use, mark this field with a character.
The library You can also re-display the result list with another
|
| Processing Information | During online processing, CATALL
shows a scrolling display of processing status information.
During batch processing, To suppress this display, overwrite the X in this field with a blank. |
| Error Report | At the end of processing, CATALL
displays a list of the errors that occurred.
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. |
| PF4 AddOp |
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
LIST.
Scrolling the selection list and the specification of new selection criteria on
the list is also done in the same way as with the
LIST command.
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 CATALL
processing:
If you enter a name in the window, the selected set of objects will
automatically be stored (in the form of CATALL
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
Library screen.
If this is not desired, press ENTER without entering anything in the window.
CATALL will then begin to process the
selected objects.
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
CATALL:
object-name TO
object-name |
Corresponds to the fields Catalog Objects from and to of the Catalog Objects in Library screen, see Catalog Objects from/to. | |||||||||||||||||||||||||||||||||
{XSET /
XREFSET} set-number |
Corresponds to the field Predict Set of the Catalog Objects in Library screen, see Predict Set and Set User. | |||||||||||||||||||||||||||||||||
[SETUSER
set-user] |
Corresponds to the field Set user of the Catalog Objects in Library screen, see Predict Set and Set User. | |||||||||||||||||||||||||||||||||
RECAT /
ALL |
Corresponds to the options Select cataloged source
objects only, or Select all source objects of
the Catalog Objects in Library screen. RECAT
is the default, see Select
Cataloged Source Objects Only, or Select All Source
Objects.
|
|||||||||||||||||||||||||||||||||
TYPES
types |
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, |
|||||||||||||||||||||||||||||||||
SAVE / CATALOG / STOW /
CHECK |
Corresponds to the actions of the same names on the
Catalog Objects in Library screen, see
Select
Function. CATALOG is the default.
|
|||||||||||||||||||||||||||||||||
options |
|
|||||||||||||||||||||||||||||||||
text-name |
Corresponds to specifying a text name in the Catalog Objects from field of the Catalog Objects in Library screen, see Catalog Objects from/to. | |||||||||||||||||||||||||||||||||
Examples:
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
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).
