tcl.catalog Verb: Access/TCL

tcl.catalog

Command tcl.catalog Verb: Access/TCL
Applicable release versions: AP, R83 3.1
Category TCL (746)
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.
Syntax catalog file.reference itemlist*
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".
Purpose
Related file.reference
basic.debug
tcl.compile-run
tcl.compile-catalog