Amanda Work Group Installation Manual

							Chapter 15: Programming Amanda 199
IfI(
value,
operator,
value,
mailbox)
 
Import, file{
file}
Information mailboxesM(
greeting[#
mailbox],
repetition,
delay)
 
IVR%I(
field,
msg_no [,
mailbox])
 
Languages, changeL(
file)
 
LengthLEN[
string]
 
Letters and spacesP
[
repetition](A,
string[,
hangup])
 
LIGHT.ON
See also message waiting indicators.
X
[(
file)
]
 
Y
[(
file)
]
 
Z
[(
file)
]
 
MenuM(
greeting[#
mailbox],
repetition,
delay)
 
Messages%I(
field,
msg_no[,
mailbox])
Messages, by numberP
[
repetition](M
n[,
mailbox[,
hangup]])
 
Messages, deleteKD(
msg_no[,
mailbox])
 
Messages, from recordingsKR(
file_or_box[,
recording_info])
Messages, number%M
[(
mailbox)
]
 
Messages, number of new%N
Messages, record and send to mailing 
listKJ(
mailbox,
list_number[,
sender])
Messages, totalP
[
repetition](M
[,
mailbox[,
hangup]])
 
Message count, total for mailbox%M
[(
mailbox)
]
P
[
repetition] (M
[,
mailbox[,
hangup]])
Quick Token Reference (Continued)
Function/Purpose of TokenSyntax 
						

							200 Installing [email protected]
Message count, new for current user%N
Message waiting indicator, creatingX
[(
file)
]
 
Message waiting indicator, deletingY
[(
file)
]
 
Message waiting indicator, testing forZ
[(
file)
]
Message waiting indicators, on/offKA(
on_off)
MoneyP
[
repetition](
amount,
currency[,
hangup])
 
Name and extensionP
[
repetition](U
[,
mailbox[,
hangup]])
 
P
[
repetition](N
[,
mailbox[,
hangup]])
 
Notification record, Method field@
Notification record, Variable fieldP
[
repetition] (V)
%V
Notify, relay pagingP
[
repetition] (R)
%R
NumberP
[
repetition] (
number,N
[,
hangup])
 
P
[
repetition] (V)
 
On-hookO(
time)
 
PagerP
[
repetition] (R)
 
%R
%V
Pager, wait forW(
n,P
[,
mailbox[,
hangup]])
 
Partial supervised transferU-
ext_no
Quick Token Reference (Continued)
Function/Purpose of TokenSyntax 
						

							Chapter 15: Programming Amanda 201
Pauses-
,
 
W
(n)
PesosP
[
repetition](
amount,P
[,
hangup])
 
Playing, absolute valueP
[
repetition](
number,N
[,
hangup])
Playing, currencyP
[
repetition](
amount,
currency[,
hangup])
 
Playing, dateP
[
repetition](
date,D
[,
hangup])
 
Playing, disk spaceP
[
repetition](D)
 
Playing, DTMF digitsP
[
repetition](R)
 
P
[
repetition](
DTMF)
 
Playing, greetingP
[
repetition](
greeting[,
mailbox[,
hangup]])
 
Playing, menuM(
greeting[#
mailbox],
repetition,
delay)
 
Playing, messagesP
[
repetition](M
n[,
mailbox[,
hangup]])
 
Playing, moneyP
[
repetition](
amount,
currency[,
hangup])
 
Playing, name and extensionP
[
repetition](N
[,
mailbox[,
hangup]])
 
P
[
repetition](U
[,
mailbox[,
hangup]])
 
Playing, numberP
[
repetition](
number,N
[,
hangup])
 
Playing, number of messagesP
[
repetition](M
[,
mailbox[,
hangup]])
 
Playing, promptP
[
repetition](
prompt_no,V
[,
hangup])
 
Playing, spellingP
[
repetition](A,
string[,
hangup])
 
Playing, timeP
[
repetition](
time,T
[,
hangup])
 
Playing, Variable fieldP
[
repetition](V)
 
Quick Token Reference (Continued)
Function/Purpose of TokenSyntax 
						

							202 Installing [email protected]
Playing, voice fileP
[
repetition](X,
file[,
hangup])
 
