Category : Network Files
Archive   : LANBP23.ZIP
Filename : LANBEEP.DOC

LanBeep v2.1

Evaluation Copy

(C) Copyright 1992 Deerfield Computer Solutions, Inc.
All Rights Reserved

Software License Agreement


This program and its documentation are copyrighted and protected by the laws of
the United States and international copyright treaties. You may not use, copy,
modify, loan, rent, give away, resell for profit, distribute, create derivative
works of, or transfer the program and/or documentation (or any copies thereof)
except as explicitly stated in this license agreement.

This is a single copy license granted by Deerfield Computer Solutions, Inc.,
and entitles you, the end user, to use this product on a single machine with a
single display monitor and a single keyboard.

The software and documentation remain the property of Deerfield Computer
Solutions, Inc.

This license may be terminated at any time by you by destroying all copies of
this program and documentation. This license may also be terminated by
Deerfield Computer Solutions, Inc. without notice to you if you fail to comply
with the terms specified in this agreement.

You may make one copy of this software in machine readable form only, and
provided that the copy is for backup purposes only.

If the software package contains both 5¬" and 3«" diskettes, you may only use
one copy of the software (whichever is appropriate or most appropriate for
your single machine). You may not use the other size diskette(s) on another
machine.

You may not decompile, disassemble, or reverse engineer this software.

If any part of this agreement is found to be unlawful, void, or unenforceable,
then that provision shall be severed from this agreement and will not affect
the validity and enforceability of any of the remaining provisions.

This license may not be modified except by a written document signed by both
parties and stating on its face that it is a modification or amendment of this
contract. In no case shall a modification be effected by oral or written
representations or advertisements, or by any purchase order or correspondence.

You will not export or transmit this software to Afghanistan, the Peoples
Republic of China, or to any group Q, S, W, Y or Z country specified in the
Export Administration Regulations issued by the U.S. Department of Commerce or
to any country to which such transmission is restricted by applicable
regulations or statutes.


Limited Warranty


This software is licensed "AS IS", and Deerfield Computer Solutions, Inc. makes
no warranty, representation or promise either expressed or implied, except as
set forth in this agreement. In particular, Deerfield Computer Solutions,
Inc. disclaims all warranties of merchantability or fitness for any particular
purpose, and the end user waives all claims against Deerfield Computer
Solutions, Inc. for special, direct, indirect, lost profits, lost savings, or
other consequential damages arising out of or in connection with the use or
inability to use this product. Under no circumstances will Deerfield Computer
Solutions, Inc.'s liability exceed the purchase price of this product.

Deerfield Computer Solutions, Inc. does not warrant that the software will meet
your requirements, or that operation of the software will be uninterrupted or
free from errors or defects, or that any errors or defects will be corrected.

The media (diskettes) are warranted to be free from errors and/or defects for a
period of sixty (60) days from the date of original purchase and under normal
use. Should the media prove defective within this time, Deerfield Computer
Solutions, Inc. will replace them free of charge if they are returned, postage
prepaid, to:

Deerfield Computer Solutions, Inc.
43 Baldwin Terrace
Wayne, NJ 07470


This license constitutes the entire agreement and understanding between the
parties and supersedes any prior agreement or understanding, whether oral or
written, relating to the subject of this license.


This software and documentation are:
(C) Copyright 1992 Deerfield Computer Solutions, Inc.
All Rights Reserved.
Manual revision #0210E-921201

LanBeep v2.1 -Contents-


Program Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Passwords/Access Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Startup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

The Display Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Beeping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Remote Access. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Sample AUTOEXEC.BAT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Sample LANBEEP.CFG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Beeper Displays. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Decoding Return Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Conversion Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Problems/Possible Solutions. . . . . . . . . . . . . . . . . . . . . . . . . 26

Comments/Suggestions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

LanBeep v2.1 -Program Overview- Page 1


Thank you for evaluating LanBeep. It is a highly reliable network file server
monitor and also a remote command center. With it, you can monitor file
servers all over the country, and also use it as a means for giving the PC
commands remotely.

The best way to use LanBeep is to run it from AUTOEXEC.BAT (see sample on page
16).

LanBeep must have the network shell loaded before it if it is to scan file
servers. LanBeep can also monitor the phone line and if a ring is detected,
LanBeep can answer and carry out a remote command. LanBeep keeps a log of all
of its activities in a file called LANBEEP.LOG.

If LanBeep determines that a file server isn't responding, it initiates a beep
which will display a code that represents the status of all of the file
servers being scanned. It will rebeep at a set time interval (see
BEEPINTERVAL on page 11) until either it receives the Acknowledgement Access
Code (see page 4), or beeps the maximum number of times (see MAXBEEPS on page
11).

One of the most common uses of LanBeep is to act as your eyes and ears in a
remote region site. Suppose you work at headquarters (housing four file
servers) in New York, and your company has an office in Chicago (housing one
file server). If you are responsible for the network administration of the
remote office, you probably call someone in that office and have them put their
PC into a remote access program's host mode, waiting for you to dial in. With
LanBeep, you can call into the LanBeep PC in Chicago, and have it run that
program's host mode for you, waiting for you to dial in, or you can have it run
a BBS, or do anything that you can put into a batch file. While the PC isn't
being used by you remotely, it is monitoring the file server in Chicago, and it
will beep you if it goes down. If you have a LanBeep PC running at
headquarters also, you can rest easy knowing that the network is up. How many
times have you been the first one in to work (an hour before people come in to
start working on the network), only to find that a server had gone down some
time the night before leaving you with one hour to get the server back up, or
face down time. This assumes that it isn't critical for the server to be up at
all times. With LanBeep, you'll get immediate notice of a file server going
down, giving you the maximum time possible to correct the problem. While this
may ruin a perfectly good night's sleep, it's a small price to pay for having
all that extra time to get the network running properly again.

