Amanda Work Group Manual

Chapter 10: Programming Amanda 141
=(
variable,
value
[,
start,
end]) Command that gives the specified variable the specified value. Use start and end to 
assign only part of the string (a substring) to the variable.
variableOne of the port or global variables.
valueA string, number, or variable.
startOptional. The starting character position to copy from value. The default is to copy 
the entire string. If start is less than 0, it is ignored.
endOptional, but must be used if start is used. The last...

142 Installing [email protected]/Windows
%DSystem variable that contains the percentage of free disk space. 
Example:
I(%D,

Chapter 10: Programming Amanda 143
%G0 %G1
%G2 %G3
%G4 %G5
%G6 %G7
%G8 %G9The Amanda system has 10 global variables (%G0–%G9). Initially, each variable is 
equal to the empty string. The values of %G0–%G9 are the same no matter what port is 
current. 
If Port 1 changes %G1, then all other ports immediately see the new value for %G1. Each 
variable can contain a string of up to 143 characters.
When the system is shut down, the values of %G0–%G9 are lost. They cannot be stored 
using the [(), ](), or |()...

144 Installing [email protected]/Windows
H(
mailbox) Command that performs exit routines when a caller hangs up. It specifies the mailbox 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 mailbox.)
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...

Chapter 10: Programming Amanda 145
I(
value,
operator,
value,
mailbox) Command that allows you to control processing based on a condition. If the specified 
values and operator create a condition that is true, Amanda continues processing 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...

146 Installing [email protected]/Windows
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. See “Serial Port Settings” on page 221.
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...

Chapter 10: Programming Amanda 147
KA(
on_off)
 Command that dials the PBX parameter dl_light_on or dl_light_off specified in the telephone 
system dial codes.  This command is often used in notification templates.
on_off1 or 0 to indicate whether the message waiting indicator is turned on or off. You can 
use a variable that contains a 1 or 0.
When the value is1, the message waiting indicator is turned on as Amanda dials the 
codes for “What to dial to set the message waiting indicator on” (the...

148 Installing [email protected]/Windows
KG(
address,
subject,
msg_no
[,
msg_disp
[,
mailbox
[,
sound_type]]])Forwards voice and fax messages—or a notification about those messages—to an Internet e-mail 
address. All the components of each message being forwarded are included in the resulting e-mail, 
which is in MIME format. Voice components are converted to WAV files containing GSM audio 
(for maximum compression while still being playable on all Windows 9x, NT, and 2000 systems). 
Fax components are...

Chapter 10: Programming Amanda 149
KG cont.Examples:KG(%V,CHECK VOICE MAIL,0)
causes Amanda to sent an Internet e-mail notification to the e-mail address specified in 
%V.
KG(%V,NEW VOICE MAIL,-1,1)
causes Amanda to send all new messages in the current mailbox to the e-mail address 
specified in %V. After sending the messages successfully, Amanda makes sure that the 
messages are no longer marked new or urgent.
KG(%V,NEW VOICE MAIL,-1,2,%U,X-WAV)
causes Amanda to send all the messages in the current...

150 Installing [email protected]/Windows
KL(
mailbox,
security_code)
 Command that logs the current caller on to the specified mailbox. The caller is at the top level menu 
(the menu that says “Press 1 to play your messages....”). 
mailboxAny valid mailbox or a variable containing a mailbox.
security_codeThe security code for the specified mailbox.
Example:
R(G1,%S1)R(G2,%S2)P(G5)P(%S1,N)KL(%S1,%S2)
Greeting 1 says, “Please enter the mailbox you wish to log into.” After the caller enters the mailbox,...