home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / lan / tkncca12.zip / TREN120.DSK / unc.dsk / READ.ME < prev    next >
Text File  |  1993-07-20  |  37KB  |  1,195 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.   1.0  CONTENTS
  8.   _____________
  9.  
  10.  
  11.  
  12.  
  13.  
  14.   1.1  About This File   . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  15.   1.2  Card Services Aware Device Drivers  . . . . . . . . . . . . . . . . .  1
  16.     1.2.1  IBMTOKCS.DOS  . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  17.       1.2.1.1  Error Indications   . . . . . . . . . . . . . . . . . . . . .  2
  18.     1.2.2  TOKEN.COM   . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  19.     1.2.3  IBMTOKCS.OS2  . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  20.       1.2.3.1  Error Indications   . . . . . . . . . . . . . . . . . . . . .  5
  21.     1.2.4  Novell Netware Requester for OS/2 Support   . . . . . . . . . . .  7
  22.   1.3  Connectivity Enabler Software for DOS   . . . . . . . . . . . . . . .  8
  23.   1.4  Connectivity Enabler Parameters   . . . . . . . . . . . . . . . . .   10
  24.     1.4.1  CS20TOK.SYS syntax  . . . . . . . . . . . . . . . . . . . . . .   10
  25.     1.4.2  POINTTR.SYS syntax  . . . . . . . . . . . . . . . . . . . . . .   11
  26.     1.4.3  TOSHTR.SYS syntax   . . . . . . . . . . . . . . . . . . . . . .   12
  27.   1.5  Diagnostic Software   . . . . . . . . . . . . . . . . . . . . . . .   12
  28.   1.6  System Pitfalls   . . . . . . . . . . . . . . . . . . . . . . . . .   13
  29.     1.6.1  OS/2 TCP/IP 1.2.1 Users   . . . . . . . . . . . . . . . . . . .   14
  30.     1.6.2  Memory Conflicts and Memory Managers  . . . . . . . . . . . . .   14
  31.     1.6.3  Miscellaneous   . . . . . . . . . . . . . . . . . . . . . . . .   14
  32.       1.6.3.1  Machines using SystemSoft Card and Socket Services  . . . .   16
  33.   1.7  Where to find Card Services and Socket Services   . . . . . . . . .   17
  34.   1.8  OS/2 Device Driver Statement Order  . . . . . . . . . . . . . . . .   18
  35.  
  36.  
  37.   1.1  ABOUT THIS FILE
  38.   ____________________
  39.  
  40.   This file describes additional information on the IBM 16/4 Token Ring Credit
  41.   Card Adapter.  It also describes the Card Services Aware device drivers,
  42.   Connectivity Enabler Software and Diagnostic Software.
  43.  
  44.  
  45.  
  46.   1.2  CARD SERVICES AWARE DEVICE DRIVERS
  47.   _______________________________________
  48.  
  49.   The device drivers on this diskette (IBMTOKCS.DOS, TOKEN.COM, and
  50.   IBMTOKCS.OS2) are Card Services Aware and can be used with Card Services for
  51.   configuration.  The DOS drivers (IBMTOKCS.DOS and TOKEN.COM) also can be used
  52.   with Connectivity Enabler software if Card Services is unavailable.
  53.  
  54.  
  55.   1.2.1  IBMTOKCS.DOS
  56.  
  57.   IBMTOKCS.DOS is the NDIS token-ring device driver for DOS.  The PROTOCOL.INI
  58.   file is used to pass parameters to the driver.  Some new keywords have been
  59.   added that can be used in the PROTOCOL.INI file.  These keywords are only
  60.   active if you are utilizing Card Services for configuration.
  61.  
  62.   The new keywords are:
  63.  
  64.  
  65.  
  66.                                                                     Contents  1
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.   o   MMIO
  77.  
  78.   o   RINGSPEED
  79.  
  80.   o   PROMPT
  81.  
  82.   o   INTERRUPT
  83.  
  84.   o   RAMSIZE
  85.  
  86.   o   PCMCIA
  87.  
  88.   MMIO allows the user to select where the Memory Mapped I/O / BIOS domain is
  89.   located.  The default value is CC00 for primary adapters and DC00 for alter-
  90.   nate adapters.
  91.  
  92.   RINGSPEED allows the user to select the ring speed. The default ring speed is
  93.   4 Mbps.
  94.  
  95.   PROMPT allows the user to be prompted for the ring speed during boot up.  The
  96.   default is to NOT prompt the user.
  97.  
  98.   INTERRUPT allows the user to select the interrupt used by the workstation for
  99.   this adapter. The default interrupt value is 2 (9).
  100.  
  101.   RAMSIZE allows the user to select the size of the Shared RAM that is seen by
  102.   the workstation. The default RAMSIZE is 16K.
  103.  
  104.   PCMCIA is the keyword that signals the driver to look for Card Services prior
  105.   to looking for the adapter.
  106.  
  107.   See the IBMTOKCS.NIF file for valid values for these keywords.
  108.  
  109.   Below is a sample PROTOCOL.INI entry for this driver:
  110.  
  111.  
  112.   [IBMTOKCS_NIF]                   <-- This is the PROTOCOL.INI
  113.           DriverName = IBMTOK$         entry for the NDIS driver.
  114.           EARLYRELEASE
  115.           RAM = 0xD800             <-- this is the optional Shared Ram address
  116.           MMIO = 0xCC00            <-- this is the optional MMIO address
  117.           MAXTRANSMITS = 6
  118.           RECVBUFS = 2
  119.           RECVBUFSIZE = 256
  120.           XMITBUFS = 1
  121.           XMITBUFSIZE = 2040
  122.           INTERRUPT = 9            <-- this is the requested IRQ level(optional)
  123.           RINGSPEED = 16           <-- set the ring speed here
  124.           PCMCIA                   <-- this tells the driver not to look for
  125.                                        standard cards and use Card Services
  126.           PROMPT                   <-- put this in if you want to be prompted
  127.  
  128.   Most of the parameters can be commented out by placing a ";" (semi-colon) in
  129.   front of the entry.  The default values are:
  130.  
  131.  
  132.   2
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.   RINGSPEED = 4          (4 Mbps)
  144.   INTERRUPT = 2          <-- if these parameters are NOT specified, the
  145.   RAM = 0xD800           <-- driver searches for a valid address or available
  146.   MMIO = 0xCC00          <-- interrupt value until one is found (Adaptive
  147.                              mode) or the valid values tried are exhausted.
  148.  
  149.  
  150.   1.2.1.1  Error Indications
  151.  
  152.   The  NDIS  driver signals the user when a Card Services call fails. The error
  153.   signal is an alternating beep. If you hear this sound, a problem is occurring
  154.   during configuration.  At this time, review your PROTOCOL.INI and  CONFIG.SYS
  155.   to  verify  proper  parameters.    It  is vitally important that memory areas
  156.   requested are available.  Try commenting out the RAM and  MMIO  keywords  and
  157.   reboot.  If  this doesn't help, check for any programs (e.g. EMM386.EXE) that
  158.   may be conflicting with the memory requested.
  159.  
  160.  
  161.   1.2.2  TOKEN.COM
  162.  
  163.   TOKEN.COM is the ODI token-ring driver for Novell Environments.  It uses  the
  164.   NET.CFG  to  get  specific configuration information.   Two new keywords have
  165.   been added for Card Services support.
  166.  
  167.   The new keywords are:
  168.  
  169.   o   PCMCIA
  170.  
  171.   o   DATA RATE
  172.  
  173.   The PCMCIA keyword was added to tell the driver to use Card Services for con-
  174.   figuration. If you don't want to use card services, take out this keyword.
  175.  
  176.   The DATA RATE keyword is used to set the ring speed of the token-ring  credit
  177.   card.  It  has two possible values: 4 or 16.  If you don't use card services,
  178.   take out this keyword.
  179.  
  180.  
  181.   Here are the contents of a sample NET.CFG file when using Card Services:
  182.  
  183.   Link Driver TOKEN
  184.      PCMCIA
  185.      DATA RATE 4
  186.  
  187.  
  188.   The MMIO address and the Shared RAM address may be selected by using the  MEM
  189.   keyword  in NET.CFG.   Here is a sample NET.CFG where we set the MMIO and the
  190.   Shared RAM memory areas:
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.                                                                     Contents  3
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.   Link Driver TOKEN
  209.      PCMCIA
  210.      DATA RATE 16
  211.      MEM #1 D4000        <-- This sets the MMIO/ROM area to D4000.
  212.      MEM #2 CC000        <-- This sets the Shared RAM to CC000.
  213.  
  214.  
  215.  
  216.   1.2.3  IBMTOKCS.OS2
  217.  
  218.   IBMTOKCS.OS2  is  the  NDIS  token-ring  device  driver  for  OS/2 2.1.   The
  219.   PROTOCOL.INI file is used to  pass  parameters  to  the  driver.    Some  new
  220.   keywords  have  been  added that can be used in the PROTOCOL.INI file.  These
  221.   keywords are only active if you are utilizing Card  Services  for  configura-
  222.   tion.
  223.  
  224.   The new keywords are:
  225.  
  226.   o   MMIO
  227.  
  228.   o   RINGSPEED
  229.  
  230.   o   INTERRUPT
  231.  
  232.   o   RAMSIZE
  233.  
  234.   o   PCMCIA
  235.  
  236.  
  237.   MMIO  allows  the user to select where the Memory Mapped I/O / BIOS domain is
  238.   located.  The default value is CC00 for primary adapters and DC00 for  alter-
  239.   nate adapters.
  240.  
  241.   RINGSPEED allows the user to select the ring speed. The default ring speed is
  242.   4 Mbps.
  243.  
  244.   INTERRUPT allows the user to select the interrupt used by the workstation for
  245.   this adapter. The default interrupt value is 9.
  246.  
  247.   RAMSIZE  allows the user to select the size of the Shared RAM that is seen by
  248.   the workstation. The default RAMSIZE is 16K.
  249.  
  250.   PCMCIA is the keyword that signals the driver to look for Card Services prior
  251.   to looking for the adapter.
  252.  
  253.   See the IBMTOKCS.NIF file for valid values for these keywords.
  254.  
  255.   Below is a sample PROTOCOL.INI entry for this driver:
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.   4
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.   [IBMTOKCS_nif]                   <-- This is the PROTOCOL.INI
  275.           DriverName = IBMTOK$         entry for the NDIS driver.
  276.           PRIMARY
  277.           RAM = 0xD800             <-- this is the optional Shared Ram address
  278.           MMIO = 0xCC00            <-- this is the optional MMIO address
  279.           MAXTRANSMITS = 6
  280.           RECVBUFS = 2
  281.           RECVBUFSIZE = 256
  282.           XMITBUFS = 1
  283.           INTERRUPT = 9            <-- this is the requested IRQ level(optional)
  284.           RINGSPEED = 16           <-- set the ring speed here
  285.           PCMCIA                   <-- this tells the driver not to look for
  286.                                        standard cards and use Card Services
  287.  
  288.   Most of the parameters can be commented out by placing a ";" (semi-colon) in
  289.   front of the entry.  The default values are:
  290.  
  291.   RINGSPEED = 4          (4 Mbps)
  292.   INTERRUPT = 9          <-- if these parameters are NOT specified, the
  293.   RAM = 0xD800           <-- driver searches for a valid address or available
  294.   MMIO = 0xCC00          <-- interrupt value until one is found (Adaptive
  295.                              mode) or the valid values tried are exhausted.
  296.  
  297.  
  298.   1.2.3.1  Error Indications
  299.  
  300.   The  NDIS  driver signals the user when a Card Services call fails. The error
  301.   signal is an alternating beep. If you hear this sound, a problem is occurring
  302.   during configuration. Review your LANTRAN.LOG file in your \IBMCOM  subdirec-
  303.   tory  to determine what is wrong.  Depending on the error, you may see one or
  304.   more of the following statements:
  305.  
  306.       LTG0091E: Card Services could not be found.
  307.       LTG0093E: No sockets were found by Card Services.
  308.       LTG0083E: Token-Ring Credit Card RequestIO failed. Return code xx.
  309.       LTG0084E: Token-Ring Credit Card RequestIRQ failed. Return code xx.
  310.       LTG0085E: Token-Ring Credit Card RequestWindow failed. Return code xx.
  311.       LTG0086E: Token-Ring Credit Card RequestConfiguration failed. Return code
  312.       xx.
  313.       LTG0090E: Token-Ring Credit Card RegisterClient failed. Return code xx.
  314.  
  315.   At this time, review your CONFIG.SYS to verify proper statement ordering,  or
  316.   review  your  PROTOCOL.INI to verify proper parameters.  It is vitally impor-
  317.   tant that resources requested (interrupt, memory areas) are available.
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.                                                                     Contents  5
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.   Below are suggested actions to help resolve these error conditions:
  341.  
  342.   o   LTG0091E: Card Services could not be found.
  343.  
  344.       The  statement DEVICE=x:\OS2\PCMCIA.SYS is missing from CONFIG.SYS.  Make
  345.       sure the device driver is present on your hard drive and  this  statement
  346.       is in your CONFIG.SYS.
  347.  
  348.   o   LTG0093E: No sockets were found by Card Services.
  349.  
  350.       Either your workstation has no sockets, the socket services device driver
  351.       is  not  installed,  or  the socket services device driver is incorrectly
  352.       installed.   Make sure the socket  services  device  driver  follows  the
  353.       token-ring driver in CONFIG.SYS and can be found on your hard drive.
  354.  
  355.   o   LTG0083E: Token-Ring Credit Card RequestIO failed.  Return code xx.
  356.  
  357.       Another  adapter  is  using either ports A20-A23 for a PRIMARY adapter or
  358.       ports A24-A27 for an ALTERNATE adapter.  Either remove the other  adapter
  359.       or change this adapter from PRIMARY to ALTERNATE.
  360.  
  361.   o   LTG0084E: Token-Ring Credit Card RequestIRQ failed.  Return code xx.
  362.  
  363.       The  interrupt  you requested is being used by another adapter.  Try com-
  364.       menting out the INTERRUPT= statement or change the value used.
  365.  
  366.   o   LTG0085E: Token-Ring Credit Card RequestWindow failed.  Return code xx.
  367.  
  368.       The MMIO or RAM memory window requested could not be acquired.  Try  com-
  369.       menting out these statements or changing their values.
  370.  
  371.   o   LTG0086E:  Token-Ring  Credit  Card RequestConfiguration failed.   Return
  372.       code xx.
  373.  
  374.       The  card  could  not  be  configured  with  the  IO/IRQ/Memory   Windows
  375.       requested.  Try using different values.
  376.  
  377.   o   LTG0090E: Token-Ring Credit Card RegisterClient failed.  Return code xx.
  378.  
  379.       The  device  driver could not register with Card Services.  Make sure you
  380.       have Card Services 2.0 properly installed.
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.   6
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.   1.2.4  NOVELL NETWARE REQUESTER FOR OS/2 SUPPORT
  407.  
  408.   There  is  no  native  OS/2 driver for Novell Environments.  You must use the
  409.   ODI2NDI mapper that is provided with this diskette.  Use the Install  program
  410.   to install and configure your workstation for a Novell Environment.  A sample
  411.   PROTOCOL.INI file configured for a Novell Environment follows:
  412.  
  413.        [PROT_MAN]
  414.           DRIVERNAME = PROTMAN$
  415.        [IBMLXCFG]
  416.           IBMTOKCS_nif = IBMTOKCS.nif
  417.           ODI2NDI_nif = ODI2NDI.NIF
  418.        [ODI2NDI_nif]
  419.           DriverName = ODI2NDI$
  420.           Bindings = IBMTOKCS_nif
  421.           Netaddress = "T400000000001"        <-- You MUST have an address
  422.           TOKEN-RING = "yes"                      specified or you will not
  423.           TOKEN-RING_SNAP = "no"                  connect to a server
  424.           ETHERNET_802.3 = "no"
  425.           ETHERNET_802.2 = "no"
  426.           ETHERNET_II = "no"
  427.           ETHERNET_SNAP = "no"
  428.           TRACE = 0x0
  429.        [IBMTOKCS_nif]
  430.           DriverName = IBMTOK$
  431.           ADAPTER = "PRIMARY"
  432.           MAXTRANSMITS = 6
  433.           RECVBUFS = 2
  434.           RECVBUFSIZE = 256
  435.           XMITBUFS = 1
  436.           PCMCIA
  437.           RINGSPEED = 16
  438.  
  439.   You must have either your Universally Administered Address (UAA) or a Locally
  440.   Administered  Address (LAA) specified in the Netaddress field.  The installa-
  441.   tion program will fill in a default value that you should change.    To  find
  442.   out  your adapter's UAA you should boot this diskette and run the Diagnostics
  443.   program.
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.                                                                     Contents  7
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.   1.3  CONNECTIVITY ENABLER SOFTWARE FOR DOS
  473.   __________________________________________
  474.  
  475.   The  Connectivity  Enabler  software  is  used to configure the PCMCIA socket
  476.   hardware and the IBM 16/4 Token-Ring Credit Card Adapter hardware for  opera-
  477.   tion.    It is loaded as a device driver in CONFIG.SYS BEFORE any Token- Ring
  478.   device drivers and AFTER the Card Services and Socket Services Device Drivers
  479.   (Card and Socket Services are NOT required for operation  of  the  Token-Ring
  480.   Credit  Card  Adapter).   Once the Connectivity Enabler has run successfully,
  481.   the Credit Card Adapter behaves like a full-sized shared RAM IBM 16/4  Token-
  482.   Ring adapter.  After the Connectivity Enabler has run, it removes itself from
  483.   the  system  memory. This is not true in the case of CS20TOK.SYS.  It remains
  484.   resident in memory to handle card insertions  and  card  deletions  from  the
  485.   system.
  486.  
  487.  
  488.   The  NDIS  (IBMTOKCS.DOS) and ODI (TOKEN.COM) drivers on this diskette do not
  489.   require the use of an enabler when used with Card  Services.    They  have  a
  490.   built-in  interface to Card Services for configuration purposes.  They can be
  491.   used without Card Services if Card Services is  unavailable  or  incompatible
  492.   with the driver.
  493.  
  494.  
  495.   For  the adapter to function properly in systems without Card Services, it is
  496.   essential that the correct enabler is used and that the  Token-Ring  communi-
  497.   cations  software used agree on two parameters.  These parameters are the IRQ
  498.   level and the Shared RAM address.
  499.  
  500.  
  501.   The default value of IRQ 2 works for all current software.
  502.  
  503.   Non-Card Services Aware drivers can only use the  default  IRQ  value  of  2.
  504.   This  is  due  to the way the IRQ value from the credit card is determined by
  505.   existing software. Existing software will always determine  that  the  credit
  506.   card is using IRQ 2.
  507.  
  508.  
  509.   Token  Ring  communications software selects where the shared RAM will reside
  510.   in the Workstation's memory space. This is not done  by  the  enabler.    The
  511.   Shared RAM address set by the enabler must match the memory location selected
  512.   by the Token Ring communications software or communication will not occur.
  513.  
  514.   There  are  three different connectivity enablers included with this package.
  515.   They are:
  516.  
  517.   o   CS20TOK.SYS
  518.  
  519.   o   POINTTR.SYS
  520.  
  521.   o   TOSHTR.SYS
  522.  
  523.   CS20TOK.SYS is a Card Services 2.0 interface enabler.  It uses the card  ser-
  524.   vices that is included as a device driver with the computer or as part of the
  525.   operating  system.    This  enabler should be used when your machine has card
  526.   services installed, but the Token-Ring driver you wish to use does not inter-
  527.  
  528.  
  529.   8
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.   face with card services.   One such driver  is  the  DXMC0MOD.SYS  token-ring
  540.   driver available with the IBM LAN Support Program.
  541.  
  542.   POINTTR.SYS  is  an  enabler  that communicates directly to Intel 82365SL (or
  543.   equivalent) hardware.   This is a PCMCIA socket  controller  common  in  many
  544.   systems.    This  enabler should be used when card and socket services do not
  545.   exist on your machine or the version of card  and  socket  services  on  your
  546.   machine  do  not communicate correctly with CS20TOK.SYS or the card services-
  547.   aware driver.
  548.  
  549.   TOSHTR.SYS is an enabler that is used with the Toshiba T3300SL computer.
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.                                                                     Contents  9
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.   1.4  CONNECTIVITY ENABLER PARAMETERS
  606.   ____________________________________
  607.  
  608.   Each  enabler  has  parameters that allow the enabler to be customized to the
  609.   communication software.  The parameters allow the selection of  which  socket
  610.   is  used  for  the  card,  memory  areas  used by the card and the ring speed
  611.   desired.  The default parameters should be sufficient for most users.
  612.  
  613.  
  614.  
  615.   1.4.1  CS20TOK.SYS SYNTAX
  616.  
  617.   Complete Syntax:
  618.  
  619.   DEVICE=\path\CS20TOK.SYS [RS=16/RS=4] [PROMPT] [MMIO=XXXX]
  620.                            [PRI/ALT] [IRQ=X] [SRAM=XXXX,Y[Y]] [DS=16/DS=8]
  621.  
  622.   RS       Ring Speed (16 or 4 MBPS)
  623.   PROMPT   Prompt for ring speed selection at boot time
  624.   MMIO     Memory Mapped I/O Address
  625.   PRI/ALT  Primary/ Alternate adapter
  626.   IRQ      Interrupt Level (PCMCIA controller interrupt)
  627.   SRAM     Shared Ram address [XXXX] and size [Y[Y]] in kbytes
  628.   DS       Data size (16 or 8 bit bus)
  629.  
  630.   note: X is a hexadecimal number
  631.         Y is a decimal number
  632.         Memory Mapped I/O and Shared RAM addresses are valid between
  633.         C000 and DE00.
  634.  
  635.   sample:
  636.  
  637.   DEVICE=C:\LAN\CS20TOK.SYS RS=16 MMIO=CC00 SRAM=D800,16
  638.  
  639.   This would configure an IBM 16/4 Token-Ring credit card for a ring  speed  of
  640.   16  Mbps, MMIO address at CC00 segment, and Shared RAM at D800 segment with a
  641.   workstation memory size of 16K bytes.
  642.  
  643.   The default parameters are:
  644.  
  645.   RS=4             (Ring speed of 4 Mbps)
  646.   No Prompt        (Do not prompt for ring speed at boot time)
  647.   MMIO=D000        (Memory Mapped I/O at the D000 segment)
  648.   PRI              (Primary Adapter)
  649.   IRQ=9            (PCMCIA controller interrupt at IRQ 9) (redirected IRQ 2)
  650.   SRAM=D800,16     (Shared RAM at D800 segment, 16k bytes in size )
  651.   DS=16            (Data Bus size of 16 bits)
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.   10
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.   1.4.2  POINTTR.SYS SYNTAX
  673.  
  674.  
  675.   Complete Syntax:
  676.  
  677.   DEVICE=\path\POINTTR.SYS [SA/SB/SC/SD] [RS=16/RS=4] [PROMPT] [MMIO=XXXX]
  678.                            [PRI/ALT] [IRQ=X] [SRAM=XXXX,Y[Y]]
  679.                            [WS=0,1,2,3,4] [DS=16/DS=8]
  680.  
  681.   SA/SB/SC/SD - Socket A, Socket B, Socket C, or Socket D
  682.   RS    - Ring Speed (16 or 4 MBPS)
  683.   PROMPT - Prompt for ring speed selection at boot time
  684.   MMIO - Memory Mapped Address
  685.   PRI/ALT - Primary/ Alternate adapter
  686.   IRQ - Interrupt Level (PCMCIA controller interrupt)
  687.   SRAM - Shared Ram address [XXXX] and size [Y[Y]] in kbytes
  688.   WS - Wait state selection
  689.   DS - Data size (16 or 8 bit bus)
  690.  
  691.   note: X is a hexadecimal number
  692.         Y is a decimal number
  693.  
  694.   sample:
  695.  
  696.   DEVICE=C:\LAN\POINTTR.SYS SB RS=16 MMIO=D000 SRAM=D800,16 WS=0
  697.  
  698.   This  would configure an IBM 16/4 token ring credit card for socket B, a ring
  699.   speed of 16 Mbps, MMIO address at D000 segment, Shared RAM  at  D800  segment
  700.   with a workstation memory size of 16K bytes and no wait states.
  701.  
  702.   The default parameters are:
  703.  
  704.   RS=4             (Ring speed of 4 Mbps)
  705.   SA               (Socket A)
  706.   No Prompt        (Do not prompt for ring speed at boot time)
  707.   MMIO=D000        (Memory Mapped IO at the D000 segment)
  708.   PRI              (Primary Adapter)
  709.   IRQ=9            (PCMCIA controller interrupt at IRQ 9) (redirected IRQ 2)
  710.   SRAM=D800,16     (Shared RAM at D800 segment, 16k bytes in size )
  711.   WS=1             (1 wait state)
  712.   DS=16            (Data Bus size of 16 bits)
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.                                                                    Contents  11
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.   1.4.3  TOSHTR.SYS SYNTAX
  739.  
  740.  
  741.   Complete Syntax:
  742.  
  743.   DEVICE=\path\TOSHTR.SYS [RS=16/RS=4] [PROMPT] [MMIO=XXXX]
  744.                           [PRI/ALT] [SRAM=XXXX,Y[Y]]
  745.  
  746.  
  747.   RS    - Ring Speed (16 or 4 MBPS)
  748.   PROMPT - Prompt for ring speed selection at boot time
  749.   MMIO - Memory Mapped Address
  750.   PRI/ALT - Primary/ Alternate adapter
  751.   SRAM - Shared Ram address [XXXX] and size [Y[Y]] in kbytes
  752.  
  753.   note: X is a hexadecimal number
  754.         Y is a decimal number
  755.         Memory Mapped I/O and Shared RAM addresses are valid between
  756.         C000 and DE00.
  757.  
  758.   sample:
  759.  
  760.   DEVICE=C:\LAN\TOSHTR.SYS PROMPT MMIO=D000 SRAM=D800,16
  761.  
  762.   This would configure an IBM 16/4 token ring credit card for a ring speed of 4
  763.   Mbps,  MMIO  address at D000 segment, Shared RAM at D800 segment with a work-
  764.   station memory size of 16K bytes.  During  CONFIG.SYS  processing,  the  user
  765.   would be prompted to either accept the configured 4 Mbps ring speed or change
  766.   it to 16 Mbps.
  767.  
  768.   The default parameters are:
  769.  
  770.   RS=4             (Ring speed of 4 Mbps)
  771.   No Prompt        (Do not prompt for ring speed at boot time)
  772.   MMIO=D000        (Memory Mapped IO at the CC00 segment)
  773.   PRI              (Primary Adapter)
  774.   IRQ=9            (PCMCIA controller interrupt at IRQ 9) (redirected IRQ 2)
  775.   SRAM=D800,16     (Shared RAM at D800 segment, 16k bytes in size )
  776.  
  777.  
  778.  
  779.   1.5  DIAGNOSTIC SOFTWARE
  780.   ________________________
  781.  
  782.   The diagnostic software is used to determine if a properly installed IBM 16/4
  783.   Token-Ring  Credit Card is performing correctly.  It is not used to determine
  784.   problems with the configuration.
  785.  
  786.  
  787.   There is a diagnostic enabler that is used  when  the  diagnostics  are  run.
  788.   This  enabler  has  the same default parameters except for memory size as the
  789.   enabler in CONFIG.SYS.
  790.  
  791.  
  792.  
  793.  
  794.  
  795.   12
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.   For DOS, TRCCTEST checks  to  see  if  Card  Services,  Socket  Services,  or
  806.   enablers  are present in the system.  If none of these are present, a message
  807.   saying that Card Services or an enabler must be installed will be  displayed.
  808.   Your machine must be configured to run with the Token-Ring Credit Card before
  809.   executing the diagnostics.
  810.  
  811.  
  812.   Ring  diagnostics requires the use of 4K bytes of shared RAM starting at D800
  813.   for the primary adapter and D400 for the alternate adapter.  When using  Card
  814.   Services, if either adapter is configured in the PROTOCOL.INI or NET.CFG with
  815.   an  MMIO  address  of  D800  or  D400  the ring diagnostics will fail with an
  816.   initialization failure.   Modify the MMIO  address  in  the  PROTOCOL.INI  or
  817.   NET.CFG  file  to  use other values (e.g. MMIO=CC00 for a primary adapter and
  818.   MMIO=DC00 for a alternate adapter) and reboot the machine  to  run  the  ring
  819.   diagnostics. If problems still persist, the diagnostics can be run by booting
  820.   the  workstation  from  the  installation  diskette  as  is required for OS/2
  821.   systems.
  822.  
  823.  
  824.   For OS/2, the workstation must  be  booted  from  the  installation  diskette
  825.   because  the  diagnostics  will not work in a DOS window under OS/2.  It will
  826.   ask for your machine type and socket where the adapter is installed.
  827.  
  828.  
  829.   Your system must have the ANSI.SYS device driver loaded at boot time for  the
  830.   diagnostic software to display properly.  This device driver is used for for-
  831.   matting the information on the screen.
  832.  
  833.  
  834.   It  is  best  not to load your network operating system software when running
  835.   diagnostics.  This can interfere with the operation of the  diagnostic  soft-
  836.   ware.
  837.  
  838.  
  839.   After  executing  the  diagnostics,  turn  off  the  system power. Remove the
  840.   diskette and then turn on the system power.
  841.  
  842.  
  843.  
  844.   1.6  SYSTEM PITFALLS
  845.   ____________________
  846.  
  847.   Some of the new systems that support PCMCIA 2.0 I/O cards have features  that
  848.   the user must be aware of when using the IBM 16/4 Token-Ring Credit Card.
  849.  
  850.  
  851.   For the PCMCIA socket to receive power, many computers must have the power to
  852.   the  PCMCIA  socket enabled. This is typically done with a setup utility that
  853.   comes with the computer.
  854.  
  855.  
  856.   If you are using Card and Socket Services, make sure your  PCMCIA  socket  is
  857.   enabled.    If  your socket is not enabled, IBM Socket Services will not load
  858.   and will not display an error message;  IBM Card Services will not load,  but
  859.   will display an error message that Socket Services is not present.
  860.  
  861.  
  862.                                                                    Contents  13
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.   1.6.1  OS/2 TCP/IP 1.2.1 USERS
  876.  
  877.   If  you  are  using the TCP/IP LAN Adapter and Protocol Support, TCPLAPS V1.0
  878.   for OS/2 TCP/IP, you must not use the Install option of LAPS to  install  the
  879.   Token-Ring  Credit  Card driver.   It will fail to copy the driver files from
  880.   the diskette.  You must first install LAPS, then copy the following files:
  881.        COPY A:IBMTOKCS.NIF C:\IBMCOM\MACS
  882.        COPY A:IBMTOKCS.OS2 C:\IBMCOM\MACS
  883.        COPY A:LTG.MSG C:\IBMCOM
  884.        COPY A:LTGH.MSG C:\IBMCOM
  885.   After copying the files, re-enter LAPS and use the Configure option.
  886.  
  887.  
  888.  
  889.   1.6.2  MEMORY CONFLICTS AND MEMORY MANAGERS
  890.  
  891.   Many computers cache or shadow sections of memory  to  speed  up  operations.
  892.   The IBM 16/4 Token-Ring Credit Card is a shared RAM adapter and utilizes some
  893.   of  the  system memory space.  Some computers cache the segment C000 to D000.
  894.   You may want to consult  the  manufacturer's  manual  for  your  computer  or
  895.   contact the manufacturer if you find you are having problems.
  896.  
  897.  
  898.   The DOS utility EMM386.EXE, if used, must be configured to exclude the memory
  899.   used by the adapter for its memory-mapped I/O and its Shared RAM.  Here is an
  900.   example invocation of EMM386.exe in your CONFIG.SYS:
  901.  
  902.   DEVICE=C:\DOS\EMM386.EXE X=D000-D200 X=D800-DC00
  903.  
  904.   This would exclude the memory areas necessary for standard default operation.
  905.  
  906.  
  907.   When  using  utilities  like  QEMM  or 386MAX, it is important to exclude the
  908.   memory used by these utilities from the memory used by the token-ring  credit
  909.   card. The operation of the token-ring credit card will be affected.
  910.  
  911.  
  912.  
  913.   1.6.3  MISCELLANEOUS
  914.  
  915.   It  is  important  to  have a token-ring credit card adapter inserted in your
  916.   computer before starting some  Local  Area  Network  software.  Unpredictable
  917.   results may occur if the adapter is not present and the software is executed.
  918.  
  919.  
  920.   It  is also important not to remove your token-ring credit card once communi-
  921.   cation on a LAN has begun. Unpredictable operation can occur if this  happens
  922.   (possible system hang).
  923.  
  924.  
  925.  
  926.  
  927.  
  928.   14
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.   The  IBMTOKCS.NIF  file is intended for use only with the IBM 16/4 Token-Ring
  939.   Credit Card Adapter.  Errors may result if used with other Token-Ring cards.
  940.  
  941.  
  942.   The  IBM  ThinkPad  720/720C notebook computer typically uses Card and Socket
  943.   Services.  If you do not want to use Card and  Socket  Services,  POINTTR.SYS
  944.   can  be  used.    You  must use the WS=0 parameter on the command line of the
  945.   enabler for the card to function properly in this machine.  A system hang may
  946.   result if POINTTR.SYS is used with  Card  Services.    Use  the  Credit  Card
  947.   Installation program to remove any connectivity enablers.
  948.  
  949.  
  950.   The  Toshiba  T3300SL computer comes with a utility called SETVER.EXE that is
  951.   executed in CONFIG.SYS. This is a special version of  MS-DOS  5.0  that  only
  952.   comes  with the Toshiba. This particular version is incompatible with network
  953.   operating environments like DOS LAN Requestor. An error indicating an  incor-
  954.   rect  DOS  version occurs.  This has not been found on other MS-DOS machines.
  955.   The installation utility will remark out this utility in  CONFIG.SYS  on  the
  956.   Toshiba.
  957.  
  958.  
  959.   The AST PowerExec series computers come with a utility called CCU.EXE that is
  960.   executed  in CONFIG.SYS.   This program allows the IBM 16/4 Token-Ring Credit
  961.   Card Adapter to be used in conjunction with other PCMCIA feature cards.    It
  962.   is  recommended  that  you  use  CCU.EXE since this program performs the same
  963.   function as the connectivity enabler.   A  system  hang  may  result  if  you
  964.   attempt  to  use  both  CCU.EXE  and  the  POINTTR.SYS  connectivity enabler.
  965.   Consult your AST computer documentation for information  on  setting  CCU.EXE
  966.   parameters.
  967.  
  968.  
  969.   When two adapters are used in a single machine with Card Services and you are
  970.   using  the  NDIS  driver,  it  is  important  for the user to edit the second
  971.   section [IBMTOKCS2_NIF] of the PROTOCOL.INI to remark out the  references  to
  972.   MMIO  and  RAM.  This  is  to ensure that the drivers can allocate the memory
  973.   resources necessary for each driver.
  974.  
  975.  
  976.   When two adapters are used in a single machine, we  recommend  that  you  set
  977.   each adapter to a different interrupt level. This can be done in PROTOCOL.INI
  978.   and NET.CFG when using Card Services.
  979.  
  980.  
  981.   The following machines have two PCMCIA sockets. Here are their socket assign-
  982.   ments:
  983.  
  984.                                  Socket A (or 1)       Socket B (or 2)
  985.                                  ---------------       ---------------
  986.  
  987.       AST Powerexec                Bottom                Top
  988.       IBM ThinkPad 720             Top                   Bottom
  989.       NEC UltraLite VERSA          Bottom                Top
  990.  
  991.  
  992.  
  993.  
  994.                                                                    Contents  15
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.   The  PS/2  E  Model 9533 has four PCMCIA sockets. Here are its socket assign-
  1005.   ments:
  1006.  
  1007.           Socket A - Front Top
  1008.           Socket B - Front Bottom
  1009.           Socket C - Back Top
  1010.           Socket D - Back Bottom
  1011.  
  1012.   Single Socket machines use Socket A.
  1013.  
  1014.  
  1015.   If  you plan to use the Personal Computer LAN Program (PCLP) as a server on a
  1016.   machine with an IBM token-ring credit card adapter, it  is  recommended  that
  1017.   the LAN Support Program native token-ring driver (DXMC0MOD.SYS) be used.
  1018.  
  1019.  
  1020.  
  1021.   1.6.3.1  Machines using SystemSoft Card and Socket Services
  1022.  
  1023.   In  order  for machines with SystemSoft Card and Socket services installed to
  1024.   be able to use the IBM Token-Ring Credit Card Adapters, the following  proce-
  1025.   dure should be followed:
  1026.  
  1027.  
  1028.   Make  sure  your  system  is  using  the  level  of  Card Installation Client
  1029.   (CIC.EXE) dated 3-25-93 or later.  If you're using an earlier  level,  update
  1030.   your system software.
  1031.  
  1032.  
  1033.   After  installing  the IBM Token Ring Credit Card Adapter and the appropriate
  1034.   device drivers, make the following parameter changes:
  1035.  
  1036.      1. Edit the CONFIG.SYS and locate the CIC.EXE line.
  1037.         Update the parameters so that the line appears as below:
  1038.  
  1039.         DEVICE=C:\path\CIC.EXE /NWBAS D8 /NWSIZ 4 /LIRQ 9 /NWBAS2 D0 /NWSIZ2 2
  1040.  
  1041.      2. If running in a Novell environment:
  1042.  
  1043.         Edit the NET.CFG file and remove the PCMCIA keyword.
  1044.  
  1045.  
  1046.  
  1047.   Please refer to the SystemSoft CardSoft Reference Guide for further  informa-
  1048.   tion.
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.   16
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.   1.7  WHERE TO FIND CARD SERVICES AND SOCKET SERVICES
  1071.   ____________________________________________________
  1072.  
  1073.   Device Driver    |  Description
  1074.   -----------------+---------------------------------------------------------
  1075.   PCMCIA.SYS       |  OS/2 Card Services.  This device driver ships with
  1076.                    |  OS/2 2.1.  It can be installed either when you first
  1077.                    |  install OS/2 2.1 or by selecting the 'Selective
  1078.                    |  Install' icon.
  1079.                    |
  1080.   IBMDOSCS.SYS     |  IBM DOS Card Services.  This device driver ships on a
  1081.                    |  diskette included with your workstation.  For example,
  1082.                    |  the diskette is labeled 'IBM ThinkPad 720/720C PCMCIA
  1083.                    |  Device Driver Diskette' if you purchased either the
  1084.                    |  IBM ThinkPad 720 or 720C.
  1085.                    |
  1086.   IBM2SS01.SYS     |  IBM OS/2 Socket Services. This device driver ships on a
  1087.   IBM2SS02.SYS     |  diskette included with your workstation.  For example,
  1088.                    |  the diskette is labeled 'IBM ThinkPad 720/720C PCMCIA
  1089.                    |  Device Driver Diskette' if you purchased either the
  1090.                    |  IBM ThinkPad 720 or 720C.  The driver ending in 01 is
  1091.                    |  for ISA bus machines.  The driver ending in 02 is for
  1092.                    |  MicroChannel machines.
  1093.                    |
  1094.   IBMDSS01.SYS     |  IBM DOS Socket Services. This device driver ships on a
  1095.   IBMDSS02.SYS     |  diskette included with your workstation.  For example,
  1096.                    |  the diskette is labeled 'IBM ThinkPad 720/720C PCMCIA
  1097.                    |  Device Driver Diskette' if you purchased either the
  1098.                    |  IBM ThinkPad 720 or 720C.  The driver ending in 01 is
  1099.                    |  for ISA bus machines.  The driver ending in 02 is for
  1100.                    |  MicroChannel machines.
  1101.                    |
  1102.   ICRMU01.SYS      |  IBM OS/2 Resource Map Utility. This device driver ships
  1103.   ICRMU02.SYS      |  on a diskette included with your workstation.  For
  1104.                    |  example the diskette is labeled 'IBM ThinkPad 720/720C
  1105.                    |  PCMCIA Device Driver Diskette' if you purchased either
  1106.                    |  the IBM ThinkPad 720 or 720C.  The driver ending in 01
  1107.                    |  is for ISA bus machines.  The driver ending in 02 is for
  1108.                    |  MicroChannel machines.
  1109.                    |
  1110.   DICRMU01.SYS     |  IBM DOS Resource Map Utility. This device driver ships
  1111.   DICRMU02.SYS     |  on a diskette included with your workstation.  For
  1112.                    |  example the diskette is labeled 'IBM ThinkPad 720/720C
  1113.                    |  PCMCIA Device Driver Diskette' if you purchased either
  1114.                    |  the IBM ThinkPad 720 or 720C.  The driver ending in 01
  1115.                    |  is for ISA bus machines.  The driver ending in 02 is for
  1116.                    |  MicroChannel machines.
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.                                                                    Contents  17
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.   1.8  OS/2 DEVICE DRIVER STATEMENT ORDER
  1138.   _______________________________________
  1139.  
  1140.   For  OS/2, the order of statements in your CONFIG.SYS is very important.  The
  1141.   order must be:
  1142.      DEVICE=C:\OS2\PCMCIA.SYS
  1143.                .
  1144.                .
  1145.      DEVICE=C:\IBMCOM\MACS\IBMTOKCS.OS2
  1146.                .
  1147.                .
  1148.      DEVICE=C:\IBM2SS02.SYS
  1149.      DEVICE=C:\ICRMU02.SYS
  1150.  
  1151.   The  installation  program  will examine your CONFIG.SYS and move Socket Ser-
  1152.   vices and the Resource Map Utility to the bottom of the file, if they are not
  1153.   there already.  They do not have to be the  last  statements  in  CONFIG.SYS,
  1154.   they  must be after every PCMCIA client driver you have installed; the bottom
  1155.   of CONFIG.SYS is the most logical place to ensure they are after every client
  1156.   driver.
  1157.  
  1158.   For a list of compatible notebook computers, dial 1-800-643-7409 (U.S.A. and
  1159.   Canada).
  1160.  
  1161.   Toshiba is a trademark of Toshiba America, Incorporated.
  1162.   Dell is a trademark of Dell Computer Corp, Incorporated.
  1163.   AST is a trademark of AST Research Incorporated.
  1164.   NCR is a trademark of the NCR Corporation.
  1165.   INTEL is a trademark of the INTEL Corporation.
  1166.   NEC is a trademark of the NEC Corporation.
  1167.   SystemSoft is a trademark of SystemSoft Corporation.
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.   18
  1195.