Assume that MAXBEEPS=5, BEEPINTERVAL=300 and file servers FS1, FS2, FS3 and FS4
are being scanned. The network shell is loaded, and then LanBeep is run.
Assuming that all of the file servers are ok, the return code is "000" and no
beep will occur until this changes. Now, if FS1 goes down, you'll get beeped
with a return code of "001". Now you call in with the Acknowledgement Access
Code, and start driving to your office. Then something unheard of happens- FS1
comes back up by itself. LanBeep will beep you with a return code of "000" so
you know that all of the servers are ok and you can turn around and go back
home. LanBeep will beep you every five minutes until either you call in with
the Acknowledgement Access Code, or MAXBEEPS is reached (three more beeps).

LanBeep v2.1 -Program Overview (Continued)- Page 2


To shut LanBeep down locally, enter the Shutdown Password (see page 4) on the
keyboard. No keystrokes are displayed, and the key is not necessary to
signal the end of the password. If a mistake is made, just start over- no
key is necessary.

LanBeep v2.1 -Requirements- Page 3


A PC with an 80286 processor or higher (if LanBeep is to monitor file servers,
the PC must be connected to a Novell(R) network, with the network shell already
loaded).

A Hayes(R) compatible modem (US Robotics(R) Courier(tm) modem necessary for
touch tone recognition- see TONERECOGNITION on page 12).

A beeper/pager (it is possible to use LanBeep without a beeper, but it will
only function as a remote command center- see MINFSERRORCOUNT on page 11).
NOTE: This evaluation copy of LanBeep does not actually call a beeper, but it
still documents its actions in the log file.

LanBeep v2.1 -Passwords/Access Codes- Page 4


LanBeep uses three codes. The first is the Dial In Access Code. This is a six
digit number that must be used to issue remote commands to LanBeep. The second
code is the Acknowledgement Access Code. This is a six digit number that is
used remotely to tell LanBeep to stop calling the beeper. The last code is the
Shutdown Password. This is a 1 - 20 character password used to stop LanBeep's
execution from the keyboard.

If TONERECOGNITION is set to "YES", then the modem will monitor the phone line
for incoming calls. When a ring is detected, the modem will answer the phone
and await tones from the remote phone.

The Dial In Access Code allows you to enter remote commands (see Commands on
page 15).

The Acknowledgement Access Code signals LanBeep to stop beeping with the
current status. This code does not allow commands to follow it.

The Shutdown Password allows termination of LanBeep from the keyboard. After
entering the Shutdown Password, the modem will be reset, and you will be
returned to the operating system.

The default passwords/access codes are:

Dial In Access Code 111111
Acknowledgement Access Code 222222
Shutdown Password SHUTDOWN

To change the passwords/access codes, you must use the supplied program
LBPASSWD.COM. LBPASSWD will ask you to change each code in succession. No
passwords are displayed on screen. To change a code, when prompted, enter the
current code being asked for. This is to prevent the unauthorized changing of
a code by someone who doesn't even know what it currently is. After entering
the correct code, you will be prompted twice to enter a new code. The two
entries must match exactly to be flagged for updating. If a mistake is made
during either entry, the key can be hit to bypass the update of that
code. Once all codes have been processed by you (either changed or left
alone), LBPASSWD will put any changes into effect.

We recommend keeping LBPASSWD.COM separate from the LanBeep program (except
when being used to change codes) because anyone knowing any of the codes can
change them to something else without telling you, in effect, locking you out.
Changing codes is a supervisor's function and thus should be limited to a
select few.


LanBeep v2.1 -Passwords/Access Codes (Continued)- Page 5


LBPASSWD may be started from any directory by typing:

LBPASSWD

as long as LBPASSWD.COM is either in your path or in your current directory.
LANBEEP.COM must be in your current directory.

NOTE: LBPASSWD modifies LANBEEP.COM so you should use a copy of LANBEEP.COM,
and keep the original diskette as a backup.

NOTE: LBPASSWD.COM is not supplied with this evaluation copy of LanBeep.

LanBeep v2.1 -Startup- Page 6


LanBeep may be started from any directory by typing:

LANBEEP

as long as LANBEEP.COM is either in your path or in your current directory.
LANBEEP.CFG must be in your current directory, and LANBEEP.LOG will be created
in your current directory if it doesn't already exist (if it does exist, it
will be appended to).

You may specify a command line option as follows:

LANBEEP /C forces LanBeep to use color video address
LANBEEP /M forces LanBeep to use monochrome video address
LANBEEP /B forces LanBeep into black and white mode

If LanBeep produces no display, try the /C or /M option. If this doesn't work,
try the other one. The /B option removes color from the display, leaving only
a black and white screen. (Depending on your monitor, the screen may actually
be displayed in green and white or amber and white when using the /B option.)

LanBeep v2.1 -The Display Screen- Page 7


