
RUPS v3.2
UPS Monitoring Utility
User's Manual

Microsoft Windows 95, Windows NT, Windows 3.1, MS-DOS,
Novell NetWare, IBM LAN Server, ARTISOFT LANtastic,
Microsoft LAN Manager

COPYRIGHT ANNOUNCEMENT
LIMITED WARRANTY
THE PROGRAM AND ENCLOSED MATERIALS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
IMPLIED WARRANTIES OF MERCHANT ABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
THE ENTIRE RISK AS TO QUALITY AND PERFORMANCE OF THE PROGRAM AND ENCLOSED
MATERIAL IS ASSUMED BY YOU.

LIMITATION OF REMEDIES
Mega System Technologies Incorporation entire liability and your exclusion
remedy shall be replacement of the media if you have met the conditions as
described under "Limited Warranty."
In no event will Mega System Technologies Incorporation be liable to you for
any other damages arising out of your use of this program.
All mentioned trademarks are registered trademarks of their respective
owners.

TECHNICAL SUPPORT
RUPS is developed by Mega System Technologies, Inc. If there is any question
or comment about this product, please be free to contact us.

Mega System Technologies, Inc.
12F, No.219, Sec.3, Pa-Teh Road, Taipei, Taiwan, R.O.C.
Tel: +886-2-5701300
Fax: +886-2-5701345
CompuServe ID#: 101400,362
E-MAIL: service@megatec.com.tw
FTP: ftp://megatec.com.tw
WWW: http://www.megatec.com.tw
Copyright 1996, 1997 by: Mega System Technologies, Inc.

CONTENTS
1. Introduction 1
1.1 Overview    1
1.2 Features    1
1.3 Operating System Supported  2
1.4 Package Contains    2
2. Hardware Installation        3
3. RUPS for Windows 95 & v3.1   4
3.1 Installation        4
3.2 UPS Status Display  4
3.3 Configuration       5
3.4 Actions RUPS takes when Power Failed        6
3.5 Review History Information  7
3.6 RUPS Warning Messages       9
3.7 Terminate RUPS      9
4. RUPS for Windows NT  10
5. RUPS for MS-DOS      13
5.1 Installation        13
5.2 Configuration       13
5.3 Define Profile Keys 15
5.4 Review History Information  16
5.5 Warning Messages    17
6. RUPS for NetWare     18
6.1 Installation        18
6.2 Start and Stop RUPS 18
6.3 UPS Status Display  19
6.4 RUPS Functions      20
6.5 Warning Messages    22
7. RUPS for LAN Server  23
8. RUPS for LANtastic   25
9. RUPS for LAN Manager 26
Appendix - Hardware Requirements        27

1. Introduction
1.1 Overview
Many computer systems use the UPS (Uninterrupted Power System) to protect
the system from utility power failure. However, the UPS can only provide
limited battery power. When a power failure occurs, system operator has to
shut down the system. Otherwise, it may cause system corruption and data loss
when the battery is exhausted.

RUPS is a UPS monitoring utility. It can detect the status of an intelligent
UPS at a local location, through a cable attached to a serial port on the
system. When power failure occurs, RUPS will get the power failure signal
and send warning message to all the users on the system. After the shutdown
timer countdowns to zero, RUPS will shut down the operating system and then
turn off UPS power. Upon recovery of the utility power, UPS will activate
and boot-up the system.

RUPS also provides programmable timer setting for battery low situations.
The battery low detection could ensure a complete system shutdown when the
UPS battery is almost exhausted.

1.2 Features
* Line Failure and Battery Low Detection.
* Abnormal Power Condition Recording and Broadcasting.
* Monitors Power Status through the system's RS232 Serial Port. No
Additional Hardware Required.
* Programmable Shutdown Delay Time and Warning Period.
* Saves files and closes applications in MS-DOS with user defined key-in
strings.
* Saves your work and shuts down Microsoft Windows 95 and v3.1, before
turning off UPS. No shutdown macros needed.
* Provides Night-Off function in the Novell NetWare operating system.

