The Programmer's Guide to TRSDOS Version 6 - Tim Mann's Home ...

CONTROL
Bit 7 Set if numeric values are to be accepted.
Bit 6 Set if switch values are to be accepted.
Bit 5 Set if string values are to be accepted.
Bit 4 Set if the first character of NAME is accepted as an abbreviation for
the parameter.
Bits 0-3 Contain the length of the NAME field (1-15).
NAME
Contains the parameter name used to reference the parameter on the command line.
This field must be in upper case.
RESPONSE
VECTOR
Bits 7-5 Are set by @PARAM as appropriate to the type of entry made by the
user.
Bits 0-4 Contain the length of the string entry if a string was entered. A
length of 0 is indicative of either a NULL string or a string longer
than 31 characters. This can be differentiated by testing the first
character of the string. If a double quote ("), then a NULL string
was entered. Any other character indicates a string longer than 31
characters which will be terminated by a (").
This word is a pointer to the memory location that will receive the parsed value.
It is filled in the same manner as that identified in the first format.
Note: Caution is to be observed in the proper use of the enhanced mode when you
have something like the following: ON and ONLY in the table; if ON islisted first,
then ON, ONx, ONxx, etc will match. This is because the parsing stops as soon as
the length of the table entry has been reached. Alternatives are to add an
appending space to the table entry, or order the table ONLY followed by ON.
See Chapter 8, the Appendix, USING THE SYSTEM PARAMETER SCANNER, for detailed
information. The @PARAM protocol is as follows:
Registers Affected: AF, BC, HL.
Entry:
DE A pointer to the beginning of your parameter table.
HL A pointer to the command line to parse.
Exit:
HL Returns pointing to the terminating character.
Z Set if either no parameters found or valid parameters.
NZ If a bad parameter was found.
A Effective with 6.2.0, contains error code 44 on NZ return.
7.6.59 @PAUSE SVC-16
This SVC will suspend program execution and go into a "wait" state for a period of time
determined by your count. The delay is approximately 15 microseconds per count regardless
of the system FAST/SLOW option.
7-31