Amanda Amanda@Work.Place Version 3.xx, Installer'S Manual

Page: 107 / 206

Chapter 11: Programming Amanda 99
[(file)
Command that reads the first line in the specified file as the first ten port variables (%S0-
%S9). The 10 values in the file must be comma delimited. The first value is %S0, the
second is %S1, etc. The quotation marks used to delimit strings do not appear in the file,
but the commas that separate them from the other variables do. For example, empty
strings take up no space in the file.
This command is usually used with the ]() command to keep track of what the port is
doing. You read the variables using the [() command, update them, and then write them
to the file once more using the ]() command.
Read with the [() command and write with the ]() command within the same field to
avoid potential simultaneous access errors caused by another port accessing the file.
If the file does not exist, Amanda just goes on to the next token.
file A string or variable containing a valid DOS file name for the text file to be read. No
line in the file should exceed 143 characters. There is no limit to the number of
lines.
Example:
[(C:\\AMANDA\\FOOBAR.TXT)
places the following line in FOOBAR.TXT
,,,10,,,,5,9,555
In this case %S0, %S1, %S2, %S4, %S5, and %S6 were empty strings.
To count the number of calls, etc. processed by a particular port (or all ports), read the
variables, add 1 to the contents of the one that stores the count, and write the variables
back to the file.
[(C:\\AMANDA\\FOOBAR.TXT)+(%S4)]
(C:\\AMANDA\\FOOBAR.TXT)
If you are counting all ports, use the same file for all ports. If you are counting per port,
use a different file for each port.
Failure: Does not fail
\\ Backslash, the actual "\" character. Can be used in strings.
Failure: Does not fail
\A
Attention, which is a bell sound (Ctrl+G). Can be used in strings.
Failure: Does not fail
\B Ctrl+B. Added for Ericsson MD-110 serial integration. For the MD-110, Ctrl+B is the
Start of Transmission (STX) character. Can be used in strings.
Example:
@S(3,"\B06%Emm\N")
which controls message waiting indicators.
Failure: Does not fail
\N Newline (Ctrl+J).
Can be used in strings.
Failure: Does not fail
\R Return (Ctrl+M).
Can be used in strings.
Failure: Does not fail
\T T
AB
(Ctrl+I).
Can be used in strings.
Failure: Does not fail
Alphabetical Token Reference (Continued)
Token Syntax Description