1.3 Operating System Supported
RUPS can provide UPS services on the following operating systems which have
a dedicated RS232 serial port.
* Microsoft Windows 95
* *Microsoft Windows NT v4.0 and v3.x
* Microsoft Windows v3.1
* MS-DOS version 5.0+
* Novell NetWare v3.1x, v4.x
* *IBM LAN Server v3.0
* *ARTISOFT LANtastic v4.1, v5.0 and v6.0
* *Microsoft LAN Manager
*Using the original UPS services included in the Operating System.

1.4 Package Contains
* RUPS Installation Diskettes.
* RUPS User's Manual.
* M2501 or M2603 Cable.
* A DB-9 Male/DB-25 Female Adapter.


2. Hardware Installation
Please follow the instructions below to install RUPS for local UPS
monitoring.

1. Plug the DB-9 female connector of M2501/M2603 cable to the RS232 port of
your system. Please use the DB9Male/DB25Female adapter if you want to
connector a DB-25 male serial port.
2. Connect the DB-9 male end of M2501/M2603 cable to the interface port of
intelligent UPS, which is a DB-9 female connector on UPS.
WARNING! There is an electronic circuit inside the M2501 and M2603 cable. Do
not use this cable to connect any other devices except UPS. Permanent damage
will be caused if used in an improper condition.

3. RUPS for Windows 95 & v3.1
3.1 Installation
To install RUPS on Windows 95, execute the 'SETUP.EXE' in sub-directory
'Win95' in RUPS installation diskette. The installation program will copy
all the necessary files to the target folder and copy a execution file name
'RupsWin.EXE' to the system 'StartUp' folder. This will make RUPS for
Windows95 execution program executed every time system startup.

To install RUPS on Windows v3.1, please install the RUPS for MS-DOS first.
Then bring up Windows v3.1 and execute a program named 'SETUPGRP.EXE' in the
RUPS directory. The setup group program will ask you if confirm about
generating a new group for RUPS. Please press 'YES' to create new group and
program items for RUPS. The 'SETUPGRP.EXE' will also append a load
'RupsWin.EXE' command in your startup group.

3.2 UPS Status Display
In Windows95 and v3.1 environment, you could get the current UPS status in
the RupsWin window. Double click the RupsWin icon shows the dialog as shown
here. Explanation of each item is as follows.
Uninterruptible Power Supply is Installed on
This field shows which COM port is currently attached to the UPS and is used
for status communication.
System AC Power
This field shows the status of system AC power; it can be changed to either
'Normal' or 'Failed'.
UPS Battery Status
This field shows status of UPS battery; it can be changed to either 'Normal'
or 'Weak'.
Shutdown Countdown
This field shows the countdown value of RUPS shutdown timer if there is a
power abnormal condition occurred.
Button OK
Press this button to minimize this UPS Status window.
Button Help
Press this button to display the help information of RUPS.
Button Config
Press this Button to modify RUPS parameters.

3.3 Configuration
Please select the 'Configuration...' item in the RupsWin system menu to
display the RUPS Configuration dialog, as shown here. In this dialog, you
can configure all the parameters of RUPS for Windows.
Uninterruptible Power Supply is installed on
This field shows which RS232 port will be used to connect UPS. Set 'AUTO' to
make RUPS search through all the COM port on the system every time RUPS
loaded. Please restart the system every time you modify this field.
Expected Battery Life
This option sets how long the expected UPS battery life will be. Please
refer to the UPS reference manual for an appropriate setting. The input
range is between 00:10 - 999:59 minutes.
Battery Life when Battery Low
This option sets how long the expected UPS battery could supply system power
when it is in a battery weak condition will be. The input range is between
00:00 - 99:59 minutes. Because it takes some time to shut down the system,
we recommend you set this field as zero.
Time between Power failure and initial warning message
This option sets when the first warning message will be initiated after an
abnormal condition happened. The input range is between 00:03 - 02:00
seconds.
Delay between warning messages
This option sets how long the periodical warning message will be initiated
after the first warning message. The input range is between 05:00 - 15:00
seconds.

3.4 Actions RUPS takes when Power Failed
If there is an abnormal condition in system power detected, RupsWin will
take the following actions:
Inform User the Abnormal Condition
RupsWin will send out warning messages to inform user about this abnormal
condition. The warning delay time is set in Configuration dialog (see Sec.3.3
 Configuration for more information).
