Amanda Work Group 7xx Installation Manual

Chapter 11: Programming Amanda 189
G(
mailbox)
 Command that controls processing. Amanda continues standard processing at the 
specified mailbox’s Extension field (as shown in Administering Aman-
[email protected]/DOS). 
mailboxA valid mailbox or a variable containing a mailbox. 
N
OTE:
If you use the G() command in a Notify Method field, remember that the 
telephone port is still in Notify mode and cannot transfer a call. There-
fore, the Extension field that you go to should start with an @.
Example:...

190 Installing [email protected]
H(
mailbox)
 Command that performs exit routines when a caller hangs up. It specifies the mail-
box to be processed if a hang-up condition is detected while processing the current 
set of tokens. (Processing these tokens can take Amanda to more than one mail-
box.)
mailboxA valid mailbox or a variable containing a mailbox.
This command is used only in Extension fields.
Example:
H(614)
causes Amanda to go to mailbox 614 when a caller hangs up. Because you are 
tracking the...

Chapter 11: Programming Amanda 191
I(
value,
operator,
value,
mailbox)
 Command that allows you to control processing based on a condition. If the speci-
fied values and operator create a condition that is true, Amanda continues process-
ing at the specified mailbox. If the condition is false, the next token after this 
command is executed.
valueAny string, number, or variable.
operatorOne of the following symbols:
>
greater than
<
less than
=
equal
!
not equal
mailboxAny valid mailbox or a variable...

192 Installing [email protected]
J(
file_or_box,
phone_no
[,
tokens
])
 Command that allows a fax to be received as a file (for later transmission with the 
T() command) or as a message for a mailbox.
Before using this command, make sure the configuration settings for the physical 
serial port have been defined. 
file_or_boxA string or variable indicating where the fax is to be stored. It contains 
either a mailbox indicating whose message it is or a valid DOS file 
name for a text file. Use the complete...

Chapter 11: Programming Amanda 193
K*(
ext,
on_off)
 Only for Amanda systems using the tAA voice board for Norstar. Turns the mes-
sage waiting indicator for the specified extension on or off.
extThe extension to turn on or off. 
on_offUse one of the following:
1
Turns the light on.
0
Turns the light off.
Examples:
@
K*(%E,1)
used in a notification record to turn the message waiting indicator on.@K*(%E,0)used in a notification record to turn the message waiting indicator off.
Failure:  
Does not fail
K

194 Installing [email protected]
KB(
frequency,
msecs)
 Command that plays a certain frequency for a certain time period (defined in mil-
liseconds). 
frequencyA number of Hz. For example, the only frequencies supported by the 
Brooktrout driver are those roughly within the range 300–3000 Hz. 
msecsA number of milliseconds. 
Example:
KB(350,2000)plays the frequency 350 Hz for two seconds. 
Failure:  
Does not fail
KC(
mailbox,
variable)
 Command that compares the security code for the specified mailbox...

Chapter 11: Programming Amanda 195
KD(
msg_no
[,
mailbox
] [,1
])
 Command that deletes a message from the specified or current mailbox. Using this 
command cancels any pending Notify actions for the specified message automati-
cally.
msg_noA number or a variable containing a number.
mailboxOptional. Any valid mailbox or a variable containing a mailbox. The de-
fault is the current mailbox.
1
Optional. When used, if the specified message does not exist, Amanda 
says, Sorry, I’m unable to do that at this...

196 Installing [email protected]
KI(
target,
source,
variable)
 Command that searches one string (called the source string) to see if it contains a 
copy of another string (called the target string).
targetA string or a variable containing the string to be searched for inside the 
source. 
sourceA string or a variable containing the string to search. 
variableThe port or global variable to which the KI() command assigns one of the 
following:
 Zero if the target is not found in the source.
 The number...

Chapter 11: Programming Amanda 197
KL(
mailbox)
 Command that logs the current caller on to the specified mailbox, bypassing the 
mailbox’s security code unless the KC() command is also used. The caller is at the 
top level menu (the menu that says “Press 1 to play your messages....”). This com-
mand is usually used right after the KC() command.
mailboxAny valid mailbox or a variable containing a mailbox.
Example:
R(G1,%S1)P(G5)P(%S1,N)KL(%S1)is a simplified example that doesn’t use the KC() command....

198 Installing [email protected]
KP(
mailbox,
security_code)
 Command that sets the security code for the specified mailbox.
mailboxAny valid mailbox or a variable containing a mailbox. 
security_codeString of DTMF digits that indicate the new security code for the 
specified mailbox. 
Example:
KP(128,”5404”)
causes Amanda to change the security code for mailbox 128 to 5404.
Failure:  
Invalid mailbox
mailbox is locked or read-only
Security code is an empty string, contains invalid characters, or exceeds...