Amanda Work Group Installation Manual

Chapter 16: Programming Examples 255
Translating to Amanda’s Tokens:
1. To ask the caller for an order number, use R(G1,%S1,20) where Greeting 
1 has the recording “Please enter the five-digit order number now.” 
After the caller enters the order number, Amanda can perform some 
additional checking. For example, to determine if a five-digit order 
number was entered, use 
I(LEN[%S1],!,5,
mailbox). If the number of 
digits stored in %S1 is not equal to 5, Amanda continues processing 
with mailbox...

256 Installing [email protected]
One-call and Two-call Faxbacks
You can use fax files and the token programming language to perform one-
call and two-call faxbacks. Most of this functionality is preconfigured for 
you inside Amanda using specific mailboxes.
A one-call faxback is a call from a fax machine so that a document can be 
faxed to the caller at that fax machine. Unless you have a toll-free telephone 
line, the faxing is at the caller’s expense.
A two-call faxback requires two calls. Someone...

Chapter 16: Programming Examples 257
If you decide to use a fax machine and a mailbox, the mailbox that performs 
these tasks must have:
Extension Field:@R(G1,%S1,30)J(“C:/FAX/
%S1”,””,”%X%FH”)G(999)
DND: OFF
Screen Calls: OFF
Store Messages: YES
Greeting  1: Please enter the number of the fax that you are sending 
new.
%S1 must not be used in any other application.
%X must be defined in 1001.PBX.
%F must be the extension that is physically connected to the fax modem 
and must be set in the install.cfg...

258 Installing [email protected]
Mailbox 92000 contains the menu. It should have the following settings and 
greetings:
Extension Field: blank
DND: ON
Store Messages: NO
Greeting 1: If you are calling from your fax machine, please press 
the number corresponding to the technical report you 
are interested in. For report #1 on SMDI, press 1. For 
report #2 on Service Plans, press 2. For report #3 on 
Upgrading Voice Boards, press 3.
Menu 1: 92001
Menu 2:  92002
Menu 3: 92003
Mailbox 92001’s Extension...

Chapter 16: Programming Examples 259
NOTE:All the quotation marks in these token examples are single 
quotation marks (although double quotation marks can be 
used). Forward slashes are used (although double back-
ward slashes \\ can also be used with this token).
Two-call Faxback
This example allows the caller to select one or more fax documents, and 
leave his fax number. The steps are as follows:
1. Request the fax area code (this is to determine whether or not to set up 
for long distance dialing)....

260 Installing [email protected]
Menu 2: 1000
Menu 3: 991
Mailbox 1001’s Extension field contains the tokens that determine whether 
or not the entered area code is local (assuming that the local area code is 
714). If the area code is not local, it stores the long distance dialing digit 1 in 
the variable %S0.
Extension Field:@I(%S1,=,714,1002)=(%S0,1)G(1003)
DND: OFF
Store Messages: NO
If the area code is local, mailbox 1002’s Extension field sets both the long 
distance dialing string and the area...

Chapter 16: Programming Examples 261
Mailbox 1004 contains a menu that lists the available documents. It should 
have the following settings and greetings:
Extension Field:@(C:/FAX/TECH1)G(1005)
DND: OFF
Store Messages: NO
Greeting 1: The technical report on SMDI will be faxed to you. 
Mailbox 10042’s Extension field contains the tokens that send technical 
report #2.
Extension Field:@P(G1)>(C:/FAX/TECH2)G(1005)
DND: OFF
Store Messages: NO
Greeting 1: The technical report on service plans will be faxed...

262 Installing [email protected]
Mailbox 1005 allows the caller to select another document to be faxed or to 
end the call (Menu 2 goes to 999). You might prefer to have Menu 2 return to 
the caller instructions mailbox 991.
Extension Field: blank
DND: ON
Store Messages: NO
Greeting 1: To request an additional document, press 1; to exit, 
press 2.
Menu 1: 1004
Menu 2:  999
N
OTE:All the quotation marks in these token examples are single 
quotation marks (although double quotation marks can be 
used)....

Chapter 16: Programming Examples 263
Making the User Comfortable
To make users feel that they are in control of the application rather than at 
the mercy of it, the greetings should perform the following tasks in order:
1. Identify the company or service so that the user can determine whether 
he has placed his call correctly.
2. Identify the application as non-human so that the user does not expect 
human interaction.
For example, avoid personal pronouns in phrases. Use “Please enter the 
number” rather...

264 Installing [email protected]
Using Menus
As you create your menus, do the following:
 Find logical topics for menus
 Offer topics in order:  most likely to be selected to least likely. Make 
an exception to this rule when the topic itself contains a number. 
For example, use “To order the Series 3, press 3” rather than “To order 
the Series 3, press 1”—even when your most popular sales item is Series 
3.
 Limit the number of options on each menu. If a menu contains more 
than eight options...