HP OpenVMS DCL Dictionary
Allows you to set a prefix control string for verified command lines.
SET [NO]PREFIX string
Specifies the FAO control string to be used in generating a prefix to a
verified command line. The following rules apply:
- No more than 64 characters are allowed in the control string.
- The resulting string can be no longer than 64 characters.
- Basic formatting FAO directives can be used ("!/", "!_", "!^",
"!!", "!%F", and "!n*c").
- Time and date FAO directives can be used ("!%T" and "!%D").
- Repeat counts can be used ("!n(DD)").
- Output field length specifications can be used ("!lengthDD").
- Combination of repeat count and output field length can be used
- FAO directives that require arguments will always receive a value
The SET PREFIX command allows you to prefix verified command lines with
a custom string. This string is a limited FAO control string that
specifies date and time information as well as constant information and
formatting controls (that is, tabs, form feeds, and so on). For
example, this allows you to use a full date and time prefix (a time
stamp) to identify batch runs and to verify that a batch job ran at the
See the documentation on the F$FAO lexical function for more
information about FAO control strings.
The first line of a verified command is prefixed with the result of the
control string. The control string is evaluated before the command
itself is executed. Any continuation lines are prefixed with a blank
string in order to make them flush with the first line of the command.
Command input and output are not prefixed. The prefix control string
can later be retrieved by using VERIFY_PREFIX with F$ENVIRONMENT.
$ SET VERIFY
$ SET DEFAULT SYS$LOGIN
$ SHOW DEFAULT
$ SET PREFIX "(!5%T) "
(17:52) $ SET DEFAULT SYS$LOGIN
(17:52) $ SHOW DEFAULT
This example demonstrates the difference between having and not having
a prefix for verification. The first command turns on verification.
(Verification must be turned on to see the prefix.) The second command
invokes a test procedure to show what the output looks like without a
prefix. The third and fourth lines reflect the contents of the test
procedure invoked in the preceding command. The third command sets the
prefix to an FAO control string so that the first five characters of
the standard time will be shown for each command. The last command
invokes the test procedure again to demonstrate what the output looks
like with a prefix.