Amanda Work Place Instructions Manual

Chapter 10:
Accessing Amanda Remotely
Accessing Amanda from Another Computer
You can control and configure [email protected] remotely from another computer 
using the Host and Remote programs. Host runs on Amanda (server or standalone) and 
Remote runs on the computer that is accessing Amanda remotely. You also need either a 
null modem cable to connect the computers or a modem on each computer.
These programs allow the remote computer’s monitor and keyboard to take over for 
Amanda’s monitor and...

74 Installing [email protected]
This lines for the modem and null modem cabled can be explained as follows:
The line for the modem is:
REM LH HOST /4 >>%LOGN%
Use the list above (for the null modem) to understand each part of this line.
Change the /4 to the number of the COM port used by the modem on Amanda’s computer, 
and add a /f if your modem can handle data speeds of higher than 2400 bps.
Setting Up the Remote Computer
The remote computer must have a copy of the Remote program. Then you can run the...

Chapter 10: Accessing Amanda Remotely 75
Connecting by Cable
To connect over a null modem cable: 
1. Attach one end of the null modem cable to the correct serial port (for example, 
COM2) on Amanda’s computer and to a serial port on the remote computer.
2. Turn on both computers. 
3. From the remote computer, use the following command to start the Remote program. 
remote /x
 /n /f 
where x is 1 or 2, depending on what COM port the cable is connected to on the 
remote computer. For COM1, you can use /1 or...

76 Installing [email protected]
The Remote program works only with COM1 or COM2, with industry standard IRQ and 
I/O port addressing. That is: 
COM1 with IRQ4 and not other devices on COM1 or using IRQ4
COM2 with IRQ3 and not other devices on COM2 or using IRQ3
To control Amanda via modem:
1. Use the following command to start the Remote program:
remote /x
 
where x is 1 or 2, depending on what COM port the cable is connected to on the 
remote computer. (For COM1, you can use /1 or nothing at all because...

Chapter 11:
Programming Amanda
Using Tokens
The Token Programming Language allows you to write programs for Amanda. These 
programs consist of tokens entered in Extension fields (defined per mailbox using the 
Users screen) and/or in Method fields (defined per mailbox using the Notify Screen). This 
section describes the language and introduces you to common programming terms. 
Understanding these terms can help you understand any programming language.
A token is a sequence of one or more characters that...

78 Installing [email protected]
When most people think of a program, they think of a series of lines, each of which 
contains a single action or command. The Token Programming Language is similar, but 
each line become the contents of a different field, using the Extension field of a mailbox.
If the program contains only a few lines, sometimes you can use just one Extension or 
Method field for the entire program. However, when you need more fields, you use the 
Extension fields from additional...

Chapter 11: Programming Amanda 79
Tracing Token Execution
Amanda’s trace files can let you know where and how a token program is failing. This is 
an invaluable debugging tool. 
Amanda creates trace files as she runs, because the following trace command should be in 
the AUTOEXEC.BAT file.
amanda /t5 /s1300
Like the default trace command, this command creates C:\AMANDA\TRACE.OUT file 
and limits its size to the last 1.3MB of data. (A file this size will fit on a 3 1/2-inch floppy 
disk.) What is...

80 Installing [email protected]
9, is a string that Amanda might dial for an outside line. It consists of the DTMF digit 9 
followed by the comma for a pause.
A string that has no characters is called the empty string. It often occurs in programming 
and is written as 
 or 
.
If you use one kind of quotation mark within a string, you should use the other kind as the 
string’s delimiters: Amandas or Do not use  (the double quotation character).
Variables
Each variable is the name of a storage location...

Chapter 11: Programming Amanda 81
Commands
Commands are more complex than literals and variables. Commands perform actions. For 
example, a command may tell Amanda to play a particular message or go to another 
mailbox. 
Each command has a name followed by a series of parts called parameters. Some 
parameters contain information that Amanda needs to perform the command. Others 
contain information that Amanda obtains for you as she performs the command. Each 
parameter is a literal, variable, or another...

82 Installing [email protected]
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 requested. For example, 
Amanda might need the name of the file in which to store a fax or the telephone number 
for a pager. You supply the input parameters and make sure that the information in them is 
correct....