Amanda Work Group Manual

Chapter 11: Programming Examples 171
Using Amanda’s Tokens
This could be accomplished with tokens as follows:
1. To remember that a specific language was selected, we could use a storage (variable) 
token such as %S1 to have a value that represents the language. To assign %S1 a 
value, we use the =() token. For example,
 =(%S1,MEXICAN) stores the value 
MEXICAN into %S1.
2. To determine which language Instruction mailbox to access, we could use the I() 
token, often called the If token, which allows...

172 Installing [email protected]/Windows
3. If the order has not shipped, inform the caller. Otherwise, tell the caller the date the 
order was shipped.
In order for Amanda to determine an order’s shipped status and its ship date, the system 
needs to retrieve information from some source. One possible way the system can obtain 
the data is by using the serial, S(), token to request it from another computer. An 
alternative solution is to access the information by looking in a file on Amanda’s hard disk...

Chapter 11: Programming Examples 173
Summary
To summarize the above, the mailbox settings and tokens are as follows:
Allowing 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...

174 Installing [email protected]/Windows
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 file, the file controlled by the Setup utility.
Do not enter more than eight digits in response to this greeting (because of DOS nam-
ing conventions). The number you enter becomes the name...

Chapter 11: Programming Examples 175
DND: OFF
Store Messages: NO
Greeting 1: Please press the start button on your fax machine at the tone. 
N
OTE: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 backward 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....

176 Installing [email protected]/Windows
If the area code is local, mailbox 1002’s Extension field sets both the long distance dialing 
string and the area code string to  (the empty string).
Extension Field:@=(%S0,)=(%S1,)G(1003)
DND: OFF
Store Messages: NO
Mailbox 1003’s Extension field contains the tokens that request the fax telephone number 
and stores it in the variable %S2.
Extension Field:@R(G1,%S2,40)P(G2)P(%S2)M(G3,2,30)
DND: OFF
Store Messages: NO
Greeting 1: Please enter the telephone number...

Chapter 11: Programming Examples 177
DND: OFF
Store Messages: NO
Greeting  1: The technical report on upgrading voice boards will be faxed to you. 
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...

178 Installing [email protected]/Windows
For example, avoid personal pronouns in phrases. Use “Please enter the number” 
rather than “tell me the number.”
3. If necessary, separate callers using touch-tone telephones from those using dial-pulse 
telephones.
Use something similar to “If you are calling from a touch-tone phone, please press 1 
now. Otherwise, please remain on the line. An attendant will help you.”
4. Early on the first menu, offer the user access to a human attendant.
5. Offer access to a...

Chapter 11: Programming Examples 179
Making Requests
Requests to users fall into the following categories:
 Request for single-digit response (such as 1 for Yes or 2 for No)
 Request for multi-digit response such as a telephone or credit card number
 Group of questions that comprise a voice form
For example, you might ask the user a series of questions, the answers to which are 
essentially the fields on a paper form. These voice responses are saved as messages.
For single-digit responses, you can use...

180 Installing [email protected]/Windows
 Play an error message, status message, or tone.
Status messages, such has “We are still processing your order” should play after the 
first two seconds and then every seven to ten seconds. 
For an error message, provide a retry greeting (and perhaps suggest a remedy) before 
repeating the current greeting. Be sure to notify the user when returning to the main 
menu or transferring the user to an attendant after an error.
Word your informational greetings...