Try to Close Every Application in Your Windows System
When the countdown timer reaches zero and this failure condition continued,
RupsWin will try to close every application in your Windows system. It will
also record every application's name and title in the history file (see
Sec.3.5 Review Shutdown Information for more information).
Save Your Working Data
If your application program is asking for a confirmation of saving the
current working data before exit, RupsWin will always answer YES for you.
Give a TMP Filename to Save Current Working Data
If you did not give the current working data a filename, RupsWin will give
the application a '~Wnnnn.TMP' filename. You could review these working data
in the Related Working Filename window in the Review Shutdown Records (see
Sec.3.5 Review History Information). However, we strongly recommend you give
a filename every time you open a new working sheet.
Close DOS Boxes According to the Profile Keys
If there is a DOS Box in your Windows system, RupsWin will restore the DOS
Box window and try to close it according to the key-in strings user defined
in 'RUPS.KEY' (see Sec.5.3 Define RUPS Profile Keys for more information).
Because Windows is a multi-tasking environment, it will take a longer time
to close the application in DOS Box compared with in the DOS environment.
In order to make RUPS able to monitor current UPS status in the DOS box,
please mark the Background Execution check box in the DOS box PIF file
setting.
Exit Windows and Turn Off UPS Power
If there is no application in your Windows system, RupsWin will shut down
your Windows system and go back to DOS. RUPS will then turn off UPS power
right after Windows exit.

3.5 Review History Information
RUPS records all the abnormal information in a log file named 'RUPS.LOG' in
the RUPS directory. RupsWin also records the closed applications name/title
and related new filenames in the log file during a shutdown process. User
can review this information to check if there is any power failure or any
new file been saved during the last power failure.
3.5.1 Review RUPS Log File
You can review the information in log file by selecting the 'Review RUPS Log
File' item in the RupsWin system menu.
In this dialog, you can view the date and time of all the abnormal UPS
condition that happened. It contains the following possible messages:
RUPS System Start. - 'RUPS.EXE' is loaded.
System AC Power Failed. - System AC power failure detected.
System AC Power Recovered. - System power failure recovered.
UPS Battery Low. - UPS battery low detected.
UPS Battery Low Recovered. - UPS battery low recovered.
RUPS TSR Unloaded. - 'RUPS.EXE' is unloaded.
Shutdown System Power. - RUPS shuts down system power.
This Log file size is limited to 50K bytes. Therefore, you do not have to
worry about it, becoming too large. Press 'OK' to close this dialog or press
'Clear' to clear all the history information in 'RUPS.LOG'.
3.5.2 Review Shutdown Information
You can also view the shutdown information in 'RUPSWIN.INI' file by selecting
the 'Review Shutdown Information...' item in the RupsWin system menu. In this
dialog, you can check if there is any application closed during the last
power failure shutdown. It also shows the related filenames in the next
window. The related filenames were given in the last shutdown process, when
the closed application asked for a filename (see Sec.3.4 Actions RUPS takes
when Power Failed for more information).
This dialog can show only the information about last power failure shutdown.
The information before last shutdown will be cleared. Press 'OK' to close
this dialog or press 'Clear' to clear all the shutdown information in
'RUPSWIN.INI'.

3.6 RUPS Warning Messages
RUPS continuously check the status of system UPS. If there is an abnormal
condition detected, a warning message will show on the screen followed by a
warning beep. The delay time of the first warning message and time between
warning messages can be configured in the Configuration dialog (see Sec.3.3
Configuration for more information).
In Windows environment, if there is an abnormal condition detected, a
warning dialog will be displayed on the screen showing the time left before
shutdown. The icon of RupsWin will also reveal the current status of system
UPS, listed as follows:
        System power is in a normal condition.
        System AC power failed.
        System UPS battery is in a weak condition.
        RupsWin is shutting down the system.

3.7 Terminate RUPS
Select the item 'Close' in the RupsWin system menu to close the RupsWin in
Microsoft Windows.


4. RUPS for Windows NT
Microsoft Windows NT and Microsoft Windows NT Advanced Server includes a UPS
monitoring service in its system. After the hardware installation, start the
UPS monitoring software on the Windows NT as shown in figure below. Please
refer to the Windows NT user's manual for more detailed information about
the meaning of each option in the UPS service.