The following is a representation of the display screen:


ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ LANBEEP v2.1 (C) Copyright 1992 Deerfield Computer Solutions, Inc. ³
³ All Rights Reserved ³
³ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³
³ ³
³ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³
³ ³ Parameter Setting ³ ³ Program Operation ³ ³
³ ³ ³ ³ Indicator: * ³ ³
³ ³ BEEPINTERVAL = 300 ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ³
³ ³ MAXBEEPS = 0 ³ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³
³ ³ MINFSERRORCOUNT = 10 ³ ³ Scan Indicator: * ³ ³
³ ³ PORT = COM2 ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ³
³ ³ REGION = 99 ³ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³
³ ³ SCANINTERVAL = 0 ³ ³ Modem Status: ³ ³
³ ³ TONERECOGNITION = YES ³ ³ Waiting for ring ³ ³
³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ³
³ ³
³ ³
³ ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» ³
³ º Scanning Server: º ³
³ º FS1 º ³
³ ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ ³
³ ³
³ ³
³ ENTER SHUTDOWN PASSWORD TO RETURN TO THE OPERATING SYSTEM ³
³ ³

ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

The Parameter/Setting box displays the values that each parameter is currently
set at.
NOTE: This evaluation copy of LanBeep does not actually call a beeper or exit
to the operating system with the errorlevel set by a remote call. Instead, it
displays a message in this box as to what action would be taking place had this
been the production version of LanBeep. This copy does, however, still
document in the log file what actions would have occurred had this not been an
evaluation copy.

The Program Operation Indicator box contains a spinning wheel. As long as the
wheel is spinning, LanBeep is doing something, and will respond to anything
that needs attention as soon as it has completed its current task.

The Scan Indicator box also contains a spinning wheel. This wheel may move
rather quickly or hardly at all depending upon how often the file servers are
being scanned (see SCANINTERVAL on page 11).

The Modem Status box indicates the current status of the modem/phone line. If
TONERECOGNITION is set to "NO", this box will display "Phone line not
monitored".

LanBeep v2.1 -The Display Screen (Continued)- Page 8


The Scanning Server box displays the name of the file server that is currently
being checked. If MINFSERRORCOUNT is set to 0, this box will display "None-
MINFSERRORCOUNT is set to 0", and the Scan Indicator box will display "N/A".

To shut LanBeep down locally, enter the Shutdown Password on the keyboard. No
keystrokes are displayed, and the key is not necessary to signal the
end of the password. If a mistake is made, just start over- no key is
necessary.

LanBeep v2.1 -Beeping- Page 9


When LanBeep determines that it needs to call a beeper, it looks at three
things:

First it looks at MAXBEEPS to see if it has already beeped the maximum
number of times. If so, it just skips the beep and continues with
whatever it was doing.

Second, it looks for the Acknowledgement Access Code. Calling the
number that the modem is attached to and entering the Acknowledgement
Access Code will cause LanBeep to discontinue beeping you with the
CURRENT status. If the status changes again, LanBeep will start
beeping you again with the new status as long as it hasn't already
beeped the maximum number of times. The only way to reset the beep
count is to either restart LanBeep or dial in (using the Dial In Access
Code) and using command 21 (see Commands on page 15). Using the
Acknowledgement Access Code will only acknowledge that the beep has
been received, NOT reset the beep count.

Third, LanBeep determines if the time interval for beeping has expired
(see BEEPINTERVAL on page 11). If so, LanBeep will call the beeper.

LanBeep v2.1 -Configuration- Page 10


LANBEEP.CFG must exist (see sample on page 17) and contain any/all of the
following (keywords are not case sensitive):

Keyword Keyvalue Default Required
REGION 2 digit number n/a Yes
FSNAME 1-48 characters n/a Yes
BEEPER beeper number to dial n/a Yes
PORT any string containing a '2' COM1 No
MAXBEEPS 0-9999 0 No
SCANINTERVAL 0-3600 0 No
BEEPINTERVAL 0-3600 300 No
MINFSERRORCOUNT 0-9999 10 No
TONERECOGNITION any string containing a 'Y' NO No

The format (using a pure ASCII text editor) is:

keyword=keyvalue

where the keyword starts in column 1, and a separate line is used for each
keyword. If a semicolon (;) is in column 1, the entire line is treated as a
comment.

Required keywords must be entered. If they do not apply to your situation, use
any valid value as a dummy keyvalue.

REGION is a 2 digit number which identifies the origination of a beep.

FSNAME is a 1-48 character file server name to be checked. Use one statement
for each file server to be scanned.
NOTE: The maximum number of file servers that can be scanned is limited by the
version that you have purchased, but also by the number of digits that your
beeper can display. To calculate the maximum number of file servers that your
beeper can report on, use the following formula:

max servers = integer((beeper_digits - 5) / 3) * 8

If you hate math and know the number of digits that your beeper can display,
call Technical Support at (201) 696-3817 or try the calculation using English:

Subtract 5 from the number of digits that your beeper can display.
Then divide this number by 3. Multiply the integer portion of the
divide by 8. The number that you are left with represents the maximum
number of file servers that can be reported to your beeper.

NOTE: The maximum number of file servers that can be scanned with this
evaluation copy of LanBeep is eight (8).

LanBeep v2.1 -Configuration (Continued)- Page 11


BEEPER is the phone number of the beeper including any necessary extra digits
(e.g., 9).
NOTE: The maximum number of characters that can be contained in this field is:

