home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / upsmon2.zip / upsmons.hlp (.txt) < prev    next >
OS/2 Help File  |  1999-07-19  |  39KB  |  726 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Description ΓòÉΓòÉΓòÉ
  3.  
  4. UPS Monitor for OS/2 ver. 1.1a - Utility program to monitor the status of the 
  5. APC Uninterruptible Power Sources (UPS). Provides shutdown services to the 
  6. operating system. Includes two programs optimized for most APC-brand UPS 
  7. models. Fully supports the Smart-UPS and Back-UPS Pro models for setting UPS 
  8. operating parameters. Auto sense of parameter settings  for 110V and 240V 
  9. models. Designed for single workstation environment. 
  10.  
  11. UPS Monitor for OS/2 is shareware and registration is available through BMT 
  12. Micro at www.bmtmicro.com or through the author directly. See the section How 
  13. To Register UPS Monitor for details. 
  14.  
  15. Which executable do I use? 
  16.  
  17. There are currently two versions of the UPS Monitor program available. 
  18. UPSMONS.EXE supports the smart signalling of the Smart-UPS, Smart-UPS v/s and 
  19. the Back-UPS Pro. Matrix-UPS may also be supported, but is untested. UPS 
  20. parameter setting is supported and only available on the Smart-UPS and Back-UPS 
  21. Pro models. This program requires the cable number 940-0024B or 940-0024C to be 
  22. connect to the UPS. UPSMONS.EXE will not work with the Back-UPS models. 
  23.  
  24. UPSMONB.EXE, also referred to as UPS Monitor B, is designed for the Back-UPS 
  25. model only (non-Pro version) and uses simple signalling. This program requires 
  26. the cable number 940-0020B to be connect to all the UPS model. UPSMONB.EXE will 
  27. not work with other models. 
  28.  
  29.  
  30. ΓòÉΓòÉΓòÉ 2. General Program Operation ΓòÉΓòÉΓòÉ
  31.  
  32. Installation and Configuration. 
  33.  
  34. You must first configure UPS Monitor to recognize the UPS model and the comm 
  35. port it is connected to. Select Options - Settings and select the comm port and 
  36. UPS model from the controls. Save the settings and select Options - Connect. 
  37. This will connect to the UPS and a message will tell you if it was successful. 
  38. You are all set. If it did not recognize the UPS, see the section on 
  39. Troubleshooting for information. 
  40.  
  41. If you want UPS Monitor to start automatically when your OS/2 system powers up, 
  42. then place a shadow of the executable into the Startup folder (it's located 
  43. under the OS/2 System folder). 
  44.  
  45. You must also provide the command line parameters to UPSMONS.EXE or UPSMONB.EXE 
  46. for automatic operation. The commands are /Con to automatically connect to the 
  47. UPS and /Min to minimize on start-up. You must provide these commands on the 
  48. Parameters line in the Properties page of Warp 4.0 or Settings page of Warp 
  49. 3.0. To get to that page, right-click on the UPSMON object and click Properties 
  50. or Settings. 
  51.  
  52. Program Operation. 
  53.  
  54. Please note: This program provides support for the features common to all these 
  55. models: Smart-UPS, Smart-UPS v/s and Back-UPS Pro. If you have the Smart-UPS or 
  56. Back-UPS Pro, all UPS operating parameters can be set by UPS Monitor starting 
  57. with version 1.1. You may want to continue to run the older version of UPS 
  58. Monitor if you do not need to change the UPS operation parameters. 
  59.  
  60. To minimize the CPU load, UPS Monitor will check the UPS every 4 seconds for 
  61. status. All time settings therefore have a resolution of 4 seconds as well. For 
  62. example, a UPS on Battery alarm in the worst case, may not be detected until 4 
  63. seconds after the actual power failure. If Measure is enabled, the UPS 
  64. parameters are also measured every 4 seconds. 
  65.  
  66. The UPS Monitor background color changes according to events and settings. If 
  67. UPS Monitor is not connected to the UPS, the background color is light yellow. 
  68.  
  69. During normal operation when the UPS is on-line and no scheduled shutdowns have 
  70. been enabled, the background is light green. 
  71.  
  72. If one or more of the scheduled shutdowns have been enabled, then the 
  73. background is light blue. 
  74.  
  75. If a power failure is detected and the UPS is on battery, the background 
  76. changes to light red. 
  77.  
  78. If UPS Monitor detects a power failure and after the Message Delay expired, or 
  79. a schedule shutdown has been started, the program will give itself focus and it 
  80. will be restored to screen if it had been minimized. This will alert you of a 
  81. possible shutdown. 
  82.  
  83. Scheduled shutdowns can be aborted if enough time has been set to announce the 
  84. shutdown. Select Options - Abort Sched. Shutdown or press the ESC key when UPS 
  85. Monitor has focus. 
  86.  
  87. The UPS Monitor window can be sized and positioned anywhere on the desktop. 
  88. Size and position are saved. 
  89.  
  90. To bring up Help, simply press F1. Help is context sensitive, so if you have 
  91. the Settings window open, help for the settings will pop up. 
  92.  
  93. When UPS Monitor shuts down your system, it will not save any data of the 
  94. applications that are running or save any current changes to the desktop. It is 
  95. the applications responsibility to save any data. Set your application to auto 
  96. or timed save if this option is available. 
  97.  
  98. In a power fail situation, UPS Monitor will send out a command to the UPS to 
  99. turn itself off if a low battery command has been received or the fixed 
  100. shutdown time has expired. The turn off time is adjustable for the Smart-UPS 
  101. and Back-UPS Pro model. The Smart-UPS v/s has a fixed delay of 20 seconds. If 
  102. you have a Smart-UPS v/s model, make sure shutdown is possible in less than 20 
  103. seconds. UPS Monitor uses the DOSShutdown API call to perform the internal 
  104. shutdown. This call will only secure the file system and is therefore quicker 
  105. than the regular shutdown. Note that this API call was selected to guarantee 
  106. that the system will shutdown in unattended mode, even if some irate process 
  107. would prevent a regular shutdown. This call will flush the buffers and the 
  108. system will reboot cleanly the next time. 
  109.  
  110. If you use the external shutdown script, UPS Monitor will arm the UPS to turn 
  111. itself off within the specified turn off time, call UPSMONS.CMD and then close 
  112. itself. UPSMONS.CMD must then shutdown the system. You must make sure that 
  113. UPSMONS.CMD is set to shutdown the operating system within the UPS turn off 
  114. time. As shipped, this file will not shutdown the system. See inside the file 
  115. UPSMONS.CMD for sample code to perform a shutdown. I suggest to use external 
  116. shutdown only if you know the system inside out. If you have a better way to 
  117. shutdown OS/2 in unattended mode, I would like to know. 
  118.  
  119. CAUTION 
  120.  
  121. During shutdown and while the system is waiting for the UPS to turn off, the 
  122. screen will display a full size message in black and white. First it displays: 
  123. UPS Monitor is shutting system down. Please wait... 
  124.  
  125. Then it will display: Shutdown has completed. The UPS has been armed and will 
  126. turn off your computer after the set turn-off delay. Do NOT use Ctrl-Alt-Del to 
  127. restart. To restart the system now, turn the UPS off manually and then restart. 
  128.  
  129. The UPS has been armed at this point and will turn itself off after the turn 
  130. off time reaches the set value. 
  131.  
  132. DO NOT restart the computer with Ctrl-Alt-Del at this point, even if power is 
  133. restored. If you want to restart, you must first reset the UPS by turning it 
  134. off and on again. 
  135.  
  136. If you do not follow these instructions, the UPS timer will continue to count 
  137. down and will turn itself off as your system is operating again. 
  138.  
  139. It is possible on some systems that the second message will not get displayed. 
  140. Nonetheless, the file system is secured and you may restart the system as soon 
  141. as there is no disk activity. 
  142.  
  143. If desktop lockup was activated when the system shutdown, you will not see the 
  144. above mentioned message. If the system has shutdown and the UPS is armed and 
  145. waiting for turn off, your computer will appear locked up. The UPS is armed and 
  146. set to turn off. If you want to use the system immediately, turn off the UPS 
  147. first to reset the armed count-down and then restart your system. 
  148.  
  149.  
  150. ΓòÉΓòÉΓòÉ 3. Menu Description ΓòÉΓòÉΓòÉ
  151.  
  152. Describes all menu items available for this program. 
  153.  
  154. Note: The Diagnostics menu is only enabled when the UPS Monitor is connected to 
  155. the UPS. 
  156.  
  157.  
  158. ΓòÉΓòÉΓòÉ 3.1. FILE - Open Log ΓòÉΓòÉΓòÉ
  159.  
  160. Opens the UPS Monitor event or parameter log files for viewing. These log files 
  161. are regular text files and can also be opened with any text editor or word 
  162. processor. 
  163.  
  164. After a log file has been selected, it will show the log in a separate window. 
  165. From this window, you can print or open another log file. You can reposition or 
  166. resize the View Log window. Size and position will be remembered the next time 
  167. you open this window. 
  168.  
  169. Printing is done with the font 6.Helvetica. 
  170.  
  171. Note: The main UPS Monitor window displays the last 10 to 20 events only. If 
  172. more than 20 events are displayed, the oldest 10 events are cut. You can use 
  173. Open Log to view all previous log events. 
  174.  
  175.  
  176. ΓòÉΓòÉΓòÉ 3.2. FILE - Exit ΓòÉΓòÉΓòÉ
  177.  
  178. Exit the program. If the program is still connected to the UPS, the connection 
  179. is terminated. This event is logged. 
  180.  
  181.  
  182. ΓòÉΓòÉΓòÉ 3.3. OPTIONS - Settings ΓòÉΓòÉΓòÉ
  183.  
  184. Opens the UPS Monitor settings window. Set the Com Port (COM1 - COM8) where the 
  185. UPS is connected to, Enable Logging to a file, set the maximum Log File Size 
  186. and set the location and name of the log file. 
  187.  
  188. The log file will be kept approximately within the file size specified. If the 
  189. log file exceeds the selected size, then it is renamed for backup to the same 
  190. name with the extension .000 and a new log is started. If the backup file with 
  191. the extension .000 already existed, then it is replaced. This way it keeps at 
  192. least one log full of data. 
  193.  
  194. Select your UPS model from the selection box. This will tell UPS Monitor what 
  195. features to support. If you select the wrong model and one of the unsupported 
  196. features is accessed, then unpredictable results may occur. YOU CAN NOT MAKE A 
  197. BACK-UPS PRO MODEL OUT OF A SMART-UPS. 
  198.  
  199. Note that com port and UPS model selection is only possible when the UPS 
  200. Monitor is offline. 
  201.  
  202. The Bypass Self Test check box allows to enable or disable automatic self test 
  203. when UPS Monitor connects to the UPS. 
  204.  
  205. The Beep check box enables or disables the audible alarm during program 
  206. operation. The audible alarm will activate whenever a power failure is detected 
  207. and at every subsequent shutdown message interval. The alarm is a short, low to 
  208. high tone beep. An audible alarm is also activated whenever a scheduled 
  209. shutdown is announced. The alarm is a short, high to low tone beep for that 
  210. situation. 
  211.  
  212. The Measure check box enables the measurement of line voltage, load capacity 
  213. (in percent), battery voltage and battery capacity (in percent). These values 
  214. are displayed on the bottom portion of the main window and updated every 4 
  215. seconds. If power fails and the UPS Monitor shuts down, then the last measured 
  216. parameters are logged to the event log file. Measure is not available for the 
  217. Smart-UPS v/s models. 
  218.  
  219. If Measure is enabled, parameter logging can be done to a separate log file. In 
  220. the Parameter Logging group box you can enable parameter logging, select the 
  221. log file name and set the maximum parameter log size. The frequency of 
  222. parameter logging can also be set from 0 to 96 hours. If set to zero, parameter 
  223. logging will occur approximately every 4 seconds. You may enter fractions of 
  224. hours in the Freq. input box, i.e. 0.1 would correspond to logging every 6 
  225. minutes. Default frequency is 1 hour, default log size is 10 kbytes and the 
  226. default file name is UPSPARM.LOG. Parameter logging is only possible with the 
  227. Smart-UPS and Back-UPS Pro models. 
  228.  
  229. The 24Hrs check box selects AM/PM or 24 Hour format for the Scheduled Shutdown 
  230. settings. 
  231.  
  232.  
  233. ΓòÉΓòÉΓòÉ 3.4. OPTIONS - Shutdown Parameters ΓòÉΓòÉΓòÉ
  234.  
  235. Opens the shutdown parameter window. Set the UPS on Battery message delay (0-99 
  236. secs.) and message interval (0-999 secs.). This will bring the UPS Monitor to 
  237. the foreground and indicate that the UPS is running on battery. Select a range 
  238. that matches your UPS capacity in order to get notified on time when the UPS 
  239. shuts down. Default values are 10 second delay and 30 second intervals. 
  240.  
  241. Set Wait for Low Battery Signal or Fixed Duration shutdown after a UPS on 
  242. Battery signal. If Fixed Duration is selected, then the UPS Monitor will 
  243. shutdown the system when a low battery signal is received or after the set time 
  244. has expired (whichever comes first). If Wait for Low Battery is selected, then 
  245. the UPS Monitor will shutdown the system when the UPS signals low battery. 
  246.  
  247. Note: If the communication to the UPS is lost during a power failure, UPS 
  248. Monitor will switch over to a fixed duration shutdown of 60 seconds. If the 
  249. power and communications do not restore, the system will shutdown within these 
  250. 60 seconds. 
  251.  
  252. The Resume after Power Failure check box, when checked, gives you the option to 
  253. have the UPS restart after power is restored. If this box is unchecked, then 
  254. the UPS is turned off and must be manually restarted. 
  255.  
  256. The Ext. Shutdown Script checkbox allows to execute an external script (the 
  257. file UPSMONS.CMD) for shutting the system down. You can customize this file to 
  258. your own liking. Remember to keep the process short and well within the 
  259. shutdown delay range of the UPS. When UPSMONS.CMD is executed, the UPS is armed 
  260. and has begun countdown of the UPS turn off. You must use UPSMONS.CMD to 
  261. shutdown your operating system. As shipped, UPSMONS.CMD does not contain any 
  262. code to do that. See inside that file for sample code. 
  263.  
  264.  
  265. ΓòÉΓòÉΓòÉ 3.5. OPTIONS - UPS Shutdown Parameters ΓòÉΓòÉΓòÉ
  266.  
  267. These settings are only accessible if the UPS Monitor is online to a Back-UPS 
  268. Pro or Smart-UPS model UPS. All parameters on this page are stored to and 
  269. retrieved from the UPS. When this window is open, UPS polling for power status 
  270. is temporarly suspended. If this window is left open for longer than two 
  271. minutes and no activitity is detected, it will close automatically. 
  272.  
  273. The UPS Lo Bat. Signal Time is the amount of battery run time remaining before 
  274. there is a low battery condition. A setting of 2 minutes will cause a shutdown 
  275. when there is 2 minutes of battery run time left. Possible values are 2, 5, 7 
  276. or 10 minutes. Default is 2 minutes. 
  277.  
  278. The UPS Turn Off Delay parameter is the delay between when the UPS receives the 
  279. shutdown command and the actual turn-off of the UPS. Possible settings are 20, 
  280. 180, 300 and 600 seconds. Default is 20 seconds. 
  281.  
  282. You must select a UPS Turn Off Delay value long enough to allow your operating 
  283. system to shutdown. Depending on processor speed, amount of memory, or open 
  284. programs, the default 20 seconds may not be long enough to allow the operating 
  285. system to shutdown. Instead, the UPS will turn itself off while the operating 
  286. system shutdown is still in progress. Not a very favorable situation. A setting 
  287. of 180 seconds is therefore a better choice. 
  288.  
  289. The UPS Wakeup Time is the UPS turn-on delay after power has failed. When line 
  290. power return, the UPS will wait for the set time, then check if battery 
  291. capacity is greater than the set UPS Wakeup Capacity. It will then turn on it's 
  292. output receptacles. This delay is helpful if several systems need to be started 
  293. up in sequence.  Possible values are 0, 60, 180 or 300 seconds. Default is 0. 
  294.  
  295. The UPS Wakeup Capacity is the total battery capacity that needs to be reached 
  296. before the UPS will turn on the power outlets after line power is restored. 
  297. This ensures that the battery capacity is sufficient to power the equipment 
  298. should another power failure occur. Possible values are 0, 15, 50 or 90 
  299. percent. Default is 0. This parameter is not available on the Matrix-UPS 
  300. models. 
  301.  
  302. The UPS Audible Warning can be set to turn on at Power Fail,  Power Fail + 30 
  303. (seconds),  At Low Battery or Never Beep. Default is Power Fail. 
  304.  
  305. Pressing SAVE will save all changed parameters to the UPS and close the window. 
  306. CANCEL will abort the settings and close the window. 
  307.  
  308. Note: Only those UPS parameters that are changed will be stored to the UPS 
  309. memory. Depending on the number of parameters to save, it may take several 
  310. seconds to upload the data. 
  311.  
  312.  
  313. ΓòÉΓòÉΓòÉ 3.6. OPTIONS - UPS Operating Parameters ΓòÉΓòÉΓòÉ
  314.  
  315. These settings are only accessible if the UPS Monitor is online to a Back-UPS 
  316. Pro or Smart-UPS model UPS. All parameters on this page are stored to and 
  317. retrieved from the UPS. When this window is open, UPS polling for power status 
  318. is temporarly suspended. If this window is left open for longer than two 
  319. minutes and no activitity is detected, it will close automatically. 
  320.  
  321. The Firmware Revision is indicated with a three character code and is a string 
  322. stored in the UPS. It can not be changed. 
  323.  
  324. The High Transfer Point is the high line voltage at which the UPS will switch 
  325. over to battery operation. Possible values are: 127, 130, 133 or 136 Volts AC 
  326. for 110V models. Default is 127 VAC. For 240V models, the parameters are 253, 
  327. 257, 261 or 265 Volts AC. Parameter detection for 110 or 240V models is 
  328. automatic. 
  329.  
  330. The Low Transfer Point is the low line voltage at which the UPS will switch 
  331. over to battery operation. Possible values are: 97, 100, 103, 106 Volts AC for 
  332. 110V models. Default is 106 VAC. For 240V models, the parameters are 196, 200, 
  333. 204 or 208 Volts AC. Parameter detection for 110 or 240V models is automatic. 
  334. The Low Transfer Point cannot be changed on the Matrix-UPS. 
  335.  
  336. The Sensitivity is the amount of incoming line voltage distortion the UPS can 
  337. tolerate before it switches to battery operation. Possible values are High, 
  338. Medium or Low. Default value is High. If UPS Monitor indicates frequent, very 
  339. short power failures, you may want to decrease the sensitivity to prevent 
  340. unnecessary switching. 
  341.  
  342. The UPS Identification is an 8 character ID that can be used to give the UPS a 
  343. unique name. You can edit the ID and when saved, it will be stored in the UPS. 
  344.  
  345. The Last Battery Replacement is used to store the date when the UPS battery was 
  346. last changed. The date format is MM/DD/YY. You can change the date and it will 
  347. be stored in the UPS. 
  348.  
  349. UPS Serial No. and UPS Manufacture Date are strings stored in the UPS and can 
  350. not be changed. 
  351.  
  352. Pressing SAVE will save all changed parameters to the UPS and close the window. 
  353. CANCEL will abort the settings and close the window. 
  354.  
  355. Note: Only those UPS parameters that are changed will be stored to the UPS 
  356. memory. Depending on the number of parameters to save, it may take several 
  357. seconds to upload the data. 
  358.  
  359.  
  360. ΓòÉΓòÉΓòÉ 3.7. OPTIONS - Scheduled Shutdown ΓòÉΓòÉΓòÉ
  361.  
  362. This window allows you to schedule system shutdown at a daily, weekly or 
  363. one-time basis. You also have the option to restart or not restart the UPS. No 
  364. restart can be viewed as the system pulling it's own plug. 
  365.  
  366. Note that the restart option is not available on the Smart-UPS v/s models. 
  367.  
  368. Each of the shutdown options can be activated by the enable boxes. Set the 
  369. time, weekday or date with the controls provided. The priority of the shutdown 
  370. from highest to lowest is as follows: one-time, weekly, daily. You can have the 
  371. UPS shutdown daily, but a weekly shutdown will interrupt the daily shutdown 
  372. until the UPS restarts again. A one-time shutdown will require a manual restart 
  373. of the UPS. 
  374.  
  375. For daily shutdown, note that if the restart time is earlier than the shutdown 
  376. time, the restart will actually span into the next day. 
  377.  
  378. The weekly shutdown and restart time span is limited to 99.9 hours. You must 
  379. set the restart time within this limit before you can save the settings. Weekly 
  380. restart times have a resolution of 6 minutes and is a limitation of the UPS, 
  381. not UPS Monitor. 
  382.  
  383. The Announcement xx sec. before Shutdown (0-999 secs.) gives you the time to 
  384. abort a scheduled shutdown by selecting Options - Abort Sched. Shutdown from 
  385. the menu or by pressing the ESC key when the UPS Monitor program has the focus. 
  386.  
  387. The SAVE button will save all options to disk, the CANCEL will cancel operation 
  388. and discard any changes. 
  389.  
  390.  
  391. ΓòÉΓòÉΓòÉ 3.8. OPTIONS - Abort Sched. Shutdown ΓòÉΓòÉΓòÉ
  392.  
  393. Aborts the scheduled shutdown in progress. This menu item is only active when a 
  394. scheduled shutdown has started and you had set the Announcement xx sec. before 
  395. Shutdown delay in the Scheduled Shutdown window. You can also abort a scheduled 
  396. shutdown by pressing the ESC key. The UPS Monitor window must have focus for 
  397. this key to work. 
  398.  
  399.  
  400. ΓòÉΓòÉΓòÉ 3.9. OPTIONS - Shutdown Now ΓòÉΓòÉΓòÉ
  401.  
  402. This selection shuts down your operating system and turns off the UPS. You will 
  403. be prompted before shutdown starts. The system pulls it's own plug. The UPS 
  404. must be manually restarted after this shutdown. 
  405.  
  406.  
  407. ΓòÉΓòÉΓòÉ 3.10. OPTIONS - Connect ΓòÉΓòÉΓòÉ
  408.  
  409. Opens the selected comm port and connects to the UPS. The UPS is first 
  410. identified and then a self test is initiated. This event is logged. 
  411.  
  412.  
  413. ΓòÉΓòÉΓòÉ 3.11. OPTIONS - Disconnect ΓòÉΓòÉΓòÉ
  414.  
  415. Disconnects from the UPS and closes the comm port. This event is logged. 
  416.  
  417.  
  418. ΓòÉΓòÉΓòÉ 3.12. DIAGNOSTICS - UPS Info ΓòÉΓòÉΓòÉ
  419.  
  420. Displays the UPS model, serial number and firmware revision on the screen. Must 
  421. be connected to the UPS to access this feature. 
  422.  
  423.  
  424. ΓòÉΓòÉΓòÉ 3.13. DIAGNOSTICS - Test UPS Alarm ΓòÉΓòÉΓòÉ
  425.  
  426. Activates the UPS alarm. This event is logged. 
  427.  
  428. Must be connected to the UPS to access this feature. 
  429.  
  430.  
  431. ΓòÉΓòÉΓòÉ 3.14. DIAGNOSTICS - Simulate Power Failure ΓòÉΓòÉΓòÉ
  432.  
  433. Initiates a Simulate Power Failure and checks the UPS circuitry for proper 
  434. operation. This event is logged. 
  435.  
  436. Must be connected to the UPS to access this feature. 
  437.  
  438.  
  439. ΓòÉΓòÉΓòÉ 3.15. DIAGNOSTICS - Initiate UPS Self Test ΓòÉΓòÉΓòÉ
  440.  
  441. Initiates a UPS Self Test and checks the UPS circuitry for proper operation. 
  442. This event is logged. 
  443.  
  444. Must be connected to the UPS to access this feature. 
  445.  
  446.  
  447. ΓòÉΓòÉΓòÉ 3.16. HELP - Help Contents ΓòÉΓòÉΓòÉ
  448.  
  449. Displays this help file (UPSMONS.HLP). Help is organized in sections using the 
  450. Index feature. Wherever you see Index, think of it as Contents. 
  451.  
  452.  
  453. ΓòÉΓòÉΓòÉ 3.17. HELP - Product Information ΓòÉΓòÉΓòÉ
  454.  
  455. Product information. 
  456.  
  457.  
  458. ΓòÉΓòÉΓòÉ 4. Smart Signalling Cable Pinout ΓòÉΓòÉΓòÉ
  459.  
  460. Below is a connection diagram to connect the APC UPS to a 25 or 9 pin serial 
  461. port. This cable requires a UPS supporting smart signalling and the UPSMONS.EXE 
  462. program. 
  463.  
  464.  
  465. ΓòÉΓòÉΓòÉ 5. Troubleshooting ΓòÉΓòÉΓòÉ
  466.  
  467. If you are having problems connecting to the UPS, then follow these steps 
  468. below. 
  469.  
  470.       Γûá  UPS Monitor is only designed and tested for the APC (American Power 
  471.       Conversion) models Back-UPS, Smart-UPS, Smart-UPS v/s and Back-UPS Pro. 
  472.  
  473.       Γûá  The UPSMONS.EXE executable is only designed to work with models 
  474.       supporting smart signalling like the Smart-UPS, Smart-UPS v/s and 
  475.       Back-UPS Pro. You must use cable number 940-0024B or 940-0024C included 
  476.       with these UPS for proper operation. It is possible that this program 
  477.       will work with other APC models, like the Matrix-UPS, using smart 
  478.       signalling. UPS Monitor has not been tested with the Matrix-UPS model. 
  479.       UPSMONS.EXE will not work with the model Back-UPS (400, 450 and 600) 
  480.       which use simple signalling. 
  481.  
  482.       Γûá  The UPSMONB.EXE executable is only designed to work with models 
  483.       supporting simple signalling, like the Back-UPS (non-Pro models). You 
  484.       must use cable number 940-0020B included with this UPS for proper 
  485.       operation. See the help inside UPSMONB.EXE for more information. 
  486.  
  487.       Γûá  UPS Monitor will not work with brands other than APC. 
  488.  
  489.       Γûá  Make sure the Com Port in the Settings window matches the com port you 
  490.       use for the UPS. 
  491.  
  492.       Γûá  Make sure you have all the included files present in your directory. 
  493.  
  494.       Γûá  If you have Ray Gwinn's SIO comm drivers, use the included PMLM (Poor 
  495.       Man's Line Monitor) to monitor data exchange between the computer and 
  496.       UPS. PMLM will also display the baudrate the port is set to. If it is not 
  497.       2400 then SIO may be locking the port to another baudrate. See below. 
  498.  
  499.       Γûá  If you are using Ray Gwinn's SIO com drivers, check if the baud rate 
  500.       is locked for the particular com port you are using with the interface. 
  501.       Unlock it so UPS Monitor can change the baud rate to 2400. From the SIO 
  502.       reference, it states: 
  503.  
  504.  
  505.                Locked Baud Rate
  506.  
  507.                Placing a colon and a baud rate following the communications port, eg
  508.                (COM1:38400,3F8,IRQ4), causes the port to be locked at that baud rate.
  509.                No program, OS2 or DOS, is allowed to change the baud rate.
  510.  
  511.       Γûá  Try the standard COM1 or COM2 ports if you have problems with any 
  512.       other com ports like COM3 - COM8. Also, remove any serial cable 
  513.       extensions or adapters and connect the UPS directly to the computer. See 
  514.       the section Smart Signalling Cable Pinout for connector pin-outs. 
  515.  
  516.       Γûá  Try using a different computer or different com port to access the 
  517.       UPS. 
  518.  
  519.       Γûá  If you are using UPS Monitor on COM3 or COM4, make certain that these 
  520.       ports are configured for their own unique IRQ. By standard definition, 
  521.       COM1 and COM3 normally share IRQ4 and COM2 and COM4 share IRQ3. OS/2 does 
  522.       not like this configuration and you will get interaction between devices 
  523.       connected to COM1 and COM3 or COM2 and COM4 making reliable UPS 
  524.       monitoring impossible. 
  525.  
  526.  
  527. ΓòÉΓòÉΓòÉ 6. Installation ΓòÉΓòÉΓòÉ
  528.  
  529. Note:  REXX or Object REXX must be installed on your system for this program to 
  530. work. REXX is installed by default, but if you did not install it then run Warp 
  531. installation again and selectively install REXX support. 
  532.  
  533. Unzip all files into a separate directory, I suggest the name UPSMON. 
  534.  
  535. Open an OS/2 Window and change to the directory you just created. Type INSTALL 
  536. and the script will create a UPSMonitor folder on the desktop and fill it with 
  537. all executable programs present in the directory. To start the program, 
  538. double-click on the UPSMONB or UPSMONS object inside the folder. 
  539.  
  540. You must first configure UPS Monitor to recognize the UPS model and the comm 
  541. port it is connected to. Select Options - Settings and select the comm port and 
  542. UPS model from the controls. Save the settings and select Options - Connect. 
  543. This will connect to the UPS and a message will tell you if it was successful. 
  544. You are all set. If it did not recognize the UPS, see the section on 
  545. Troubleshooting for information. 
  546.  
  547. If you want UPS Monitor to start automatically when your OS/2 system powers up, 
  548. then place a shadow of the executable into the Startup folder (it's located 
  549. under the OS/2 System folder). 
  550.  
  551. You must also provide the command line parameters to UPSMONS.EXE or UPSMONB.EXE 
  552. for automatic operation. The commands are /Con to automatically connect to the 
  553. UPS and /Min to minimize on start-up. You must provide these commands on the 
  554. Parameters line in the Properties page of Warp 4.0 or Settings page of Warp 
  555. 3.0. To get to that page, right-click on the UPSMON object and click Properties 
  556. or Settings. 
  557.  
  558. Installing this program on your system does not change any of the INI or 
  559. CONFIG.SYS files. 
  560.  
  561. UPS Monitor is only designed and tested for the APC models Back-UPS, Smart-UPS, 
  562. Smart-UPS v/s and Back-UPS Pro. It includes two executable programs and to 
  563. determine which program to use, please read the Description for information. 
  564.  
  565. The following files belong to this program: 
  566.  
  567.        UPSMONB.EXE       The executable program using simple signalling. 
  568.  
  569.        UPSMONB.HLP       The Help file for UPSMONB.EXE. 
  570.  
  571.        UPSMONS.EXE       The executable program using smart signalling. 
  572.  
  573.        UPSMONS.HLP       The Help file for UPSMONS.EXE. 
  574.  
  575.        UPSMONB.INI       Settings file for executable. Created by UPSMONB.EXE. 
  576.  
  577.        UPSMONS.INI       Settings file for executable. Created by UPSMONS.EXE. 
  578.  
  579.        UPSMONB.LOG       Default log file created by UPSMONB.EXE. 
  580.  
  581.        UPSMONS.LOG       Default log file created by UPSMONS.EXE. 
  582.  
  583.        UPSMONB.CMD       External shutdown script file for UPSMONB.EXE. 
  584.  
  585.        UPSMONS.CMD       External shutdown script file for UPSMONS.EXE. 
  586.  
  587.        UPSMONx.000       Default backup log files if log size exceeds specified 
  588.                          size (x = B or S). 
  589.  
  590.        UPSPARM.LOG       Default parameter log file created by UPSMONS.EXE. 
  591.  
  592.        UPSPARM.000       Historical parameter log file created by UPSMONS.EXE. 
  593.  
  594.        UPSPMSD.DLL       Dynamic Link Library required by executables. 
  595.  
  596.        VPOBJ.DLL         Dynamic Link Library required by executables. 
  597.  
  598.        VPUTIL.DLL        Dynamic Link Library required by executables. 
  599.  
  600.        RXSI2.DLL         Dynamic Link Library required by executables. 
  601.  
  602.        RXASYNC.DLL       Dynamic Link Library required for serial 
  603.                          communications to the UPS. This library of serial 
  604.                          communications routines is included by permission of 
  605.                          Crucial Applications (Author: Ian Timms, e-mail: 
  606.                          itimms@ariel.ucs.unimelb.edu.au). The entire serial 
  607.                          communications package, including the source code for 
  608.                          RXASYNC, is available at my home page or other major 
  609.                          OS/2 sites by the filename RXASYN20.ZIP. This file has 
  610.                          been packed for smaller size using LXWARP. 
  611.  
  612.        INSTALL.CMD       General installation script for UPS Monitor. 
  613.  
  614.        README.TXT        Program description and installation instructions. 
  615.  
  616.        BMTORDER.TXT      Order form to register UPS Monitor through BMT Micro. 
  617.  
  618.  To remove this program from your system, close the program, delete all your 
  619.  UPS Monitor object or shadow from your desktop or folders and delete all the 
  620.  files listed above. 
  621.  
  622.  
  623. ΓòÉΓòÉΓòÉ 7. The Legal Stuff ΓòÉΓòÉΓòÉ
  624.  
  625. UPS Monitor for OS/2 is shareware and not free. You may use it and try it out 
  626. for 30 days. There are no limitations to the shareware version of UPS Monitor 
  627. other than it will cease to function after 30 days. If you like this program 
  628. and would like to continue using it, you must register to obtain a license. See 
  629. How To Register section on ways to register. 
  630.  
  631. The shareware version of this program may be distributed electronically as long 
  632. as all files are kept together. The shareware version is recognized by the 
  633. title  UPS Monitor for OS/2 - Unregistered in the title bar of the main 
  634. program. 
  635.  
  636. A single registration entitles the owner to use the two executables as 
  637. individual registered programs. Only one copy of each of the executables may be 
  638. run at one time on a computer, in other words, if you have a laptop and a 
  639. desktop, you may copy this program onto both computers but only one instance of 
  640. one of the UPS Monitor programs may be run at one time. If there is a 
  641. possibility that two of the same executable programs may be run at the same 
  642. time, then you must get a second license. You may however use UPSMONS.EXE and 
  643. UPSMONB.EXE together on two separate systems by only having one registration. 
  644.  
  645. The registered version of UPS Monitor may not be distributed in any way. 
  646.  
  647. Quantity discounts start with two licenses, contact the author for more 
  648. information. 
  649.  
  650. Registration gives you many benefits. Besides removing of all restrictions, I 
  651. will provide prompt technical support, implement suggestions to program 
  652. improvements, enhancements and customization (if technically possible). 
  653.  
  654. RXASYNC.DLL, required for serial communications to the UPS, is a library of 
  655. serial communications routines and is included by permission of Crucial 
  656. Applications (Author: Ian Timms, e-mail: itimms@ariel.ucs.unimelb.edu.au). The 
  657. entire serial communications package, including the source code for RXASYNC, is 
  658. available at my home page or other major OS/2 sites by the filename 
  659. RXASYN20.ZIP. This DLL has been packed using LXWARP for smaller size. 
  660.  
  661. UPS Monitor is protected using SecureIt. To get more information on this 
  662. shareware protection program, see http://www.bmtmico.com/catalog/secureit/ 
  663.  
  664. DISCLAIMER 
  665.  
  666. Although this software has been tested and run successfully, the author of UPS 
  667. Monitor for OS/2 is in no way responsible for any damage this program may cause 
  668. to computer equipment. 
  669.  
  670. Any trademarks mentioned in this document belong to their respective owners and 
  671. the author of this program is not connected in any way to these products nor 
  672. does he endorse any of the products mentioned. 
  673.  
  674. TRADEMARKS 
  675.  
  676. APC stands for American Power Conversion. 
  677.  
  678. APC, Back-UPS, Smart-UPS, Smart-UPS v/s, Back-UPS Pro and Matrix-UPS are 
  679. registered trademarks of American Power Conversion. 
  680.  
  681.  
  682. ΓòÉΓòÉΓòÉ 8. How to Register UPS Monitor ΓòÉΓòÉΓòÉ
  683.  
  684. There are two ways you can register UPS Monitor: 
  685.  
  686. Send e-mail to ASchw@worldnet.att.net to request my mailing address. You can 
  687. then send me a check or money order and I will return the registration code. 
  688. The cost is $10.00 using this option. 
  689.  
  690. Register through BMT Micro at www.bmtmicro.com. BMT Micro offers a variety of 
  691. purchasing methods, see the file BMTORDER.TXT for details. You will receive the 
  692. registration code usually within one day. The cost is $15.00 for this option. 
  693.  
  694. Quantity discounts are available. Please e-mail me for details. 
  695.  
  696. A single registration entitles you to use both programs, UPSMONB.EXE and 
  697. UPSMONS.EXE and any new versions of UPS Monitor will always be free to 
  698. registered users. 
  699.  
  700.  
  701. ΓòÉΓòÉΓòÉ 9. Support ΓòÉΓòÉΓòÉ
  702.  
  703. For support for this program, you can contact me directly via e-mail. 
  704.  
  705. My e-mail address: 
  706.  
  707.   ASchw@worldnet.att.net 
  708.  
  709. Visit my home page, "The Warped Code Cellar" at 
  710.  
  711.   http://home.att.net/~ASchw 
  712.  
  713. for other information and applications for OS/2 like HOUSE/2 and HOUSE/290, two 
  714. home automation programs using X-10 devices, Memory Game and Leave One, two 
  715. speech navigation enabled games. 
  716.  
  717. Monitor my home page regularly for new and upgraded OS/2 programs. This will be 
  718. the place where all programs will be available first. 
  719.  
  720. This program is also available at the following sites: 
  721.  
  722. Internet: 
  723.  
  724.   http://home.att.net/~ASchw 
  725.   http://www.bmtmicro.com 
  726.   http://hobbes.nmsu.edu