Amanda Work Group 7xx Installation Manual

Chapter 11: Programming Amanda 219
W(
n,
[event
[,
mailbox
]])
 Command that tells Amanda to:
 Wait a number of tenths of a second
 Wait for an event, such as a dial tone or another appropriate 
answer. If the event does not occur, Amanda goes to the spec-
ified mailbox.
nWithout an event parameter (P, V, or T), a number of tenths of a second.
For dial tone (T), the number of seconds.
For pager (P) and voice (V), the number of rings to wait before continu-
ing. If n is 0 for pager or voice, the 0 is...

220 Installing [email protected]
X
[(
file)
]
 Command that creates the specified file or LIGHT.ON. Used in conjunction with 
the Y() and Z() commands, this command can control Amanda’s processing of to-
kens.
fileA string or variable containing a valid DOS file name for a text file. The 
default is to create the file LIGHT.ON in the mailbox’s directory.
Example:
A user’s message light toggles on and off. For the first message, Amanda should 
turn the light on. The light should be left on for the second...

Chapter 11: Programming Amanda 221
Troubleshooting
Check for the following mistakes:
1. Did you start the string of tokens without @ when you wanted Amanda 
to perform a hookflash or PCPM?
2. Did you start the string of tokens with @ when Amanda should NOT 
perform a hookflash or PCPM?
3. If the tokens are in an Extension field, did you forget that both Do Not 
Disturb and Call Screening must be OFF?
4. Did you check the trace file for information about what went wrong?
%ZSystem variable that contains...

222 Installing [email protected]
TIP:Remember that when a string of tokens in an Extension 
field fails, Amanda goes to the mailbox specified in the 
Done Chain for that mailbox. If you are testing a program 
and are not sure which strings of tokens fails, use different 
mailboxes in the Done Chain fields to help you. For exam-
ple, if you do not know which of two strings fails, you 
might put mailbox 4000 in one Done Chain and mailbox 
4001 in the other. If you use 
@P(G1, your_personal_mailbox) 
in the...

Chapter 12:
Programming Examples
System Paging of a User for Special Callers
This example illustrates inter-mixing tokens with Amanda’s standard call 
processing.
Application
This application creates a special mailbox (for example, 611) for family, 
friends, or special customers. When callers access this mailbox, Amanda 
pages you over the telephone paging system in your office. After letting you 
know that you have an important call, Amanda transfers that call to your 
extension through a “backdoor”...

222 Installing [email protected]
Translating to Amanda’s Tokens
This could be translated into Amanda tokens as follows:
1. Dial the code for putting the caller on Transfer Hold (which is normal 
processing if the first character is not an @ sign).
2. Dial the telephone switching system paging access code, for example, 
33* (if that is your system’s code for a system page.)
3. Play a greeting that you have already recorded such as “There is an 
important call for David” using the P() token.
4. Dial the...

Chapter 12: Programming Examples 223
Application
Let’s start by allowing a caller to select outgoing greetings in a different 
language. When a call is answered by Amanda, processing begins at the 
Company Greeting mailbox (which is 990 by default.) After the greeting is 
played, processing (by default) continues at mailbox 991 which plays the 
caller Instructions. During either the Greeting (990) or the Instructions (991) 
you can give the caller the option to press a digit to hear the Instructions in a...

224 Installing [email protected]
language system prompts the caller hears. To change the system prompts to 
another language we must use tokens (and of course have installed the 
appropriate language prompts).
Using Amanda’s Tokens
The token to change system prompts is L(). To change to the Mexican 
Spanish system prompts, use L(MEXICAN) provided that the Mexican 
Spanish system prompts file resides in the Amanda directory and is named 
MEXICAN.IDX (if your system has a Brooktrout voice board) or...

Chapter 12: Programming Examples 225
NOTE:There are several ways this same activity could have been 
accomplished. For example, instead of using the 
G(981) to-
ken, mailbox’s RNA Chain could have had 981 in it. (We 
use the RNA Chain, since Amanda returns Ring No An-
swer after successfully performing the tokens in the Exten-
sion field).
Another Consideration
This works for most situations. However, there is one final consideration. 
What happens if the caller enters an invalid extension or choice? By...

226 Installing [email protected]
To have callers always access the proper language Instruction mailbox, you 
can add a control structure to Amanda. In this example, we might perform 
the following:
1. If an alternate language is selected, remember which language was 
selected.
2. Before playing the default Instruction mailbox, determine which lan-
guage Instruction mailbox should play and continue processing at that 
mailbox.
Using Amanda’s Tokens
This could be accomplished with tokens as follows:
1. To...