tcl.catalog

Verb: Access/TCL, Releases: AP and R83 3.1

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

Command Name Type Description
file.reference Definition How to reference files in Pick.
basic.debug Statement Invokes Pick/BASIC debugger.
tcl.compile-run Verb: Access Compiles and runs a Pick/BASIC program.
tcl.compile-catalog Verb: Access Compiles and catalogs Pick/BASIC program.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.