
           IBM OS/2 PCMCIA DRIVERS FOR IBM AND NON-IBM HARDWARE

                 (INCLUDES PCMCIA CONFIGURATION MANAGER)


  Contents

  Chapter 1.    License

  Chapter 2.    Files and Installation (Includes Supported Hardware)
          2.1   Syntax Notation
          2.2   Installation Instructions
          2.3   CONFIG.SYS setting
          2.4   Parameters for SOCKET SERVICES
          2.5   Parameters for RESOURCE MAP UTILITY (RMU)
          2.6   Parameters for PCMCIA ATA DEVICE DRIVER
          2.7   Parameters for IBM PCMCIA Flash Memory devices
          2.8   What about "extra" drives created?
          3.0   Other Equipment Manufacturer Hardware Support


***************************************************************************

  Chapter 1.  License
  ___________________


            IBM Socket Services Driver Package for OS/2

        The IBM OS/2 Socket Services Device Driver packages are available on
        all sponsored IBM BBS's and CompuServe.  All the programs are
        stored and listed in OS2PCM.ZIP and OS2P21.ZIP files.


  *********************************************************************
  *                                                                   *
  * NOTICE                                                            *
  *                                                                   *
  * You accept these programs with the understanding that             *
  * the IBM Corporation makes no representations or warranties        *
  * as to the suitability of these programs for your particular       *
  * purpose, and that to the extent you use, you do so your own risk. *
  * In no event will the IBM Corporation be liable for any damages,   *
  * whether consequential, incidental, or special, arising out of     *
  * the use of or inability to use the programs provided.             *
  * Please read the LICENSE which follows to determine if you want    *
  * to use these programs.                                            *
  *                                                                   *
  * Copyright the IBM Corporation, 1994. All rights reserved.         *
  *                                                                   *
  * DO NOT POST MODIFIED VERSIONS OF THESE PROGRAMS FOR PUBLIC ACCESS *
  *********************************************************************


         IBM License Agreement for OS/2 Socket Services Device Driver
       -----------------------------------------------------------------


       IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS.

       International Business Machines Corporation grants you a license
       to use the Program only in the country where you acquired it. The
       Program is copyrighted and licensed (not sold). We do not
       transfer title to the Program to you. You obtain no rights other
       than those granted you under this license.

       Under this license, you may:

       1. use the Program on one or more machines at a time;
       2. make copies of the Program for use or backup purposes within
          your Enterprise;
       3. make copies of the original file you downloaded and distribute
          it, provided that you transfer a copy of this license to the
          other party. The other party agrees to these terms by its
          first use of the Program.

       You must reproduce the copyright notice and any other legend of
       ownership on each copy or partial copy, of the Program.

       You may NOT:

       1. sublicense, rent, lease, or assign the Program; and
       2. reverse assemble, reverse compile, or otherwise translate the
          Program.

       We do not warrant that the Program is free from claims by a third
       party of copyright, patent, trademark, trade secret, or any other
       intellectual property infringement.

       Under no circumstances are we liable for any of the following:

       1. third-party claims against you for losses or damages;
       2. loss of, or damage to, your records or data; or
       3. economic consequential damages (including lost profits or
          savings) or incidental damages, even if we are informed of
          their possibility.

       Some jurisdictions do not allow these limitations or exclusions,
       so they may not apply to you.

       We do not warrant uninterrupted or error free operation of the
       Program. We have no obligation to provide service, defect
       correction, or any maintenance for the Program. We have no
       obligation to supply any Program updates or enhancements to you
       even if such are or later become available.


       IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS.

       THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE
       IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
       PARTICULAR PURPOSE.

       Some jurisdictions do not allow the exclusion of implied
       warranties, so the above exclusion may not apply to you.

       You may terminate this license at any time. We may terminate this
       license if you fail to comply with any of its terms. In either
       event, you must destroy all your copies of the Program.

       You are responsible for the payment of any taxes resulting from
       this license.

       You may not sell, transfer, assign, or subcontract any of your
       rights or obligations under this license. Any attempt to do so is
       void.

       Neither of us may bring a legal action more than two years after
       the cause of action arose.

       If you acquired the Program in the United States, this license is
       governed by the laws of the State of New York. If you acquired
       the Program in Canada, this license is governed by the laws of
       the Province of Ontario. Otherwise, this license is governed by
       the laws of the country in which you acquired the Program.

       10/94
