tcl.catalog
Creates 'verb' item for a Pick/BASIC program.
Syntax
catalog file.reference itemlist*
Description
creates a 'verb' entry in the md of the current account, making the specified program executable directly from the TCL prompt.
If the cataloged program is a 'mainline' program (not a subroutine or function), it can be executed by issuing its program.name at the TCL prompt.
'file.reference' names the file containing the program to catalog. In AP, if no file is specified, it defaults to 'bp'.
'itemlist*' names the previously compiled Pick/BASIC program(s) to add to the master dictionary. If no itemlist* is specified, or if an asterisk (*) is used, all programs in the file are cataloged.
Once a program has been cataloged, it does not need to be cataloged again, even if it is changed and recompiled. (Issuing the catalog command from TCL is the same as using the <ctrl>+xc on a Pick/BASIC program in UP.)
If there is currently a cataloged program with the same name, it is overwritten.
All external subroutines must be cataloged.
Activating a cataloged Pick/BASIC program :
program.name {(options}
To activate a cataloged program, enter the program name at the TCL prompt character. All options available to the 'run' command are allowed.
Options
o Overwrites any existing item except file-defining items and Q-pointers. A cataloged Pick/BASIC program item in the master dictionary has its name specified in attribute 4. If an item already exists in the master dictionary that is not in Pick/BASIC verb format and the 'o' option has not been specified, an error message displays indicating that the item is already on file and the program is not cataloged.
* See the 'run' verb for additional options.
Example
catalog bp testprog
[244] 'testprog' cataloged.
The 'TCL' command sentence to catalog the 'testprog' object
in the dictionary of file 'bp'.
See Also
User Comments
What do you think?
Share your experience or ask a question by using the form below.
Login to leave your comments.
