Amanda Work Group Administrations 7 Xx Instructions Manual

							Chapter 6: Notifying Users 141
Disabling a Notification Record
You can disable a notification record temporarily or permanently. For 
example, if a user takes a leave of absence or a vacation, you can disable all 
his notification records. Amanda keeps the original information so you can 
reactivate the record later.
To disable a notification record:
1. From the Users screen, type the number for the mailbox in the Mailbox 
field, then press Enter.
2. Press Alt+N.
The Notify screen appears. The first notification record in the Notifica-
tion Records List is selected. 
TypeDefines what condition activates this notification. 
There are five types. Press F2 to see the list of types, 
use Up Arrow and Down Arrow to select a type, 
then press Enter to return to the Notify screen.
VariableThe telephone number that Amanda substitutes for 
%V when she executes this notification record. If 
the Method field does not contain the token %V, 
this field is ignored. 
C
AUTION:  If the Method field contains the token 
%V and this telephone number or exten-
sion is invalid, the system might lock 
up. Additionally, make sure your tele-
phone lines are toll restricted.
Method See “Examples of Notification Methods” on 
page 143 and, for more information about the To-
ken Programming Language, see Installing Aman-
[email protected]/DOS.
Notification Record Fields
Field NameDescription 
						

							142 Administering [email protected]/DOS
3. Press Page Down until the record to be disabled is selected.
The cursor is positioned at the Enabled field at the bottom of the screen.
4. Press spacebar to change the Enabled field from YES to NO.
5. To save your change, press Alt+S. 
You are prompted:
OVERWRITE Notification record? [NY]
Press Y to change the current notification record or press N to cancel.
Changing Notification Telephone Numbers
If a user changes his pager number or another telephone number used in a 
notification record, you need to change the contents of the Variable field for 
that record. This number replaces the %V token in the record’s Method field.
You can change the number for the user, or he can change the number 
himself by calling Amanda over the telephone.
To change a notification record’s Variable field:
1. From the Users screen, type the number for the mailbox in the Mailbox 
field, then press Enter.
2. Press Alt+N.
The first notification record in the Notification Records List is selected. 
3. Press Page Down until the record to be disabled is selected.
The cursor is positioned at the Enabled field at the bottom of the screen.
4. Press Tab until the Variable field is selected.
5. Type the new number. 
						

							Chapter 6: Notifying Users 143
6. To save your change, press Alt+S. 
You are prompted:
OVERWRITE Notification record? [NY]
Press Y to change the current notification record or press N to cancel.
Examples of Notification Methods
This section includes examples of notification records. Use them as 
references, but don’t copy them unless they work correctly with your 
system. For example, the commands for turning the message light on and off 
are probably different on your telephone switching system.
Controlling a Message Light
Some telephone switching systems support message lights that are 
controlled by a special sequence of keys. Suppose that the sequence #63, 
followed by the extension number, turns on the extension’s message light. 
Then the notification record contains:
Type: NORMAL
Method: #63%E
Amanda automatically replaces %E with the contents of the Extension field 
for this mailbox. This works if and only if the Extension field contains only 
an extension number, for example, 127. 
If #91, followed by the extension number, turns off the extension’s message 
light, you create a second notification record containing:
Type: PICKUP
Method: #91%E 
						

							144 Administering [email protected]/DOS
Using %U and %V instead of %E
When the Extension field contains more than the extension number, for 
example, 127H or a set of tokens starting with @, you cannot use %E in 
notification records to turn the message light on and off. 
If the mailbox is the same number as the extension, you can substitute %U.
If neither %E nor %U can be used, you can substitute %V and put the 
extension number, such as 127, in the Variable field for the notification 
record.
Using Voice Notification
Voice notification is commonly used instead of message waiting lights. The 
following is an example of a notification record that calls the user’s 
extension to inform him about his messages:
Type: NORMAL
Method: %EW(5,V)P(U)P(M)P(N)
TokenDescription
%ENumber to be dialed to reach the user’s extension. (See “Us-
ing %U and %V instead of %E” on page 144 if the contents 
of the Extension field contains more or something other 
than the extension number.)
W(5,V)A five-ring wait for a voice response.
P(U)Amanda plays the mailbox’s Name and Extension record-
ing.
P(M)Amanda says the total number of messages and the number 
of new messages.
P(N)Amanda plays the Name/Extension recording for the current mail-
box. 
						

							Chapter 6: Notifying Users 145
Calling a Pager
The following example shows the Method field with the tokens that call a 
pager to indicate the total number of messages and the number of new 
messages. You may need more pauses, longer pauses, different signals for 
the paging service, or a longer wait for the paging service to respond.
Type: NORMAL
Method: 9,%V,W(2,P)-%U*%M*%N#
TokenDescription
9Number to be dialed for an outside line.
,A two-second pause.
%VThe contents of the Variable field in the notification record. 
In this case, the Variable field contains the telephone num-
ber for the paging service.
,A two-second pause.
W(2,P)A two-ring wait for the paging service to respond with a 
confirmation tone. 
-A half-second pause.
%UThe current mailbox (to let the user who is being paged 
know the source of the page).
*For this particular paging service, the asterisk tells the pag-
ing service to place a hyphen on the screen for the pager.
%MThe total number of messages for this mailbox.
*Another hyphen.
%NThe number of new messages for this mailbox.
#Signal to the pager service that the information is complete. 
						

							146 Administering [email protected]/DOS
