Amanda Work Group Installation Manual

Chapter 15: Programming Amanda 239
Q(
{
greeting
[#
mailbox][,E
]})
 Command that allows you to ask a caller a series of questions and store all the call-
er’s responses as a single message for the current mailbox. Each question is record-
ed as a greeting which Amanda plays back with a tone. Then Amanda records a 
response and goes on to the next question. Up to 20 questions are allowed. To ask 
more than 7 questions (after using Greetings 1 to 7 for the current mailbox) you can 
use greetings from...

240 Installing [email protected]
%RSystem variable (the relay variable) that contains the DTMF digits entered by the 
caller who requested relay paging notification. Each port has its own %R. For more 
information, see Administering [email protected]. This is primarily used to 
send up to 16 digits of information to a user’s pager/beeper.
This token is used only in Notify Method fields. 
Example:
9,%VW(9,V)P(U)P(R)
causes Amanda to call someone at home and say the telephone number and other 
information...

Chapter 15: Programming Amanda 241
%S0 %S1
%S2 %S3
%S4 %S5
%S6 %S7
%S8 %S9
%S10 %S11
%S12 %S13
%S14 %S15
%S16 %S17
%S18 %S19Each telephone port has its own set of 20 %S variables where you can store, mod-
ify, or retrieve information. One port’s %S1 is not the same as another port’s %S1. 
If Port 1 changes %S1, it does not change the value of Port 2’s %S1. Initially, each 
variable is equal to the empty string. Each variable can contain a string of up to 143 
characters.
See also %G0–%G9.
N
OTE:
The [(),...

242 Installing [email protected]
S(
port,
[
string],
[
variable],
[
termination],
[
length],
[
time-
out])
 Command that gives Amanda access to other computers via the serial ports. Aman-
da can send a string to and/or receive a string from the remote computer. When re-
ceiving, Amanda terminates the connection when the first of the following occurs:
 Amanda receives the specified termination string
 She receives the maximum number of characters
 A timeout occurs
When sending, Amanda terminates the...

Chapter 15: Programming Amanda 243
S
 token continuedExample:
S(2,%S3,%S4,,,50)
both sends and receives. The command uses COM port 2. %S3 stores the string to 
be sent. %S4 stores the string that is received. Amanda waits a half second for the 
first character and between characters.
S(2,%S3)
only sends. The command uses COM port 2. %S3 stores the string to be sent. This 
command has non-standard syntax. Because all the parameters after the string to be 
sent are not being used, this command does not...

244 Installing [email protected]
T(
file,
phone_no
[,
tokens])
 Command that sends faxes to either a specified telephone number or to a connected 
call. Before using this command, be sure at least one fax modem is installed and 
configured on Amanda. 
Before using this command, make sure the configuration settings for the physical 
serial port have been defined. 
fileThe file name of the fax you wish to transmit. It can be any valid DOS 
file name. Use the complete path to the file unless the file is in...

Chapter 15: Programming Amanda 245
U-
ext_noCommand that performs partially supervised transfers. Amanda does not transfer 
the call if she detects a busy signal. To use the U token, the setting for Maximum 
Rings for the mailbox must be set to 1.
ext_noSeries of DTMF digits that indicate an extension number.
This command is used only in Extension fields.
Example:
U-144
causes Amanda to call extension 144 (if Amanda is processing a call). If the exten-
sion rings, she transfers the call and hangs up. If...

246 Installing [email protected]
V(
file,
field,
value{,
field,
variable}[,
n])Command that searches the specified file for the nth record that has the 
specified value in the specified field. It retrieves values from up to 8 other 
fields in that record, putting the retrieved values in the specified variables. 
See also the N() command.
fileA string or variable containing a valid DOS file name for the text or .DBF 
file. Use the complete path to the file unless the file is in C:\AMANDA. 
No line in the...

Chapter 15: Programming Amanda 247
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...

248 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 waiting indicator toggles on and off. For the first message, 
Amanda should turn the indicator on. The indicator should be...