Amanda Work Group Installation Manual

							Chapter 15: Programming Amanda 209
\BCtrl+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 
\NNewline (Ctrl+J). Can be used in strings.
Failure:  Does not fail 
\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 
to be read. No line in the file should exceed 143 characters. There is 
no limit to the number of lines. When you specify a file name, its full 
path is required unless the file is stored in the directory for the cur-
rent mailbox. For example, if you use ](file) with only a file name, 
and the mailbox number is 101, your file must be located in the 
C:\VMB.DB\1\101 directory or the file cannot be found.
Example:
See the [() command. 
Failure:  
The file is read-only
Insufficient disk space to save file
Alphabetical Token Reference (Continued) 
 Token SyntaxDescription 
						

							210 Installing [email protected]
^(
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 Rhetorex voice boards ranges from -8 
(softest) to +8 (loudest). Initially, the volume is set to 0, 
but that is not necessarily its current value. If the value is 
+8 and you apply a change of -16, the volume’s value 
goes to -8. If the value is 0 and you apply a change of -16, 
the value of the volume goes to -8 and an error appears in 
the trace file.
For tAA voice boards, the volume ranges from 1 (the soft-
est) to 9 (the loudest). Initially, the volume is set to 5, but 
that is not necessarily its current value. If the volume is 5, 
and you apply a change of 4, the volume goes to 9. If you 
apply a change of 6, the volume goes to 9 and Amanda 
ignores the fact that you asked for more volume than was 
available.
Example:
^(8)
raises the volume of the port to its loudest.
Failure:  
Does not fail
Alphabetical Token Reference (Continued) 
 Token SyntaxDescription 
						

							Chapter 15: Programming Amanda 211
{
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 no limit to the number of 
lines in the file.
N
OTE Since the entire file is read and since white space is ignored, you can 
make the file easier to read by putting one token per line. (White space is 
tabs, spaces, and carriage return/linefeeds.)
Example:
{C:\\AMANDA\\RELAY.TXT}
causes Amanda to process the tokens in RELAY.TXT.
Failure:  
Does not fail
The failure of any token within the file causes the rest of the file to be ignored. 
Then Amanda executes the token after the {} token or the RNA chain if there 
is no token after the {} token.
|(
file)
 Command that appends the first ten %S port variables (%S0–%S9) to the specified 
file. If the file does not exist, Amanda creates it. The values are comma-separated 
and terminated by a carriage return/linefeed.
fileA string or variable containing a valid DOS file name for a text file. 
Use the complete path to the file unless the file is in C:\AMANDA.
Example:
|(C:\\AMANDA\\PORTVARS.TXT)
causes Amanda to add a line to PORTVARS.TXT. You can use this to add a line 
to PORTVARS.TXT every time the port you are tracing changes the value of a 
variable. Later you can review the file.
Failure:  
The file is read-only
Insufficient disk space to save file
~Literal that pulse dials the digit 1 to effect a timed break recall.
Alphabetical Token Reference (Continued) 
 Token SyntaxDescription 
						

							212 Installing [email protected]
+(
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 process with this command and, as the caller requests fax-
es, you add the file for the requested document using the >() command. The fax is 
sent automatically after the caller hangs up.
phone_noString, number, or variable containing the DTMF digits to be di-
aled. 
This command is used only in Extension fields.
Example:
(C:\\AMANDA\\PRICES.TXT)>
(C:\\AMANDA\\OPTIONS.TXT)>(C:\\AMANDA\\OPTIONS.TXT)
causes Amanda to call (714)452–5570 (after dialing 9 for an outside line and paus-
ing). Then Amanda faxes two files. Duplicate files are ignored.
Failure:  
Does not fail
Alphabetical Token Reference (Continued) 
 Token SyntaxDescription 
						

							Chapter 15: Programming Amanda 213
=(
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.
Examples:
=(%S1,FRENCH)Gives %S1 the value of FRENCH=(%S1,FRENCH,3,4)Gives %S1 the value of EN. 
If %S2 is the telephone number 7530414,
=(%S1,%S2,1,3)extracts the prefix 753 from %S2 and assigns it to %S1
If %S3 is 1 and S4 is 1, 
=(%S1,MARY,%S3,%S4)
 %S1 is assigned M. 
>(
file)
 Before using this command, you start incremental faxing with the () command more than once (per incremental 
fax), it is faxed only once.
fileA string or variable containing a valid DOS file name for the text file 
to be transmitted. Use the complete path to the file unless the file is 
in C:\AMANDA.
This command is used only in Extension fields.
Example:
See the 
						

							214 Installing [email protected]
%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.
%DSystem variable that contains the percentage of free disk space. Example:
I(%D,
						

							Chapter 15: Programming Amanda 215
%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 Rhetorex voice 
boards) or for the Set Name field (if your system is connected 
to a Norstar KSU)
mailboxOptional. Any valid mailbox or a variable containing a mailbox. The 
default is the current mailbox.
Example:
%F(3,126)
assigns the string from the Comment or Set Name field for mailbox 126 to %F.
Failure:  
Invalid mailbox
FLiteral that performs a hookflash. The duration of the hookflash is specified in the 
telephone switching system dial codes section of the Setup utility. See also recall. 
Failure:  
Does not fail
%G0 %G1
%G2 %G3
%G4 %G5
%G6 %G7
%G8 %G9The Amanda system has 10 global variables (%G0–%G9). Initially, each variable 
is equal to the empty string. The values of %G0–%G9 are the same no matter what 
port is current. 
If Port 1 changes %G1, then all other ports immediately see the new value for %G1. 
Each variable can contain a string of up to 143 characters.
When the system is shut down, the values of %G0–%G9 are lost. They cannot be 
stored using the [(), ](), or |() commands.
See also %S0–%S9.
Example:
+(%G0)
adds one to the current value of %G0.
=(%G2,555)
assigns the mailbox 555 to %G2.
G(%G2)
causes Amanda to go to the Extension field for mailbox 555.
Failure:  
Invalid variable name (such as %G52)
Alphabetical Token Reference (Continued) 
 Token SyntaxDescription 
						

							216 Installing [email protected]
G(
mailbox)
 Command that controls processing. Amanda continues standard processing at the 
specified mailbox’s Extension field (as shown in Administering Aman-
[email protected]). 
mailboxA valid mailbox or a variable containing a mailbox. 
N
OTE:
If you use the G() command in a Notify Method field, remember that the 
telephone port is still in Notify mode and cannot transfer a call. There-
fore, the Extension field that you go to should start with an @.
Example:
G(176)
causes Amanda to go to the Extension field for mailbox 176.
Failure:  
Invalid mailbox
%HSystem variable that contains the empty string unless your 1001.PBX file (in the 
C:\PBX.DB directory) is set up for ANI or (in the future) Caller ID digits. Each port 
has its own %H.
Example:
If 1001.PBX contains:
integration 10 Cxxxxxxxccccccc
and the packet C00000007530414 arrives, %H contains the number 7530414 as 
long as the port that received the call is active.
[
ext_no]HCommand that performs a hang-up. With an extension number, it performs an un-
supervised  transfer before hanging up. This H() command ends the processing of 
tokens for the current Extension or Notify Method field.
If you use an unsupervised transfer in the mailbox’s Extension field, make sure that 
Call Screening is locked off. If Call Screening is on for an supervised call, the caller 
is screened but that recording is not played to the user.
ext_noSeries of DTMF digits that indicate an extension number.
Example:
151H
causes Amanda to transfer the call to extension 151 and hang up (without wait-
ing for a voice or busy signal) when Amanda is processing a call.
Failure:  
Invalid extension number
Alphabetical Token Reference (Continued) 
 Token SyntaxDescription 
						

							Chapter 15: Programming Amanda 217
H(
mailbox)
 Command that performs exit routines when a caller hangs up. It specifies the mail-
box to be processed if a hang-up condition is detected while processing the current 
set of tokens. (Processing these tokens can take Amanda to more than one mail-
box.)
mailboxA valid mailbox or a variable containing a mailbox.
This command is used only in Extension fields.
Example:
H(614)
causes Amanda to go to mailbox 614 when a caller hangs up. Because you are 
tracking the number of hang ups, the Extension field for mailbox 614 has tokens 
that add one to the variable with which you are counting the hang-ups, for example, 
+(%G4)
.
Failure:  
Invalid mailbox
Alphabetical Token Reference (Continued) 
 Token SyntaxDescription 
						

							218 Installing [email protected]
%I(
field,
msg_no
[,
mailbox])
 System variable that contains the data from the specified field of the specified mes-
sage. Each port has its own %I. This lets you extract specific information from a 
message. For example, you might use %I in  a notification record.
fieldOne of the following:
D
for the Date field
T
for the Time field
F
for the From field
msg_noThe number of an existing message. You cannot use a variable con-
taining that number.
mailboxOptional. Any valid mailbox or a variable containing a mailbox. The 
default is the current mailbox.
N
OTE:
If a message is from an outside caller, the From field of that message is 
equal to -1. If the message is from a caller who is logged on to Amanda, 
the From field contains the caller’s mailbox.
Examples:
P(%I(D,5),D)plays the date of message 5 in the current mailbox.P(%I(T,5),T)plays the time of message 5 in the current mailbox.P(%I(D,5,212),D)plays the date of message 5 of mailbox 212.P(%I(F,5,212),U)plays the Name/Extension recording of the mailbox who sent message 5 of mailbox 
212.
See the P() command for more information.
Failure:  
Invalid mailbox
Invalid message number
Alphabetical Token Reference (Continued) 
 Token SyntaxDescription