1. Start the UPS service dialog, as shown in the figure below.
2. Enable the UPS monitoring function and choose the COM port connection for
UPS in your system.
3. Enable the 'Power failure signal' and select 'Negative' in the reference
voltage. The UPS service will send out warning messages when it detects a
power failure condition. The first warning delay and delay between warning
messages can also be configured in this dialog.
Please check the following settings if you have any trouble in receiving the
power failure warnings:
* Check if the 'Alerter Services' is started in the 'Control Panel: Services'.
* Check if the 'Messenger' is started in the 'Control Panel: Services'.
* Choose 'Control Panel: Server' and select 'Alerts'. Check if the target
computer or username is in the alert list.
4. Enable the 'Low battery signal' and select 'Negative' in the reference
voltage. The UPS service will shut down Windows NT as soon as it detects
this low battery condition.
The UPS service expects the UPS can supports system power more than 2
minutes after sending out this signal. If you are using the UPS in a heavy
loaded situation, which means the UPS cannot support the 2 minutes power
after battery low, or your system takes more than 2 minutes to shut down, do
not enable this function. Please specify the time in minutes that the system
can run on battery power in 'Expected Battery Life' in the 'UPS
Characteristics'. In addition, specify the time of the battery recharged for
every minute of run time in 'Battery recharge time per minute of run time'.
5. Enable the 'Remote UPS Shutdown' and select 'Positive' in the reference
voltage.
If the UPS turned off system power as soon as Windows NT boot-up when system
is running on the UPS battery power, please contact your dealer to replace
the UPS cable from M2501 to M2603.
6. If there is a command file intended to be execute before power failure
shutdown, enable the 'Execute Command File' and set the command file name.
Press 'OK ' to close the UPS service dialog and start the UPS service.
7. Check if the UPS service is activated and set to 'Automatic'. Select
'Services' in Control Panel and check the status of UPS service. As shown in
the figure below.

After UPS service started, the power abnormal conditions can be found in the
'Event Viewer' by selecting the 'Programs/Administrative Tools:Event Viewer'.

5. RUPS for MS-DOS
5.1 Installation
To install RUPS for MS-DOS, execute the 'INSTALL.EXE' under MS-DOS.
C:\>A:INSTALL

Please select the 'MS-DOS' in the installation menu, the installation program
will copy all the necessary files of RUPS for MS-DOS into the designated
RUPS path. It also appends a RUPS loading command in your 'AUTOEXEC.BAT'
file. After complete installation, installation program will execute the
configuration program and let you setup the configurations of RUPS.
'RUPS.EXE' is a resident program and a primary execution file of RUPS for
DOS/Windows. You have to install RUPS for MS-DOS first to make RUPS for
Windows functional.

5.2 Configuration
RUPS for DOS provides a user-friendly interface for you to configure the
parameters of UPS monitoring. Select the 'Configuration...' after you
execute the RUPS configuration program 'CONFIG.EXE'. The configured
parameters will be saved in 'RUPS.CFG' in RUPS directory. Detailed
explanation is follows.
Where Uninterruptible Power Supply is installed
This field shows which RS232 port will be used to connect UPS. Set 'AUTO' to
make RUPS search through all the COM port in the system every time RUPS
loaded. Please unload and reload 'RUPS.EXE' every time modifying this field.
Expected Battery Life
This option sets how long the expected UPS battery life. Please refer to the
UPS reference manual for an appropriate setting. The input range is between
10 - 59999 seconds.
Battery Life when Battery Low
This option will set how long the expected UPS Battery can supply system
power when it is in a battery weak condition. The input range is between 0 -
5999 seconds. Because it takes some time to shut down the system, we
recommend you set this field to zero.
Time between Power failure and initial warning message
This option sets when will the first warning message be initiated after an
abnormal condition happened. The input range is between 3 - 120 seconds.
This parameter is only used by RupsWin in Microsoft Windows. In MS-DOS, the
first warning message will be initiated immediately after abnormal condition
occurs.
Delay between warning messages
This option sets how long the periodical warning message will be initiated
after the first warning message. The input range is between 5 - 900 seconds.
You could also append new parameters after the 'RUPS.EXE' command. Type
'RUPS /?' under MS-DOS shows:
Usage: RUPS [/Ann] [/Bnn] [/Wnn] [/Pn] [/Q]
/Ann : System shutdown after nn seconds when AC Power Failed.[10-59999]
/Bnn : System shutdown after nn seconds when UPS Battery Low.[0--5999]
/Wnn : Warning beeps every nn second when Power Failed.[5--900]
/Pn  : COM port n for UPS control.[0--4, 0 : Auto Detect]
/Q   : Unload RUPS.