modem_buffer_size - 11 - ((integer((number_of_servers - 1) / 8) + 1) * 3)

The modem's command buffer is usually 40 characters but may be different on
your particular modem. If LanBeep runs into problems with dialing a beeper,
you will have to find out the buffer size to determine if this is where the
problem lies. If you hate math and know your modem buffer size, call Technical
Support at (201) 696-3817 or try the calculation using English:

Take the number of file servers being monitored and subtract 1. Then
divide this number by 8. Now add 1 to the integer portion of the
divide. Multiply this number by 3. Now add 11. Subtract this new
number from the modem's buffer size and what you are left with is the
maximum number of characters that can be contained in the BEEPER field.

NOTE: BEEPER is NOT a required keyword in this evaluation copy of LanBeep.

PORT is a string that can contain a '2'. If a '2' is found anywhere in this
keyvalue, the ports will be set up to use COM2. The default setup is for COM1.

MAXBEEPS is the maximum number of times that LanBeep will dial the beeper until
the count is reset (using command 21). The default is 0 which means beep until
acknowledged with the Acknowledgement Access Code.

SCANINTERVAL is the number of seconds to wait before checking the file server
list again. LanBeep only validates this for numeric entries, and not the range
of 0-3600. The number will wrap around to 0 somewhere slightly above 3600.
The default is 0 which means continuous checking.

BEEPINTERVAL is the number of seconds to wait before dialing the beeper again
if it has not received acknowledgement of the initial beep. The same
validation holds true for this keyword as for SCANINTERVAL. The default is
300 which means beep every 5 minutes. NOTE: LanBeep delays 40 seconds after
dialing a beeper to allow for the modem to finish the command. Setting
BEEPINTERVAL to a value less than 60 may cause a backup which will prevent
local shutdown and possibly remote shutdown.

MINFSERRORCOUNT is the number of times that LanBeep will retry a file server
that doesn't respond before considering the file server to have a problem.
This eliminates false beeps caused by sporadic errors that recover
automatically. The default is 10. If MINFSERRORCOUNT is set to 0, the file
servers will NOT be scanned at all, no matter what SCANINTERVAL is set at.
This can be used to disable the network scanning, and still use LanBeep as a
means to shut the PC down with an errorlevel (e.g., remote shutdown with
errorlevel 1 might cause the PC to jump into ProComm Plus(R) host mode, while
remote shutdown with errorlevel 2 might cause the PC to jump into
PC/Anywhere(R) host mode).

LanBeep v2.1 -Configuration (Continued)- Page 12


TONERECOGNITION is a string that can contain a 'Y'. If a 'Y' is found anywhere
in this keyvalue, the modem will answer the phone when a ring is detected in
an attempt to receive remote commands. The default setup is to ignore incoming
calls.
NOTE: When using a US Robotics(R) Courier(tm) modem (required for using this
keyword), the "supervisor chip" needs to have a date of 09/25/91 or later. To
determine the date of your chip, use a communications package to do the
following:

Go into terminal mode (where you can manually enter modem commands)
Type ATI7 (the third character is a capital i)

The date of the supervisor chip will be displayed. If the supervisor chip has
a date before 09/25/91, you can obtain a free upgrade chipset (three chips) by
calling US Robotics(R) Customer Service at (800) 982-5151. Have your modem's
serial number handy, and ask for the chip upgrade. It will be free as long as
you return the old chips after you replace them. An easy to follow instruction
sheet accompanies the chip upgrade package.

LanBeep v2.1 -Remote Access- Page 13


To have the LanBeep PC execute commands (via the batch file that started
LanBeep), voice call the PC, and when it picks up, wait about five seconds
before entering digits from your telephone's keypad. There is no confirmation
from the PC that it has answered, only the lack of rings. After waiting five
seconds for the PC to set itself up, enter the following on the phone's
keypad:

#Acknowledgement Access Code#
-or-
#Dial In Access Code#command#

where the code is the six digit Dial In Access Code or Acknowledgement Access
Code, and command is a valid command (see Commands on page 15). The first #
signals the start of the access code, the second # signals the end of the
access code, and also the start of the command, and the third # signals the end
of the command. Note that the command field is not required when using the
Acknowledgement Access Code (and is ignored if it is supplied).

If an entry has not been completed, and a key is not punched in over the phone
within 20 seconds of the last key punched in, LanBeep will hang up and resume
whatever it was doing before the call came in.

If an incorrect digit is pushed while entering either the access code or
command, you can push '*' to signal that the current FIELD is being re-entered.
If the Dial In Access Code is 123456, and the command is 14, then you'd enter:

#123456#14#

and hang up. The following examples show possibilities that will result in the
same command being executed as the above example, except that they contain
errors and corrections in the keyed data:

#2*123456#14# -2 was entered instead of 1 for the first
access code digit, so restart the access code
field by entering a '*'.

#12346*123456#14# -5 was skipped in the access code, so restart
the access code field by entering a '*'.

#123456#5*16*14# -5 was entered instead of 1 for the first
command digit, so restart the command field by
entering a '*', then 6 was entered instead of 4
4 for the last command digit, so restart the
command field again.

123456#123456#14# -all data is ignored before LanBeep recognizes
a '#'.

LanBeep v2.1 -Remote Access (Continued)- Page 14