PortsS(
port,
[
string,
[
variable],
[
termination],
[
length],
[
timeout])
 
Ports, change volume^(
volume_change)
 
Port, current connect time%T
Port number, current%C
Port, transfer code for current%X
Previous mailbox%P
PromptP
[
repetition] (
prompt_no,V
[,
hangup])
L(
file)
 
Pulse dial~
Questions and answersQ(
{
greeting[#
mailbox][,E
]})
 
Read, file{
file}
N(
file,
field,
value{,
field,
variable})
V(
file,
field,
value{,
field,
variable}[,
n]
Recordings, stored as messages or filesKR(
file_or_box[,
recording_info])
Records, deleteKV(
file,
field,
value)
 
Remote computersS(
port,
[
string,
[
variable],
[
termination],
[
length],
[
timeout])
 
Rings, wait for number ofW(
n,
event [,
mailbox])
 
Rotary trainingKT(G
n)
Quick Token Reference (Continued)
Function/Purpose of TokenSyntax 
						

							Chapter 15: Programming Amanda 203
Search, file?(
line,
file,
mailbox)
N(
file,
field,
value{,
field,
variable})
V(
file,
field,
value{,
field,
variable}[,
n]
KV(
file,
field,
value)
 
Search, stringKI(
target,
source,
variable)
 
Security codeKC(
mailbox,
variable)
 
KL(
mailbox,
security_code)
 
KP(
mailbox,
security_code)
 
Serial port accessS(
port,
[
string,
[
variable],
[
termination],
[
length],
[
timeout])
 
Set Name%F(
field[,
mailbox])
 
ShutdownKS
[(
errorlevel)
]
 
Sound volume, change^(
volume_change)
 
Space%D
P
[
repetition](D)
 
SpellP
[
repetition](A,
string[,
hangup])
 
String, searchKI(
target,
source,
variable)
 
Strings, lengthLEN[
string]
 
Subtract+(
variable[,
value])
 
Testing for message notification fileZ
[(
file)
]
 
Time%I(
field,
msg_no[,
mailbox])
P
[
repetition](
time,T
[,
hangup])
 
Quick Token Reference (Continued)
Function/Purpose of TokenSyntax 
						

							204 Installing [email protected]
Time, connect time%T
Time, current%Z
Timed break recall~
Tokens, processing@
Tones012
345
678
9AB
CD*#
Total messagesP
[
repetition] (M
[,
mailbox[,
hangup]])
 
Transfer code for current port%X
Transfer, unsupervised (blind)[
ext_no]H
Transfer, supervisedext_no
ext_noKM
Transferring to specified mailboxG(
mailbox)
 
Mailbox accessKC(
mailbox,
variable)
 
KL(
mailbox,
security_code)
  
KP(
mailbox,
security_code)
 
Mailbox, current%U
Mailbox, Extension field of current%E
Mailbox, new message count%N
Mailbox, playing Name/Extension record-
ingP
[
repetition] (U
[,
mailbox[,
hangup]])
Mailbox, previous%P
Quick Token Reference (Continued)
Function/Purpose of TokenSyntax 
						

							Chapter 15: Programming Amanda 205
Mailbox, total message count%M
[(
mailbox)
]
Mailbox, value of field%F(
field [,
mailbox])
Variable fieldP
[
repetition](V)
 
%V
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
						

							206 Installing [email protected]
Weekday%W
Write, file](
file)
N(
file,
field,
value{,
field,
variable})
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 line within the file. If the line is found, processing con-
tinues at the specified mailbox. If the line is not found, processing continues with 
the next token. 
lineThe string or variable to be matched as a line in the file. No line in 
the file should exceed 143 characters.
fileA string or variable containing a valid DOS file name for the text file 
to be searched. Use the complete path to the file unless the file is in 
C:\AMANDA. There is no limit to the number of lines in the file.
mailboxA valid mailbox or a variable containing a mailbox. 
Example:
?(%S9,C:\\AMANDA\\FOOBAR.TXT,247)
causes Amanda to search FOOBAR.TXT for a line that matches the characters in 
%S9. If a line is found, Amanda continues processing at mailbox 247.
Failure:  
Invalid mailbox
Quick Token Reference (Continued)
Function/Purpose of TokenSyntax 
						

							Chapter 15: Programming Amanda 207
@Literal that causes Amanda to process the Extension or Notify Method field as a set 
of tokens instead of processing the field normally. 
Normal processing for the Extension field:
 Amanda plays “Please hold while I 
try that extension,” puts the caller on transfer hold, then evaluates the tokens in the 
field. The @ stops Amanda from performing the dial code that puts a caller on 
transfer hold (also known as the dl_dtwait dial code). As explained in Installing 
[email protected], you use the Setup utility (selection 1) to set or view the dial 
codes. The codes are stored in C:\AMANDA\PBX.DB\1001.PBX, which you can 
view or edit using the JOVE utility.
Normal processing of the Notify Method field:
 Amanda tries to access a port for 
an outbound notification call. The @ stops Amanda from going off-hook.
Alphabetical Token Reference (Continued) 
 Token SyntaxDescription 
						

							208 Installing [email protected]
 [(
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.
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:
[(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 
\AAttention, which is a bell sound (Ctrl+G). Can be used in strings.
Failure:  Does not fail 
Alphabetical Token Reference (Continued) 
 Token SyntaxDescription