If there is an abnormal condition in system power detected, RUPS will take
the following actions:
Inform User the Abnormal Condition
RUPS will send out warning messages to inform user about this abnormal
condition. The warning delay time is set in the Configuration dialog (see
RUPS Configuration for more information).
Try to Close Every Application in Your System
When the countdown timer reaches zero and this failure condition continued,
RUPS will try to close every application in your MS-DOS system. RUPS closes
these applications according to the key-in string user define in the file
RUPS.KEY (see Define Profile Keys for more information).
Turn Off UPS Power
When there is no application operated in your DOS system, RUPS will turn off
UPS power. If Windows is currently running, RUPS will wait until Windows
exits and turns off UPS power.

5.3 Define Profile Keys
If a power failure occurred and the timer counts down to zero, RUPS will try
to close every application in your MS-DOS. RUPS close these applications
according to the keying-string you defined in the application profile.
Select the item 'Edit Profile Keys...' in RUPS configuration to show the
dialog below.
During the shutdown process, RUPS checks the name of the application running
in MS-DOS and send out the keying-string defined here to save data and exit
to DOS. After RUPS ends all the application in the MS-DOS environment, RUPS
will turn-off UPS power. Below are the explanations for each field in this
dialog:
Application Field
In this field, you can review or modify the application names saved in the
application profile. You can press '<Ins>' to insert a new application name,
'<Del>' to delete the focused application name or '<Alt-R>' to rename the
focused application name.
If you have a mouse in you system, move the cursor into this field and press
the right button of mouse will also shows a popup menu to select functions
available.
Exit Keys Field
In this field, you can review or modify the exit keying-string correspond to
the focused application in the 'Application Field'. The available functions
are listed below.
* Press <Ins> to insert a keying-string started at the focused key-in
position. When finished, input a <Ctrl-Enter> at the end of exit key string.
* Press <Del> to delete the focused key in the exit keying.
* Press <Alt-A> to append keying-strings at the end of the key-in string.
Press <Ctrl-Enter> at the end of exit key input.
* Press <Alt-E> to insert a <Ctrl-Enter> at the focused keying position.
* Press <Alt-C> to clear all the keys in this exit keying-string.
If you are able to use a mouse in you system, move the cursor into this
field and press the right button of mouse will also shows a popup menu to
select all the functions available.
If you are using a DOS shell command in one application to execute another
program, please make sure there is an 'EXIT<Enter>' keying-string for the
application named 'COMMAND' in this dialog. This will make RUPS able to exit
the DOS shell and go back to where you started DOS shell.

5.4 Review History Information
RUPS records all the abnormal power information in a file named 'RUPS.LOG'
in the RUPS directory. You can view the information in log file by selecting
the menu item 'Review History Information...' in the RUPS configuration
program.
In this dialog, you could review the data/time of all the abnormal power
condition that happened. The log file size is limited to less than 50K bytes.
Therefore, you do not have to worry about if it becoming too large. Press
'OK' to close this dialog or press 'Clear' to clear all the history
information in 'RUPS.LOG'.

5.5 Warning Messages
RUPS continuously checks the status of system UPS. If there is an abnormal
condition detected, a warning message will be shown on the screen followed
by a warning beep. The delay time of the first warning message and time
between warning messages can be configured in the configuration dialog.
When RUPS detected a power failure or battery low condition, it will send
out a warning beep immediately. The power condition and the time left before
shutdown will also be shown at the upper-left corner on the screen. As
followed:
AC Fail nnnn
System power failure, system shutdown after 'nnnn' seconds.
Batt Low nnn
UPS battery low, system shutdown after 'nnn' seconds.
AC Recovered
System power recovered, shutdown process aborted.


6. RUPS for NetWare
6.1 Installation
To install RUPS in a NetWare network operating system, please execute the
installation program on a network workstation. Please follow the procedures
below to install RUPS on your NetWare system.
1. Log on the target file server that you intend to install UPS service. The
login user must have read/write privilege in the sub-directory 'SYS:SYSTEM'.
2. Insert the RUPS diskette to the floppy disk driver and execute the
installation program. The installation program will copy RUPS utility to the
sub-directory 'SYS:SYSTEM' of the File Server.
3. The installation program will also append a command in the server's
startup file 'AUTOEXEC.NCF'. Thus, the file server will load RUPS every time
system boot-up.