Here is an alternative:
Type: NORMAL
Method: 9W(4,T)%V,,W(3,P)-%U*%M*%N#-
Remember that Amanda defines the successful completion of a notification 
record as reaching the end of the token string successfully—not getting an 
answer. If, for example, a paging server answers but does not provide a 
recognizable progress tone, Amanda might prematurely abort execution of 
the string. The call was answered, but the execution of the tokens was 
incomplete. Therefore, Amanda tries again.
Relaying Information to a Pager
While the mailbox’s greeting plays, the caller can press # to activate relay 
paging. The caller enters his telephone number. Amanda saves the number in 
%R, and sends it, instead of the number of messages, to the pager. A 
notification record can send the contents of %R to the user’s pager. This 
allows a caller to page a mailbox without having to dial, or even know, the 
user’s pager number.
TokenDescription
9Number to be dialed for an outside line.
W(4,T)A four-second wait for a dial tone.
%VThe contents of the Variable field in the notification record. 
In this case, the Variable field contains the telephone num-
ber for the paging service.
,,A four-second pause.
W(3,P)A three-ring wait for the paging service to respond with a 
confirmation tone. 
-%U*%M*
%N#The same as in the previous example.
-A half-second pause before hanging up. 
						

							Chapter 6: Notifying Users 147
Type: RELAY
Method: 9W(4,T)%V,,W(2,P)-%U*%R#-
You can add the total number of messages by adding *%M:
Type: RELAY
Method: 9W(4,T)%V,,W(2,P)-%U*%R*%M#-
If the paging service can accept three asterisks, you could include the 
number of new messages by adding *%N:
Type: RELAY
Method: 9W(4,T)%V,,W(2,P)-%U*%R*%M*%N#-
TokenDescription
9Number to be dialed for an outside line.
W(4,T)A four-second wait for a dial tone.
%VThe contents of the Variable field in the notification record. 
In this case, the Variable field contains the telephone 
number for the paging service.
,,A four-second pause.
W(2,P)A two-ring wait for the paging service to respond with a 
confirmation tone. 
-A half-second pause before hanging up.
%UThe current mailbox (to let the user who is being paged 
know the source of the page).
*For this particular paging service, the asterisk tells the 
paging service to place a hyphen on the screen for the 
pager.
%RThe telephone number (or other information) from the 
caller.
#Signal to the pager service that the information is complete.
-A half-second pause before hanging up. 
						

							148 Administering [email protected]/DOS
Calling Home
The following example shows the Method field with the tokens that call a 
user at home to indicate the total number of messages and the number of new 
messages. You may need more pauses, longer pauses, or a longer wait for a 
voice response.
Type: NORMAL
Method: 9,%V,W(9,V)-P(U)P(M) 
TokenDescription
9Number to be dialed for an outside line.
,A two-second pause.
%VThe contents of the Variable field in the notification record. 
In this case, the Variable field contains the user’s home tele-
phone number.
,A two-second pause.
W(9,V)A nine-ring wait for a voice response. 
-A half-second pause.
P(U)Amanda plays the mailbox’s Name/Extension recording.
P(M)Amanda says the total number of messages and the number 
of new messages. 
						

							Chapter 6: Notifying Users 149
To allow for an answering machine’s recording and a beep, you might 
consider one of the next two examples:
Type: NORMAL
Method: 9,%V,W(100)P(U)P(M) 
Type: NORMAL
Method: 9,%V,W(9,V)-P(U)P3(M) 
TokenDescription
9,%V,The same as in the previous example.
W(100)A ten-second wait. (100 x 1/10 sec.)
P(U)P(M)Amanda plays the mailbox’s Name/Extension recording 
followed by the total number of messages and the number 
of new messages.
TokenDescription
9,%V,The same as in the previous example.
W(9,V)A nine-ring wait for a voice response.
P(U)Amanda plays the mailbox’s Name/Extension recording.
P3(M)Amanda plays the total number of messages and the number 
of new messages three times. 
						

							150 Administering [email protected]/DOS
To log the person who answers the telephone on to the mailbox:
Type: NORMAL
Method: 9,%V,W(9,V)P(U)P(M)%X210,*%U#
You could add the security code, and so forth, but that would allow any 
person who answered the telephone to listen to the messages. That would be 
a security risk.
N
OTE:To log on the user as in this example, one voice mail port 
must call another. The telephone switching system may re-
quire special programming to support this.
TokenDescription
9,%V, 
W(9,V) 
P(U) 
P(M)The same as in a previous example.
%XSystem variable that contains the codes needed to get the 
transfer dial tone on the current port. Each port has its own 
%X. This is the setting of the dl_dtwait configuration 
option (usually F-).
210The number to be dialed as Amanda’s extension. The 210 
is just an example. 
-A half-second pause before hanging up.
*An asterisk to indicate that a user is logging on.
%U#The current mailbox followed by the # expected by 
Amanda.