
<<<<<<<<<<<<<<<<<<<<<<  IBM PlayAtWill Installation Program  >>>>>>>>>>>>>>>>>>>>>>>>

  Welcome to IBM PlayAtWill Installation Package for PC Card 5.0 CardBus
  support. This README.TXT contains the latest information. It also contains
  helpful hints.


  CONTENTS
  --------

 1.0   Systems supported by this Installation Package

 2.0   How to Install IBM PlayAtWill Installation Program

 3.0   How to Run the IBM PlayAtWill Installation Program Utilities

 4.0   Parameter Definitions

 5.0   Hints

 6.0   Enhanced Features

 7.0   Files

 8.0   Restore


 1.0   Systems Supported by this Installation Package
       ----------------------------------------------

       This PlayAtWill installation package is support for CardBus support.
       The CardBus support is PC Card 5.0 specifications. CardBus support for
       the following systems are included in this installation package:

          Chembook 2600
          Toshiba Tecra 510CDT


 2.0   How to Install IBM PlayAtWill Installation Program
       --------------------------------------------------

       The PLAYWILL.EXE file that you received contains all the files required
       to install IBM PlayAtWill in a self-extracting format. To install IBM
       PlayAtWill you must first expand the the PLAYWILL.EXE file in to the
       component files and then invoke the PMCINST2.EXE executable file to
       actually installs the IBM PlayAtWill components on your system.

       (a.) Start OS/2 3.0 or later.
       (b.) Start an "OS/2 Window".
       (c.) Change the current directory to the directory containing the
            PLAYWILL.EXE file
       (d.) Type PLAYWILL at the OS/2 command prompt. This will extract all the
            files required for the "IBM PlayAtWill" installation. These
            installation files will be extracted to the current working
            directory.
       (e.) Type PCMINST2 at the OS/2 command prompt. This will invoke the
            "IBM PlayAtWill" installation utility.
       (f.) Follow the instructions on the screen.
       (g.) After completion of the installation utility, if desired, all the
            installation files located in the current working directory may
            be deleted.
       (h.) Restart the system after completing the installation.


 3.0   How to Run the IBM PlayAtWill Installation Program Utilities
       ------------------------------------------------------------

    The IBM PlayAtWill Installation Program Utilities for OS/2 are registered
    as objects in the "IBM PlayAtWill Installation Program" folder. You can
    see ICONs titled "IBM PlayAtWill Installation Program","ATA Mount
    Utility","Auto Configurator Utility", and "Supported PCCards". To start
    these utilities, click on an ICON.


 4.0   Parameter Definitions
       ---------------------

  4.1  Socket Services

       /C0=z   : These parameters define the IRQ level to be used by the
       /C1=z     Socket Services driver. The new Card Services and Socket
                 Services drivers for OS/2 do not use a hardware interrupt
                 to notify the PCMCIA status change, so you do not need
                 these parameters.

       /IG0=y  : This parameter defines a slot number, which Socket Services
                 ignores. If you use the "Point enabler" supplied
                 with a PC Card, you should take into consideration the
                 coexistence with Socket Services.

                 For Example, "/IG0=1" defines that slot 1 is reserved for a
                 "Point enabler" and Socket Services will ignore the slot.

       /RI0=x  : This parameter defines a slot number, where Socket Services
                 disables the RI_OUT signal.
                 For Example, "/RI0=1" specifies slot 1.

       /D      : This parameter enables "Warm docking" from the
                 view point of PCMCIA hardware. By adding this parameter,
                 two additional PCMCIA slots are reserved for the docking
                 station.

       /APOFF  : This parameter turns off the Auto-Power Mode. If the
                 Auto-Power Mode is ON, a PC Card will be automatically
                 turned ON by the hardware when it is inserted.
                 The default for Auto-Power Mode is ON.

       /IO0=s  : This parameter defines the slot number, for which Socket
                 Services will change the way the -IOCS16 signal is generated.
                 By default, the -IOCS16 signal is generated based on the
                 -IOIS16 signal from the PC Card. If this parameter is
                 specified, the -IOCS16 signal is generated based on the
                 I/O data size which is specified by the Client program.
                 This option is needed for some cards which do not
                 generate the -IOIS16 signal. You need to verify
                 this information with PCMCIA card vendors.

                 For Example, "/IO0=1" specifies that the -IOCS16 signal
                 for slot 1 is to be generated based on the I/O data
                 size specified by the Client program.




  4.2  Card Services

       /R:200  : Specify that card services will conform to the PCMCIA 2.0
                 standard instead of the PCMCIA 5.0 standard which is the
                 default value.

       /P      : In previous releases, this parameter disabled the hardware
                 interrupt which was used by OS/2 Socket Services drivers to
                 notify clients of a change in status.

                 Neither the new Card Services nor Socket Services drivers
                 for OS/2 use a hardware interrupt to signal PCMCIA status
                 changes. So this parameter is no longer needed.


  4.3  Resource Map Utility

       /MA=xxxx-yyyy :
                 Specifies the address range available for Card Services and
                 the PC Cards. This should be specified in the range
                 from C000h to EFFFh.
                 One or more ranges may be specified in 4K blocks with a comma
                 (,) separating the address ranges.

                 << Note >>
                  The minimum size of this area depends on:
                    - The type of PC Card being used (see list below)
                    - Number of PC Cards used simultaneously
                    - Combinations of PC Cards used simultaneously

                        - Card Services           4K  (mandatory)
                                               or 8K  (CardBus system)
                        - Modem                   0K
                        - IBM Ethernet           16K
                        - IBM Token Ring         24K
                        - IBM 3270                8K
                        - IBM 5250                8K
                        - IBM SCSI                0K
                        - SRAM                    4K
                        - ATA                     0K
                        - FLASH                   4K

       /IX=n     Specifies the IRQ level (or levels) that should not be used
                 by the PC Cards (where n=IRQ level). This parameter is used
                 to avoid possible IRQ conflicts. The Resource Map Utility
                 can automatically detect many IRQ's that are already in
                 use, but may not detect all.
                 Multiple IRQ's may be specified by separating them
                 with a comma (,).

       /SH=1   : This parameter enables the "Shared" IRQ for the built-in
                 serial devices. If this parameter is set, the Resource Map
                 Utility registers the IRQ levels for the system's built-in
                 serial devices as "Shared" IRQ level. So the inserted modem
                 PC Card can be configured as IRQ4 or IRQ3 which may be used
                 by the built-in serial devices.



 5.0   Hints
       -----

    - For OS/2 Warp 3.0, you can see current system resource information
      with RMVIEW.EXE program. The RMVIEW.EXE is a standard OS/2 utility
      program which is included in OS/2 Warp 3.0. To run this program,
      type "RMVIEW" at the OS/2 command prompt and press ENTER. You can
      see short help with "/?" option.

    - For OS/2 Warp 3.0, the RESERVE.SYS is used instead of the Resource
      Map Utility(ICRMU01.SYS,RMUOS2AT.SYS). The RESERVE.SYS is a standard
      OS/2 device driver which is included in OS/2 Warp 3.0.

      RESERVE.SYS: RESERVE.SYS is used in conjunction with the Resource
      Manager in two separate scenarios:

      * If you are using a device driver that is not Resource Manager-aware
        and you know the resources that the device uses, use RESERVE.SYS to
        reserve those resources so the Resource Manager-aware drivers will
        not have access to those resources.

      * If you have a piece of hardware that does not tolerate the examination
        of its resources, reserve the resources so the Resource Manager-aware
        drivers do not examine the hardware.

      To use RESERVE.SYS, place the following statement as the first line in
      CONFIG.SYS:

        BASEDEV=RESERVE.SYS <arguments>

      Arguments:

            Ŀ
            v                                       
          /IO:  
             /P:    /DW:Ĵ   /EXC  Ĵ
                                      /MUL  Ĵ
             /MEM: Ĵ   /SHA  
             /DMA: Ĵ
             /IRQ: 

      Ŀ
       Switch  Format    Example        Description                     
      Ĵ
       /IO:    /IO:x,x   /IO:340,4      Reserve IO ports.               
                                        The first number is the base    
                                        port in HEX, and is followed by 
                                        the length (number of ports) in 
                                        HEX.                            
      Ĵ
       /P:     /P:x,x    /P:340,4       same as /IO:                    
      Ĵ
       /MEM:   /MEM:x,x  /MEM:CA00,100  Reserve Memory.                 
                                        The first number is the base    
                                        memory address in HEX, with the 
                                        assumption that the address is  
                                        XXXX:0, and is followed by the  
                                        length (number of address) in   
                                        HEX.                            
      Ĵ
       /DMA:   /DMA:x    /DMA:2         Reserve DMA Channel             
                                        The number is in decimal format.
      Ĵ
       /IRQ:   /IRQ:x    /IRQ:13        Reserve IRQ.                    
                                        The number is in decimal format.
      Ĵ
       /EXC    /EXC      /EXC           Exclusive resource attribute.   
      Ĵ
       /MUL    /MUL      /MUL           Multiplexed resource attribute. 
      Ĵ
       /SHA    /SHA      /SHA           Shared resource attribute.      
      Ĵ
       /DW:    /DW:x     /DW:10         Decode width of IO address.     
                                        Valid numbers are 10 and 16.    
                                        Only valid with /IO: switch.    
      

       More than one resource attribute per-resource entry is an error and
       is not allowed. If no attribute or decode width is set, the default
       is EXCLUSIVE and 16 respectively. For example, to reserve an IRQ 13
       EXCLUSIVE, DMA 0 SHARED, MEMORY CA00:0 for 1000 hex-bytes shared,
       IO ports 340 for 10 hex-ports EXCLUSIVE and with a decode width of 16,
       and IO ports 300 for 64 hex-ports with a decode width of 10, the
       following is specified:

       BASEDEV=RESERVE.SYS /IRQ:13 /DMA:0 /SHA /MEM:CA00,1000 /SHA /IO:340,10
                           /IO:300,64 /DW:10

    - All the PC cards, which have been powered off in the utility, will
      be powered on when you exit from the IBM PlayAtWill Installation
      Program utility.


  5.1  Storage PC Cards

    - Before using a brand-new FLASH PC Card, you have to initialize the
      card with the FFORMAT.EXE, FCHECK.EXE, FFORMAT2.EXE or FCHECK2.EXE
      program.

    - If you see the following message :

          << Attention >>
          This card isn't supported formally
          It is possible that it doesn't work correctly

      while the FFORMAT.EXE, FCHECK.EXE, FFORMAT2.EXE or FFORMAT2.EXE
      program is running, the card will be formatted as if it has
      256KB-erase-zone size and the write/erase logic of INTEL 28F020
      or 28F010.

    - If you see the following message :

          The size of this card is too small for the card to be formatted

      while the FFORMAT.EXE, FCHECK.EXE, FFORMAT2.EXE or FFORMAT2.EXE
      program is running, the card can't be formatted because its size
      is too small to accept the transfer unit.
      (At least one transfer unit is required for FTL.)

    - You can't use the SRAM region of the IBM FLASH & SRAM combo card
      on OS/2 even if you install PCM2SRAM.SYS (SRAM device driver).
      The card appears to be a FLASH card if you install
      FLSH2MTD.SYS (FLASH memory technology driver), PCM2FLSH.SYS
      (FLASH device driver), or other drivers.

    - OS/2 Warp includes a flash memory card device driver that
      can enable only IBM flash memory cards. The flash memory card device
      driver in this IBM PlayAtWill Installation Program can't enable cards formatted with
      the one in OS/2 Warp.

    - In case of formatting two or more Storage PC Cards, you have to run and
      exit the FORMAT program for every card.
      You must not format two or more Storage PC Cards from a single
      invocation of FORMAT.

    - You can't use the DISKCOPY program for the Storage PC Cards drive.

    - If your PC has two or more PCMCIA slots, do not insert or remove a
      storage PC Card in the slot while you are executing DOS commands,
      such as FORMAT or COPY to a storage PC Card in another slot.

    - If your system has three or more PCMCIA slots, for example a
      notebook computer with docking station which has PCMCIA slots, the
      total number of PCMCIA slots which will be used for Storage PC Cards
      must be specified.  For example, if you have four PCMCIA slots:

        BASEDEV=PCM2ATA.ADD /S:4 /!DM /NOBEEP

  5.2  Others

    - For the Auto Configurator driver and Utility, please refer to the
      AUTODRV.DOC file for more detail.

    - For the PC Cards, please refer to the PCMCIA.CRD file for more
      detail on the support level.

    - For the PC Cards, sample installation/configuration files (CONFIG.SYS,
      AUTOEXEC.BAT, etc.) are available on your "IBM PlayAtWill Installation Program for OS/2"
      diskette. Please refer to the \SAMPLES directory on the diskette.

    - If you use a Docking Station with your notebook computer, the adapter
      cards or the devices in the docking station may use resources such as
      I/O port, memory window, IRQ.
      Exclude these resources from the usable area of the Card Services.
      To exclude resources from the usable area, RESERVE.SYS can be used.
      See  "4.0 For OS/2" (RESERVE.SYS) in
      this document.

    - Add /INT option if an error or a timeout occurs while ATA(HDD) card
      being used.

        DEVICE=...PAWATA.SYS /INT   or
        DEVICE=...PAWATAS.SYS /INT  or
        DEVICE=...PAWATASF.SYS /INT

      In this case 4KB memory window is required for every ATA(HDD) card.

    - If you have an Adaptec SCSI PCCard, find

                  'REM BASEDEV=AHA152X.ADD'

      in config.sys and change it to

                  'BASEDEV=AHA152X.ADD'.

    - If you have a Future Domain SCSI PCCard, find

                  'REM BASEDEV=FD16-700.ADD'

      in config.sys and change it to

                  'BASEDEV=FD16-700.ADD'.


 6.0   Enhanced Features
       -----------------

    - New Storage PC Card Drivers which support ATA, SRAM and FLASH PC Cards.
    - New Auto Configurator which can be customized easily to support a
      variety of I/O PC Cards.
    - New utility programs:
        - ATA Mount Utility which enables multiple partitions on a ATA PC Card.
        - Auto Configurator Utility which helps users with customization.
    - New IBM PlayAtWill Installation Program Utility which provides greater usability:
        - Power control for the PC Cards.
        - Information on errors, PC Card resources, System resources, and
          more.
    - New sample installation/configuration files.
    - New problem determination scenario in the manual.
    - New Virtual Card Services driver which supports MVDM environments.
    - CSSCSI.SYS client driver is no longer needed.  This function has been
      implemented in FD16-700.ADD.


 7.0   Files
       -----

      README.TXT   : This file
      PCMINST2.EXE : Installation program for OS/2
      PCMINST2.DAT : Installation program for OS/2, data file
      PCMCIA.CRD   : PC Card Support List

      EZPLAY2.DLL  : IBM PlayAtWill Installation Program Utility for OS/2
      EZPLAY2.HLP  : IBM PlayAtWill Installation Program Utility for OS/2, help file
      PCMCIA.SYS   : Card Services driver for OS/2
      VPCMCIA.SYS  : Virtual Card Services driver for OS/2
      $ICPMOS2.SYS : PCMCIA Power Management Support driver for OS/2
      PAWFLDR.ICO  : IBM PlayAtWill Installation Program Folder ICON file
      LOGO_1.ICO   : PC Card Logo
      COM.SYS      : COM.SYS for OS/2 2.1

      TPIC95SS.SYS : Socket Services driver for Chembook 2600
      CL6832SS.SYS : Socket Services driver for Toshiba Tecra

      AUTODRV2.SYS : Auto Configurator for OS/2
      AUTODRV2.SCR : Auto Configurator for OS/2, script file
      AUTOUTL2.EXE : Auto Configurator Utility for OS/2
      AUTODRV2.SEL : Auto Configurator Utility for OS/2, data file
      AUTOUTL2.HLP : Auto Configurator Utility for OS/2, help file
      AUTODRV.DOC  : Auto Configurator READ.ME file
      *.SCR        : Auto Configurator sample script files

      ATAMNT2.EXE  : ATA Mount Utility for OS/2
      ATAMNT2.HLP  : ATA Mount Utility for OS/2, help file
      OS2PCARD.DMD : Storage Driver for OS/2
      PCM2ATA.ADD  : Storage Driver for OS/2 (ATA)
      PCMSSDIF.SYS : Storage Driver for OS/2 (Interface)
      PCM2SRAM.SYS : Storage Driver for OS/2 (SRAM)
      FLSH2MTD.SYS : Storage Driver for OS/2 (FLASH MTD)
      PCM2FLSH.SYS : Storage Driver for OS/2 (FLASH)
      FCHECK2.EXE  : FLASH PC Card Low-Level check program for OS/2
      FFORMAT2.EXE : FLASH PC Card Low-Level format program for OS/2

      AHA152X.ADD  : Adaptec SCSI PCCard for OS/2
      FD16-700.ADD : Future Domain SCSI PCCard for OS/2

      TDKENAB.OS2  : TDK CardBus NetFlyer NDIS Driver
      TDKFLYR.OS2  : TDK CardBus NetFlyer Client Driver
      PROTOCOL.INI : Protocol file for TDK Netflyer CardBus Card


 8.0   Restore
       -------
      If you wish to return your system to its original state (its state
      prior to PCCARD installation), you should follow the steps below.

      1) Copy all files in the backup directory to '\os2' directory on the
         boot drive.  The backup directory is a subdirectory of the
         PCCARD target directory for which you were prompted at install.
         The default target directory is '\ezplay'. For example,

               'copy c:\ezplay\backup\*.*  c:\os2'

         will restore all device drivers in the backup directory to the
         'c:\os2' directory.

      2) Rename the backup CONFIG.Sxx to CONFIG.SYS.

      3) Remove the PlayAtWill object from your desktop by dragging it to
         the shredder or by deleting it using other methods.