6.2 Start and Stop RUPS
After RUPS installation, the file server will load RUPS every time system
boot-up. To start RUPS on file server manually, execute the following
command at console:
:LOAD RUPS
After loading the 'RUPS.NLM', the console will display the RUPS screen as
followed. If there is an error message showing that there is a missing NLM
during the RUPS loading, please copy the missing NLM from the RUPS diskette
to the sub-directory 'SYS:SYSTEM' manually.
RUPS provides two different ways in accessing file server's RS232 ports, the
'UPSC' and 'UPSA'. The 'UPSC.NLM' accesses server's RS232 ports directly and
the 'UPSA.NLM' uses the 'AIOCOMX.NLM', which comes from Novell, as a standard
interface in accessing server's RS232 ports. The default auto-loading driver
of RUPS is the 'UPSC'. If you already use the 'AIOCOMX' in managing file
server's RS232 ports, you should use the 'UPSA' instead of 'UPSC' in case of
any conflict. Please insert a command 'LOAD UPSA' before the 'LOAD RUPS'
command in the file 'SYS:SYSTEM\AUTOEXEC.NCF' after complete installation.
:LOAD UPSA
:LOAD RUPS
To stop RUPS process, you can unload RUPS by selecting 'Exit' on the screen.
You can also unload RUPS by using the unload command on console:
:UNLOAD RUPS
The 'UPSC.NLM' or 'UPSA.NLM' is still in server's memory after you unload
RUPS.NLM. You can unload these NLMs with the unload command at console
screen.

6.3 UPS Status Display
The UPS status is showing in the RUPS screen on console. It contains the
current UPS status information at the left window and abnormal condition
that happened recently at right. The explanation of each field is as follows.
File Server AC Power Status: NORMAL
This field displays the status of system AC power, shows 'NORMAL' or 'FAILED'.
File Server UPS Battery Status: NORMAL
This field displays the status of UPS battery, shows 'NORMAL' or 'WEAK'.
UPS Connect Port: COM1
This field displays the COM port name of file server for UPS communication.
UPS Communication: NORMAL
Displays the status of communication between file server and UPS, shows
'NORMAL' or 'FAILED'.
Shutdown Countdown: 10:00
Displays the system shutdown countdown when system power fails.
The right area of Power System Information shows the latest abnormal
condition RUPS detected. The power abnormal conditions will also be recorded
in the log file.

6.4 RUPS Functions
RUPS menu is located in the bottom of RUPS screen. User can use Up/Down
arrow key to select RUPS functions. Detailed explanations of RUPS functions
are followed.
6.4.1 Configuration
Select the item 'Configuration' to setup RUPS parameters. Selecting the item
will show the dialog here. Description of every item in the configuration
dialog is as follows.
Time Between AC Power Fail and Initial Warning Message
The delay time of the first warning sent out after AC Power fail is detected.
Delay Between Warning Message
The delay time between every warning message.
Delay of Shutdown Server When AC Power Failed
Delay time of system shutdown when AC Power failed detected.
Delay of Shutdown Server When Battery Low
Delay time of system shutdown when UPS Battery Low detected.
Communication Serial Port
The communication port connecting the UPS. Set 'AUTO' to this field will
enable the auto-searching mode.
Night-Off Function
Turn On/Off the Night-Off Function. The Night-Off function provides a
different shutdown delay time in a pre-setting period. If a power failure
happened at night, the system can be shut down immediately. This function
can also provide a scheduled turn-on and turn-off function when combined
with a 24 hour electric timer.
Night-Off Begin time
The begin time of Night-Off function.
Night-Off End time
The end time of Night-Off function.
Night-Off Delay time
The shutdown delay time during the Night-Off period.
6.4.2 View Error Log File
This function is for reviewing the abnormal power condition that happened.
This information is saved in a file named 'RUPS.LOG' in the 'SYS:SYSTEM'
sub-directory. The file is limited up to a size of 50K bytes, thus you do
not have to worry about if it gets too large and occupies the working space
of file server.
Press 'Enter' at the item 'View Error Log File' to show the log file
contents. The explanations of the messages in log file are follows.
System AC Power Failed. - RUPS detected an AC Power failure condition.
UPS Battery Low. - A UPS battery low condition detected.
System AC Power Recovered. - RUPS detected AC Power was restored.
UPS Battery Low Recovered. - Detect UPS battery low condition recovered.
<ERROR> Unable to Shutdown Server. - System error. Unable to shut down file
server.
<ERROR> Unable to Notify Users. - System error. Unable to send warning
messages to users.
RUPS.NLM System Start. - RUPS had been activated.
RUPS.NLM Unloaded. - RUPS was unloaded.
Shutdown File Server. - RUPS shut down the file server.
6.4.3 System Shutdown
You can shut down the file server with this function. If you execute this
command during the AC power abnormal condition, RUPS will shutdown the file
server and turn-off UPS immediately. If you execute this command when in
power normal condition, RUPS will shutdown the file server, but will not
turn-off UPS. Press 'Enter' at item 'System Shutdown' to shut down the File
Server, as shown in figure below.

