Each user has his own command vocabulary, based on command entries in the account’s Master Dictionary. The user’s vocabulary can be expanded or reduced by adding or deleting entries in the Master Dictionary. Users can create synonyms for existing commands by making a copy of the entry under a new name.
|
NOTE |
Be careful not to remove entries accidentally or modify the contents of any command entry. |
Each command has its own entry in the Master Dictionary. The format of these entries is similar for all commands, but it varies slightly according to whether the command is a TCL-I, TCL-II, or INFO/ACCESS command, or a cataloged BASIC program. It is not necessary to understand the format of command entries. New users may wish to skip the remaining material in this section.
All commands are identified by entries that have a P in Attribute 1. This letter can be followed by any letter except a Q (PQ indicates a Proc). All commands also define in Attribute 2 a main entry point for a processor. This entry point is the ABS location in hexadecimal of the code that will be executed. TCL-I commands only define Attributes 1 and 2, as shown in the table below.
|
Attribute |
Example |
Description |
|
0 |
TIME |
Item-ID: Unique identifier of command in Master Dictionary. |
|
1 |
PZ |
Identifier: P indicates a command. Optionally followed by a single character that is passed to the processor. |
|
2 |
3033 |
Processor’s Entry Point: Defines the entry point and ABS frame address to which TCL passes control. In this case, 3 is the entry point and 033 is the ABS frame address. |
TCL-II commands are entries that have a 2 in Attribute 2. The format of TCL-II commands is shown in the table below. Attribute 2 references code in ABS frame 2 that parses the command line, verifies the file name, and stores the location of the file in the process workspace. Once this has been done, control is transferred to the processor defined in Attribute 3. Some TCL-II commands also define a tertiary transfer point in Attribute 4 that is used as a branch routine by the processor. Attribute 5 contains a parameter string that is passed to the processor.
|
Attribute |
Example |
Description |
|
0 |
COPY |
Item-ID: Unique identifier of a command in Master Dictionary. |
|
1 |
PZ |
Identifier: P indicates a command. Optionally followed by a single character that is passed to the processor. |
|
2 |
2 |
File Processor Entry Point: Defines entry point (entry point 0 of Frame 2) for routine to parse command line for file and validate file name and item-ID. |
|
3 |
8C |
Secondary Transfer Point: Defines transfer point for processor to handle file and item now specified in workspace. |
|
4 |
Not Used. |
Tertiary Transfer Point: Defines routine to branch to by routine specified above. |
|
5 |
UZ |
Parameter String: These parameters determine how items are retrieved by TCL-I commands and passed to the processor defined in Attribute 3. |
|
C |
Copy item to process workspace. |
|
|
F |
Use file parameters only and ignore item list. |
|
|
N |
Creating new items is permitted. |
|
|
P |
Print item-ID if item list is * or if select-list is used. |
|
|
S |
Preserve select-list when single item-ID is specified. |
|
|
U |
Keep temporary item list if * is specified as item-list. |
|
|
Z |
Final entry required to the mode specified in Attribute 3 after all items have been processed. |
INFO/ACCESS commands are entries that contain 35 in Attribute 2. The format of INFO/ACCESS command entries is described in the table below. 35 references code in ABS frame hexadecimal 35 that parses the INFO/ACCESS command line. Attribute 3 defines the transfer point for an INFO/ACCESS processor routine.
|
Attribute |
Example |
Description |
|
0 |
LIST |
Item-ID: Unique identifier of a command in Master Dictionary. |
|
1 |
PA |
Identifier: P indicates a command. Optionally followed by a single character that is passed to the processor. |
|
2 |
35 |
Processor’s Entry Point: Defines entry point for routine to parse INFO/ACCESS command line. |
|
3 |
4D |
Secondary Transfer Point: Defines transfer point for the processor to handle file items now in workspace. |
Cataloged mvBASIC programs have entries in the Master Dictionary that reference the entry point of the mvBASIC Runtime Package and the name of the file containing a pointer to the location of the object code. The format of entries for cataloged programs is described in the table below.
|
Attribute |
Example |
Description |
|
0 |
FX |
Item-ID: Unique identifier of a command in Master Dictionary. |
|
1 |
P |
Identifier: P indicates a command. |
|
2 |
E6 |
Processor Entry Point: Defines entry point for mvBASIC Runtime Package. |
|
3 |
Not Used. |
|
|
4 |
Not Used. |
|
|
5 |
BASICLIB |
Program File: This is the name of the file, the dictionary of which contains a pointer to the object code. |
See Also