home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / apm2v14.zip / Read.me < prev    next >
Text File  |  1998-05-06  |  10KB  |  174 lines
  1. ******************************************************************************
  2.                                   Announcing
  3.  
  4.                             APM/2 Version 1.40 for
  5.                                IBM OS/2 Warp 4
  6.        Copyright (C) by Roman Stangl (rstangl@vnet.ibm.com) 1997, 1998
  7.  
  8. ******************************************************************************
  9.  
  10. Dear User, Lieber Benutzer!
  11.  
  12. APM/2 allows you to put your workstation into APM standby, suspend or power 
  13. off mode under Warp 4. I emphasize Warp 4, as only that version has the
  14. required support in APM.SYS, other system files and the Kernel to successfully
  15. process APM power off requests. However, you can force APM/2 power off to run 
  16. under Warp 3 and before by the commandline option /Force (usefuly when a 
  17. fixpack improves APM support). APM/2 also allows you to schedule a automatic
  18. power on, if APM level 1.2+ is detected. APM requests can also be scheduled.
  19. APM/2 is NLS enabled that allows you easily to create a translation in your
  20. national (SBCS single byte character set) language.
  21.  
  22. Just launch the executable from an OS/2 window to see the commandline options.
  23.  
  24. Under previous versions of OS/2 for APM power off requests, the filesystem 
  25. will not be closed correctly, causing a CHKDSK during the next reboot. And a
  26. tip from Frank Schroeder (OS/2 I/O Subsystem/Device Driver Development): "Do 
  27. not try to run the Version 4.0 APM device driver on OS/2 Warp Version 3.0 as 
  28. there are dependencies upon other system files including the os2krnl".
  29.  
  30. Though Warp 4 is supposed to perform a filesystem shutdown when requesting APM
  31. power off, you can force APM/2 to flush the filesystem before invoking APM
  32. power off and from a user I know that this (surprisingly) increased stability.
  33. There are 2 shutdown options, DosShutdown(0) shuts down and locks the file 
  34. system (which causes any file I/O to fail or block) and DosShutdown(1) which
  35. quiescent executing threads but does not lock the file system.
  36.  
  37. The sourcecode is available in the encrypted file NLS.ZIE. By using the
  38. program PROTECT.EXE you can decrypt it into NLS.ZIP by entering from an OS/2
  39. commandline:
  40. PROTECT apm2v13 NLS.ZIE
  41.  
  42. By using encryption I can ensure that everyone interested viewing the source
  43. code must have access to an OS/2 installation, as I'll only provide a 32-bit
  44. OS/2 version of the decryption program (my answer to "Windows-only" vendors).
  45.  
  46. The archive NLS.ZIP contains the following files:
  47. Apm.cpp ....... Source code
  48. Apm.hpp ....... Source code header 
  49. Apm.h ......... APM for OS/2 toolkit
  50. Apm.def ....... Module definition file
  51. ApmUs.txt ..... Message source file (English)
  52. ApmGr.txt ..... Message source file (German)
  53. Make.cmd ...... Batch file to build English and German versions
  54.  
  55. Please run the executables to read the conditions of APM/2 use!
  56.  
  57. You are welcome to drop me some comments or to visit my homepage at the URL:
  58. http://www.geocities.com/SiliconValley/Pines/7885/
  59.  
  60. Warning! APM Power Off may not work on all systems (and I've also seen a WIN95
  61.          OS2R2 preloaded PC that did hang after a APM power off request, so
  62.          no reason to think it's just OS/2's fault) despite they are supporting 
  63.          APM and APM.SYS works correctly. Symptoms are (thanks to Frank 
  64.          Schroeder from the OS/2 I/O Subsystem/Device Driver Development, 
  65.          who owns the OS/2 APM driver, for his support to give me some 
  66.          explanations about possible causes):
  67.  
  68.          *) APM power off does power off your PC, but even under Warp 4 a
  69.             CHKDSK is performed due to the next reboot. This may be related to 
  70.             the combination of a too fast processor and a too slow harddisk, 
  71.             because the request to the disk subsystem didn't finish in time 
  72.             before the power is dropped (this may corrupt partitions!). 
  73.          *) Your PC is powered off, but immediately powers on again. This may 
  74.             be related that the APM BIOS thinks that is should power up again, 
  75.             which can be caused by "Wakeup on LAN" adapters or that OS/2's APM 
  76.             support polls APM BIOS which confuses APM BIOS.
  77.          *) APM power off does not work under OS/2 but does under Windows. As 
  78.             OS/2 (as a protected mode operating system) may use different 
  79.             entrypoints into APM BIOS as Windows, there are some chances that 
  80.             there are BIOS bugs. Even when the same BIOS code is used, timing 
  81.             issues ad differences in the frequency of polling, the order of 
  82.             APIs called, the method of APM event notifications,... can explain 
  83.             differences.
  84.  
  85. Warm regards from Austria! Roman
  86.  
  87. ******************************************************************************
  88.  
  89. APM/2 erlaubt es Ihnen, Ihren Rechner unter Warp 4 in den APM standby, suspend
  90. oder power off Modus zu bringen. Die Betonung liegt auf Warp 4, da nur diese
  91. Version APM Funktionen in APM.SYS, anderen Systemdateien und im Kernel
  92. verarbeiten kann. Sie können jedoch mit der Befehlszeilen Option /Force  APM/2 
  93. power off auch unter Warp 3 und früher ausführen (nützlich für den Fall, dass 
  94. APM mit einem Fixpack besser unterstützt wird). APM/2 erlaubt es auch einen
  95. Zeitpunkt für automatisches Einschalten zu planen, wenn APM level 1.2+ vor-
  96. handen ist. Die APM Funktionen können auch geplant werden. APM/2 ist NLS
  97. fähig und erlaubt es ohne Probleme nationale (SBCS single byte character set)
  98. Versionen zu übersetzen.
  99.  
  100. Rufen Sie das Programm einfach von einer OS/2 Befehlszeile auf um die
  101. Optionen angezeigt zu bekommen
  102.  
  103. Unter früheren Versionen von OS/2 wird das Dateisystem bei APM power off
  104. Funktionen nicht korrekt abgeschlossen, was zu einem CHKDSK beim nächsten
  105. Hochfahren führt. Noch ein Tip von Frank Schroeder (OS/2 I/O Subsysteme/
  106. Gerätetreiber Entwicklung): "Versuchen Sie nicht den Version 4.0 APM Geräte-
  107. treiber unter OS/2 Warp Version 3.0 einzusetzen, da es auch Abhängigkeiten
  108. von anderen Systemdateien inklusive dem os2krnl gibt".
  109.  
  110. Obwohl Warp 4 ein Shutdown des Dateisystems durchführen sollte, können Sie 
  111. APM/2 zwingen ein Shutdown durchzuführen bevor APM power off aufgerufen wird.
  112. Von einem Benutzer weiss ich, dass das (überraschenderweise) die Stabilität
  113. erhöht hat. Es gibt dazu 2 Shutdown Optionen, DosShutdown(0) macht ein
  114. Shutdown des Dateisystems und beendet es (wodurch weiteres Datei I/O nicht
  115. mehr möglich ist oder blokiert) und DosShutdown(1) was zwar the Threads
  116. aber nicht Dateisystemzugriffe blokiert.
  117.  
  118. Der Quellenkode befindet sich verschlüsselt in der Datei NLS.ZIE. Durch das
  119. Programm PROTECT.EXE kann diese jedoch in die Datai NLS.ZIP dekodiert
  120. werden, indem man auf einer OS/2 Befehlszeile eingibt:
  121. PROTECT apm2v13 NLS.ZIE
  122.  
  123. Durch die Verschlüsselung ist sichergestellt, dass jeder der an dem 
  124. Quellenkode interessiert ist Zugriff auf eine OS/2 Installation haben muss,
  125. da ich nur eine 32-bit OS/2 Version des Entschlüsselungsprogramms zur
  126. Verfügung stelle (meine Antwort auf "Windows-only" Softwarehäuser).
  127.  
  128. Das Archiv NLS.ZIP beinhaltet folgende Dateien:
  129. Apm.cpp ....... Quellenkode
  130. Apm.hpp ....... Quellenkode Header 
  131. Apm.h ......... APM für OS/2 Toolkit
  132. Apm.def ....... Modul Definitionsdatei
  133. ApmUs.txt ..... Nachrichtendatei Quellenkode (English)
  134. ApmGr.txt ..... Nachrichtendatai Quellenkode (German)
  135. Make.cmd ...... Stapeljob um die englische und deutsche Version zu erzeugen
  136.  
  137. Starten Sie bitte das Programm um die Benutzungsbedingungen zu lesen!
  138.  
  139. Kommentare sind gerne willkommen, oder auch ein Besuch auf meiner Homepage
  140. unter der URL:
  141. http://www.geocities.com/SiliconValley/Pines/7885/
  142.  
  143. Warnung! Es besteht die Möglichkeit, dass APM Power Off nicht auf allen 
  144.          Systemen korrekt funktioniert (ich habe auch schon ein WIN95 OS2R2
  145.          preloaded System gesehen wo ein APM Power Off request zu einem
  146.          kompletten Hang geführt hat), obwohl APM unterstützt wird und 
  147.          APM.SYS korrekt funktioniert. Symptome sind (Dank an Frank Schroeder
  148.          vom OS/2 I/O Subsystem/Device Driver Development, der der Owner des
  149.          OS/2 APM Treibers ist, für seine Unterstützung der Suche nach 
  150.          möglichen Erklärungen der Ursachen):
  151.         
  152.          *) APM power off schaltet Ihren PC aus, aber trotz Warp 4 wird beim
  153.             nächsten Boot ein CHKDSK ausgeführt. Mögliche Ursache kann die
  154.             Kombination eines schnellen Prozessors mit einer langsamen 
  155.             Festplatte sein, da die Festplatte nicht rechtzeitig fertig 
  156.             geworden ist bevor die Stromversorgung abgeschalten wurder (das
  157.             kann auch Partitionen beschädigen).
  158.          *) Ihr PC wird ausgeschalten, schaltet sich aber sofort wieder ein.
  159.             Das kann damit zusammenhängen, dass das BIOS glaubt den PC wieder
  160.             einschalten zu müssen, weil ein "Wakup on LAN" Adapter dies 
  161.             verlangt oder dass der OS/2 APM Treiber das APM BIOS abfragt und
  162.             damit verwirrt.
  163.          *) APM power off funktioniert nicht unter OS/2 aber unter Windows.
  164.             Da OS/2 (als protected mode Betriebssystem) möglicherweise andere
  165.             Einsprungspunkte in das APM BIOS benutzt als Windows, kann es 
  166.             durch BIOS Fehler zu Unterschieden kommen. Selbst wenn der gleiche
  167.             BIOS Kode benutzt wird, können Unterschiede durch Timingprobleme,
  168.             Unterschieder in der Abfragefrequenz, der Reihenfolge der 
  169.             Funktionsaufrufe, der verwendeten Methode für APM Notifikationen,
  170.             ... werden. 
  171.  
  172. Mit freundlichen Grüssen aus Österreich! Roman
  173.  
  174.