6.5 Warning Messages
If RUPS detected any abnormal condition of system power or UPS battery, it
will broadcast a warning message to the console and the workstations
attaching to this server. The descriptions of warning messages are here
below.
<WARNING> POWER FAIL, FS shutdown in 5 Min.
System power failure detected, shutdown timer starts to countdown.
<ATTENTION> Server FS shutdown in 1 Min.
System shutdown process continues, system will be shut down after 1 minute.
<ATTENTION> BATTERY LOW, FS shutdown in 1 Min.
UPS battery low detected, system will be shut down after 1 minute.
Server FS Power Recovered, shutdown abort.
Power recovering detected; system will not be shutdown.
Server FS Battery Low Recovered, shutdown in 2 Min.
UPS battery low recovered, but AC power still not recovered.
Server FS Battery Low Recovered, shutdown abort.
UPS battery low recovered, system shutdown process aborted.

7. RUPS for LAN Server
IBM LAN Server includes a UPS monitoring function in the system. Please
refer to the LAN Server's Network Administrator Reference Volume 1:
'Planning and Installation' for detailed information. After installing the
UPS device driver, the LAN Server sets the PORT parameter of the device
driver to either COM1 or COM2.
device=path>\netprog\upsdrv.os2 /PORT:COMx
        /IOADDR:xxxx /IRQ:x

Please append the /IOADDR and /IRQ parameter according to the system
configuration at end of the 'UPSDRV.OS2' command. The 'UPSDRV.OS2' cannot
function properly without these parameters.
Please configure the following options with proper values in the file
'IBMLAN.INI'.
BATTERYMSG:seconds
BATTERYTIME:seconds
CMDFILE:pathname
CMDTIMER:seconds
DEVICENAME:UPS_DEV
LOWBATTERY:WARNING
MESSDELAY:seconds
RECHARGE:minutes
SIGNALS:111
VOLTLEVELS:001

* BATTERYMSG:seconds  range:30 - 3600  default:600
This parameter is valid only when the LOWBATTERY parameter is set to either
"WARNING" or "SHUTDOWN" and a low battery signal is received while the AC
line current is still satisfactory. This parameter determines the interval
of time used to repeat alerts for a low battery condition.
* BATTERYTIME:seconds range: 0 - 28800 default: 60
Sets the number of seconds the server can run on a battery before the UPS
service initiates shutdown. This optional entry is used only if no low-
battery signal is available.
* CMDFILE:pathname
Specifies a command batch program of commands to be run before server
shutdown. The path name can be either absolute or relative to the LAN Server
root directory (IBMLAN). The batch program has only 30 seconds to complete
before the UPS service ends the program.
* CMDTIMER:seconds range:0 - 600 default:30
Specifies the number of seconds the UPS service will give the command file
to complete.
* DEVICENAME:device_name default:UPS_DEV
Specifies the name of the device for the server to open.
* LOWBATTERY:lowbattery  default:WARNING
Specifies the response by the UPS services if the UPS signals that its
battery power is low but the AC line current is satisfactory. If this
parameter is set to 'WARNING', the UPS service generates repeated warnings
to alert recipients, identifying the affected server. If this parameter is
set to 'SHUTDOWN', the UPS service shuts down the affected server after
warning the server's local users and alerting users who have active sessions
with the server. For both WARNING and SHUTDOWN, the 'LOWBATTERY' argument is
set to 'DISABLE', the event is recorded in the error log and no alert is
generated.
* MESSDELAY:seconds range:0 - 120 default:5
Sets the number of seconds between the initial power failure and the first
message sent to user. No messages are sent if power is restored within this
interval.
* MESSTIME:seconds  range:30 - 300  default:120
Sets the number of seconds between messages sent to users notifying them of
a power failure.
* RECHAGE:minutes  range:5 - 250  default:100
Specifies the number of minutes of recharge time required for each minute of
battery run time.
* SIGNALS:111
Specifies the signals available of low-battery from the battery.
* VOLTLEVELS:001
Specifies the voltage levels for the signals listed in the SIGNALS option.

