Amanda Work Group Manual

Chapter 9: Miscellaneous111
To have different company greetings:
 In the Per Port Settings of the Setup utility, change the mailbox for the company 
greeting on a per port basis. 
The Setup utility’s basic operation is explained in “Logging On to Amanda” on 
page 5.
Suppose the first company uses ports 1 and 2, and the second company uses ports 3 
and 4. Then box_grt for ports 1 and 2 might be set to mailbox 990, while box_grt for 
ports 3 and 4 might be set to mailbox 880.
Per port settings are stored...

112 Installing [email protected]/Windows
Per port settings are stored in the install.cfg file.
To use different mailboxes for direct messaging:
 In the Per Port Settings of the Setup utility, change the mailbox for the direct mes-
saging on a per port basis.
For example, box_snd for ports 1 and 2 might be set to mailbox 998, while box_grt 
for ports 3 and 4 might be set to mailbox 888.
Per port settings are stored in the install.cfg file. 

Chapter 9: Miscellaneous11 3
If two departments share an Amanda system, you might use the default mailboxes for one 
department and create another set for the other department. If you intend to use the 
defaults, don’t overwrite these mailboxes when you create new mailboxes for employees. 
For more information about default mailboxes, see “Using Default and Recommended 
Mailboxes” on page 53.
Queuing Unanswered and Busy Calls
In certain environments (such as Automatic Call Distributors—ACDs), a...

114 Installing [email protected]/Windows 

Chapter 10:
Programming Amanda
Using Tokens
The Token Programming Language allows you to write programs for Amanda. These 
programs consist of tokens entered in Extension fields (defined per mailbox using 
Amanda Administrator’s Mailbox window) and/or in Method fields (defined per mailbox 
using Amanda Administrator’s Notify window). This section describes the language and 
introduces you to common programming terms. Understanding these terms can help you 
understand any programming language.
A token is...

116 Installing [email protected]/Windows
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.
When most people think of a program, they think of a series of lines, each of which 
contains a single action or command. The Token Programming Language is similar, but 
each line become the contents of a different field, using the Extension field of a mailbox.
If the program contains only a few lines, sometimes...

Chapter 10: Programming Amanda 117
Tracing Token Execution
Amanda’s trace files can let you know where and how a token program is failing. This is 
an invaluable debugging tool. 
Amanda creates trace files as the system runs, because the following trace command 
should be in the AUTOEXEC.BAT file.
amanda /t5 /s1300
Like the default trace command, this command creates C:\AMANDA\TRACE.OUT file 
and limits its size to the last 1.3MB of data. (A file this size will fit on a 3 1/2-inch floppy 
disk.) What is...

118 Installing [email protected]/Windows
A string that has no characters is called the empty string. It often occurs in programming 
and is written as  or .
If you use one kind of quotation mark within a string, you should use the other kind as the 
string’s delimiters: Amandas or Do not use  (the double quotation character).
Any string can contain the following special characters:
\A Attention, which is a bell sound (Ctrl+G)
\B Start of transmission (STX; Ctrl+B)
\D End of transmission (Ctrl+D)
\N...

Chapter 10: Programming Amanda 119
Initially, each port and global variable has the empty string as its value. Assignment is 
done in the Token Programming Language using the assignment command, which starts 
with the equal sign (=). When the variable contains a number, you can add to that number 
or subtract from it using the command that starts with a plus sign (+).
For example, =(%S1,24) puts the number 24 in the variable named %S1. 
+(%S1,15) adds 15 to the 24 in %S1 and then stores the sum 39 in...

120 Installing [email protected]/Windows
When a command is referred to by name in this guide, the parentheses appear after the 
command’s name. For example, the command named P is referred to as the P() command, 
which is read as “the P command.”
Parameters
Parameters can be required or optional. The syntax places brackets […] around optional 
parameters.
Parameters can also be for input or for output. Input parameters provide the information 
that Amanda needs in order to perform the action that you...