Amanda Work Place Instructions Manual

							Chapter 11: Programming Amanda 93
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]) 
Message count, total for mailbox%M
[(
mailbox)
]
P
[
repetition] (M
[,
mailbox])
Message count, new for current user%N
Message waiting indicators, creatingX
[(
file)
] 
Message waiting indicators, deletingY
[(
file)
] 
Message waiting indicators, testing forZ
[(
file)
]
Message waiting indicators, turning on 
and offKA(
on_off)
MoneyP
[
repetition](
amount,
currency) 
Name and extensionP
[
repetition](U
[,
mailbox]) 
P
[
repetition](N
[,
mailbox]) 
Notification record, Method field@
Notification record, Variable fieldP
[
repetition] (V)
%V
Notify, relay pagingP
[
repetition] (R)
%R
NumberP
[
repetition] (
number,N) 
P
[
repetition] (V) 
On-hookO(
time) 
PagerP
[
repetition] (R) 
%R
%V
Pager, wait forW(
n,P
[,
mailbox]) 
Partial supervised transferU-
ext_no
Pauses-
, 
Quick Token Reference (Continued)
Function/Purpose of TokenSyntax 
						

							94 Installing [email protected]
W(n)
PesosP
[
repetition](
amount,P) 
Playing, absolute valueP
[
repetition](
number,N)
Playing, currencyP
[
repetition](
amount,
currency) 
Playing, dateP
[
repetition](
date,D) 
Playing, disk spaceP
[
repetition](D) 
Playing, DTMF digitsP
[
repetition](R) 
P
[
repetition](
DTMF) 
Playing, greetingP
[
repetition](
greeting[,
mailbox]) 
Playing, menuM(
greeting[#
mailbox],
repetition,
delay) 
Playing, messagesP
[
repetition](M
n[,
mailbox]) 
Playing, moneyP
[
repetition](
amount,
currency) 
Playing, name and extensionP
[
repetition](N
[,
mailbox]) 
P
[
repetition](U
[,
mailbox]) 
Playing, numberP
[
repetition](
number,N) 
Playing, number of messagesP
[
repetition](M
[,
mailbox]) 
Playing, promptP
[
repetition](
prompt_no,V) 
Playing, spellingP
[
repetition](A,
string) 
Playing, timeP
[
repetition](
time,T) 
Playing, Variable fieldP
[
repetition](V) 
Playing, voice fileP
[
repetition](X,
file) 
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)
L(
file) 
Quick Token Reference (Continued)
Function/Purpose of TokenSyntax 
						

							Chapter 11: Programming Amanda 95
Pulse dial~
Questions and answersQ(
{
greeting[#
mailbox][,E
]}) 
Read, file{
file}
N(
file,
field,
value{,
field,
variable})
V(
file,
field,
value{,
field,
variable})
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]) 
Search, file?(
line,
file,
mailbox)
N(
file,
field,
value{,
field,
variable})
V(
file,
field,
value{,
field,
variable})
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) 
String, searchKI(
target,
source,
variable) 
Strings, lengthLEN[
string] 
Subtract+(
variable[,
value]) 
Testing for message notification fileZ
[(
file)
] 
Quick Token Reference (Continued)
Function/Purpose of TokenSyntax 
						

							96 Installing [email protected]
Time%I(
field,
msg_no[,
mailbox])
P
[
repetition](
time,T) 
Time, connect time%T
Time, current%Z
Timed break recall~
Tokens, processing@
To n e s01 2 3
45 6 7
89 A B
CD * #
Total messagesP
[
repetition] (M
[,
mailbox]) 
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])
Mailbox, previous%P
Mailbox, total message count%M
[(
mailbox)
]
Mailbox, value of field%F(
field [,
mailbox])
Variable fieldP
[
repetition](V) 
%V
Quick Token Reference (Continued)
Function/Purpose of TokenSyntax 
						

							Chapter 11: Programming Amanda 97
Va r i a b l e s[(
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
						

							98 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.
NOTE:
Be careful not to confuse this comma with the separator found in commands 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 continues 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
@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 util-
ity.
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. 
						

							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.
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.
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 
\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 
Alphabetical Token Reference (Continued) 
 Token SyntaxDescription 
						

							100 Installing [email protected]
](
file) Command that writes the values of the first 10 port variables (%S0–%S9) to the speci-
fied 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 written 
to. Use the complete path to the file unless the file is in C:\AMANDA.
Example:
See the [() command. 
Failure:  
The file is read-only
Insufficient disk space to save file
^(
volume_change)
 Command that changes the volume of the current port.
volume_changeAmount to increase or decrease the current volume. Use a positive num-
ber to increase the volume and a negative number to decrease the vol-
ume. Use the minus sign for negative numbers, but omit the plus sign for 
positive numbers. Amanda gives you a volume as close as possible to 
what you ask for. 
The volume ranges from 1 (the softest) to 9 (the loudest). Initially, the 
volume is set to 5, but that is not necessarily its current value. If the vol-
ume 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
{
file}Command that reads Amanda tokens from an external file. This allows you to exceed 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 complete 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 ter-
minated by a carriage return/linefeed.
fileA string or variable containing a valid DOS file name for a text file. Use the com-
plete 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
Alphabetical Token Reference (Continued) 
 Token SyntaxDescription 
						

							Chapter 11: Programming Amanda 101
~Literal that pulse dials the digit 1 to effect a timed break recall.
+(
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 documents, 
you initiate the process with this command and, as the caller requests faxes, 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 dialed. 
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 pausing). 
Then Amanda faxes two files. Duplicate files are ignored.
Failure:  
Does not fail
=(
variable,
value
[,
start,
end]) Command that gives the specified variable the specified value. Use start and end to as-
sign 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 position 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. 
Alphabetical Token Reference (Continued) 
 Token SyntaxDescription 
						

							102 Installing [email protected]
>(
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 trans-
mitted. 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