Amanda Work Group Installation Manual

Chapter 15: Programming Amanda 179
Press O to stop the display. On-screen traces for Amanda Voice Server are 
not stored in a file. You can create trace files using Amanda Monitor. For 
details, see Administering [email protected]. You can use Amanda 
Monitor to display on-screen traces as well.
Kinds of Tokens
Tokens fall into the following categories: 
 Literals
Variables
 Commands
Literals
A literal is an exact value such as the whole numbers 4 or 1144. Notice that 
you do not use commas within...

180 Installing [email protected]
Variables
Each variable is the name of a storage location within the computer that can 
store a string or a -hole number. After you store something in a variable, you 
can use that variable’s name instead of typing the string or the number. This 
is useful because:
 Amanda’s variables have simple names (no more than four charac-
ters) and save you typing time. (You are less likely to make a mistake 
typing a short variable name than a long string.)
 You can change the...

Chapter 15: Programming Amanda 181
Assignment
You control port and global variables. For example, you can assign numbers 
or strings to them and later change those numbers or strings. For example, 
you might assign the value of 65 to %G4 and the value Amanda to %S9. 
Assigning a value to a variable copies that value to the variable’s storage 
location. 
Initially, each port and global variable has the empty string as its value. 
Assignment is done in the Token Programming Language using the 
assignment...

182 Installing [email protected]
The command P(0745,T) tells Amanda to say the number 0745 as a time. It 
also has the command name P, but it has two parameters: the number 0745 
and the literal T. 

Chapter 15: Programming Amanda 183
When a command is referred to by name in this guide, the parentheses 
appear after the command’s name. For example, the command named P is 
referred to as the P() command, which is read as “the P command.”
Parameters
Parameters can be required or optional. The syntax places brackets […] 
around optional parameters.
Parameters can also be for input or for output. Input parameters provide the 
information that Amanda needs in order to perform the action that you...

184 Installing [email protected]
within a string if you delimit that string with quotation marks. You cannot 
use a number from 0 to 9 after %S1 in a string because Amanda assumes that 
you meant the variable %S10 or %S11, etc.
Most system variables do not have parameters. However, a couple of system 
variables have parameters that affect the contents of that system variable. For 
example, to use %I, the system variable that retrieves data from specific 
fields of specific messages, you use parameters to...

Chapter 15: Programming Amanda 185
%I() has three parameters: field, msg_no and mailbox.
Because the %I and parentheses are bold, you know that you have to include 
them in the command. The commas are bold, but the one in front of mailbox 
is inside brackets […], which surround optional parts of the syntax. If you 
use the bracketed part of the syntax, you must use the comma.  

186 Installing [email protected]
Because field is italicized, you know that it is a place holder for information 
that you must provide. Field can be any one of the following fields 
associated with messages:
D for the Date field
T for the Time field
F for the From field
Because msg_no is also italicized, you know that it is a place holder for 
information that you must provide. For example, to find out the date for 
message number 8, you replace msg_no with the number 8. Because mailbox 
is inside...

Chapter 15: Programming Amanda 187
Files and Directories
This section points out what you need to know about files and file names 
when using the Token Programming Language. It assumes that you already 
know the following and other facts about files and directories:
 DOS files are stored in directories.
 The complete name for a file starts with the root directory (usually 
C:), lists the subdirectories leading to the file, and ends with the 
name of the file, each of which is separated by a backslash...

188 Installing [email protected]
Text files that contain database records should have commas separating each 
field of each record and a carriage return/linefeed separating one record from 
another. (A carriage return/linefeed is the pair of ASCII characters placed in 
a file when you press Enter on your keyboard.) 
Sample Address Record as a line in a text file:
MARY,HU,28291 HOOVER ST.,WINTER FALLS,MI,48444
When Amanda reads records from a text file, you tell her the number of the 
fields you want to...