home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / os2test.zip / readme < prev    next >
Text File  |  2002-08-20  |  20KB  |  493 lines
  1.   CONTENTS
  2.   --------
  3.  
  4.   This README file includes the following information:
  5.  
  6.   1.0   Terms and conditions
  7.   2.0   Installation notes
  8.   3.0   Multiple VDM Environment
  9.   4.0   Project Odin
  10.   5.0   Hibernation and dedicated sessions
  11.     5.1   TVFS
  12.     5.2   System Commander
  13.     5.3   Miscellaneous issues
  14.   6.0   XDFCOPY
  15.   7.0   Optional components
  16.     7.1   OS/2** Segmented Executable Linker v 2.00
  17.     7.2   IBM** IEEE-1284 Enhanced Parallel Port Driver
  18.     7.3   IBM** Micro Channel** IDE DASD driver
  19.   8.0   Optional untested components
  20.     8.1   Bi-directional input method
  21.     8.2   Universal Serial Bus (USB) support
  22.     8.3   Pen Device Driver
  23.   9.0   Large IDE media
  24.  10.0   Using the IBM1S506.ADD /!SHUTDOWN switch
  25.  11.0   ST-506/412 MFM drives
  26.  12.0   SVGA support
  27.  13.0   Netmos** Nm-9835 PCI I/O board
  28.  14.0   ISA Plug'n'Play support
  29.  15.0   Trademarks
  30.  
  31.  
  32.   1.0   Terms and conditions
  33.         --------------------
  34.  
  35.         Downloading this product indicates your acceptance of the following
  36.         terms and conditions:
  37.  
  38.         1. You may not use the product for any business, government or
  39.            institutional activities.
  40.         2. You may not charge any additional costs for this product except
  41.            media costs.
  42.         3. You have the royalty-free right to distribute this product provided
  43.            that this license information is left unmodified in the copies you
  44.            distribute.
  45.         4. In no event shall the authors be liable for any damage, either
  46.            direct or consequential, resulting from use or misuse of this
  47.            product. The authors hereby disclaim all warranties with regard to
  48.            this product, including, but not limited to, warranties of
  49.            merchantability and fitness for a particular purpose.
  50.  
  51.         All occurences of term "OS/2" in this product designate the mode of
  52.         operation compatible with IBM** OS/2 Warp 4**, unless otherwise
  53.         indicated with reference to a specific software product.
  54.  
  55.  
  56.   2.0   Installation notes
  57.         ------------------
  58.  
  59.         This product is not intended for end-user installation, therefore the
  60.         current version does not include an installation facility. The topics
  61.         in this section deal with particular cases, given that the user has
  62.         acceptable background in installation and maintenance of IBM** OS/2**
  63.         systems.
  64.  
  65.         To facilitate the installation, this distribution duplicates VDISK.SYS
  66.         and FORMAT.COM at disk 2. This arrangement may be changed in future
  67.         releases of the product.
  68.  
  69.         The installation options available to the user are as follows:
  70.  
  71.         (a) Drop-in replacement for existing IBM** OS/2 Warp 4** system with
  72.             prerequisite build level 9.023. In this case, copy the following
  73.             files to the OS/2** startup partition:
  74.  
  75.               o  Disk 0:
  76.                  OS2KRNLI -> \OS2KRNL
  77.                  SYSINSTX.COM -> \OS2\INSTALL\BOOTDISK\
  78.                  OS2LDR -> \
  79.                  OS2LDR.MSG -> \
  80.                  OS2DUMP -> \
  81.                  README -> \
  82.               o  Disk 1:
  83.                  OS2LOGO -> \
  84.                  *.FLT -> \OS2\BOOT\
  85.                  *.ADD -> \OS2\BOOT\
  86.                  *.SYS [excluding CONFIG.SYS] -> \OS2\BOOT\
  87.               o  Disk 2:
  88.                  KEYBOARD.DCP -> \OS2\
  89.                  VIOTBL.DCP -> \OS2\BOOT\
  90.                  HPFS.IFS -> \OS2\
  91.                  CDFS.IFS -> \OS2\BOOT\
  92.                  OS2CDROM.DMD -> \OS2\BOOT\
  93.                  COUNTRY.SYS -> \OS2\SYSTEM\
  94.                  *.DLL -> \OS2\DLL\
  95.                  *.COM -> \OS2\
  96.                  HARDERR.EXE -> \OS2\SYSTEM\
  97.                  SYSLEVEL.OS2 -> \OS2\INSTALL\
  98.                  CMD.EXE -> \OS2\
  99.                  TESTCFG.SYS -> \OS2\BOOT\
  100.                  MOUSE.SYS -> \OS2\BOOT\
  101.                  VDISK.SYS -> \OS2\BOOT\
  102.               o  Disk 3:
  103.                  UHPFS.DLL -> \OS2\DLL\
  104.                  UNPACK.EXE -> \OS2\
  105.                  *.COM -> \OS2\
  106.  
  107.             Install the bundle files using the UNPACK command. Run it
  108.             with your OS/2** boot partition as current drive, e.g.
  109.  
  110.             [D:\]A:\unpack A:\bundle
  111.             [D:\]A:\unpack A:\vga
  112.  
  113.             To install the hibernation and dedicated sessions support on a
  114.             HPFS partition (where it was not made available by OS/2 Warp 4**
  115.             installer), first unpack the TRUEMODE bundle from OS/2 Warp 4**
  116.             CDROM (\OS2IMAGE\DISK_37 directory), then unpack TRUEMODE from
  117.             osFree disk 3. Be sure to install HYBERSET.EXE in CONFIG.SYS.
  118.  
  119.         (b) Stand-alone installation after booting from floppy disks. In
  120.             this scenario, the CONFIG.SYS on disk 1 has to be modified to
  121.             install the VDISK.SYS driver as follows:
  122.  
  123.             DEVICE=VDISK.SYS 1024 512 112
  124.  
  125.             First, run FDISK after booting to create the partitions.
  126.             Reboot if necessary.
  127.  
  128.             Then, after the osFree prompt is available, the library files
  129.             need to be copied to the virtual disk. For example, if VDISK
  130.             acquires drive letter H:, and the target installation partition
  131.             is named G:, the following actions might be done:
  132.  
  133.             SET BEGINLIBPATH=H:\
  134.             COPY *.DLL H:
  135.             [insert disk 3]
  136.             COPY *.DLL H:
  137.             FORMAT G: /FS:HPFS
  138.             [insert disk 0]
  139.             SYSINSTX H:
  140.  
  141.             Then the system files have to be copied to appropriate locations
  142.             as described in method (a) above, and the CONFIG.SYS file has to
  143.             be created. The structure of CONFIG.SYS is not discussed in the
  144.             present document, please refer to the sample below for a typical
  145.             hard disk boot configuration.
  146.  
  147.         (c) Installation to a FAT16 partition using DOS or other compatible
  148.             operating system. In this case, osFree boot is only required to
  149.             create and format the target partition. From the floppy disk 2 run
  150.             the following command:
  151.  
  152.             FORMAT x:
  153.  
  154.             where x: is the drive letter of target partition. Then refer to
  155.             method (a) for information on copying the system files. Copy the
  156.             following file from disk 0 to establish the boot loader:
  157.  
  158.             OS2BOOT -> \
  159.  
  160.         A sample CONFIG.SYS file follows:
  161.  
  162.         buffers=32
  163.         iopl=yes
  164.         memman=swap
  165.         swappath=d:\os2\system 3072 512
  166.         protshell=d:\os2\cmd.exe
  167.         diskcache=D2,LW
  168.         protectonly=yes
  169.         libpath=.;d:\os2\dll;
  170.         ifs=d:\os2\hpfs.ifs /c:64
  171.         pauseonerror=no
  172.         country=1,d:\os2\system\country.sys
  173.         codepage=437
  174.         devinfo=kbd,us,d:\os2\keyboard.dcp
  175.         devinfo=scr,vga,d:\os2\boot\viotbl.dcp
  176.         device=d:\os2\boot\mouse.sys
  177.         set path=d:\os2;d:\os2\system
  178.         set dpath=d:\os2;d:\os2\system;\os2\install
  179.         set keys=on
  180.         basedev=ibmkbd.sys
  181.         basedev=ibm1flpy.add
  182.         basedev=ibm1s506.add /!SHUTDOWN
  183.         basedev=ibm2flpy.add
  184.         basedev=ibm2adsk.add
  185.         basedev=ibm2scsi.add
  186.         basedev=os2dasd.dmd
  187.         device=d:\os2\boot\testcfg.sys
  188.         basedev=ibmatapi.flt
  189.         basedev=ibmidecd.flt
  190.         device=d:\os2\boot\os2cdrom.dmd /q
  191.         ifs=d:\os2\boot\cdfs.ifs /q
  192.         set video_devices=vio_vga
  193.         set vio_vga=device(bvhvga)
  194.  
  195.  
  196.   3.0   Multiple VDM Environment
  197.         ------------------------
  198.  
  199.         The implementation of OS/2**-compatible MVDM environment is pending
  200.         to be included in a future release. The osFree package may be
  201.         integrated into an existing OS/2** installation with MVDM, however.
  202.  
  203.         The kernel may impose problems with DOS applications that utilize the
  204.         INT 2Fh calls to release timeslices. A workaround is to set
  205.         IDLE_SENSITIVITY=1 for the suffering applications.
  206.  
  207.  
  208.   4.0   Project Odin
  209.         ------------
  210.  
  211.         Project Odin is an effort of implementing the Microsoft proprietary
  212.         Win32 programming interface on OS/2** platforms. The kernel in this
  213.         release includes an update to support the Project Odin, provided
  214.         that you have IBM** Presentation Manager and IBM** Multimedia
  215.         Presentation Manager/2** installed.
  216.  
  217.         To use the WIN32K.SYS kernel loader for Win32 executables, be sure to
  218.         extract the OS2KRNL.SYM file from the kernel debugger files in this
  219.         package and place it into the root directory along with OS2KRNL.
  220.  
  221.         If the Win32 executable files fail to start under Project Odin,
  222.         causing a "SYS2070: WGSS50->PMMERGE.5473" error, it indicates that
  223.         the version of Presentation Manager is not capable of supporting the
  224.         APIs required by the current version of Project Odin. In this case it
  225.         is advised either to upgrade PMMERGE.DLL, or to install a version of
  226.         Project Odin dated before July 19th, 2001. This problem may be
  227.         corrected in future versions of WGSS50.DLL.
  228.  
  229.  
  230.   5.0   Hibernation and dedicated sessions
  231.         ----------------------------------
  232.  
  233.         Hibernation and trapdoor support is available both on FAT and HPFS
  234.         partitions.
  235.  
  236.         HYBERNAT.EXE has the following new options besides the function
  237.         provided for compatibility with IBM** HYBERNAT.EXE:
  238.  
  239.              /i = Relax the OS2LDR version check (hibernation requires some
  240.                   specific functions of OS2LDR). Also, bypasses the
  241.                   verification for absence of write-mode files with /s
  242.                   ("sticky boot") option. This parameter is DANGEROUS.
  243.  
  244.             /u1 = specify a pre-hibernation user hook. The hook can be used to
  245.                   check the conditions for hibernation and/or perform some
  246.                   custom cleanup.
  247.  
  248.                   The hook must not start any background processes for which
  249.                   it is not aware of. The hook must not be a batch file (to
  250.                   run a batch file, set /u1"cmd /c mybatch.cmd"). The hook may
  251.                   be a DOS or OS/2 program, but not a Windows** or PM
  252.                   program.
  253.  
  254.                   If the hook returns a non-zero errorlevel, then the
  255.                   hibernation is aborted.
  256.  
  257.                   When it is launched, the hook may observe and/or modify the
  258.                   startup files created for dedicated session.
  259.  
  260.             /u2 = specify a post-restore user hook. This is to revert the
  261.                   action of /u1 hook. The same rules as with /u1 apply here,
  262.                   but there are some specific points:
  263.  
  264.                     o  If /u1 never ran (or returned a non-zero errorlevel),
  265.                        then the /u2 hook is not launched.
  266.                     o  The errorlevel for this hook is not verified.
  267.                     o  Background processes may be started if you're sure that
  268.                        you won't attempt hibernation again until they finish.
  269.  
  270.         With the trapdoor/dedicated session setup, HYBERNAT also accepts the
  271.         following special parameters:
  272.  
  273.              /c = Prevent from removing the system \CONFIG.SYS and \AUTOEXEC.BAT
  274.                   and replacing them with DOS ones. /c is particularly useful
  275.                   together with /t<xxx> and is recommended if you run
  276.                   multiple systems from the FAT partition.
  277.  
  278.              /m = Disable the Boot Manager switching into unattended mode.
  279.  
  280.         /b<xxx> = Specify the trapdoor invocation point:
  281.  
  282.                     o  A drive specification (e.g. C:) tells to invoke the
  283.                        boot sector of this drive, possibly launching the
  284.                        associated OS.
  285.  
  286.                     o  A filename specification (e.g. E:\MISC\DOSBOOT.DAT)
  287.                        means that the boot sector (or an MBR snapshot) will be
  288.                        taken from this file. Such files can be created with
  289.                        Norton Utilities** or similar tools, but it is out of
  290.                        scope of this document. Only 512 bytes are read.
  291.  
  292.                     o  A directory specification (e.g. C:\WARPDOS) is for
  293.                        pointing an alternative location for the IBM** DOS
  294.                        files supplied in TRUEMODE bundle of OS/2 Warp 4**. The
  295.                        default is C:\OS2\SYSTEM (note the C:, as the
  296.                        dedicated session still requires a C: FAT16 primary
  297.                        partition).
  298.  
  299.         Any parameters to HYBERNAT.EXE can be preset in the SET HIBEROPT=...
  300.         option in CONFIG.SYS.
  301.  
  302.   5.1   TVFS
  303.         ----
  304.  
  305.         The IBM** Toronto Virtual File System (TVFS) needs to be disabled with
  306.         a user hook prior to entering the hibernation. An example follows:
  307.  
  308.         SET HIBEROPT=/u1"c:\os2\tvfs\tvkill" /u2"cmd /c tvfsinit"
  309.  
  310.         TVFSINIT.CMD must contain:
  311.  
  312.         @echo off
  313.         c:
  314.         cd\os2\tvfs
  315.         set TVFS_RESTORE_CMD=C:\OS2\TVFS\TVFS_RST.CMD
  316.         tvctl.exe -p -w -r
  317.         tvrestor
  318.  
  319.         All applications accessing files on a TVFS volume will go into
  320.         undetermined state for the time between TVKILL is issued and the
  321.         system is finally suspended by HYBERNAT (though the effort was made
  322.         to reduce this time to a minimum by freezing the system as soon as
  323.         possible after the /u1 hook finishes).
  324.  
  325.         The second critical point is when the system is released but the /u2
  326.         hook is not yet launched. That is imperative that daemon processes
  327.         running with open files on TVFS must be tolerant to this temporary
  328.         lock-out.
  329.  
  330.   5.2   System Commander
  331.         ----------------
  332.  
  333.         The "MultiFAT" setup of System Commander requires /c to be present in
  334.         HIBEROPT. This will preserve the system CONFIG.SYS and AUTOEXEC.BAT from
  335.         overwriting with dedicated session ones in the SC MultiFAT repository.
  336.  
  337.   5.3   Miscellaneous issues
  338.         --------------------
  339.  
  340.         - Disk space: the free space on startup volume: has to be capable to
  341.           keep the hibernation file (\SWAPPER2.DAT), which is equal to the
  342.           amount of physical RAM.
  343.  
  344.         - Fragmentation of the boot partition should be avoided. A warning
  345.           message will appear if the level of fragmentation is too high.
  346.  
  347.         - Conflicting drivers: in very unlikely cases, hibernation may fail
  348.           consistently, until a reboot is performed. The reason is unknown,
  349.           since this situation is rather infrequent and has not been
  350.           investigated yet.
  351.  
  352.         - Network connections. There is a variety of network configurations,
  353.           the operability of hibernation depends on the exact case. The
  354.           Ethernet LAN as well as PPP connections are not known to compromise
  355.           the hibernation, though the data sent over these connections will
  356.           be discarded.
  357.  
  358.         - EXT2FLT.FLT, a driver commonly used for foreign filesystem support,
  359.           if installed with the /A switch, results in a broken hibernation
  360.           file.
  361.  
  362.         - The keyboard is not intercepted while HYBERNAT.EXE runs. Switching
  363.           the tasks will result in inability to restore the system state.
  364.  
  365.  
  366.   6.0   XDFCOPY
  367.         -------
  368.  
  369.         XDFCOPY supports the low-density (720 KB 3.5") floppy media.
  370.  
  371.         Please be aware that the version of XDFCOPY supplied in this package
  372.         is protected mode only and will not run in DOS.
  373.  
  374.  
  375.   7.0   Optional components
  376.         -------------------
  377.  
  378.         The following components are not required to provide compatibility
  379.         with IBM** OS/2** system but are provided as optional:
  380.  
  381.   7.1   OS/2** Segmented Executable Linker v 2.00
  382.         -----------------------------------------
  383.  
  384.         The updated linker in this release contains a superset of functions
  385.         provided in Microsoft** Segmented-Executable Linker Version 5.10. New
  386.         function includes the NONAME clause of EXPORT statement in definition
  387.         files. It tells the linker to not include symbolic names for export
  388.         ordinals.
  389.  
  390.   7.2   IBM** IEEE-1284 Enhanced Parallel Port Driver
  391.         ---------------------------------------------
  392.  
  393.         The driver for ECP/EPP parallel ports is available as PAR1284.SYS.
  394.  
  395.   7.3   IBM** Micro Channel** IDE DASD driver
  396.         -------------------------------------
  397.  
  398.         The driver for Micro Channel** IDE controllers is available
  399.         as IBM2IDE.ADD.
  400.  
  401.  
  402.   8.0   Optional untested components
  403.         ----------------------------
  404.  
  405.         The following packages are included in the current release for
  406.         evaluation purposes and are not meant to be tested for compatibility
  407.         or completeness.
  408.  
  409.   8.1   Bi-directional input method
  410.         ---------------------------
  411.  
  412.         The optional components of osFree include the base support for BIDI
  413.         (Arabic and Hebrew) input method. This function is provided as
  414.         untested in the current release. Additional NLS components may be
  415.         required.
  416.  
  417.   8.2   Universal Serial Bus (USB) support
  418.         ----------------------------------
  419.  
  420.         The Universal Serial Bus drivers are provided as untested in the
  421.         current release.
  422.  
  423.   8.3   Pen Device Driver
  424.         -----------------
  425.  
  426.         The light pen (serial digitizer) driver is provided as untested
  427.         in the current release.
  428.  
  429.  
  430.   9.0   Large IDE media
  431.         ---------------
  432.  
  433.         In contrast to IBM** OS/2 Warp 4**, the level of IBM1S506.ADD bundled
  434.         with osFree supports IDE drives larger than 8.4 GB, with the limit of
  435.         128 GB.
  436.  
  437.  
  438.  10.0   Using the IBM1S506.ADD /!SHUTDOWN switch
  439.         ----------------------------------------
  440.  
  441.         IBM1S506.ADD may be installed with the /!SHUTDOWN switch to prevent
  442.         hard drive power-down at the time of system shutdown or reboot. This
  443.         option should be avoided on laptop computers, such as Toshiba**
  444.         Satellite Pro**, with IBM** TravelStar** hard drives, where the manual
  445.         power-down may result in emergency unload of drive heads. Refer to
  446.         IBM** TravelStar** specifications for more details.
  447.  
  448.  
  449.  11.0   ST-506/412 MFM drives
  450.         ---------------------
  451.  
  452.         The current version of IBM1S506.ADD does not support ST-506/412
  453.         controllers.
  454.  
  455.  
  456.  12.0   SVGA support
  457.         ------------
  458.  
  459.         The base display drivers in this product are compatible with IBM**
  460.         OS/2 Warp 4**. A problem has been prevented that might lead to TRAP
  461.         or IPE when switching between video pages in applications that run
  462.         in 132-column text mode.
  463.  
  464.  
  465.  13.0   Netmos** Nm-9835 PCI I/O board
  466.         ------------------------------
  467.  
  468.         To use the Netmos** PCI I/O cards with osFree, the I/O ports need to
  469.         be preconfigured to match the "legacy" addressing. This has to be
  470.         done before the OS boots. An example configuration follows:
  471.  
  472.           o  Register 10h = COM3 = 03E9h
  473.           o  Register 14h = COM4 = 02E9h
  474.           o  Register 16h = LPT2 = 0279h
  475.           o  Register 17h = ECP/EPP for LPT2 = 0679h
  476.  
  477.         Future versions may include the appropriate modifications to
  478.         PRINT01.SYS and COM.SYS.
  479.  
  480.  
  481.  14.0   ISA Plug'n'Play support
  482.         -----------------------
  483.  
  484.         The "snooper" code required to detect ISA Plug'n'Play devices is not
  485.         included in this version. The Resource Manager still can be used to
  486.         install "snoopers" by means of SNOOP.LST file.
  487.  
  488.  
  489.  15.0   Trademarks
  490.         ----------
  491.  
  492.         The trademarks denoted with (**) belong to their respective owners.
  493.