8. RUPS for LANtastic
ARTISOFT LANtastic includes a UPS monitoring utility named 'UPS.EXE' in the
system. However, RUPS uses a different signal polarity from the 'UPS.EXE'.
We have to modify the 'UPS.EXE' in the RUPS installation program. Please
execute the 'INSTALL.EXE' in RUPS installation diskette to setup your system.
After your LANtastic system was completely installed, execute RUPS
installation program at DOS prompt. Select item 'LANtastic' to start setup
the UPS service for LANtastic. In order to modify the 'UPS.EXE', the
installation program has to locate where the LANtastic directory is. Please
answer where the LANtastic sub-directory was located in your system.
After the modification, execute 'UPS.EXE' as mentioned in the LANtastic
User's Manual.
C:\LANTASTI>UPS /DEVICE=COM2
        /LOW_BATTERY=1
        /SHUTDOWN_MINUTES=10
        /BROWNOUT_SECONDS=1
        /CANCEL_SECONDS=3

Please refer to LANtastic User's Manual for detail explanation of 'UPS.EXE'
parameters.

9. RUPS for LAN Manager
Microsoft LAN Manager includes a UPS monitoring utility in the system.
Please refer to the user's manual of LAN Manager if you have any difficulties
in configuring the UPS service.
The command to start UPS service on LAN Manager is:
NET START UPS   [/BATTERYTIME:seconds]
        [/CMDFILE:pathname]
        [/MESSDELAY:seconds]
        [/MESSTIME:seconds]
        [/RECHARGE:minutes]
        /SIGNALS:111
        /VOLTLEVELS:001

* /BATTERYTIME:seconds  range: 0 - 28800  default: 60
Sets the number of seconds the server can run on a battery before the UPS
service initiates shutdown. This optional entry is used only if no low-
battery signal is available.
* /CMDFILE:pathname  default: NULL(empty)
Sets the pathname for the command batch program. This program contains
commands that are run when the server begins to shut down.
* /MESSDELAY:seconds  range: 0 - 120  default: 120
Sets the number of seconds between the initial power failure and the first
message sent to user. No messages will be sent if power is restored within
this interval.
* /MESSTIME:seconds  range: 30 - 300  default: 120
Sets the number of seconds between messages sent to users notifying them of
a power failure.
* /RECHAGE:minutes  range: 5 - 250  default: 100
Sets the minutes of recharge time required for each minute of battery run
time.
* /SIGNALS:111
Specifies the signals available of low-battery from the battery.
* /VOLTLEVELS:001
Specifies the voltage levels for the signals listed in the /SIGNALS option.
For RUPS cable, please specify '001' for this parameter.

Appendix - Hardware Requirements
The M2501 and M2603 cable of RUPS can be used as an interface between the
RS232 port and an intelligent UPS. There are two types of contact closure
signal that RUPS support.
TYPE I
Pin 2
AC Power Failure
Pin 4
Common Ground of Pin 2, 5, 6
Pin 5
UPS Battery Low
Pin 6
Turn Off UPS

TYPE II
Pin 2
AC Power Failure
Pin 4
Common Ground of Pin 2, 5
Pin 5
UPS Battery Low
Pin 6
Turn Off UPS
Pin 7
GND of Pin 6

RUPS - User's Manual
Copyright ( Mega System Technologies, Inc. 1997 Rev.2.7.001