If the Acknowledgement Access Code is 141414, then to stop LanBeep from dialing
the beeper, you'd enter:

#141414# -Acknowledgement Access Code entered, no
command field.

The following show invalid keyed data which will result in the PC hanging up
the line and resuming whatever it was doing before the call came in:

##14# -signal start and end of the access code field
(##), but the access code is actually null
(same effect as if the wrong code had been
entered).

#123456## -signal start and end of the command field
(##), but the command is actually null (same
effect as if an unknown command had been
entered). This will, however, still act as an
acknowledgement of a beep (if the
Acknowledgement Access Code was 123456).

#123456# -timeout will occur 20 seconds after the last
key is hit (unless the Acknowledgement Access
Code was 123456, in which case the beeping
would be acknowledged).

#12 -timeout will occur 20 seconds after the last
key is hit.

LanBeep v2.1 -Commands- Page 15


The following are valid commands that LanBeep can react to:

Command Result

10 exit with errorlevel set to 0
11 exit with errorlevel set to 1
12 exit with errorlevel set to 2
13 exit with errorlevel set to 3
14 exit with errorlevel set to 4
15 exit with errorlevel set to 5
16 exit with errorlevel set to 6
17 exit with errorlevel set to 7
18 exit with errorlevel set to 8
19 exit with errorlevel set to 9
20 beep back with current status
21 reset beep count


NOTES:

Command 20 does not increment the beep count

Command 21 is used to allow LanBeep to start beeping again (if
necessary) after it has reached MAXBEEPS

Commands beginning with a '1' (exit with errorlevel set) are not
actually carried out in this evaluation copy of LanBeep. They are,
however, still documented in the log file.

LanBeep v2.1 -Sample AUTOEXEC.BAT- Page 16


The following is an example AUTOEXEC.BAT that uses the errorlevel exit codes of
LanBeep to determine what to do next:

prompt $p$g set the prompt
path=c:\dos;c:\ set the path
\lan\ipx load the network shell (ipx and netx)
\lan\netx
cd \lan\monitor
lanbeep run LanBeep
if errorlevel 9 goto level9 evaluate exit code
if errorlevel 8 goto level8
if errorlevel 7 goto level7
if errorlevel 6 goto level6
if errorlevel 5 goto level5
if errorlevel 4 goto level4
if errorlevel 3 goto level3
if errorlevel 2 goto level2
if errorlevel 1 goto level1
goto done
:level9 command(s) to execute upon exit code 9
do something
.
.
.
:level2 commands to execute upon exit code 2
cd \pcplus
pcplus /fhostmode run Procomm Plus(R) using a host mode
script (see Procomm Plus(R) manual)
cd \ when host mode is finished,
coldboot use a program to reboot the PC
:level1 commands to execute upon exit code 1
cd \awhost
awhost -m=w run PC/Anywhere(R) in host mode
:done
cd \
cls

LanBeep v2.1 -Sample LANBEEP.CFG- Page 17


The following is an example configuration for LanBeep:

;identify this region
REGION=01
;file server names
FSNAME=FS1
FSNAME=FS2
FSNAME=FS3
FSNAME=FS4
FSNAME=FS5
FSNAME=FS6
FSNAME=FS7
FSNAME=FS8
FSNAME=FS9
;beeper number to dial
BEEPER=912015556666
;use com2
PORT=COM2
;beep a maximum of 10 times
MAXBEEPS=10
;scan the file server list every 5 seconds
SCANINTERVAL=5
;beep every 15 minutes
BEEPINTERVAL=900
;minimum of 15 errors before considered real
MINFSERRORCOUNT=15
;enable remote command recognition (see REQUIREMENTS on page 3)
TONERECOGNITION=YES

NOTE: Using this example, if any one of the servers has a problem, LanBeep
will retry that server 15 times in a row (MINFSERRORCOUNT=15). It will not
consider each 5 second scan (SCANINTERVAL=5) as 1 received error, it will try
up to 15 times within a single scan.

LanBeep v2.1 -Beeper Displays- Page 18


Using the sample configuration file from page 17, the following is the beep
layout:

01ccc111000 where:

01 indicates the region code.
ccc is the count of beeps since last reset (implicitly by
program startup, or explicitly by command 21).
111 is the return code for file servers 9-16 (10-16 are not
used in this example).
000 is the return code for file servers 1-8.

NOTE: For every group or partial group of 8 file servers, there will be 3
digits in the beep layout for its return code, ranking from right to left
corresponding to the configuration file. If there were 19 file servers, the
beeper would display:

01ccc222111000 where:

222 is the return code for file servers 17-24 (17-19 are
relevant).

NOTE: The beeper may also display 010010 where:

01 indicates the region code.
0010 indicates that the shell isn't loaded.

This is usually followed by a beep with the previously described layout,
indicating that all the file servers are not responding, i.e., you'll get 2
beeps:

010010
01ccc255255

NOTE: A code of 255 means either all of the file servers are down, the shell
isn't loaded (which would make it appear to LanBeep as if all of the file
servers are down), or that the file server to which the Lanbeep PC is attached
is down. For instance, if you have a LanBeep PC attached to a Hub/MAU which
hangs off of FS4, and FS4 goes down, the PC will no longer be able to see any
of the other file servers on the network. It will get a network error and
reboot. AUTOEXEC.BAT will fail to load the shell, and Lanbeep will beep you
indicating: on the first beep- that the shell isn't loaded, and on every beep
after that- that all of the file servers are down. It is for this reason that
we recommend hanging a LanBeep PC off of a backbone, independent of any one
specific file server, when used in a multi-server environment.

