Amanda Work Place Instructions Manual

Chapter 11: Programming Amanda 113
O(
time) Command that makes Amanda go on-hook for the specified amount of time. Depending 
upon the value used, you can cause a hookflash or a hang-up. This is particularly useful 
for generating an intermediate hang-up condition during token processing without ter-
minating the actual continued token processing. See also the H() command.
timeA number in tenths of seconds or a variable containing that number.
Example:
O(20)
causes Amanda to go on-hook for two seconds....

114 Installing [email protected]
P
[
repetition]
(
number,N) Command that tells Amanda to say the absolute value of the number. 
repetitionThe number of times to repeat absolute value. The default is 1. 
numberA number or variable representing a number from 0 to 999 million. 
N
OTE:
Use a condition to test whether the number is positive or negative. Use a greeting that 
says “negative” or “minus” to handle negative numbers.
Examples:
Suppose that %S1 contains -1234 and G1 contains the recording...

Chapter 11: Programming Amanda 115
P
[
repetition]
(M
[,
mailbox]) Command that tells Amanda to say the total number of messages for the specified or cur-
rent mailbox.
Using this command cancels any pending Notify actions for the specified message auto-
matically. 
When this command plays a message that is marked with Receipt Verification, the veri-
fication message’s From field contains the mailbox which executed this command.
repetitionThe number of times to repeat the number of messages. The default...

116 Installing [email protected]
P
[
repetition]
(
prompt_no,V) Command that tells Amanda to look for the specified prompt number in the current sys-
tem language file. Then Amanda plays the prompt associated with that number.
repetitionThe number of times to repeat the prompt. The default is 1.
prompt_noThe number or variable containing the number for the prompt. The current range is 
from 1 to 477. (For some languages, some of the prompt numbers reference blank 
messages.)
Example:P2(15,V)
causes...

Chapter 11: Programming Amanda 117
Q(
{
greeting
[#
mailbox] 
[,E
]}) Command that allows you to ask a caller a series of questions and store all the caller’s 
responses as a single message for the current mailbox. Each question is recorded 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 ques-
tions (after using Greetings 1 to 7 for the current mailbox) you can use greetings from...

118 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. See the notification 
chapter in 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 infor-...

Chapter 11: Programming Amanda 119
S(
port,
[
string],
[
variable],
[
termination],
[
length],
[
timeout]) Command that gives Amanda access to other computers via the serial ports. Amanda can 
send a string to and/or receive a string from the remote computer. When receiving, 
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...

120 Installing [email protected]
%TSystem variable that contains the current connect time, the number of seconds that the 
current port/call has been active. Each port has its own %T.
Examples:
P(%
T,N)
causes Amanda to say the amount of connect time as a number. See the P() command 
for more information.
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...

Chapter 11: Programming Amanda 121
V(
file,
field,
value{,
field,
variable})Command that searches the specified file for the first 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...

122 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 tokens.
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 left...