Novell Doc: NW 6.5 SP8: Utilities Reference

1.174 UPS_AIO

Purpose

If your uninterruptible power supply (UPS) is connected to the server through a serial port, use UPS_AIO to provide the software link between your server and the UPS.

Syntax


[LOAD] [path]UPS_AIO [parameter...]

Parameter	Use to
path	Specify the path to UPS_AIO if you moved it from the default directory.
DOWNTIME=number	Specify the amount of time to run on battery before system shutdown. If power is restored before this time elapses, no shutdown will occur. If a low battery condition occurs before this time elapses, an immediate shutdown will occur. Supported values: 30 seconds minimum, no practical maximum limit. Default: 300 seconds
MSGDELAY=number	Specify the elapsed time before a broadcast message is first sent to users. Supported values: 0 seconds minimum, no practical maximum limit. Default: 5 seconds The broadcast message states the time remaining until shutdown. This message is generated automatically by UPS_AIO.
MSGINTERVAL=number	Specify the time interval between broadcast messages sent to users. Supported values: 20 seconds minimum, no practical maximum limit Default: 30 seconds The broadcast message states the time remaining until shutdown. This message is generated automatically by UPS_AIO.
DRIVERTYPE=number	Specify the AIO device driver type. Supported values: 1, 2, 3 Default: 1 The default value of 1 represents the AIOCOMX driver, which comes with NetWare®. Other drivers might be represented by other driver type numbers. Refer to the documentation that came with the driver.
BOARD=number	Specify the AIO board number. Supported values: Determined by the driver manufacturer Default: 0 To determine the board number, read the driver information when the AIOCOMX driver is loaded. This information includes both the board and port numbers. If you do not use the AIOCOMX driver, refer to the driver documentation to determine the board number.
PORT=number	Specify the port number. Supported values: Determined by the driver manufacturer Default: 0 To determine the port number, read the driver information when the AIOCOMX driver is loaded. This information includes both the port and board numbers. If you do not use the AIOCOMX driver, refer to your driver documentation to determine the port number.
SIGNAL_HIGH	Specify the signal_high parameter to set the normal RS232 signaling state to high. Supported values: SIGNAL_HIGH or no value Use this parameter only if your UPS system uses high values, instead of low values, to determine if power is off or the battery is low. Most UPS systems use low values. Refer to your UPS hardware documentation to determine whether you need to use the parameter.
?	Display a help screen that explains these parameters. When you use this parameter, the UPS_AIO module is not loaded. To load UPS_AIO, you must execute LOAD UPS_AIO again, without the ? parameter.

Using UPS_AIO

NOTE:The serial cable between the UPS and the server must be designed for use with the UPS. Contact the manufacturer of your UPS for information on the correct cable to use for your system.

You must load an AIO device driver before loading UPS_AIO; the driver is not loaded automatically. The AIOCOMX driver is included with the NetWare operating system. If you want to use a different driver, consult the UPS hardware and driver documentation.
The UPS_AIO module does not allow you to change parameter settings after loading the module. If you want to change the settings, reload the module with the new parameter values.
Place the commands to load the device driver and UPS_AIO in your autoexec.ncf file to load them each time the server comes up.
After you load UPS_AIO, a status screen displays messages about the current status and activities of the UPS. To toggle between this and other screens, press Alt Esc. These messages are also logged to sys:system\sys$log.err.