LanBeep v2.1 -Decoding Return Codes- Page 19


The return codes are bitmapped from right to left. To figure out which file
server(s) are not responding, convert the digits from decimal to hex to binary.
Assume that LanBeep is scanning file servers 1-9. If the beeper displays
01001001165, it means:

01 = region code.
001 = this is the first beep.
001 = return code for file server 9 (9-16, but only 9 exists in
this example).
165 = return code for file servers 1-8.

Convert from decimal to hex to binary:

Return code 001 = 01h = 00000001b.
Return code 165 = A5h = 10100101b.

Determine which file servers are not responding:

001/01h ³ 165/A5h = status in decimal/hex.
00000001 ³ 10100101 = status in binary.
xxxxxxx9 ³ 87654321 = file servers in order defined in configuration
file, laid out from right to left.

So FS1, FS3, FS6, FS8 and FS9 are not responding because their corresponding
bits are set to 1.

As previously mentioned, for each group of eight file servers, there is a three
digit return code. If you don't want to do the conversions, see the table on
page 20 which tells you what file servers are not responding (within their
specific group of eight). So, given the previous example of 001165 as the
return code for servers 1-9, after looking at the chart we can see that:

001 = the first server in this group is not responding
165 = file server numbers 1, 3, 6 and 8 in this group are not
responding

LanBeep v2.1 -Conversion Table- Page 20


Return Code Corresponding File Server(s)
(Decimal) Not Responding (Within Group)


000 ................................... None- all are ok
001 ................................... 1
002 ................................... 2
003 ................................... 1 and 2
004 ................................... 3
005 ................................... 1 and 3
006 ................................... 2 and 3
007 ................................... 1, 2 and 3
008 ................................... 4
009 ................................... 1 and 4
010 ................................... 2 and 4
011 ................................... 1, 2 and 4
012 ................................... 3 and 4
013 ................................... 1, 3 and 4
014 ................................... 2, 3 and 4
015 ................................... 1, 2, 3 and 4
016 ................................... 5
017 ................................... 1 and 5
018 ................................... 2 and 5
019 ................................... 1, 2 and 5
020 ................................... 3 and 5
021 ................................... 1, 3 and 5
022 ................................... 2, 3 and 5
023 ................................... 1, 2, 3 and 5
024 ................................... 4 and 5
025 ................................... 1, 4 and 5
026 ................................... 2, 4 and 5
027 ................................... 1, 2, 4 and 5
028 ................................... 3, 4 and 5
029 ................................... 1, 3, 4 and 5
030 ................................... 2, 3, 4 and 5
031 ................................... 1, 2, 3, 4 and 5
032 ................................... 6
033 ................................... 1 and 6
034 ................................... 2 and 6
035 ................................... 1, 2 and 6
036 ................................... 3 and 6
037 ................................... 1, 3 and 6
038 ................................... 2, 3 and 6
039 ................................... 1, 2, 3 and 6
040 ................................... 4 and 6
041 ................................... 1, 4 and 6
042 ................................... 2, 4 and 6
043 ................................... 1, 2, 4 and 6
044 ................................... 3, 4 and 6
045 ................................... 1, 3, 4 and 6

LanBeep v2.1 -Conversion Table (Continued)- Page 21


Return Code Corresponding File Server(s)
(Decimal) Not Responding (Within Group)


046 ................................... 2, 3, 4 and 6
047 ................................... 1, 2, 3, 4 and 6
048 ................................... 5 and 6
049 ................................... 1, 5 and 6
050 ................................... 2, 5 and 6
051 ................................... 1, 2, 5 and 6
052 ................................... 3, 5 and 6
053 ................................... 1, 3, 5 and 6
054 ................................... 2, 3, 5 and 6
055 ................................... 1, 2, 3, 5 and 6
056 ................................... 4, 5 and 6
057 ................................... 1, 4, 5 and 6
058 ................................... 2, 4, 5 and 6
059 ................................... 1, 2, 4, 5 and 6
060 ................................... 3, 4, 5 and 6
061 ................................... 1, 3, 4, 5 and 6
062 ................................... 2, 3, 4, 5 and 6
063 ................................... 1, 2, 3, 4, 5 and 6
064 ................................... 7
065 ................................... 1 and 7
066 ................................... 2 and 7
067 ................................... 1, 2 and 7
068 ................................... 3 and 7
069 ................................... 1, 3 and 7
070 ................................... 2, 3 and 7
071 ................................... 1, 2, 3 and 7
072 ................................... 4 and 7
073 ................................... 1, 4 and 7
074 ................................... 2, 4 and 7
075 ................................... 1, 2, 4 and 7
076 ................................... 3, 4 and 7
077 ................................... 1, 3, 4 and 7
078 ................................... 2, 3, 4 and 7
079 ................................... 1, 2, 3, 4 and 7
080 ................................... 5 and 7
081 ................................... 1, 5 and 7
082 ................................... 2, 5 and 7
083 ................................... 1, 2, 5 and 7
084 ................................... 3, 5 and 7
085 ................................... 1, 3, 5 and 7
086 ................................... 2, 3, 5 and 7
087 ................................... 1, 2, 3, 5 and 7
088 ................................... 4, 5 and 7
089 ................................... 1, 4, 5 and 7
090 ................................... 2, 4, 5 and 7

