Amanda Work Group 7xx Installation Manual

Chapter 11: Programming Amanda 179
Variables[(
file)
 
](
file)
 
|(
file)
 
+(
variable
[,
value
])
 
=(
variable,
value
[,
start,
end
])
 
%G0 %G1 %G2 %G3 %G4
%G5 %G6 %G7 %G8 %G9
%S0 %S1 %S2 %S3
%S4 %S5 %S6 %S7
%S8 %S9 %S10 %S11
%S12 %S13 %S14 %S15
%S16 %S17 %S18 %S19
Variables, shiftK

180 Installing [email protected]
Alphabetical Token Reference 
 Token SyntaxDescription
-Literal that pauses processing for .5 (one-half) second.
,
 Literal that pauses for 2 seconds. Used when dialing an extension or to introduce a 
pause before processing the next token.
N
OTE:
Be careful not to confuse this comma with the separator found in com-
mands and records.
?(
line,
file,
mailbox)
 Command that searches the specified file (line by line) for the specified line. The 
line must match an entire...

Chapter 11: Programming Amanda 181
 [(
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...

182 Installing [email protected]
\RReturn (Ctrl+M). Can be used in strings.
Failure:  Does not fail 
\T TAB (Ctrl+I). Can be used in strings.
Failure:  Does not fail 
](
file)
 Command that writes the values of the first 10 port variables (%S0–%S9) to the 
specified file. The values are comma-separated and terminated by a carriage return/
linefeed. Usually used in conjunction with the [() command which reads the %S 
variables. 
fileA string or variable containing a valid DOS file name for the text file...

Chapter 11: Programming Amanda 183
^(
volume_change)
 Command that changes the volume of the current port.
volume_changeAmount to increase or decrease the current volume. Use a 
positive number to increase the volume and a negative 
number to decrease the volume. Use the minus sign for 
negative numbers, but omit the plus sign for positive 
numbers. Amanda gives you a volume as close as possi-
ble to what you ask for. 
The volume on Brooktrout voice boards ranges from -8 
(softest) to +8 (loudest)....

184 Installing [email protected]
{
file}Command that reads Amanda tokens from an external file. This allows you to ex-
ceed the 65-character limit in the Extension and Notify Method fields. If the file 
does not exist, Amanda just goes on to the next token.
fileA string or variable containing a valid DOS file name. Use the com-
plete path to the file unless the file is in C:\AMANDA. The file must 
be a text file containing valid Amanda tokens. No line in the file 
should exceed 143 characters. There is...

Chapter 11: Programming Amanda 185
+(
variable
[,
value
])
 Command that allows you to add a number to or subtract a number from the value 
stored in a variable. Usually used to set limits and control programming loops. 
variableOne of port or global variables. 
valueOptional. A number or variable. The default is 1.
Example:
+(%S7,-1)
subtracts 1 from the value stored in %S7.
+(%G6)
adds 1 to the value stored in %G6
. 
Failure:  
Does not fail
() command. To fax multiple doc-
uments, you initiate the...

186 Installing [email protected]
=(
variable,
value
[,
start,
end
])
 Command that gives the specified variable the specified value. Use start and end 
to assign only part of the string (a substring) to the variable.
variableOne of the port or global variables.
valueA string, number, or variable.
startOptional. The starting character position to copy from value. The 
default is to copy the entire string.
endOptional, but must be used if start is used. The last character posi-
tion to copy from value....

Chapter 11: Programming Amanda 187
%ASystem variable containing the value of the fax_dl_init configuration setting. 
Example:
If %A is 9,, a 9 followed by a pause is needed to access an outside telephone line.
%B1 %B2
%B3 %B4
%B5 %B6System variable that contains the serial number of the corresponding voice board. 
%B1 is voice board 1, %B2 is voice board 2, etc.
%CSystem variable that contains the port number. Each port has its own %C. For ex-
ample, if the current caller is on Port 3, %C contains a 3....

188 Installing [email protected]
%F(
field
[,
mailbox
])
 System variable that contains the value of the specified field for the specified mail-
box. Each port has its own %F.
fieldOne of the following numbers or a variable containing that number:
1
for the Directory Name 1 field
2
for the Directory Name 2 field
3
for the Comment field (if your system uses Brooktrout voice 
boards) or for the Set Name field (if your system is connected 
to a Norstar KSU)
mailboxOptional. Any valid mailbox or a variable...