---------------------------------------------------------------------------


***************************************************************************
  Chapter 2.  Files and Installation In Package OS2PCM2.ZIP
  __________________________________




  FILES:
  ------

  DD    = Device Driver
  RMU   = Resource Map Utility
  SSDD  = Socket Service Device Driver

  File Name         File Size    Date      Description
  ------------      ---------  --------  ------------------------------------
  AST2RMU1.SYS           7187  06-17-94  AST Bravo/AST PowerExec RMU
  AUTODRV2.INI           2493  04-26-94  PCMCIA Device Description File
  AUTODRV2.SYS          10862  06-17-94  Connection Mgr Configuration DD
  COM.SYS               25544  05-24-94  OS/2 COM.SYS Device Driver
  IBM2AST1.SYS          10577  06-17-94  AST Bravo/AST PowerExec SSDD
  INSTALL.EXE           52767  10-28-94  OS/2 2.1 Installation Utility
  PCM2ATA.ADD           22534  06-23-94  IBM ATA PCMCIA DD
  PCMCIA.SYS            36203  06-17-94  OS/2 Card Services DD
  PCMCIA.TBL             1094  10-31-94  Beta PCMCIA Intallation Table
  README.txt            30446  10-31-94  This File
  SSVLSI.SYS             6434  11-10-94  AST Ascentia 900N SSDD
  VPCMCIA.SYS            1120  05-24-94  OS/2 Virtual Card Services DD
  WPCMPNP.DLL          160793  06-24-94  Configuration Manager Object
  WPCMPNP.HLP           23255  06-24-94  Configuration Manager Help

  INSTALLATION:
  --------------

  2.1   Syntax Notation

  <drv&dir> :- disk drive and directory
        A "drv"  is a valid disk drive letter ended with a colon ":".
        A "dir"  is a valid directory path in your system

  <> :- means optional

  |  :- means either left or right but not both


  2.2   Installation Instructions

        a.  If you have previously installed the EZPLAY or the PlayAtWill
            application, you must first delete the object from the
            workplace shell, shutdown and reboot the operating system.
            This is a problem which is currently being addressed.

        b.  Change your working directory to the directory where the files
            have been unpacked.  This utility will install from diskette or
            the hard disk.

        c.  Enter INSTALL and press the enter key.

        d.  Select the system to install for from the list.  The
            installation process takes about 30 - 60 seconds to complete.
            You will be notified when the installation process has
            completed. You will then need to shutdown and reboot the OS/2
            operating system to complete the installation of the drivers.

        e.  A Status log (named PCMINST2.LOG) is created in the root directory
            of the install drive.  You can review this log for errors.

        f.  All device drivers and the CONFIG.SYS will be saved as NAME.xxx
            where 'NAME' is either the name of the CONFIG.SYS file or the
            device driver and 'xxx' is a number beginning with '001'.  If
            there is not enough space to make a backup, the install process
            may fail.  WARNING:  The install utility does not check to see
            that enough disk space is available before proceeding.

  2.3   CONFIG.SYS statements

        The following is an example of the general ordering of the CONFIG.SYS
        file.  While your CONFIG.SYS file may not be identical, the following
        dependencies must be maintained:

        a.  COM.SYS always comes after MOUSE.SYS.  No parameters should be
            passed passed to the COM.SYS device driver.

        b.  AUTODRV2.SYS must always follow the COM.SYS device driver.

        c.  The SOCKET SERVICE and RESOURCE MAP UTILITY drivers are usually
            located at the end of the CONFIG.SYS file.  The RESOURCE MAP
            UTILITY precedes the SOCKET SERVICE.


  ********       ****  C O N F I G . S Y S  E X A M P L E  ****     ********
                       ==================================


  IFS=C:\OS2\HPFS.IFS  /CACHE:64 /CRECL:4
  PROTSHELL=C:\OS2\PMSHELL.EXE
  SET USER_INI=C:\OS2\OS2.INI
  SET SYSTEM_INI=C:\OS2\OS2SYS.INI
  SET OS2_SHELL=C:\OS2\CMD.EXE
  SET AUTOSTART=PROGRAMS,TASKLIST,FOLDERS,CONNECTIONS
  SET RUNWORKPLACE=C:\OS2\PMSHELL.EXE
  SET COMSPEC=C:\OS2\CMD.EXE
  .
  .
  .
  DEVICE=C:\OS2\APM.SYS
  DEVICE=C:\OS2\MDOS\VAPM.SYS
  DEVICE=C:\OS2\POINTDD.SYS
  DEVICE=C:\OS2\MOUSE.SYS
  DEVICE=C:\OS2\COM.SYS                      {Serial Driver for OS/2 2.1}
  DEVICE=C:\OS2\MDOS\VCOM.SYS
  CODEPAGE=437,850
  DEVINFO=KBD,US,C:\OS2\KEYBOARD.DCP
  .
  .
  .
  REM ************* P C M C I A  S E C T I O N **************
  BASEDEV=PCMCIA.SYS
  BASEDEV=RMU.SYS                      {Machine Specific Resource Map Utility}
  BASEDEV=SOCKET.SYS /s0=n             {Machine specific Socket Service      }
  BASEDEV=PCM2ATA.ADD                               {PCMCIA ATA Device Driver}
  DEVICE=C:\OS2\AUTODRV2.SYS C:\OS2\AUTODRV2.INI   {Auto Configuration Driver}
  DEVICE=C:\OS2\MDOS\VPCMCIA.SYS
  REM *********  E N D  P C M C I A  S E C T I O N  *********





  2.4   Parameters for SOCKET SERVICES

        NOTE: There are no optional parameters for the Socket driver for the
              AST Ascentia 900N driver (SSVLSI.SYS).  The following parameters
              apply to all other drivers.

        BASEDEV=<drv&dir>\socket.sys /S0=number_of_slots

        NOTE: '/S0=' and '/C0' is the number zero(0) and not the letter (O).

        The following parameters will automatically be provided for any
        computer listed in the install list.  This information is provided to
        allow users to experiment with computers which are not listed in the
        compatibility list.  With the exception of the number_of_slots
        parameter, all other parameters are optional.

        socket.sys        :

        The specific OS/2 socket driver for the notebook computer.


        number_of_slots   : 1 | 2 | 3 | 4

        Specifies number of PCMCIA socket(slots) for the system.
        ________________________________________________________________

        ***********************   O P T I O N S   **********************
        ________________________________________________________________


        status_change_irq : 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 |
                           12 |13 |14 |15

        Specifies interrupt level for the PCMCIA controller status
        change, such as card insertion or removal. The default value
        interrupt level is 15.  If you are using your notebook in a
        docking station, you may have interrupt (IRQ) conflicts with
        devices such as CD-ROM drives, LAN or multimedia adapters.
        This switch will allow you alter the IRQ used by the Socket
        Controller Chip.

        /N:IRQ0  : No-Check IRQ-0 Value at SetAdapter\SetSocket Functions.


        /IRQH    : Select IRQ Trigger Level.  (AT-Bus system is set to be
        /IRQL      IRQ-High as default)


        /APOFF   : Set Auto-Power Mode to be off.  Auto-Power
                   Mode provides the PC-Card Power automatically On\Off by
                   Hardware.  (Default:Auto-Power Mode is off)

        /PH      : Change return-code from BAD SOCKET to BUSY
                   when Client access the specified socket which is for
                   the Boot-Socket or Not-Accessible Socket.


        /IO0=    : nnnn
        /IO1=    : nnnn

                 Socket Number List of Adapter n.
                 Adapter number 0 through 1.

                 <Example>
                 /IO0=12  :Socket 1 & 2 are changed on Adapter 0.
                 /IO0=21  :Same as \MEM0=12.
                 /IO1=124 :Socket 1 & 2 & 4 are changed on Adapter 1.

                   Change IOCS16 Control-Line Connection from PC-Card
                   itself to PC-Card Controller Chip.  This option will be
                   needed for some cards which do not generate IOCS16-
                   signal.  Customers will need to verify this information
                   with their computer / PCMCIA card vendors.


        /MEM0=   : nnnn
        /MEM1=   : nnnn

                 Socket Number List of Adapter n.
                 Adapter number 0 through 1.

                 <Example>
                 /MEM0=12  :Socket 1 & 2 are changed on Adapter 0.
                 /MEM0=21  :Same as \MEM0=12.
                 /MEM1=124 :Socket 1 & 2 & 4 are changed on Adapter 1.

                   Change MEMCS16-Line generated from A23-A12 to A23-A17.



        /RI0=    : nnnn
        /RI1=    : nnnn

                 Socket Number List of Adapter n.
                 Adapter number 0 through 1.

                 <Example>
                 /RI0=12  :Socket 1 & 2 are changed on Adapter 0.
                 /RI0=21  :Same as \MEM0=12.
                 /RI1=124 :Socket 1 & 2 & 4 are changed on Adapter 1.

                   Change RI-Signal (Ring Indicator) from the I\O Card to
                   be mapped STSCHG Line in the system.
                   (For ExCA V1.50 Requirement)


        /IG0=    : nnnn
        /IG1=    : nnnn

                 Socket Number List of Adapter n.
                 Adapter number 0 through 1.

                 <Example>
                 /IG0=12  :Socket 1 & 2 are changed on Adapter 0.
                 /IG0=21  :Same as \MEM0=12.
                 /IG1=124 :Socket 1 & 2 & 4 are changed on Adapter 1.

                   Ignore the specified socket(s).  For this option,
                   socket services does not access the physical socket(s).
                   This option is for some point-enabler software, but
                   point-enabler software is not guaranteed to work
                   perfectly under running the socket services.



        /NC0=    : nnnn
        /NC1=    : nnnn

                 Socket Number List of Adapter n.
                 Adapter number 0 through 1.

                 <Example>
                 /NC0=12  :Socket 1 & 2 are changed on Adapter 0.
                 /NC0=21  :Same as \MEM0=12.
                 /NC1=124 :Socket 1 & 2 & 4 are changed on Adapter 1.

                   Treat specified socket on Adapter to be considered not
                   to be connected in the system.

        /DEBUG   : Display PC-Card Controller Information.

        /H       : for PS2\E System
        /G       : for PS55\E System
        /TP710T  : for ThinkPad 710T System
        /TP730T  : for ThinkPad 730T System

                   Set socket-services environment for specified system.
                   These options are available for IBM2SS01.SYS.


  2.5   RESOURCE MAP UTILITY

        A special purpose device driver created to provide card services with
        a system specific resource map detailing the resources in use and the
        resources available at system IPL.

        The following parameters will automatically be provided for any
        computer listed in the install list.  This information is provided to
        allow users to experiment with computers which are not listed in the
        compatibility list.  All of these parameters are optional.

        ________________________________________________________________

        ***********************   O P T I O N S   **********************
        ________________________________________________________________


        /IX=     : Interrupt level currently in use by system or other
                   devices.

                   Format : /IX=1,2,3......


        /PX=     : IO port currently in use by system or other devices.

                   Format : /PX=100-3FF,400-407.....

                   Hex value, range is from 0000 through FFFF.
                   Upper case, lower case can be specified.


        /MX=     : Memory space currently in use by system or other devices.

                   Format : /MX=C000-CFFF,D800-D8FF......

                   Hex value, range is from C000 through DFFF.
                   Value represent an address in 4K byte blocks.
                   Upper case, lower case can be specified.


        /MA=     : Memory space available for PCMCIA subsystem.

                   Format :/MA=C000-DFFF........

                   Hex value, range is from C000 through DFFF.
                   Value represent an address in 4K byte blocks.
                   Upper case, lower case can be specified.

        Note:      The values which are specified in /IX, /PX, or /MX
                   parameters will be registered to Card Services as
                   EXCLUSIVE USE.




  2.6   PCMCIA ATA DEVICE DRIVER

        The PCM2ATA.SYS device driver is a client OS/2 Device Driver for
        PCMCIA ATA devices. The following are some parameters which may be
        necessary for proper operation.

        ________________________________________________________________

        ***********************   O P T I O N S   **********************
        ________________________________________________________________



        /S:n     : The number of sockets (Default is 2).


        /I:n     : Socket number to be ignored (1 origin).

                   The ignored socket is not assigned drive letter. All CARD
                   events for the ignored socket are ignored in the Call Back
                   Handler of PCM2ATA.ADD.

                   This switch is useful for the socket which may always be
                   used for communication PCMCIA cards or for the socket which
                   is always occupied by Type-3 PCMCIA cards.


        /B       : There is a PCMCIA ATA device as used IDE harddisk.

                   This switch must be required when OS\2 is booted up from
                   PCMCIA ATA device itself.

                   This switch is only valid if the computer's BIOS supports
                   booting from a PCMCIA ATA device.  Users will have to
                   check with their computer manufacturers to inquire about
                   support for this function.


        /NOBEEP  : No beep is made when PCMCIA ATA device is inserted and is
                   recognized.

                   The default is making a beep sound.


        /STBTIME : nn
                   Specifies the value in minute that ATA cards will go to
                   standby mode. (Default is 0; maximum value is 21 minutes).

                   If a value bigger than 21 is specified, this option is
                   ignored and set it to default.


        /EXIRQ   : n
                   Do  Not use this IRQ level number.

                   IRQ level number specified by this switch is excluded when
                   PCM2ATA.ADD requests IRQ level number for CardService and
                   OS\2.


  2.8   What about "extra" drives created?

    The installation utility will install the PCMCIA ATA device driver
    as the default.  This will create extra removable media icons in the
    DRIVES folder.  This may also interfere with drive letters used
    when connect to a Local Area Network (LAN).  If the user has no
    plans to use PCMCIA ATA or Flash devices, the user can edit the
    CONFIG.SYS file and REMark the following lines as demonstrated below:

        rem BASEDEV=PCM2ATA.ADD


  3.0   Other Equipment Manufacturer Hardware (OEM) Support

    Only the Personal Computers listed in the install utility have been
    tested by IBM.  We are providing the Socket chip sets used in the
    hardware supported by these drivers in case you have OEM hardware not
    listed in the installation utility.  Please note that even though an
    OEM may uses the same chip sets, different revisions have been found to
    perform differently.  We make the following information available to
    assist customers in locating the closest match for their OEM system but
    the IBM Corporation makes no representations or warranties as to the             *
    suitability of these programs for your particular purpose, and that to
    the extent you use, you do so your own risk.  In no event will the IBM
    Corporation be liable for any damages, whether consequential,
    incidental, or special, arising out of the use of or inability to use
    the programs provided.


    MANUFACTURER                    CHIP SET
    ========================        ===============================

    AST Bravo/AST Powerexec         Intel
    AST Ascentia 900N               VLSI

12/94
*****************************************************************************