LanBeep v2.1 -Conversion Table (Continued)- Page 22


Return Code Corresponding File Server(s)
(Decimal) Not Responding (Within Group)


091 ................................... 1, 2, 4, 5 and 7
092 ................................... 3, 4, 5 and 7
093 ................................... 1, 3, 4, 5 and 7
094 ................................... 2, 3, 4, 5 and 7
095 ................................... 1, 2, 3, 4, 5 and 7
096 ................................... 6 and 7
097 ................................... 1, 6 and 7
098 ................................... 2, 6 and 7
099 ................................... 1, 2, 6 and 7
100 ................................... 3, 6 and 7
101 ................................... 1, 3, 6 and 7
102 ................................... 2, 3, 6 and 7
103 ................................... 1, 2, 3, 6 and 7
104 ................................... 4, 6 and 7
105 ................................... 1, 4, 6 and 7
106 ................................... 2, 4, 6 and 7
107 ................................... 1, 2, 4, 6 and 7
108 ................................... 3, 4, 6 and 7
109 ................................... 1, 3, 4, 6 and 7
110 ................................... 2, 3, 4, 6 and 7
111 ................................... 1, 2, 3, 4, 6 and 7
112 ................................... 5, 6 and 7
113 ................................... 1, 5, 6 and 7
114 ................................... 2, 5, 6 and 7
115 ................................... 1, 2, 5, 6 and 7
116 ................................... 3, 5, 6 and 7
117 ................................... 1, 3, 5, 6 and 7
118 ................................... 2, 3, 5, 6 and 7
119 ................................... 1, 2, 3, 5, 6 and 7
120 ................................... 4, 5, 6 and 7
121 ................................... 1, 4, 5, 6 and 7
122 ................................... 2, 4, 5, 6 and 7
123 ................................... 1, 2, 4, 5, 6 and 7
124 ................................... 3, 4, 5, 6 and 7
125 ................................... 1, 3, 4, 5, 6 and 7
126 ................................... 2, 3, 4, 5, 6 and 7
127 ................................... 1, 2, 3, 4, 5, 6 and 7
128 ................................... 8
129 ................................... 1 and 8
130 ................................... 2 and 8
131 ................................... 1, 2 and 8
132 ................................... 3 and 8
133 ................................... 1, 3 and 8
134 ................................... 2, 3 and 8
135 ................................... 1, 2, 3 and 8


LanBeep v2.1 -Conversion Table (Continued)- Page 23


Return Code Corresponding File Server(s)
(Decimal) Not Responding (Within Group)


136 ................................... 4 and 8
137 ................................... 1, 4 and 8
138 ................................... 2, 4 and 8
139 ................................... 1, 2, 4 and 8
140 ................................... 3, 4 and 8
141 ................................... 1, 3, 4 and 8
142 ................................... 2, 3, 4 and 8
143 ................................... 1, 2, 3, 4 and 8
144 ................................... 5 and 8
145 ................................... 1, 5 and 8
146 ................................... 2, 5 and 8
147 ................................... 1, 2, 5 and 8
148 ................................... 3, 5 and 8
149 ................................... 1, 3, 5 and 8
150 ................................... 2, 3, 5 and 8
151 ................................... 1, 2, 3, 5 and 8
152 ................................... 4, 5 and 8
153 ................................... 1, 4, 5 and 8
154 ................................... 2, 4, 5 and 8
155 ................................... 1, 2, 4, 5 and 8
156 ................................... 3, 4, 5 and 8
157 ................................... 1, 3, 4, 5 and 8
158 ................................... 2, 3, 4, 5 and 8
159 ................................... 1, 2, 3, 4, 5 and 8
160 ................................... 6 and 8
161 ................................... 1, 6 and 8
162 ................................... 2, 6 and 8
163 ................................... 1, 2, 6 and 8
164 ................................... 3, 6 and 8
165 ................................... 1, 3, 6 and 8
166 ................................... 2, 3, 6 and 8
167 ................................... 1, 2, 3, 6 and 8
168 ................................... 4, 6 and 8
169 ................................... 1, 4, 6 and 8
170 ................................... 2, 4, 6 and 8
171 ................................... 1, 2, 4, 6 and 8
172 ................................... 3, 4, 6 and 8
173 ................................... 1, 3, 4, 6 and 8
174 ................................... 2, 3, 4, 6 and 8
175 ................................... 1, 2, 3, 4, 6 and 8
176 ................................... 5, 6 and 8
177 ................................... 1, 5, 6 and 8
178 ................................... 2, 5, 6 and 8
179 ................................... 1, 2, 5, 6 and 8
180 ................................... 3, 5, 6 and 8

LanBeep v2.1 -Conversion Table (Continued)- Page 24


Return Code Corresponding File Server(s)
(Decimal) Not Responding (Within Group)


