Amanda Amanda@Work.Place Version 3.xx, Installer'S Manual

Page: 85 / 206

Chapter 11:
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 the
Users screen) and/or in Method fields (defined per mailbox using the Notify Screen). 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 a sequence of one or more characters that represents an action that Amanda can
perform. The tokens that you use most often are simple and perform routine actions such
as dialing an extension. However, a program can be much more complicated than that.
With the Token Programming Language, you can use tokens to do either of the following:
• Enhance Amanda’s normal processing of the Extension and Method fields. Nor-
mally, she uses Programmed Call Progress Monitoring (PCPM).
In this case, you add the tokens where appropriate within the field.
For example,
147H
is a sequence of four tokens that tells Amanda to dial the DTMF
digits 147 (for extension 147) and then hang up. Notice that the tokens are not sepa-
rated by spaces (or any other characters). You write tokens one right after the other.
• Stop Amanda’s normal processing of the fields and tell her what to do.
In this case, the first character in the field is @. Then you add the tokens that tell
Amanda what to do.
For example,
@
R(G1,%S1)
assigns the DTMF digits entered by the caller to a variable named %S1. This starts
with an @ to indicate that you are NOT processing this Extension field normally.
Normal processing for the Extension field: Amanda plays “Please hold while I try that
extension,” puts the caller on transfer hold, then evaluates the tokens in the field. Unless
told to do otherwise, she listens for call progress tones and an answer.
The @ stops Amanda from performing the dial code that puts a caller on transfer hold
(also known as the dl_dtwait dial code). As explained
in Installing Amanda@Work.Place ,
you use the Setup utility (selection 1) to set or view the dial codes. The codes are stored in
C:\AMANDA\PBX.DB\1001.PBX, which you can view or edit using the JOVE utility.
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.