VOC V-Type Records - Verbs

A V type (verb) record defines a command name and determines the QM component that will be used to process the command.

1:	V { descriptive text }

2:	Dispatch code

Processor

4:	{ Qualifying information }

5:	{ Security subroutine }

6:	{ Parenthetical option letters }

7:	{ Parenthetical option keywords }

The dispatch code identifies the type of processor referenced by field 3. It may be:

CA	A catalogued verb. Field 3 holds the catalogue name of the function to be executed. For system supplied verbs, field 4 may also be significant and should not be altered.

CS	A locally catalogued function program. This format allows a QMBasic program to CALL a function that is in the compiler output file rather than in the catalogue.

IN	An internal verb. Field 3 holds an identifying number which determines the action of the verb.

OS	An operating system command. QM will execute an operating system command made up from the contents of field 3 of the VOC record (which may be null) followed by the remainder of the current sentence after the verb.

Users may add their own V-type records for catalogued programs (usually by use of the CATALOGUE command) or make copies of standard records to provide synonyms for other verbs.

The optional qualifying information in field 4 will be copied to the @OPTION variable when executing the verb.

A V-type VOC record can optionally hold the name of a catalogued security subroutine in field 5. This subroutine can be used to determine whether the user is to be allowed to execute the command. If the validation fails or the subroutine cannot be found in the catalogue a message is displayed:

This command is restricted (verb)

Fields 6 and 7 allow implementation of Pick style parenthetical options. Field 6 is a multivalued list of option letters and field 7 is a corresponding multivalued list of the equivalent QM keywords. When the verb is encountered by the command processor, the parenthetical options are replaced by the corresponding keywords.

A summary of V-type VOC records may be displayed or printed using LISTV.