181 ................................... 1, 3, 5, 6 and 8
182 ................................... 2, 3, 5, 6 and 8
183 ................................... 1, 2, 3, 5, 6 and 8
184 ................................... 4, 5, 6 and 8
185 ................................... 1, 4, 5, 6 and 8
186 ................................... 2, 4, 5, 6 and 8
187 ................................... 1, 2, 4, 5, 6 and 8
188 ................................... 3, 4, 5, 6 and 8
189 ................................... 1, 3, 4, 5, 6 and 8
190 ................................... 2, 3, 4, 5, 6 and 8
191 ................................... 1, 2, 3, 4, 5, 6 and 8
192 ................................... 7 and 8
193 ................................... 1, 7 and 8
194 ................................... 2, 7 and 8
195 ................................... 1, 2, 7 and 8
196 ................................... 3, 7 and 8
197 ................................... 1, 3, 7 and 8
198 ................................... 2, 3, 7 and 8
199 ................................... 1, 2, 3, 7 and 8
200 ................................... 4, 7 and 8
201 ................................... 1, 4, 7 and 8
202 ................................... 2, 4, 7 and 8
203 ................................... 1, 2, 4, 7 and 8
204 ................................... 3, 4, 7 and 8
205 ................................... 1, 3, 4, 7 and 8
206 ................................... 2, 3, 4, 7 and 8
207 ................................... 1, 2, 3, 4, 7 and 8
208 ................................... 5, 7 and 8
209 ................................... 1, 5, 7 and 8
210 ................................... 2, 5, 7 and 8
211 ................................... 1, 2, 5, 7 and 8
212 ................................... 3, 5, 7 and 8
213 ................................... 1, 3, 5, 7 and 8
214 ................................... 2, 3, 5, 7 and 8
215 ................................... 1, 2, 3, 5, 7 and 8
216 ................................... 4, 5, 7 and 8
217 ................................... 1, 4, 5, 7 and 8
218 ................................... 2, 4, 5, 7 and 8
219 ................................... 1, 2, 4, 5, 7 and 8
220 ................................... 3, 4, 5, 7 and 8
221 ................................... 1, 3, 4, 5, 7 and 8
222 ................................... 2, 3, 4, 5, 7 and 8
223 ................................... 1, 2, 3, 4, 5, 7 and 8
224 ................................... 6, 7 and 8
225 ................................... 1, 6, 7 and 8

LanBeep v2.1 -Conversion Table (Continued)- Page 25


Return Code Corresponding File Server(s)
(Decimal) Not Responding (Within Group)


226 ................................... 2, 6, 7 and 8
227 ................................... 1, 2, 6, 7 and 8
228 ................................... 3, 6, 7 and 8
229 ................................... 1, 3, 6, 7 and 8
230 ................................... 2, 3, 6, 7 and 8
231 ................................... 1, 2, 3, 6, 7 and 8
232 ................................... 4, 6, 7 and 8
233 ................................... 1, 4, 6, 7 and 8
234 ................................... 2, 4, 6, 7 and 8
235 ................................... 1, 2, 4, 6, 7 and 8
236 ................................... 3, 4, 6, 7 and 8
237 ................................... 1, 3, 4, 6, 7 and 8
238 ................................... 2, 3, 4, 6, 7 and 8
239 ................................... 1, 2, 3, 4, 6, 7 and 8
240 ................................... 5, 6, 7 and 8
241 ................................... 1, 5, 6, 7 and 8
242 ................................... 2, 5, 6, 7 and 8
243 ................................... 1, 2, 5, 6, 7 and 8
244 ................................... 3, 5, 6, 7 and 8
245 ................................... 1, 3, 5, 6, 7 and 8
246 ................................... 2, 3, 5, 6, 7 and 8
247 ................................... 1, 2, 3, 5, 6, 7 and 8
248 ................................... 4, 5, 6, 7 and 8
249 ................................... 1, 4, 5, 6, 7 and 8
250 ................................... 2, 4, 5, 6, 7 and 8
251 ................................... 1, 2, 4, 5, 6, 7 and 8
252 ................................... 3, 4, 5, 6, 7 and 8
253 ................................... 1, 3, 4, 5, 6, 7 and 8
254 ................................... 2, 3, 4, 5, 6, 7 and 8
255 ................................... 1, 2, 3, 4, 5, 6, 7 and 8

LanBeep v2.1 -Problems/Possible Solutions- Page 26


Problem Possible Solution


No display is visible Use /C command line option
Use /M command line option

Modem doesn't dial beeper Check beeper string length (see BEEPER
NOTE on page 11)
This function is disabled in this
evaluation copy (see the log file for
the actions that would occur in the
production version)

Phone isn't being answered Use TONERECOGNITION=YES in
configuration file

Tones are not recognized from Use a US Robotics(R) Courier(tm) modem
remote phone Make sure that the supervisor chip's
date is 09/25/91 or later (see
TONERECOGNITION NOTE on page 12)

The PC reboots when you try When you connect to PC/Anywhere(R), it
to connect to PC/Anywhere(R) drops back to the next line of the
batch file that called it. Note how
the sample AUTOEXEC.BAT on page 16
allows PC/Anywhere(R) to change the
current directory and clear the screen.
No reboot will take place until you
exit PC/Anywhere(R) (as long as that
option is set- see the PC/Anywhere(R)
manual)

LanBeep v2.1 -Comments/Suggestions- Page 27


If you have any comments or suggestions, please address any correspondence to:

Deerfield Computer Solutions, Inc.
43 Baldwin Terrace
Wayne, NJ 07470
(201) 696-3817

We are also very concerned with putting out accurate, understandable
documentation, and would appreciate any feedback you have to offer.