CATALOG creates a Command Definition item in the Master Dictionary for the program you specify, which enables you to run any cataloged program directly from TCL. You must have at least SYS1 privileges in order to use CATALOG.
Format
|
CATALOG filename progname option |
Parameter(s)
|
filename |
Name of the mvBASIC program file. This file often contains many mvBASIC programs, one program per file item. |
|
|
progname |
Item-ID of the program you want to catalog. |
|
|
option |
The following option is supported: |
|
|
(O |
his option allows the command to overwrite the Master Dictionary entry even if it is not currently a cataloged mvBASIC program pointer. |
|
Description
The program must be compiled before it can be cataloged. Once cataloged, however, the program can be recompiled without having to be recataloged.
Programs need not be cataloged. Subroutines, however, must be cataloged, otherwise the object code will be inaccessible. The dictionary file item created by cataloging the subroutine contains the frame ID of the subroutine’s object code.
Cataloging an mvBASIC Program
The following example creates a Command Definition item called ORDER-SUM in the Master Dictionary. The program ORDER-SUM resides in a file called PROGRAMS:
|
> CATALOG PROGRAMS ORDER-SUM [244] ’ORDER-SUM’ CATALOGED! |