TMF Reference Manual (G06.24+)

Using TMFCOM
HP NonStop TMF Reference Manual—522418-002
2-6
Entering TMFCOM Commands
Entering TMFCOM Commands
As you enter TMFCOM commands, you can:
•
Include comments in command lines.
•
Continue a single command over multiple lines.
•
Enter multiple commands on a single line.
Including Comments in Command Lines
You can enter comments within a TMFCOM command line. The comment can
precede or follow the command, or can even be embedded within it. You begin the
comment with a pair of hyphens (- -) and terminate it with another pair of hyphens:
TMF 9> ADD DATAVOLS -- this is a comment -- $DATA1
When TMFCOM processes the command line, it ignores all text between the two sets
of hyphens.
Comments need not be terminated with a second set of hyphens if the rest of the line
can be ignored and the line is the last or only line of the command.
In the next example, the comment in the first command does not need a second set of
hyphens because the rest of the line can be ignored. The comment in the second
command, however, requires matching pairs of hyphens because the text following the
comment is part of the command and cannot be ignored:
TMF 11> ADD DATAVOLS $DATA2 -- a comment goes here
TMF 12> ADD -- another comment goes here -- DATAVOLS $DATA3
Caution. The previous version of TMFCOM, now named TMFCOM1, allowed some syntax
errors, usually spaces in file names. These syntax errors are detected by the latest version of
TMFCOM covered by this manual and may cause errors in OBEY FILES or TACL scripts. As
an example, the following file name syntax, including the spaces, was valid using the previous
version of TMCOM but results in an error using the current version:
\node .$volume . subvolume. filename.
Note. TMFCOM communicates with TMFSERVE through a buffer provided by the Subsystem
Programmatic Interface (SPI). This buffer will contain all the SPI tokens and data needed for
any particular command and is limited to 28672 characters (28 KB). If you enter a TMFCOM
command that requires more than 28672 characters of buffer space, TMFCOM displays Error
1050, alerting you to the excessive command length.
No line of command text can exceed 2048 characters, including comments and spaces, before
encountering a carriage return or a continuation character (&). For information about entering
command lines longer than 2048 characters, see Continuing Commands on Multiple Lines
.
The total length of all command text entered cannot exceed 28672 characters before
encountering a carriage return, as also discussed under Continuing Commands on Multiple
Lines.