home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / sd2.zip / ShutDown.ipf < prev    next >
Text File  |  1998-05-17  |  11KB  |  223 lines
  1. :userdoc.
  2. :title.ShutDown/2 Help Program
  3. :body.
  4.  
  5. .****************************************************************************************
  6. .*--------------------------------------------------------------------------------------*
  7. .* The user selected help with F1, the mouse or the keyboard.                           *
  8. .*--------------------------------------------------------------------------------------*
  9. .****************************************************************************************
  10.  
  11. :h1 res=350.SD/2 Help for Help
  12. :lines align=center.
  13. :color fc=red.
  14. SD/2 - ShutDown/2 Version 1.01
  15. for IBM OS/2 2.x Presentation Manager
  16. Copyright (C) by Stangl Roman 06, 1993
  17. Copyright (C) by Friedrich Schmieder 06, 1993
  18. :color fc=default.
  19. :elines.
  20. :p.Please select one of the following topics for further information:
  21. :ul compact.
  22. :li.:link reftype=hd res=600.About the utility SD/2:elink.
  23. :li.:link reftype=hd res=400.SD/2 Configuration Menu:elink.
  24. :eul.
  25. :p.:link reftype=hd res=350.<Backward>:elink.
  26.                                 :link reftype=hd res=600.<Forward>:elink.
  27.  
  28.  
  29. .****************************************************************************************
  30. .*--------------------------------------------------------------------------------------*
  31. .* The user selected help from the About SD/2 dialog box.                               *
  32. .*--------------------------------------------------------------------------------------*
  33. .****************************************************************************************
  34.  
  35. :h1 res=600.Help for About SD/2
  36. :lines align=center.
  37. :color fc=red.
  38. SD/2 - ShutDown/2 Version 1.01
  39. for IBM OS/2 2.x Presentation Manager
  40. Copyright (C) by Stangl Roman 06, 1993
  41. Copyright (C) by Friedrich Schmieder 06, 1993
  42. :color fc=default.
  43. :elines.
  44. :p.E-Mail:
  45. :ul compact.
  46. :li.rstangl@vnet.ibm.com (Roman Stangl)
  47. :li.SFRIEDRICH@vnet.ibm.com (Friedrich Schmieder)
  48. :eul.
  49. :p.
  50. ShutDown/2 - SD/2 is an OS/2 PM application, that controls your PS/2
  51. in conjunction with an external uninterruptable power supply (UPS) control
  52. logic.
  53. It will protect you system from any data losses and hardware damages
  54. caused by unexpected line power failures.
  55. If line power fails, SD/2 and the external UPS control logic will shut down
  56. your system safely.
  57. :p.
  58. The following figure shows, how SD/2 and the external UPS control logic
  59. work together:
  60. :cgraphic.
  61.   ┌─────────┐                     ┌────────────┐
  62.   │┌───────┐│                     │ &BOX.          │
  63.   ││       ││   <═══════════════> ├────────────┤
  64.   ││       ││                     │            │
  65.   │└───────┘│                     │            │
  66.   └───┬──┬──┘                     │            │
  67. ┌─────┴──┴────┐      ┌─────┐      │            │      ┌─────┐
  68. │  ═══  ═══ &BOX. │ <══> │     │ <══> │            │ <══> │ 220 │
  69. │             │      │     │      │            │      │  V  │
  70. └─────────────┘      └─────┘      └────────────┘      └─────┘
  71.  
  72.    Your PS/2       UPS control          UPS         Line power
  73.                       logic
  74. :ecgraphic.
  75. :p.
  76. The UPS control logic is attached to the UPS on one side, and to your PS/2
  77. on the other side. Your PS/2 is also attached to the UPS.
  78. The UPS has a battery inside, to supply your system with power for
  79. short periods, if line power fails.
  80. Such periods are typically 5 to 30 minutes, enough time to
  81. shut down your system to avoid data losses or hardware damages.
  82. :p.
  83. The UPS control logic is attached to your PS/2 on any serial or parallel
  84. port.
  85. SD/2 snoops at the configured port for line power failures, which
  86. are indicated by the UPS control logic.
  87. Power failures may vary in their duration, short failures are simply
  88. ignored, because the UPS has enough battery capacity to allow further
  89. operation of your system.
  90. Some failures however, may be too long to allow further operation 
  91. of your system, so SD/2 shuts it down.
  92. Immediately after your system was shut down, it is safe to power it off,
  93. and this job is done by the UPS control logic.
  94. :p.
  95. If line power reappears again, the UPS control logic will power on your
  96. system again.
  97. Your system will be rebooted and normal operation will continue.
  98. :p.
  99. SD/2 and the UPS control logic define 4 time stamps, which are
  100. defined according to the size of the UPS and the power requirements of
  101. your system:
  102. :parml break=all.
  103. :pt.UPS Battery Capacity
  104. :pd.This time stamp determines the maximum period the UPS can be allowed
  105. to supply your system before the UPS battery is empty.
  106. :pt.Alert Start
  107. :pd.This time stamp determines the duration of line power failures that
  108. can safely be ignored without interrupting your system.
  109. :pt.Alert ShutDown
  110. :pd.This time stamp determines when an user defined application is
  111. started, to prepare your system for a shut down.
  112. :pt.SD/2 ShutDown
  113. :pd.This time stamp determines when your system will be shut down after
  114. line power disappears.
  115. Once this time stamp is reached, a reappearing line power can't prevent
  116. your system from shut down.
  117. :eparml.
  118. :p.
  119. SD/2 can be controlled from Parallel or Serial ports, you just have to find
  120. out from your PC's User's Guide and BIOS which physical connector is configured
  121. for which address.
  122. For example, the logically first printer port LPT1 historically was controlled
  123. by the physical address 0x3BC, however since advanced printer functions as
  124. ECP or EPP were introduced, LPT1 is controlled by the physical address 0x278.
  125. In other words, there is no standard rule, but (HW and BIOS) implementation specific,
  126. in the :link reftype=hd res=400.<Setup dialog>:elink. you have to ensure
  127. that the physical addresses match.
  128. :p.
  129. For parallel ports SD/2 senses the status of the pins :hp2.+BUSY (pin 11):ehp2. and
  130. :hp2.-ACK (pin 10):ehp2., an external logic is controlled by the pins
  131. :hp2.-SLCT IN (pin 17):ehp2. and :hp2.-INIT (pin 16):ehp2..
  132. Due to the way these pins are used, you should even be able to loop your UPS logic
  133. between your PC and printer and the printer should still work.
  134. SD/2 detects that the UPS is running from its internal battery when both pins 11 and
  135. 10 are connected to ground (e.g. for a test plug, just connect ground from pins 25
  136. and 24 to pins 11 and 10, once you attacht that plug, SD/2 will start its processing).
  137. :p.
  138. For serial ports SD/2 senses the status of the pins :hp2.CTS (pin 5 on DB25):ehp2. and
  139. :hp2.CD (pin 8 on DB25):ehp2., an external logic is controlled by the pins
  140. :hp2.DTR (pin 20 on DB25):ehp2. and :hp2.RTS (pin 4 on DB25):ehp2..
  141. Due to the way these pins are used, you should even be able to loop your UPS logic
  142. between your PC and your serail device and the serial device should still work.
  143. SD/2 detects that the UPS is running from its internal battery when pin 5 (on DB25)
  144. is connected to positive voltage (a logical "0" in serial communication terms) and
  145. pin 8 (on DB25) is connected to negative voltage (a logical "1" in serial communication
  146. terms) (e.g. of course you can build a test plug too, but it's a little bit more
  147. difficult to the the serial RS232 voltage levels, you might e.g. use DOS' DEBUG to
  148. output them on pins unused by SD/2 or on a different serial port).
  149. :p.:link reftype=hd res=350.<Backward>:elink.
  150.                                 :link reftype=hd res=400.<Forward>:elink.
  151.  
  152.  
  153. .****************************************************************************************
  154. .*--------------------------------------------------------------------------------------*
  155. .* The user selected help from the Configuration/Setup SD/2 dialog box.                 *
  156. .*--------------------------------------------------------------------------------------*
  157. .****************************************************************************************
  158.  
  159. :h1 res=400.Help for SD/2 Setup
  160. :p.
  161. This dialog is used to setup the cooperation between SD/2 and the UPS
  162. control logic. Some entryfields are editable by the user, some entryfields
  163. are predefined for a particular UPS and PS/2 configuration.
  164. :p.
  165. For the following explanation assume that line power fails at 10&colon.30
  166. and the configuration corresponds to your UPS and PC/2 configuration:
  167. :parml break=all.
  168. :pt.UPS Battery Capacity
  169. :pd.Assume that the UPS battery capacity is 0&colon.10.
  170. Because the battery of the UPS lasts at least 10 minutes, the system
  171. must be shut down at 10&colon.40 at the latest, to avoid data losses or hardware
  172. damages due to uncontrolled power off of your system. All time stamps must
  173. occur between 10&colon.30 and 10&colon.40.
  174. :pt.Alert Start
  175. :pd.Assume that the alert start is 0&colon.1.
  176. Therefor at 10&colon.31 SD/2 will inform the user that the line power failed, and
  177. the system is operating from the UPS battery.
  178. The first minute is ignored, because it is safe to ignore short glitches
  179. of up to one minute.
  180. :pt.Alert ShutDown
  181. :pd.Assume that the alert shut down is 0&colon.4.
  182. At 10&colon.34, a user defined application will be started to prepare the system
  183. for shut down.
  184. :pt.SD/2 ShutDown
  185. :pd.Assume that SD/2 shut down is 0&colon.7.
  186. At 10&colon.37 SD/2 will signalize the UPS control logic to power off your system
  187. after SD/2 will have shut down your system, which lasts about 2 seconds.
  188. Thus 10&colon.37 is the point of no return, even if line power reappears, your
  189. system will be shut down.
  190. If line power reappears before this time stamp (f.e. at 10&colon.35), SD/2 will
  191. restart the countdown at the beginning, repeating this procedure immediately
  192. after the next line power disappearance.
  193. :pt.Application started at Alert ShutDown.
  194. :pd.These entryfields allow the user to select the application that is
  195. started after the Alert ShutDown time stamp is reached.
  196. The user has to insert at least the path and filename of an application.
  197. :pt.UPS controls SD/2 via
  198. :pd.These radiobuttons allow the user to select the port of the PS/2
  199. where SD/2 and the UPS control logic communicate over. The user can
  200. select any serial or parallel port.
  201. :caution.
  202. Be sure that the UPS control logic is attached to the port that is
  203. specified! Data may be lost or hardware may be damaged, if SD/2 is
  204. configured to a port where the UPS control logic is not attached
  205. and line power fails!
  206. :ecaution.
  207. :pt.ShutDown User Information
  208. :pd.This multiline entryfield contains the text that is displayed,
  209. immediately before your system is shut down, until your system is
  210. reset by ALT+CTRL+DEL or by a power off.
  211. The UPS control logic will power off your system shortly after this
  212. message is displayed.
  213. :eparml.
  214. :warning.
  215. Be sure to verify all data before you press :hp2.OK:ehp2. to prevent
  216. misfunction of SD/2 and the UPS control logic!
  217. :ewarning.
  218. :p.:link reftype=hd res=600.<Backward>:elink.
  219.                                 :link reftype=hd res=350.<Forward>:elink.
  220.  
  221. :euserdoc.
  222.  
  223.