Amanda Work Group 7xx Installation Manual

Chapter 11: Programming Amanda 159
%I() has three parameters: field, msg_no and mailbox.
Because the %I and parentheses are bold, you know that you have to include 
them in the command. The commas are bold, but the one in front of mailbox 
is inside brackets […], which surround optional parts of the syntax. If you 
use the bracketed part of the syntax, you must use the comma. 
Because field is italicized, you know that it is a place holder for information 
that you must provide. Field can be any one of...

160 Installing [email protected]
Because msg_no is also italicized, you know that it is a place holder for 
information that you must provide. For example, to find out the date for 
message number 8, you replace msg_no with the number 8. Because mailbox 
is inside brackets, you replace it only if you use that part of the syntax. For 
example, you may want to delete a message belonging to mailbox 151.
Whenever a parameter is optional, such as mailbox, it has a default. A default 
is the value that is used...

Chapter 11: Programming Amanda 161
When you use a DOS file name as a parameter, you must replace each 
backslash (\) found in the name with either two backslashes (\\) or one 
forward slash (/). For example, C:\AMANDA\FOOBAR.TXT must become 
either C:\\AMANDA\\FOOBAR.TXT or C:/AMANDA/FOOBAR.TXT.
You can use variable names as parts of the file name. For example, if %S1 is 
C:, and %S2 is Amanda, you can use %S1\\%S2\\FOOBAR.TXT.
Amanda can read text files (also called ASCII files) as well as files in...

162 Installing [email protected]
dBase files are created using dBase, a database software product. For dBase 
files, you tell Amanda the name of the field instead of its number. When 
Amanda reads data from a dBase file, she deletes any spaces at the end of the 
data as she stores the data into a variable. For example, if the field contains 
MARY             , Amanda reads only MARY.
Flow of Control: Branching and Looping
When programming Amanda, you often type the tokens for a program in 
more than one...

Chapter 11: Programming Amanda 163
A loop is the name given to a set of tokens that are repeated. For example, if 
the last token in the Extension field for mailbox 151 is G(151), Amanda 
returns to the beginning of the Extension field for mailbox 151. This forms a 
loop. It forms an infinite loop unless Amanda can branch to another 
mailbox’s Extension field before performing the G() command. Sometimes 
you want an infinite loop, but usually an I() command appears within the 
loop (somewhere between the...

164 Installing [email protected]
Examples
This section provides practical examples using some of the available tokens.
Customizing the Employee Directory
The default operation of the employee directory minimizes the work you 
have to do as a system administrator. All you have to do is put values in the 
Dir Name 1 and Dir Name 2 fields for each employee’s mailbox. A little 
extra work on your part can make it easier for the caller to use the employee 
directory. 
Application
This example explains how to...

Chapter 11: Programming Amanda 165
3. If more than one employee matches the digits, Amanda asks the caller to 
choose. 
For example, Amanda might say “For Steve Smith, press 1; for Stella 
Clark, press 2.”
4. Amanda dials the extension. 
Translating to Amanda’s Tokens
This example shows the use of the G() command, which stops Amanda from 
processing the current mailbox and goes directly to the specified mailbox. It 
also illustrates the M() command that causes Amanda to play a greeting and 
wait for a...

166 Installing [email protected]
Example:
Create mailboxes 783, 367, 562, 564, and 262.
4. For each of these mailboxes, make sure that:
Do Not Disturb is locked OFF. (Do Not Disturb: OFF Lock: ON)
Call screening is locked OFF. (Screen Calls? OFF Lock: ON)
5. Fill in the Extension fields for mailboxes that only match one of the 
employees with @G(employee_mailbox) 
Example:
Because 783 and 367 match Steve Forest, the Extension fields for mail-
box 783 and mailbox 367 should be:
@G(105)
Because 564 matches...

Chapter 11: Programming Amanda 167
Example:
Because 562 matches both JoAnn Johnson and Bob Knapp, the Menus 
for mailbox 562 would be:
1106
2107
The greeting would be:
“For JoAnn Johnson, press 1; for Bob Knapp, press 2.”
T
IPS:To make this better yet, use:
@P(G1)P(N,employee_mailbox)G(employee_m
ailbox)
instead of:
@G(employee_mailbox) 
Record a Greeting 1 for each of the new mailboxes that 
says “You are being transferred to” after which Amanda 
plays the Name and Extension recording for the employ-...

168 Installing [email protected]
Token Reference
This section contains two tables, each of which lists all of the tokens in the 
Token Programming Language: 
A quick token reference table, which lists each token by its func-
tion or purpose. The functions are in alphabetical order so that you 
can easily find all the tokens that perform similar functions. For ex-
ample, the J() and T() commands both deal with faxes so they are 
grouped under Fax. This table provides only the syntax for each to-
ken. For...