home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 29 Fixes_o / 29-Fixes_o.zip / us8210b4.dsk / IBMCOM / MACS / MACS.ZIP / ibmcom / macs / ibmtokcs.txt < prev    next >
Text File  |  1995-06-01  |  110KB  |  3,121 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  TOKENCS.COM   . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  19.     1.2.3  IBMTOKCS.OS2  . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  20.       1.2.3.1  Error Indications   . . . . . . . . . . . . . . . . . . . . .  5
  21.     1.2.4  TOKENCS.SYS   . . . . . . . . . . . . . . . . . . . . . . . . . .  6
  22.   1.3  Connectivity Enabler Software for DOS   . . . . . . . . . . . . . . .  7
  23.   1.4  Connectivity Enabler Parameters   . . . . . . . . . . . . . . . . . .  8
  24.     1.4.1  POINTTR.SYS syntax  . . . . . . . . . . . . . . . . . . . . . . .  8
  25.     1.4.2  TOKENRNG.SYS syntax   . . . . . . . . . . . . . . . . . . . . . .  9
  26.     1.4.3  TOSHTR.SYS syntax   . . . . . . . . . . . . . . . . . . . . . .   10
  27.     1.4.4  CS20TOK.SYS syntax  . . . . . . . . . . . . . . . . . . . . . .   11
  28.   1.5  Diagnostic Software   . . . . . . . . . . . . . . . . . . . . . . .   12
  29.   1.6  System Pitfalls   . . . . . . . . . . . . . . . . . . . . . . . . .   13
  30.     1.6.1  Super Client Drivers  . . . . . . . . . . . . . . . . . . . . .   13
  31.     1.6.2  OS/2 TCP/IP 1.2.1 Users   . . . . . . . . . . . . . . . . . . .   13
  32.     1.6.3  Memory Conflicts and Memory Managers  . . . . . . . . . . . . .   14
  33.     1.6.4  Miscellaneous   . . . . . . . . . . . . . . . . . . . . . . . .   25
  34.   1.7  Where to find Card Services and Socket Services   . . . . . . . . .   27
  35.   1.8  OS/2 Device Driver Statement Order  . . . . . . . . . . . . . . . .   27
  36.   1.9  Hot-Plugability and Suspend/Resume Issues   . . . . . . . . . . . .   28
  37.     1.9.1  DOS ODI Hot-Plugability and Suspend/Resume  . . . . . . . . . .   29
  38.     1.9.2  OS/2 NDIS Hot-Plugability and Suspend/Resume  . . . . . . . . .   29
  39.   1.10  Remote Program Load (RPL)  . . . . . . . . . . . . . . . . . . . .   30
  40.     1.10.1  Related Documentation  . . . . . . . . . . . . . . . . . . . .   30
  41.     1.10.2  Configuring OS/2 Lan Server 3.0 for RPL Support  . . . . . . .   30
  42.   1.11  Requesting Device Error/Status Messages  . . . . . . . . . . . . .   41
  43.     1.11.1  Requesting Device Message Descriptions   . . . . . . . . . . .   42
  44.  
  45.  
  46.   1.1  ABOUT THIS FILE
  47.   ____________________
  48.  
  49.   This file describes additional information on the IBM 16/4 Token Ring Credit
  50.   Card Adapter.  It also describes the Card Services-aware device drivers,
  51.   Connectivity Enabler Software and Diagnostic Software.
  52.  
  53.  
  54.  
  55.   1.2  CARD SERVICES-AWARE DEVICE DRIVERS
  56.   _______________________________________
  57.  
  58.   The device drivers on this diskette (IBMTOKCS.DOS, TOKENCS.COM, IBMTOKCS.OS2,
  59.   and TOKENCS.SYS) are Card Services Aware and can be used with Card Services
  60.   for configuration.  The DOS drivers (IBMTOKCS.DOS and TOKENCS.COM) can also
  61.   be used with Connectivity Enabler software if Card Services is unavailable.
  62.  
  63.  
  64.  
  65.  
  66.                                                                     Contents  1
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.   1.2.1  IBMTOKCS.DOS
  77.  
  78.   IBMTOKCS.DOS is the NDIS token-ring device driver for DOS; it is derived from
  79.   that for full-sized adapters (IBMTOK.DOS) but some new keywords have been
  80.   added for the PROTOCOL.INI file that is used to pass parameters to the
  81.   driver.  These keywords are active only if you are using Card Services.
  82.  
  83.   The new keywords are:
  84.  
  85.   o   MMIO
  86.  
  87.   o   RINGSPEED
  88.  
  89.   o   PROMPT
  90.  
  91.   o   INTERRUPT
  92.  
  93.   o   RAMSIZE
  94.  
  95.   o   PCMCIA
  96.  
  97.   MMIO allows the user to select where the Memory Mapped I/O / BIOS domain is
  98.   located.  The default value is D000 for primary adapters and DC00 for alter-
  99.   nate adapters.
  100.  
  101.   RINGSPEED allows the user to select the ring speed; the default is 4 Mbps.
  102.  
  103.   PROMPT allows the user to be prompted for the ring speed during boot-up.  The
  104.   default is to NOT prompt the user.
  105.  
  106.   INTERRUPT allows the user to select the interrupt used by the workstation for
  107.   this adapter. The default value is 2 (9).
  108.  
  109.   RAMSIZE allows the user to select the size of the Shared RAM that is seen by
  110.   the workstation. The default is 16K.
  111.  
  112.   PCMCIA is the keyword that tells the driver to look for Card Services before
  113.   looking for the adapter.
  114.  
  115.   Please refer to the IBMTOKCS.NIF file for valid values for these keywords.
  116.  
  117.   Below is a sample PROTOCOL.INI entry for this driver:
  118.  
  119.  
  120.   [IBMTOKCS_NIF]                   <-- This is the PROTOCOL.INI
  121.           DriverName = IBMTOK$         entry for the NDIS driver.
  122.           EARLYRELEASE
  123.           RAM = 0xD800             <-- this is the optional Shared Ram address
  124.           MMIO = 0xD000            <-- this is the optional MMIO address
  125.           RAMSIZE = 16             <-- this is the optional Shared RAM size
  126.           MAXTRANSMITS = 6
  127.           RECVBUFS = 2
  128.           RECVBUFSIZE = 256
  129.           XMITBUFS = 1
  130.  
  131.  
  132.   2
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.           XMITBUFSIZE = 2040
  143.           INTERRUPT = 9            <-- this is the requested IRQ level (optional)
  144.           RINGSPEED = 16           <-- set the ring speed here
  145.           PCMCIA                   <-- this tells the driver not to look for
  146.                                        standard cards and to use Card Services
  147.           PROMPT                   <-- put this in if you want to be prompted
  148.                                        for the ring speed
  149.  
  150.   Most of the parameters can be commented out by placing a ";" (semi-colon) in
  151.   front of the entry.  The default values are:
  152.  
  153.   RINGSPEED = 4          (4 Mbps)
  154.   INTERRUPT = 2(9)       <-- if these parameters are NOT specified, the
  155.   RAM = 0xD800           <-- driver searches for a valid address or available
  156.   MMIO = 0xD000          <-- interrupt value until one is found (Autoset
  157.                              mode) or until the valid values tried are exhausted.
  158.  
  159.  
  160.   1.2.1.1  Error Indications
  161.  
  162.   The  NDIS  driver signals the user when a Card Services call fails; the error
  163.   signal is an alternating beep. If you hear this sound, a problem is occurring
  164.   during configuration of the card and you must review  your  PROTOCOL.INI  and
  165.   CONFIG.SYS  to  verify that the parameters are correct.  It is vitally impor-
  166.   tant that memory areas requested are available.  Try commenting out  the  RAM
  167.   and  MMIO  keywords  and reboot. If this doesn't help, check for any programs
  168.   (e.g. EMM386.EXE) that may be conflicting with the memory requested.
  169.  
  170.  
  171.   1.2.2  TOKENCS.COM
  172.  
  173.   TOKENCS.COM is the DOS ODI token-ring driver for  Novell  environments.    It
  174.   uses  the  NET.CFG  to  get  specific  configuration  information and two new
  175.   keywords have been added for Card Services support:
  176.  
  177.   o   PCMCIA
  178.  
  179.   o   DATA RATE
  180.  
  181.   The PCMCIA keyword was added to tell the driver to use Card Services for con-
  182.   figuration. If you don't want to use card services, take out this keyword.
  183.  
  184.   The DATA RATE keyword is used to set the ring speed of the card; it  has  two
  185.   possible  values:  4  or  16.   If you don't use card services, take out this
  186.   keyword.
  187.  
  188.  
  189.   Here is a sample NET.CFG file for Card Services:
  190.  
  191.   Link Driver TOKEN
  192.      PCMCIA
  193.      DATA RATE 4
  194.  
  195.  
  196.  
  197.  
  198.                                                                     Contents  3
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.   You can specify the MMIO and Shared RAM addresses by using the MEM keyword in
  209.   NET.CFG; note that this keyword is not used in the same way as for full-sized
  210.   adapters (for which MEM #1 and #2 are used for the shared RAM address of  the
  211.   primary  and  alternate  adapters).   Note, however, that you can use the INT
  212.   option,  to  change  the interrupt level, in the same way as for a full-sized
  213.   adapter - INT #1 for the primary card (although INT alone is also valid).
  214.  
  215.   Here is a sample NET.CFG in which the MMIO and the Shared  RAM  memory  areas
  216.   and the interrupt level are set:
  217.  
  218.   Link Driver TOKEN
  219.      PCMCIA
  220.      DATA RATE 16
  221.      INT 5               <-- This sets the interrupt level to 5
  222.      MEM #1 D4000        <-- This sets the MMIO/ROM area to D4000.
  223.      MEM #2 CC000        <-- This sets the Shared RAM to CC000.
  224.  
  225.  
  226.  
  227.   1.2.3  IBMTOKCS.OS2
  228.  
  229.   IBMTOKCS.OS2 is the NDIS token-ring device driver for OS/2 2.1; it is derived
  230.   from  that  for  full-sized  adapters (IBMTOK.DOS) but some new keywords have
  231.   been added for the PROTOCOL.INI file that is used to pass parameters  to  the
  232.   driver.  These keywords are active only if you are using Card Services.
  233.  
  234.   The new keywords are:
  235.  
  236.   o   MMIO
  237.  
  238.   o   RINGSPEED
  239.  
  240.   o   INTERRUPT
  241.  
  242.   o   RAMSIZE
  243.  
  244.   o   PCMCIA
  245.  
  246.  
  247.   MMIO  allows  the user to select where the Memory Mapped I/O / BIOS domain is
  248.   located.  The default value is D000 for primary adapters and DC00 for  alter-
  249.   nate adapters.
  250.  
  251.   RINGSPEED allows the user to select the ring speed; the default is 4 Mbps.
  252.  
  253.   INTERRUPT allows the user to select the interrupt used by the workstation for
  254.   this adapter. The default value is 9.
  255.  
  256.   RAMSIZE  allows the user to select the size of the Shared RAM that is seen by
  257.   the workstation. The default is 16K.
  258.  
  259.   PCMCIA is the keyword that tells the driver to look for Card Services  before
  260.   looking for the adapter.
  261.  
  262.  
  263.  
  264.   4
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.   Please refer to the IBMTOKCS.NIF file for valid values for these keywords.
  275.  
  276.   Below is a sample PROTOCOL.INI entry for this driver:
  277.  
  278.   [IBMTOKCS_nif]                   <-- This is the PROTOCOL.INI
  279.           DriverName = IBMTOK$         entry for the NDIS driver.
  280.           PRIMARY
  281.           RAM = 0xD800             <-- this is the optional Shared Ram address
  282.           MMIO = 0xD000            <-- this is the optional MMIO address
  283.           RAMSIZE = 16             <-- this is the optional Shared RAM size
  284.           MAXTRANSMITS = 6
  285.           RECVBUFS = 2
  286.           RECVBUFSIZE = 256
  287.           XMITBUFS = 1
  288.           INTERRUPT = 9            <-- this is the requested IRQ level (optional)
  289.           RINGSPEED = 16           <-- set the ring speed here
  290.           PCMCIA                   <-- this tells the driver not to look for
  291.                                        standard cards and to use Card Services
  292.  
  293.   Most of the parameters can be commented out by placing a ";" (semi-colon) in
  294.   front of the entry.  The default values are:
  295.  
  296.   RINGSPEED = 4          (4 Mbps)
  297.   INTERRUPT = 9          <-- if these parameters are NOT specified, the
  298.   RAM = 0xD800           <-- driver searches for a valid address or available
  299.   MMIO = 0xD000          <-- interrupt value until one is found (Autoset
  300.                              mode) or the valid values tried are exhausted.
  301.  
  302.  
  303.   1.2.3.1  Error Indications
  304.  
  305.   The  NDIS  driver signals the user when a Card Services call fails; the error
  306.   signal is an alternating beep. If you hear this sound, a problem is occurring
  307.   during configuration of the card and you must review the LANTRAN.LOG file  in
  308.   your  \IBMCOM  sub  directory  to determine what is wrong.   Depending on the
  309.   error, you may see one or more of the following statements:
  310.  
  311.       LTG0091E: Card Services could not be found.
  312.       LTG0093E: No sockets were found by Card Services.
  313.       LTG0083E: Token-Ring Credit Card RequestIO failed. Return code xx.
  314.       LTG0084E: Token-Ring Credit Card RequestIRQ failed. Return code xx.
  315.       LTG0085E: Token-Ring Credit Card RequestWindow failed. Return code xx.
  316.       LTG0086E: Token-Ring Credit Card RequestConfiguration failed. Return code
  317.       xx.
  318.       LTG0090E: Token-Ring Credit Card RegisterClient failed. Return code xx.
  319.  
  320.   You should review your CONFIG.SYS to verify that the statements  are  in  the
  321.   correct  order  (especially  that  the  IBM  Socket Services and Resource Map
  322.   Utility statements come later than those for all the client drivers, such  as
  323.   IBMTOKCS.OS2)  and  you  should  check the parameters in PROTOCOL.INI.  It is
  324.   vitally important that resources  requested  (interrupt,  memory  areas)  are
  325.   available.
  326.  
  327.   Below are suggested actions to help resolve these error conditions:
  328.  
  329.  
  330.                                                                     Contents  5
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.   o   LTG0091E: Card Services could not be found.
  341.  
  342.       The  statement DEVICE=x:\OS2\PCMCIA.SYS is missing from CONFIG.SYS.  Make
  343.       sure that the device driver is present on your hard drive and  that  this
  344.       statement is in your CONFIG.SYS.
  345.  
  346.   o   LTG0093E: No sockets were found by Card Services.
  347.  
  348.       Your workstation has no sockets, the socket-services device driver is not
  349.       installed, or the socket-services device driver is incorrectly installed.
  350.       Make  sure  that  the  socket-services device driver comes later than the
  351.       token-ring driver (IBMTOKCS.OS2) in CONFIG.SYS and can be found  on  your
  352.       hard drive.
  353.  
  354.   o   LTG0083E: Token-Ring Credit Card RequestIO failed.  Return code xx.
  355.  
  356.       Another  adapter  is  using either ports A20-A23 for a PRIMARY adapter or
  357.       ports A24-A27 for an ALTERNATE adapter.  Either remove the other  adapter
  358.       or change this adapter from PRIMARY to ALTERNATE.
  359.  
  360.   o   LTG0084E: Token-Ring Credit Card RequestIRQ failed.  Return code xx.
  361.  
  362.       The  interrupt  you requested is being used by another adapter.  Try com-
  363.       menting out the INTERRUPT= statement or change the value used.
  364.  
  365.   o   LTG0085E: Token-Ring Credit Card RequestWindow failed.  Return code xx.
  366.  
  367.       The MMIO or RAM memory window requested could not be acquired.  Try  com-
  368.       menting out these statements or changing their values.
  369.  
  370.   o   LTG0086E:  Token-Ring  Credit  Card RequestConfiguration failed.   Return
  371.       code xx.
  372.  
  373.       The  card  could  not  be  configured  with  the  IO/IRQ/Memory   Windows
  374.       requested.  Try using different values.
  375.  
  376.   o   LTG0090E: Token-Ring Credit Card RegisterClient failed.  Return code xx.
  377.  
  378.       The  device  driver could not register with Card Services.  Make sure you
  379.       have Card Services 2.0 (PCMCIA.SYS) properly installed.
  380.  
  381.  
  382.   1.2.4  TOKENCS.SYS
  383.  
  384.   TOKENCS.SYS is the OS/2 ODI token-ring driver  for  Novell  environments;  it
  385.   uses  the NET.CFG to get specific configuration information.  One new keyword
  386.   has been added for Card Services support.
  387.  
  388.   The new keyword is:
  389.  
  390.   o   DATA RATE
  391.  
  392.   This keyword is used to set the ring speed of the card; it has  two  possible
  393.   values: 4 or 16.
  394.  
  395.  
  396.   6
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.   You can specify the MMIO and Shared RAM addresses by using the MEM keyword in
  409.   NET.CFG; note that this keyword is not used in the same way as for full-sized
  410.   adapters  (for which MEM #1 and #2 are used for the shared RAM address of the
  411.   primary and alternate adapters).  Note, however, that you  can  use  the  INT
  412.   option,  to  change  the interrupt level, in the same way as for a full-sized
  413.   adapter - INT #1 for the primary card (although INT alone is also valid).
  414.  
  415.   Here is a sample NET.CFG in which the MMIO and the Shared  RAM  memory  areas
  416.   and the interrupt level are set:
  417.  
  418.   Link Driver TOKEN
  419.      PCMCIA
  420.      DATA RATE 16
  421.      INT 5               <-- This sets the interrupt level to 5
  422.      MEM #1 D4000        <-- This sets the MMIO/ROM area to D4000.
  423.      MEM #2 CC000        <-- This sets the Shared RAM to CC000.
  424.  
  425.   You  must  specify  the  card's  Universally  Administered Address (UAA) or a
  426.   Locally Administered Address (LAA) in the Netaddress field; the  installation
  427.   program  will  fill  in  a default value that you should change.  To find out
  428.   your adapter's UAA, you should boot this diskette  and  run  the  Diagnostics
  429.   program.
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  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.   Connectivity  Enablers  can  be  used  instead  of card-services-aware device
  476.   drivers to configure the PCMCIA socket  hardware  and  the  Card.    Once  an
  477.   Enabler  has  run successfully, the Card behaves like a full-sized shared RAM
  478.   adapter.
  479.  
  480.   Four Enablers are provided (they are described fully below):
  481.  
  482.   o   POINTTR.SYS
  483.  
  484.   o   TOKENRNG.SYS
  485.  
  486.   o   TOSHTR.SYS
  487.  
  488.   o   CS20TOK.SYS
  489.  
  490.   The purpose of the Enablers (with the exception of CS20TOK.SYS,  which  needs
  491.   the card-services interface), is to enable the Card to be used when Card Ser-
  492.   vices is not available or is incompatible with some software or hardware that
  493.   you want to use.
  494.  
  495.   Please  note that, if you want to use POINTTR.SYS or TOSHTR.SYS, you MUST NOT
  496.   load Socket and Card Services.   For TOKENRNG.SYS, you  must  load  a  device
  497.   driver  that  provides Socket Services 1.01, which is supplied with some com-
  498.   puters.
  499.  
  500.   The Enablers must be loaded as CONFIG.SYS device drivers BEFORE any  adapter-
  501.   support device drivers (such as the IBM LAN Support Program) and, in the case
  502.   of CS20TOK.SYS, AFTER the Socket and Card Services device drivers.
  503.  
  504.   With  the  exception  of  CS20TOK.SYS, which remains in memory to handle card
  505.   insertions and removals, the Enablers remove themselves from memory.
  506.  
  507.   Although they are  card-services  aware,  the  NDIS  (IBMTOKCS.DOS)  and  ODI
  508.   (TOKENCS.COM)  device  drivers can be used with the Enablers (with the excep-
  509.   tion of CS20TOK.SYS, which requires the  LAN  Support  Program/Native  inter-
  510.   face).
  511.  
  512.   For  the  card  to  function properly in systems without Card Services, it is
  513.   essential that the correct enabler be used and that enabler and the  adapter-
  514.   support  software  agree on two parameters - the IRQ level and the Shared RAM
  515.   address.
  516.  
  517.   IRQ (interrupt) Level.  The default value, 2 (redirected to 9) works for  all
  518.   current software.  Please note that device drivers that are not card-services
  519.   aware - such as DXMC0MOD.SYS - can use only the default IRQ value, 2; this is
  520.   because such software will always determine that the card is using IRQ 2.
  521.  
  522.   Shared  RAM  Address.   The adapter-support software defines where the shared
  523.   RAM will reside in the computer's memory; this is not done  by  the  enabler.
  524.   However,  the  Shared  RAM address set by the enabler must nevertheless match
  525.   the memory location defined by the adapter-support software; if it does  not,
  526.   communication will not be successful.
  527.  
  528.  
  529.   8
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.   Here is a description of the connectivity enablers:
  540.  
  541.   POINTTR.SYS  is  an enabler that communicates directly with Intel 82365SL (or
  542.   equivalent) hardware; this is a  PCMCIA  socket  controller  common  to  many
  543.   systems.    It  should  be used when Card and Socket services do not exist on
  544.   your computer or when the versions that you  have  do  communicate  correctly
  545.   with CS20TOK.SYS or the relevant card-services-aware driver.
  546.  
  547.   TOKENRNG.SYS  is  an  enabler  that  uses the Socket Services 1.01 interface,
  548.   which is provided with some computers to configure the socket and card.    It
  549.   is used on computers with DATABOOK PCMCIA controllers that support the Socket
  550.   Services 1.01 interface and not Card Services.
  551.  
  552.   TOSHTR.SYS is an enabler that is used with the Toshiba T3300SL computer.
  553.  
  554.   CS20TOK.SYS  is  an  enabler  that  uses the Card Services 2.X interface.  It
  555.   should be used when the Token-ring device driver that you want  to  use  does
  556.   not  itself  interface  with  card services; one such driver is DXMC0MOD.SYS,
  557.   part of the IBM LAN Support Program.
  558.  
  559.  
  560.   1.4  CONNECTIVITY ENABLER PARAMETERS
  561.   ____________________________________
  562.  
  563.   Each enabler has parameters that allow it to be customized  to  the  adapter-
  564.   support  software;  the  parameters  allow you to choose such things as which
  565.   socket and memory areas are to be used and the  ring  speed  required.    The
  566.   default  parameters  will  probably  be satisfactory but, if you use a memory
  567.   manager, you may want to optimize the use of memory by moving the MMIO and/or
  568.   Shared RAM addresses.
  569.  
  570.  
  571.  
  572.   1.4.1  POINTTR.SYS SYNTAX
  573.  
  574.   Complete Syntax (- and defaults):
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.                                                                     Contents  9
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.     DEVICE=\path\POINTTR.SYS [SA/SB/SC/SD] [RS=16/RS=4] [PROMPT] [MMIO=XXXX]
  607.                              [PRI/ALT] [IRQ=X] [SRAM=XXXX,Y[Y]]
  608.                              [WS=0,1,2,3,4] [DS=16/DS=8] [PCIC=XXXX]
  609.  
  610.     SA/SB/SC/SD - Socket A, Socket B, Socket C, or Socket D           - A
  611.     RS          - Ring Speed (16 or 4 MBPS)                           - 4
  612.     PROMPT      - Prompt for ring speed selection at boot time        - No prompt
  613.     MMIO        - Memory Mapped IO Address                            - D000
  614.     PRI/ALT     - Primary/ Alternate adapter                          - PRI
  615.     IRQ         - Interrupt Level (PCMCIA controller interrupt)       - 9 (2)
  616.     SRAM        - Shared Ram address [XXXX] and size [Y[Y]] in kbytes - D800,16
  617.     WS          - Wait state selection                                - 1
  618.     DS          - Data size (16 or 8 bit bus)                         - 16
  619.     PCIC        - PC Card Interface Controller base I/O port          - 03E0
  620.     Note: X is a hexadecimal number
  621.           Y is a decimal number
  622.  
  623.     Here is an example:
  624.  
  625.     DEVICE=C:\LAN\POINTTR.SYS SB RS=16 MMIO=D000 SRAM=D800,16 WS=0
  626.  
  627.   This  would  configure  the  card for socket B, a ring speed of 16 Mbps, MMIO
  628.   address at the D000 segment, Shared RAM at the D800  segment  and  using  16K
  629.   bytes of PC memory and no wait states.
  630.  
  631.   NOTE: For the IBM ThinkPad 750, you must specify WS=0.
  632.  
  633.   The  PCIC  parameter  has  been added to support the Port Replicator Model I,
  634.   that attaches to the IBM ThinkPad 750 notebook computer, and any other  Intel
  635.   82365SL-based  device  that  does  not use 3E0 as its base I/O port. The Port
  636.   Replicator uses 3E2 as its I/O port base address.
  637.  
  638.   Here is a sample invocation on a machine using the Port Replicator.
  639.   sample:
  640.  
  641.     DEVICE=C:\LAN\POINTTR.SYS RS=16 PCIC=03E2
  642.  
  643.  
  644.   1.4.2  TOKENRNG.SYS SYNTAX
  645.  
  646.   Complete Syntax (- and defaults):
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.   10
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.     DEVICE=\path\TOKENRNG.SYS [SA/SB] [RS=16/RS=4] [PROMPT] [MMIO=XXXX]
  673.                               [PRI/ALT] [IRQ=X] [SRAM=XXXX,Y[Y]] [DS=16/DS=8]
  674.  
  675.     SA/SB    Socket A or Socket B                                - A
  676.     RS       Ring Speed (16 or 4 MBPS)                           - 4
  677.     PROMPT   Prompt for ring speed selection at boot time        - No prompt
  678.     MMIO     Memory Mapped I/O Address                           - D000
  679.     PRI/ALT  Primary/ Alternate adapter                          - PRI
  680.     IRQ      Interrupt Level (PCMCIA controller interrupt)       - 9 (2)
  681.     SRAM     Shared Ram address [XXXX] and size [Y[Y]] in kbytes - D800,16
  682.     DS       Data size (16 or 8 bit bus)                         - 16
  683.  
  684.     Note: X is a hexadecimal number
  685.           Y is a decimal number
  686.           Memory Mapped I/O and Shared RAM addresses are valid between
  687.           C000 and DE00.
  688.  
  689.   Here is an example:
  690.  
  691.     DEVICE=C:\LAN\TOKENRNG.SYS SA RS=16 MMIO=CC00 SRAM=D800,16
  692.  
  693.   This  would  configure  the  card for socket A, a ring speed of 16 Mbps, MMIO
  694.   address at the CC00 segment, and Shared RAM at the  D800  segment  using  16K
  695.   bytes of PC memory.
  696.  
  697.  
  698.  
  699.   1.4.3  TOSHTR.SYS SYNTAX
  700.  
  701.   Complete Syntax (- and defaults):
  702.  
  703.     DEVICE=\path\TOSHTR.SYS [RS=16/RS=4] [PROMPT] [MMIO=XXXX]
  704.                             [PRI/ALT] [SRAM=XXXX,Y[Y]]
  705.  
  706.     RS      - Ring Speed (16 or 4 MBPS)                           - 4
  707.     PROMPT  - Prompt for ring speed selection at boot time        - No prompt
  708.     MMIO    - Memory Mapped Address                               - D000
  709.     PRI/ALT - Primary/ Alternate adapter                          - PRI
  710.     SRAM    - Shared Ram address [XXXX] and size [Y[Y]] in kbytes - D000,16
  711.  
  712.     Note: X is a hexadecimal number
  713.           Y is a decimal number
  714.           Memory Mapped I/O and Shared RAM addresses are valid between
  715.           C000 and DE00.
  716.  
  717.     Here is an example:
  718.  
  719.     DEVICE=C:\LAN\TOSHTR.SYS PROMPT MMIO=D000 SRAM=D800,16
  720.  
  721.   This would configure the card for
  722.   a ring speed of 4 Mbps, MMIO address at the D000 segment, Shared RAM
  723.   at the D800 segment using 16K bytes of PC memory.  During CONFIG.SYS
  724.   processing, the user would be prompted to either accept the default
  725.   4 Mbps ring speed or change it to 16 Mbps.
  726.  
  727.  
  728.                                                                    Contents  11
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.   1.4.4  CS20TOK.SYS SYNTAX
  739.  
  740.   Complete Syntax (- and defaults:
  741.  
  742.     DEVICE=\path\CS20TOK.SYS [RS=16/RS=4] [PROMPT] [MMIO=XXXX]
  743.                              [PRI/ALT] [IRQ=X] [SRAM=XXXX,Y[Y]] [DS=16/DS=8]
  744.  
  745.     RS       Ring Speed (16 or 4 MBPS)                           - 4
  746.     PROMPT   Prompt for ring speed selection at boot time        - No prompt
  747.     MMIO     Memory Mapped I/O Address                           - D000
  748.     PRI/ALT  Primary/ Alternate adapter                          - PRI
  749.     IRQ      Interrupt Level (PCMCIA controller interrupt)       - 9 (2)
  750.     SRAM     Shared Ram address [XXXX] and size [Y[Y]] in kbytes - D800,16
  751.     DS       Data size (16 or 8 bit bus)                         - 16
  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.     Here is an example:
  759.  
  760.     DEVICE=C:\LAN\CS20TOK.SYS RS=16 MMIO=CC00 SRAM=D800,16
  761.  
  762.   This would configure the card for a ring speed of 16
  763.   Mbps, MMIO address at the CC00 segment, and Shared RAM at the D800 segment
  764.   using 16K bytes of PC memory.
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.   12
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.   1.5  DIAGNOSTIC SOFTWARE
  805.   ________________________
  806.  
  807.   The diagnostic software is used to determine if a properly installed IBM
  808.   16/4 Token-Ring Credit Card is performing correctly.  It is not used to
  809.   determine problems with the configuration.
  810.  
  811.   A special enabler is executed when the diagnostics are run.  This enabler
  812.   opens up more of the workstation memory so that the diagnostics can run more
  813.   tests; it has the same defaults, except for memory size, as an enabler such
  814.   as POINTTR.SYS.  If you change the socket or ring speed from the defaults, be
  815.   sure to add those same parameters to the enabler line in TRCCTEST.BAT
  816.   (the enabler is the first file to be run).
  817.  
  818.  
  819.   For DOS,
  820.   TRCCTEST checks to see if Card Services, Socket Services, or enablers are
  821.   present in the system.  If none of these is present, you will be asked
  822.   if you would like to run the installation program, because your computer must be
  823.   configured to run with the Card before you can use the
  824.   diagnostics.
  825.  
  826.   If your computer is running OS/2, TRCCTEST will not work; you must boot the
  827.   computer from this diskette (which includes DOS boot files).  You will be asked
  828.   for your machine type and the socket in which the Card is installed.
  829.  
  830.   One of the options is to run the Ring Diagnostic, which tests the ring itself
  831.   and your connection to it.  This program needs ANSI.SYS in order to
  832.   display its output properly.  Since ANSI.SYS must be loaded from CONFIG.SYS and,
  833.   in most cases, will not normally be loaded, you will have to edit CONFIG.SYS and
  834.   reboot if you want to run the Ring Diagnostic.  However, you will find it easier
  835.   just
  836.   to boot the PC from this diskette - the code to format the output will then be
  837.   loaded automatically.  Please note that ANSI.SYS is not necessary for the Card
  838.   Diagnostic.
  839.  
  840.  
  841.  
  842.   It is best not to load your adapter support software when running
  843.   diagnostics because this can interfere with the operation of the diagnostic
  844.   software.
  845.  
  846.  
  847.   After using the diagnostics, turn off the system power, remove the
  848.   diskette and then turn on the system power.
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.                                                                    Contents  13
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.   1.6  SYSTEM PITFALLS
  872.   ____________________
  873.  
  874.   Some of the new systems that support PCMCIA 2.0 I/O cards have features that
  875.   the user must be aware of when using the IBM 16/4 Token-Ring Credit Card:
  876.  
  877.   For the PCMCIA socket to receive power, many computers must have the power to
  878.   the socket enabled; this is often done with a setup utility that
  879.   comes with the computer.
  880.  
  881.   If you are using Card and Socket Services, make sure that your PCMCIA socket
  882.   is enabled.  If it is not, Socket Services will not
  883.   load and will not display an error message;  IBM Card Services will not load,
  884.   but will display an error message that Socket Services is not present.
  885.  
  886.  
  887.   1.6.1  SUPER CLIENT DRIVERS
  888.  
  889.   Many vendors are providing customers with Super Client Drivers; these are
  890.   drivers that will enable many different PCMCIA cards.
  891.   PC-DOS 6.1 includes one called PCMSCD.EXE, for example.
  892.   They are best used for modems and other cards that do not have a card-
  893.   services client driver of their own. If you use a super client driver,
  894.   try to disable support for the token ring credit card and use our client
  895.   driver. Our drivers have been written to take advantage of card services
  896.   and this advantage is taken away when a super client driver is used.
  897.   Look at the documentation for your super client driver to find out whether
  898.   you can disable token-ring support.
  899.  
  900.  
  901.   1.6.2  OS/2 TCP/IP 1.2.1 USERS
  902.  
  903.   If you are using the TCP/IP LAN Adapter and Protocol Support,
  904.   TCPLAPS V1.0 for OS/2 TCP/IP, you must not use the Install
  905.   option of LAPS to install the Token-Ring Credit Card driver:
  906.   it will fail to copy the driver files from the
  907.   diskette.  You must first install LAPS, then copy the following
  908.   files:
  909.  
  910.          COPY A:IBMTOKCS.NIF C:\IBMCOM\MACS
  911.          COPY A:IBMTOKCS.OS2 C:\IBMCOM\MACS
  912.          COPY A:LTG.MSG C:\IBMCOM
  913.          COPY A:LTGH.MSG C:\IBMCOM
  914.  
  915.   After copying the files, re-enter LAPS and use the Configure option.
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.   14
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.   1.6.3  MEMORY CONFLICTS AND MEMORY MANAGERS
  939.  
  940.   USING A MEMORY MANAGER WITH YOUR CREDIT CARD ADAPTER
  941.  
  942.   If  your computer comes with a memory manager (preinstalled), or if you would
  943.   like to use one, you must configure your computer so the memory manager  does
  944.   not  use the same memory as your card.  If you do not configure your computer
  945.   properly, there will be memory conflicts, and your card will not operate.  To
  946.   prevent memory conflicts, there are some guidelines you must follow.   It  is
  947.   not  possible  to describe here the requirements for all cards and all memory
  948.   managers  but  these  guidelines  should help you to make the necessary deci-
  949.   sions.  This information is also included in the READ.ME.
  950.  
  951.   The following 4 sections address the use of a memory manager  with  different
  952.   machine configurations.  Please read the section appropriate for your config-
  953.   uration.
  954.  
  955.   Section 1:  a Point Connectivity Enabler with a memory manager
  956.               (If you do not install Card and Socket Services on your
  957.               DOS computer, the installation program will install a
  958.               point connectivity enabler for you.)
  959.  
  960.   Section 2:  IBM Card and Socket Services with a memory manager
  961.               (ThinkPad 720 and ThinkPad 750)
  962.  
  963.   Section 3:  Phoenix Card and Socket Services with a memory manager
  964.               (ThinkPad 350 and PC DOS 6.1)
  965.  
  966.   Section 4:  Using Expanded Memory (EMS)
  967.               It is recommended you read the appropriate section above
  968.               (section 1, 2, or 3) before reading this section.
  969.  
  970.   Note: Throughout these 4 sections, you will see a given memory address
  971.         specified different ways.  For example, you will see the same
  972.         address, D8000, specified as D8000, D800, or D8. It is important
  973.         for you to realize these are all the same.  It's just that,
  974.         depending on the option used, it may have to be specified a
  975.         certain way.
  976.  
  977.   --------------------------------------------------------------------- Section
  978.   1:    a    Point    Connectivity    Enabler    with    a    memory    manager
  979.   ---------------------------------------------------------------------
  980.  
  981.   1. If you have a DOS machine without Card and Socket Services
  982.      installed, the installation program will install a point
  983.      connectivity enabler for you.  On DOS machines, you have the option
  984.      of using either the point connectivity enabler OR Card and Socket
  985.      Services with your token-ring card.  Please see the installation
  986.      guide for more information on these two options.
  987.  
  988.   2. Your card requires memory in order to operate.  You must configure
  989.      your computer so a memory manager and/or other PC cards do not use
  990.      the same memory range(s) as your card, otherwise, your card will
  991.      not operate.
  992.  
  993.  
  994.                                                                    Contents  15
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.      To prevent the memory manager from using the same memory as your
  1006.      card, you must exclude the memory range(s) being used by your card
  1007.      for Memory Mapped I/O (MMIO) and Shared RAM (SRAM).
  1008.      Important:  For computers with multiple PC cards, you must exclude
  1009.                  the memory ranges being used by all of them.
  1010.  
  1011.      To prevent other PC cards from using the same memory, the memory
  1012.      ranges of all cards in use in your machine cannot conflict
  1013.      (overlap) with one another.
  1014.  
  1015.   3. To add the required excludes on your memory manager line, you must
  1016.      edit your CONFIG.SYS file after completing the installation.
  1017.  
  1018.      A. If you use the default values for the card, the following
  1019.         exclusions are required on the memory manager line:
  1020.         D000-D1FF for 8KB MMIO range (MMIO base address default of D000)
  1021.         D800-DBFF for 16KB SRAM range (SRAM base address default of D800)
  1022.  
  1023.         The required exclusions are shown in the example below (using
  1024.         EMM386, this is done using the "X=" parameter):
  1025.  
  1026.         DEVICE=C:\POINTTR.SYS SA RS=4 MMIO=D000 IRQ=9 SRAM=D800,16 WS=0
  1027.                     :
  1028.         DEVICE=C:\DOS\HIMEM.SYS
  1029.                     :
  1030.         DEVICE=C:\DOS\EMM386.EXE 1024 RAM X=D000-D1FF X=D800-DBFF
  1031.  
  1032.      B. If you do not use the default values, but instead specify the
  1033.         base addresses of the memory you want your card to use (this
  1034.         capability is provided on a screen during the installation),
  1035.         you must exclude the memory ranges that start at the base
  1036.         addresses that you specified.  Please see the table below.
  1037.  
  1038.         Important: When specifying the base addresses, you must make
  1039.         certain that the MMIO and SRAM memory ranges being used by your
  1040.         card do not conflict (overlap) with memory that is being used by
  1041.         any other cards in your computer.  Also, the MMIO and SRAM base
  1042.         addresses cannot be the same.
  1043.  
  1044.         MEMORY RANGES TO EXCLUDE ON THE MEMORY MANAGER LINE
  1045.         (for EMM386, use the "X=" option)
  1046.  
  1047.         If                    If SRAM, exclude     If MMIO, exclude
  1048.         Shared RAM or         the following        the following
  1049.         Memory Mapped I/O     range                range
  1050.         Base Address is...    (16KB size)          (8KB size)
  1051.         ------------------    -----------          ----------------
  1052.  
  1053.         C0000                  C000-C3FF            C000-C1FF
  1054.         C4000                  C400-C7FF            C400-C5FF
  1055.         C8000                  C800-CBFF            C800-C9FF
  1056.         CC000                  CC00-CFFF            CC00-CDFF
  1057.         D0000                  D000-D3FF            D000-D1FF
  1058.  
  1059.  
  1060.   16
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.         D4000                  D400-D7FF            D400-D5FF
  1071.         D8000                  D800-DBFF            D800-D9FF
  1072.         DC000                  DC00-DFFF            DC00-DDFF
  1073.  
  1074.   ----------------------------------------------------------------------
  1075.   Section   2:      IBM   Card  and  Socket  Services  with  a  memory  manager
  1076.   ----------------------------------------------------------------------
  1077.  
  1078.   1. You must use the /MA option.  The /MA option gives the memory range
  1079.      which IBM Card Services (IBM CS) can use for its own purposes and
  1080.      from which it allocates portions, as required, to the PC cards
  1081.      installed in your computer.  You must specify the /MA range on the
  1082.      Resource Map Utility (RMU) line by editing the CONFIG.SYS file
  1083.      after completing the installation.
  1084.  
  1085.   2. To prevent memory conflicts between IBM CS and the memory manager,
  1086.      you must EXCLUDE the entire range specified by the /MA option from
  1087.      the memory manager.  This is done by adding the required excludes
  1088.      on your memory manager line in your CONFIG.SYS file after
  1089.      completing the installation.
  1090.  
  1091.   There are several things you must know when using the /MA option:
  1092.  
  1093.   1. The /MA option should be placed on the following line in the
  1094.      CONFIG.SYS file:
  1095.      For the IBM ThinkPad 720, "DEVICE=C:\DICRMU02.SYS"
  1096.      For the IBM ThinkPad 750, "DEVICEhigh=C:\THINKPAD\DICRMU01.SYS"
  1097.      (The ThinkPad 750 comes preinstalled with a /MA option range.
  1098.       Given what you read here and the requirements for your PC cards,
  1099.       you may decide to change it.)
  1100.  
  1101.   2. For the IBM ThinkPads, the /MA range you specify must be within
  1102.      the range C000-DFFF.
  1103.  
  1104.   3. The memory used by ALL your PC cards must be WITHIN the range
  1105.      specified by the /MA option.  Also, the memory ranges of the
  1106.      cards in use in your machine must not conflict (overlap) with
  1107.      one another.
  1108.  
  1109.      A. The default autoset mode for Memory Mapped I/O (MMIO) and
  1110.         Shared RAM (SRAM) base addresses will automatically find memory
  1111.         for your token-ring card within the /MA range.  In addition,
  1112.         provided you load the token-ring (ODI or NDIS) driver AFTER you
  1113.         load all other PC card drivers (in the CONFIG.SYS), autoset will
  1114.         prevent conflicts between your token-ring card memory and the
  1115.         other PC cards' memory.  One limitation of autoset is that you
  1116.         will not know the MMIO and SRAM range your card is using.
  1117.  
  1118.      B. Or...you can specify the base address for the MMIO and SRAM
  1119.         memory range (this capability is provided on a screen during
  1120.         installation).  You must specify the base addresses so that the
  1121.         MMIO and SRAM memory ranges are WITHIN the range specified by
  1122.         the /MA option.
  1123.         (The IBM LSP/NATIVE mode environment requires you to specify
  1124.  
  1125.  
  1126.                                                                    Contents  17
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.         the memory addresses.)
  1137.  
  1138.   4. The memory size specified by the /MA range must be equal to or
  1139.      greater than the memory required by all PC cards in use in your
  1140.      machine PLUS 4KB which is required by IBM CS for its own purposes.
  1141.      (This 4KB should only be added once regardless of the number of
  1142.      cards in your computer.  You do NOT need to add 4KB for IBM CS
  1143.      for each card.)
  1144.  
  1145.      Your token-ring card requires 24KB (using default 8KB MMIO and
  1146.      16KB SRAM).  IBM CS will take the first 4KB block it finds that
  1147.      is available and within the /MA range.
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  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.   18
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.   Some example /MA, MMIO, and SRAM ranges:  (You may choose other ranges to fit
  1203.   your requirements.  In all
  1204.    examples, the token-ring card MMIO and SRAM base addresses were
  1205.    specified to the first address shown in their respective columns.)
  1206.  
  1207.    --------------------------------------------------------------------
  1208.   | /MA range on | /MA  | Token-ring| Token-ring| Memory range | Size  |
  1209.   | RMU line in  | range| card      | card      | available for| of    |
  1210.   | CONFIG.SYS   | size | SRAM range| MMIO range| other cards  | avail |
  1211.   |              | in   | (16KB)    | (8KB)     | and IBM CS's | memory|
  1212.   | This range   | KB   |           |           | 4KB          | for   |
  1213.   | must also be |      | Must be   | Must be   |              | other |
  1214.   | excluded on  |      | specified | specified |(IBM CS will  | cards |
  1215.   | memory       |      | within    | within    |take whatever | in KB |
  1216.   | manager line |      | /MA range | /MA range |4KB block it  |       |
  1217.   | in CONFIG.SYS|      | (during   | (during   |finds that is |*See   |
  1218.   |              |      | installa- | installa- |available in  | note 1|
  1219.   |              |      | tion)     | tion)     |this range)   | below |
  1220.   |--------------+------+-----------+-----------+--------------+-------|
  1221.   |  Best use of memory (SRAM and MMIO range are contiguous and at     |
  1222.   |  lower boundary of C000):                                          |
  1223.   |              |      |           |           |              |       |
  1224.   |  C000-CFFF   | 64KB | C000-C3FF | C400-C5FF | C600-CFFF    | 36KB  |
  1225.   |--------------+------+-----------+-----------+--------------+-------|
  1226.   |  If another PC card requires C000-C3FF:                            |
  1227.   |              |      |           |           |              |       |
  1228.   |  C000-CFFF   | 64KB | C400-C7FF | C800-C9FF | C000-C3FF &  | 36KB  |
  1229.   |              |      |           |           | CA00-CFFF    |       |
  1230.   |--------------+------+-----------+-----------+--------------+-------|
  1231.   |  Using ThinkPad 750 /MA default:                                   |
  1232.   |              |      |           |           |              |       |
  1233.   |  C800-CFFF   | 32KB | C800-CBFF | CC00-CDFF | CE00-CFFF    |  4KB  |
  1234.   |--------------+------+-----------+-----------+--------------+-------|
  1235.   |  Using autoset mode (Autoset described in 3A above; to prevent     |
  1236.   |      memory conflicts, you must load your token-ring driver after  |
  1237.   |      you load all other PC card drivers; your card will take 24KB  |
  1238.   |      and IBM CS will take 4KB somewhere in the C000-CBFF range     |
  1239.   |      leaving 20KB for other cards in this range):                  |
  1240.   |              |      |           |           |              |       |
  1241.   |  C000-CBFF   | 48KB | autoset   | autoset   | C000-CBFF    | 20KB  |
  1242.   |--------------+------+-----------+-----------+--------------+-------|
  1243.   |  28KB is minimum /MA range size that can be used:                  |
  1244.   |              |      |           |           |              |       |
  1245.   |  C000-C6FF   | 28KB | C000-C3FF | C400-C5FF | C600-C6FF    |  0KB  |
  1246.   |              |      |           |           |used by IBM CS|       |
  1247.   |--------------+------+-----------+-----------+--------------+-------|
  1248.   |  Using SRAM and MMIO default values for LSP/Native environment:    |
  1249.   |              |      |           |           |              |       |
  1250.   |  D000-DBFF   | 48KB | D800-DBFF | D000-D1FF |  D200-D7FF   | 20KB  |
  1251.   |--------------+------+-----------+-----------+--------------+-------|
  1252.   |  Another example in the D-Block range:                             |
  1253.   |              |      |           |           |              |       |
  1254.   |  D000-DFFF   | 64KB | D000-D3FF | D400-D5FF |  D600-DFFF   | 36KB  |
  1255.   |--------------+------+-----------+-----------+--------------+-------|
  1256.  
  1257.  
  1258.                                                                    Contents  19
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.   |  Allocating more memory for PC cards (Expanded memory, EMS, NOT    |
  1269.   |      required and cannot be used in this example):                 |
  1270.   |              |      |           |           |              |       |
  1271.   |  C000-DFFF   |128KB | C000-C3FF | C400-C5FF |  C600-DFFF   |100KB  |
  1272.    --------------------------------------------------------------------
  1273.  
  1274.      Note 1: The number of KB remaining for your other cards.  (The 24KB
  1275.              required for your token-ring card and the 4KB required by
  1276.              IBM CS have been subtracted from the total KB specified by
  1277.              the /MA range; depending on the memory range boundaries,
  1278.              another 4KB may be required.)
  1279.  
  1280.  
  1281.   Example  CONFIG.SYS,  PROTOCOL.INI, and NET.CFG files:  (All are ThinkPad 720
  1282.   examples.)
  1283.  
  1284.   1. IBM LSP/NATIVE mode environment
  1285.      Using the token-ring card default values of D0000 for MMIO and
  1286.      D8000 for SRAM, here is a sample CONFIG.SYS:
  1287.  
  1288.       DEVICE=C:\DOS\EMM386.EXE 1024 RAM X=D000-DBFF
  1289.                  :
  1290.       DEVICE=C:\IBMDOSCS.SYS
  1291.       DEVICE=C:\DICRMU02.SYS /MA=D000-DBFF
  1292.                  :
  1293.       DEVICE=C:\CS20TOK.SYS RS=16 MMIO=D000 IRQ=9 SRAM=D800,16
  1294.                  :
  1295.       DEVICE=C:\LSP\DXMC0MOD.SYS N ,D800,0,0,0
  1296.  
  1297.       Note the ranges taken:
  1298.       8KB MMIO range of D000-D1FF
  1299.       16KB SRAM range of D800-DBFF
  1300.       4KB for IBM CS within /MA range
  1301.  
  1302.   2. NDIS environment (this example is Other NDIS Environments/IBM LSP)
  1303.      Using the token-ring card default values of autoset for MMIO and
  1304.      SRAM, here is a sample CONFIG.SYS and PROTOCOL.INI:
  1305.      (The default value autoset will find memory locations within the
  1306.       range specified by the /MA option.)
  1307.  
  1308.       CONFIG.SYS:
  1309.  
  1310.       DEVICE=C:\DOS\EMM386.EXE 1024 RAM X=D000-DBFF
  1311.                  :
  1312.       DEVICE=C:\IBMDOSCS.SYS
  1313.       DEVICE=C:\DICRMU02.SYS /MA=D000-DBFF
  1314.                  :
  1315.       DEVICE=C:\LSP\IBMTOKCS.DOS
  1316.  
  1317.       Note:
  1318.       8KB MMIO and 16KB SRAM are taken by the token-ring card
  1319.       4KB is taken by IBM CS
  1320.  
  1321.       PROTOCOL.INI:
  1322.  
  1323.  
  1324.   20
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.       [IBMTOKCS_MOD]
  1336.       ;IBM Token-Ring 16/4 Credit Card
  1337.            DriverName=IBMTOK$
  1338.            :
  1339.            PCMCIA
  1340.            :
  1341.  
  1342.   3. NDIS environment (this example is Other NDIS Environments/IBM LSP)
  1343.      Specifying token-ring card values of C8000 for SRAM and CC000 for
  1344.      MMIO, here is a sample CONFIG.SYS and PROTOCOL.INI:
  1345.  
  1346.       CONFIG.SYS:
  1347.  
  1348.       DEVICE=C:\DOS\EMM386.EXE 1024 RAM X=C800-CFFF
  1349.                  :
  1350.       DEVICE=C:\IBMDOSCS.SYS
  1351.       DEVICE=C:\DICRMU02.SYS /MA=C800-CFFF
  1352.                  :
  1353.       DEVICE=C:\LSP\IBMTOKCS.DOS
  1354.  
  1355.       Note the ranges taken:
  1356.       16KB SRAM range of C800-CBFF
  1357.       8KB MMIO range of CC00-CDFF
  1358.       4KB for IBM CS within /MA range
  1359.  
  1360.       PROTOCOL.INI:
  1361.  
  1362.       [IBMTOKCS_MOD]
  1363.       ;IBM Token-Ring 16/4 Credit Card
  1364.            DriverName=IBMTOK$
  1365.            RAM = 0xC800
  1366.            MMIO = 0xCC00
  1367.            :
  1368.            PCMCIA
  1369.            :
  1370.  
  1371.  
  1372.   4. ODI environment
  1373.      Specifying the token-ring card values of C8000 for SRAM and
  1374.      CC000 for MMIO, here is a sample CONFIG.SYS and NET.CFG:
  1375.  
  1376.       CONFIG.SYS:
  1377.  
  1378.       DEVICE=C:\DOS\EMM386.EXE 1024 RAM X=C800-CFFF
  1379.                  :
  1380.       DEVICE=C:\IBMDOSCS.SYS
  1381.       DEVICE=C:\DICRMU02.SYS /MA=C800-CFFF
  1382.  
  1383.       Note the ranges taken:
  1384.       16KB SRAM range of C800-CBFF
  1385.       8KB MMIO range of CC00-CDFF
  1386.       4KB for IBM CS within /MA range
  1387.  
  1388.  
  1389.  
  1390.                                                                    Contents  21
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.       NET.CFG:
  1401.  
  1402.       Link Driver TOKEN
  1403.            PCMCIA
  1404.            :
  1405.            MEM #1 CC000
  1406.            MEM #2 C8000
  1407.  
  1408.   ----------------------------------------------------------------------
  1409.   Section  3:    Phoenix  Card  and  Socket  Services  with  a  memory  manager
  1410.   ----------------------------------------------------------------------
  1411.  
  1412.   1. Your card requires memory in order to operate.  You must configure
  1413.      your computer so a memory manager and/or other PC cards do not use
  1414.      the same memory range(s) as your card, otherwise, your card will
  1415.      not operate.
  1416.  
  1417.      It is recommended that you do not use the default value of
  1418.      "autoset," but instead specify the base addresses of the
  1419.      Memory Mapped I/O (MMIO) and Shared RAM (SRAM) memory ranges
  1420.      you want your card to use (this capability is provided on a
  1421.      screen during the installation).
  1422.  
  1423.      Important: When specifying the base addresses, you must make
  1424.      certain that the MMIO and SRAM memory ranges being used by your
  1425.      card do not conflict (overlap) with memory that is being used by
  1426.      any other cards in your computer.  Also, the MMIO and SRAM base
  1427.      addresses must NOT be equal to (or within a 4KB range above) the
  1428.      value set by the /ADDR option.  (The /ADDR option may be found on
  1429.      the "DEVICE=C:\DOS\PCMCS.EXE" line in your CONFIG.SYS.  For the
  1430.      IBM ThinkPad 350, it is set to C8 in the preinstalled CONFIG.SYS.)
  1431.      Also, the MMIO and SRAM base addresses cannot be the same.
  1432.  
  1433.   2. To prevent the memory manager from using the same memory as your
  1434.      card, you must exclude the memory range(s) being used by your card
  1435.      starting at the base addresses that you specified.  The memory
  1436.      ranges are used by your card for Memory Mapped I/O (MMIO) and
  1437.      Shared RAM (SRAM).
  1438.      Important:  For computers with multiple PC cards, you must exclude
  1439.                  the memory ranges being used by all of them.
  1440.  
  1441.   3. To add the required excludes on your memory manager line, you
  1442.      must edit your CONFIG.SYS file after completing the installation.
  1443.  
  1444.      A. If you are using the preinstalled CONFIG.SYS on the
  1445.         IBM ThinkPad 350:
  1446.  
  1447.         1. You must specify the SRAM base address to C8000 and the
  1448.            MMIO base address to CC000 (during installation). The SRAM
  1449.            range of C800-CBFF and MMIO range of CC00-CDFF are already
  1450.            excluded on the memory manager line in the preinstalled
  1451.            CONFIG.SYS as "X=C800-CFFF."
  1452.  
  1453.         2. You must change the /ADDR option on the PCMCS line in your
  1454.  
  1455.  
  1456.   22
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.            CONFIG.SYS to be set to CE as follows:
  1467.            DEVICE=C:\DOS\PCMCS.EXE /WAIT=12 /ADDR=CE /IRQ=10
  1468.  
  1469.         3. You must also "remark" out the super client driver line in
  1470.            the CONFIG.SYS by changing it to the following:
  1471.            rem DEVICE=C:\DOS\PCMSCD.EXE /BEEP /COM=3 /RS=4
  1472.  
  1473.      B. If you are not using the preinstalled CONFIG.SYS on the
  1474.         ThinkPad 350 (or change the memory manager options), you may
  1475.         decide to use other SRAM and MMIO base addresses.  If so, the
  1476.         table below tells you what you should exclude on the memory
  1477.         manager line in the CONFIG.SYS.
  1478.  
  1479.         MEMORY RANGES TO EXCLUDE ON THE MEMORY MANAGER LINE FOR
  1480.         MMIO and SRAM
  1481.         (for EMM386, use the "X=" option)
  1482.  
  1483.         If                    If SRAM, exclude     If MMIO, exclude
  1484.         Shared RAM or         the following        the following
  1485.         Memory Mapped I/O     range                range
  1486.         Base Address is...    (16KB size)          (8KB size)
  1487.         ------------------    -----------          ----------------
  1488.  
  1489.         C0000                  C000-C3FF            C000-C1FF
  1490.         C4000                  C400-C7FF            C400-C5FF
  1491.         C8000                  C800-CBFF            C800-C9FF
  1492.         CC000                  CC00-CFFF            CC00-CDFF
  1493.         D0000                  D000-D3FF            D000-D1FF
  1494.         D4000                  D400-D7FF            D400-D5FF
  1495.         D8000                  D800-DBFF            D800-D9FF
  1496.         DC000                  DC00-DFFF            DC00-DDFF
  1497.  
  1498.         You must ALSO exclude the 4KB that Phoenix Card and Socket
  1499.         Services requires.  The /ADDR parameter that is on the card
  1500.         services line in your CONFIG.SYS gives the base address for
  1501.         the 4KB.  Depending on the /ADDR value you specify, the table
  1502.         below tells you what should exclude on the memory manager line
  1503.         in the CONFIG.SYS.
  1504.         (For example, if your card services line is as follows:
  1505.         DEVICE=C:\DOS\PCMCS.EXE /WAIT=12 /ADDR=C8 /IRQ=10
  1506.         then you must exclude C800-C8FF from your memory manager.)
  1507.  
  1508.         MEMORY RANGES TO EXCLUDE ON THE MEMORY MANAGER LINE FOR
  1509.         /ADDR PARAMETER
  1510.         (for EMM386, use the "X=" option)
  1511.  
  1512.         If     Exclude the     If     Exclude the     If     Exclude the
  1513.         /ADDR  following       /ADDR  following       /ADDR  following
  1514.         is...  range           is...  range           is...  range
  1515.                (4KB size)             (4KB size)             (4KB size)
  1516.         -----  -----------     -----  -----------     -----  -----------
  1517.  
  1518.         C0      C000-C0FF       CB     CB00-CBFF       D6     D600-D6FF
  1519.         C1      C100-C1FF       CC     CC00-CCFF       D7     D700-D7FF
  1520.  
  1521.  
  1522.                                                                    Contents  23
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.         C2      C200-C2FF       CD     CD00-CDFF       D8     D800-D8FF
  1533.         C3      C300-C3FF       CE     CE00-CEFF       D9     D900-D9FF
  1534.         C4      C400-C4FF       CF     CF00-CFFF       DA     DA00-DAFF
  1535.         C5      C500-C5FF       D0     D000-D0FF       DB     DB00-DBFF
  1536.         C6      C600-C6FF       D1     D100-D1FF       DC     DC00-DCFF
  1537.         C7      C700-C7FF       D2     D200-D2FF       DD     DD00-DDFF
  1538.         C8      C800-C8FF       D3     D300-D3FF       DE     DE00-DEFF
  1539.         C9      C900-C9FF       D4     D400-D4FF       DF     DF00-DFFF
  1540.         CA      CA00-CAFF       D5     D500-D5FF
  1541.  
  1542.   4. After you have completed the above, it is recommended that you
  1543.      turn off your computer.  Upon power on, your new configuration
  1544.      will be set up.
  1545.  
  1546.   ----------------------------------------------------------------------
  1547.   Section        4:               Using       expanded       memory       (EMS)
  1548.   ----------------------------------------------------------------------
  1549.  
  1550.   Expanded memory (EMS) requires a contiguous 64KB block of memory in the range
  1551.   from C000-DFFF to use as a page frame.  Therefore, when using EMS, you should
  1552.   be careful when specifying the memory range you want your PC  cards  to  use.
  1553.   You  must  leave a contiguous 64KB block of memory "free."  "Free" means that
  1554.   you cannot specify any card memory ranges within this 64KB block.
  1555.  
  1556.   With EMM386, you can then set the page frame base address  via  the  "FRAME="
  1557.   option  on  the memory manager line in the CONFIG.SYS.  If you do not specify
  1558.   the page frame base address, EMM386 will automatically try  to  find  a  64KB
  1559.   block  of  contiguous memory.  Both the ThinkPad 350 and 750 come with EMM386
  1560.   preinstalled and the page frame specified to the  range  D000-DFFF  (via  the
  1561.   "FRAME=D000"  option  on  the memory manager line).  To understand EMM386 and
  1562.   all its options, please see your IBM DOS manual.
  1563.  
  1564.   Some example memory ranges:   (You  may  choose  other  ranges  to  fit  your
  1565.   requirements.)
  1566.  
  1567.    --------------------------------------------------------------------
  1568.   | ALL PC cards memory must | Memory    | 64KB page frame range       |
  1569.   | be within this range     | range size|                             |
  1570.   |                          | for PC    | You must NOT specify any    |
  1571.   | See note 1 below         | cards in  | PC card memory to be in     |
  1572.   |                          | KB        | this range                  |
  1573.   |--------------------------+-----------+-----------------------------|
  1574.   |  C000-CFFF               | 64KB      | D000-DFFF                   |
  1575.   |--------------------------+-----------+-----------------------------|
  1576.   |  C800-CFFF               | 32KB      | D000-DFFF                   |
  1577.   |--------------------------+-----------+-----------------------------|
  1578.   |  C000-C6FF               | 28KB      | If "FRAME=CC00" option used,|
  1579.   |                          |           | CC00-DC00                   |
  1580.   |                          |           | If "FRAME=D000" option used,|
  1581.   |                          |           | D000-DFFF                   |
  1582.   |--------------------------+-----------+-----------------------------|
  1583.   |  D000-DFFF               | 64KB      | C000-CFFF                   |
  1584.    --------------------------------------------------------------------
  1585.  
  1586.  
  1587.  
  1588.   24
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.   Note  1:  1) If you are using IBM Card Services, this range must be specified
  1599.   as
  1600.      the /MA range on the RMU line and excluded on the memory manager
  1601.      line  in the CONFIG.SYS.  Please see section 2 above.  2) If you are using
  1602.   a point connectivity enabler or Phoenix Card
  1603.      Services, all memory ranges you specify your PC cards to use
  1604.      (within this memory range) must be excluded on the memory manager
  1605.      line in the CONFIG.SYS.  When using Phoenix Card Services, you must
  1606.      also exclude the 4KB it requires.  Please see the appropriate
  1607.      section, 1 or 3, above.
  1608.  
  1609.   If you are using EMM386, and do not follow the steps above, you may  see  one
  1610.   of the following error messages:
  1611.  
  1612.   1) One message you may see is "Warning: Option ROM or RAM within
  1613.      page frame."  This means that EMM386 could not find a 64KB block of
  1614.      contiguous memory using the page frame base address you specified
  1615.      (you have a card taking memory within the 64KB block).  However,
  1616.      EMM386 has gotten around the problem (and your configuration
  1617.      should work).  EMM386 is just flagging that it is not using its
  1618.      64KB contiguous block of memory starting at the base address you
  1619.      specified.  It does require and has found 64KB for its use, however.
  1620.  
  1621.   2) If you see the message, "Unable to set page frame base address,"
  1622.      you must follow the steps above and free a 64KB block of memory.
  1623.  
  1624.   Examples:
  1625.  
  1626.   1. Using a point enabler and the default values for the token-ring
  1627.      card leaves the C0000-CFFFF range "free" for the EMS page.  A
  1628.      sample memory manager line in your CONFIG.SYS follows:
  1629.  
  1630.      DEVICE=C:\DOS\EMM386.EXE RAM 1024 X=D000-D1FF X=D800-DBFF FRAME=C000
  1631.  
  1632.      Note:  The token-ring card uses D0000-D1FFF for 8KB MMIO and
  1633.             D8000-DBFFF for 16KB SRAM.
  1634.             The "FRAME=" parameter sets the base address of the EMS page
  1635.             frame (the page frame uses C0000-CFFFF).  So, no PC cards
  1636.             should be set to use memory in the range from C0000-CFFFF.
  1637.  
  1638.   2. Using IBM Card Services, you can set the /MA option such that a
  1639.      64KB block is free for the EMS page frame.  A sample CONFIG.SYS
  1640.      follows:
  1641.  
  1642.       DEVICE=C:\DOS\EMM386.EXE RAM 1024 X=D000-DBFF FRAME=C000
  1643.                  :
  1644.       DEVICE=C:\DICRMU01.SYS /MA=D000-DBFF
  1645.  
  1646.      Note:  Because of the /MA option, IBM CS will only use memory in
  1647.             the range from D0000-DBFFF.
  1648.  
  1649.             The "FRAME=" parameter sets the base address of the EMS page
  1650.             frame (the page frame uses C0000-CFFFF).  No PC cards should
  1651.             be set to use memory in the range from C0000-CFFFF.
  1652.  
  1653.  
  1654.                                                                    Contents  25
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.   1.6.4  MISCELLANEOUS
  1665.  
  1666.   It  is  important  to  have a token-ring credit card adapter inserted in your
  1667.   computer before starting some Local Area Network software;  results  will  be
  1668.   unpredictable if the card is not present when the software is executed.
  1669.  
  1670.  
  1671.   It  is also important not to remove your card once communication on a LAN has
  1672.   begun. Operation will be unpredictable if you do so (possible  system  hang).
  1673.   Please  study  the  exceptions  in  the section entitled "Hot-Plugability and
  1674.   Suspend/Resume Issues."
  1675.  
  1676.  
  1677.   The  IBMTOKCS.NIF  file is intended for use only with the IBM 16/4 Token-Ring
  1678.   Credit Card Adapter.  Errors may result if it is used with  other  Token-Ring
  1679.   adapters.
  1680.  
  1681.  
  1682.   The  IBM  ThinkPad  750/750C notebook computer typically uses Card and Socket
  1683.   Services.  If you do not want to use Card and Socket Services,  you  can  use
  1684.   POINTTR.SYS  but  you  must use the WS=0 parameter on the command line of the
  1685.   enabler for the card to function properly in this computer.
  1686.  
  1687.  
  1688.   A system hang may result if POINTTR.SYS is used with Card Services.   If  you
  1689.   upgrade to Card Services, you should use the Credit Card Installation program
  1690.   to remove any connectivity enablers.
  1691.  
  1692.  
  1693.   The  Toshiba  T3300SL  computer  uses a special version of MS-DOS 5.0 and its
  1694.   CONFIG.SYS includes a statement that executes a  utility  called  SETVER.EXE.
  1695.   This  particular version of SETVER.EXE is incompatible with network operating
  1696.   environments like DOS LAN Requester -  an  error  occurs  that  indicates  an
  1697.   incorrect  DOS  version.    This has not been found on other MS-DOS machines.
  1698.   The installation utility will remark out this utility in  CONFIG.SYS  on  the
  1699.   Toshiba.
  1700.  
  1701.   If you use two cards in a single machine with Card Services and you are using
  1702.   the  NDIS  driver,  it  is  important to edit the section for the second card
  1703.   [IBMTOKCS2_NIF] in the PROTOCOL.INI to remark out the references to MMIO  and
  1704.   RAM.  This  is  to  ensure that the drivers can allocate the memory resources
  1705.   necessary for each driver.
  1706.  
  1707.  
  1708.   If you use two cards in a single machine, we recommend that you set each card
  1709.   to a different interrupt level. You can do this in PROTOCOL.INI  and  NET.CFG
  1710.   when using Card Services.
  1711.  
  1712.  
  1713.   The  following  computers  have  two  PCMCIA  sockets;  here are their socket
  1714.   assignments:
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.   26
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.                                  Socket A (or 1)       Socket B (or 2)
  1731.                                  ---------------       ---------------
  1732.  
  1733.       AST Powerexec                Bottom                Top
  1734.       IBM ThinkPad 720             Top                   Bottom
  1735.       IBM ThinkPad 750             Top                   Bottom
  1736.       NEC UltraLite VERSA          Bottom                Top
  1737.  
  1738.   The PS/2-E Model 9533 has four PCMCIA sockets. Here are  its  socket  assign-
  1739.   ments:
  1740.  
  1741.           Socket A - Front Top
  1742.           Socket B - Front Bottom
  1743.           Socket C - Back Top
  1744.           Socket D - Back Bottom
  1745.  
  1746.   The IBM Port Replicator has two PCMCIA sockets. If you are using a
  1747.   point enabler, they have the following assignments:
  1748.  
  1749.           Socket A - Top Socket
  1750.           Socket B - Bottom Socket
  1751.  
  1752.   With the POINTTR.SYS enabler, you must use the PCIC=03E2 parameter for the Port
  1753.   Replicator.
  1754.  
  1755.   Single-socket machines use Socket A.
  1756.  
  1757.  
  1758.   If you plan to use the Personal Computer LAN Program (PCLP) as a server
  1759.   on a computer with an IBM Token-ring Credit Card adapter,
  1760.   it is recommended that you use the LAN Support Program
  1761.   native token-ring driver (DXMC0MOD.SYS).
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.                                                                    Contents  27
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.   1.7  WHERE TO FIND CARD SERVICES AND SOCKET SERVICES
  1797.   ____________________________________________________
  1798.  
  1799.   Device Driver    |  Description
  1800.   -----------------+---------------------------------------------------------
  1801.   PCMCIA.SYS       |  OS/2 Card Services.  This device driver ships with
  1802.                    |  OS/2 2.1.  It can be installed either when you first
  1803.                    |  install OS/2 2.1 or by using 'Selective Install'.
  1804.                    |
  1805.   IBMDOSCS.SYS     |  IBM DOS Card Services.  This device driver ships on a
  1806.                    |  diskette included with your PC.  For example,
  1807.                    |  the diskette is labeled 'IBM ThinkPad 750/750C/750P
  1808.                    |  Utility Diskette' if you purchased an IBM ThinkPad
  1809.                    |  750, 750C, or 750P.
  1810.                    |
  1811.   IBM2SS01.SYS     |  IBM OS/2 Socket Services. This device driver ships on a
  1812.   IBM2SS02.SYS     |  diskette included with your workstation.  For example,
  1813.                    |  the diskette is labeled 'IBM ThinkPad 750/750C/750P
  1814.                    |  Utility Diskette' if you purchased an IBM ThinkPad
  1815.                    |  750, 750C, or 750P.  The driver ending in 01 is
  1816.                    |  for ISA-bus machines.  The driver ending in 02 is for
  1817.                    |  Micro Channel machines.
  1818.                    |
  1819.   IBMDSS01.SYS     |  IBM DOS Socket Services. This device driver ships on a
  1820.   IBMDSS02.SYS     |  diskette included with your workstation.  For example,
  1821.                    |  the diskette is labeled 'IBM ThinkPad 750/750C/750P
  1822.                    |  Utility Diskette' if you purchased an IBM ThinkPad
  1823.                    |  750, 750C, or 750P.  The driver ending in 01 is
  1824.                    |  for ISA-bus machines.  The driver ending in 02 is for
  1825.                    |  Micro Channel machines.
  1826.                    |
  1827.   ICRMU01.SYS      |  IBM OS/2 Resource Map Utility. This device driver ships
  1828.   ICRMU02.SYS      |  on a diskette included with your workstation.  For
  1829.                    |  example the diskette is labeled 'IBM ThinkPad
  1830.                    |  750/750C/750P Utility Diskette' if you purchased an
  1831.                    |  IBM ThinkPad 750, 750C, or 750P.  The driver ending in
  1832.                    |  01 is for ISA-bus machines.  The driver ending in 02 is
  1833.                    |  for Micro Channel machines.
  1834.                    |
  1835.   DICRMU01.SYS     |  IBM DOS Resource Map Utility. This device driver ships
  1836.   DICRMU02.SYS     |  on a diskette included with your workstation.  For
  1837.                    |  example the diskette is labeled 'IBM ThinkPad
  1838.                    |  750/750C/750P Utility Diskette' if you purchased an
  1839.                    |  IBM ThinkPad 750, 750C, or 750P.  The driver ending in
  1840.                    |  01 is for ISA-bus machines.  The driver ending in 02 is
  1841.                    |  for Micro Channel machines.
  1842.  
  1843.  
  1844.   1.8  OS/2 DEVICE DRIVER STATEMENT ORDER
  1845.   _______________________________________
  1846.  
  1847.   For  OS/2, the order of statements in your CONFIG.SYS is very important.  The
  1848.   order must be:
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.   28
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.        DEVICE=C:\OS2\PCMCIA.SYS                <-- Card Services
  1865.                  .
  1866.                  .
  1867.        DEVICE=C:\IBMCOM\MACS\IBMTOKCS.OS2      <-- Client Token-Ring Driver
  1868.                  .
  1869.                  .
  1870.        DEVICE=C:\IBM2SS02.SYS                  <-- Socket Services
  1871.        DEVICE=C:\ICRMU02.SYS                   <-- Resource MAP utility
  1872.  
  1873.   The  installation  program  will examine your CONFIG.SYS and move Socket Ser-
  1874.   vices and the Resource Map Utility to the bottom of the file, if they are not
  1875.   there already.  They do not have to be the last statements in CONFIG.SYS  but
  1876.   they  must be after every PCMCIA client driver you have installed; the bottom
  1877.   of CONFIG.SYS is the obvious place to ensure this.
  1878.  
  1879.  
  1880.   1.9  HOT-PLUGABILITY AND SUSPEND/RESUME ISSUES
  1881.   ______________________________________________
  1882.  
  1883.   The DOS ODI and OS/2 NDIS drivers on this diskette support a  level  of  hot-
  1884.   plugability  and  Suspend/Resume.    Hot-plugability refers to the ability to
  1885.   remove and insert your card at any time while the machine is running.  If you
  1886.   follow these guidelines, no damage will occur to your card, machine, or soft-
  1887.   ware.  Hot-plugging has the advantage of allowing you  to  remove  your  card
  1888.   when  you  are  using battery power, thus reducing the drain on your battery.
  1889.   It also provides greater freedom in using portable computers  in  a  portable
  1890.   manner.  To use the hot-plugging features of this card, you must:
  1891.  
  1892.   o   Use  Card  and Socket Services.  If you are using a point enabler, DO NOT
  1893.       attempt to unplug your card while the machine is powered  on.    You  may
  1894.       damage both your card and the machine if you do.
  1895.  
  1896.   o   Use  either the DOS ODI environment or the OS/2 NDIS environment.  At the
  1897.       present time the OS/2 ODI, DOS Native, and DOS NDIS environments  do  not
  1898.       support hot-plugability.  Removing your card while using any of these may
  1899.       result in a system hang or the inability to access your LAN applications.
  1900.  
  1901.   o   Boot your machine with your card inserted.  The current hot-plugging fea-
  1902.       tures  do  not support the ability to insert your card for the first time
  1903.       after the machine has been powered on.
  1904.  
  1905.   o   Close all of your LAN applications before removing the card.   Presently,
  1906.       this card supports hot-plugability at the device driver level.  Until LAN
  1907.       applications  such  as  LAPS,  Novell,  or  Banyan  begin to support hot-
  1908.       plugability at the application level, it is necessary to stop the  appli-
  1909.       cation  BEFORE removing the card.  If you fail to do this, you may not be
  1910.       able to use your application without rebooting your machine  or  you  may
  1911.       hang your system.
  1912.  
  1913.   o   Remove  your  card  before going into suspend.  Some machines may hang if
  1914.       the card remains inserted when the machine is put into suspend.  For hot-
  1915.       plugging to work properly, it is recommended that  you  remove  the  card
  1916.       before using the suspend feature.
  1917.  
  1918.  
  1919.  
  1920.  
  1921.                                                                    Contents  29
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.   The  following  sections  describe,  in  more  detail, the exact procedure to
  1932.   follow for each of the supported hot-plugging environments.
  1933.  
  1934.  
  1935.   1.9.1  DOS ODI HOT-PLUGABILITY AND SUSPEND/RESUME
  1936.  
  1937.   To  remove  the card or go into a suspend mode, you must first unload all the
  1938.   drivers. This is done by removing them in the reverse order  of  installation
  1939.   by typing the following at the DOS prompt:
  1940.       netx u
  1941.      (route u)
  1942.       ipxodi u
  1943.       tokencs u
  1944.       lsl u
  1945.  
  1946.   At  this  point, you may remove the card from your machine.  Once the card is
  1947.   removed, you may enter and exit suspend mode as  often  as  you  like  before
  1948.   reinstalling the card.  It is best to reinstall the card while the machine is
  1949.   not in suspend mode.
  1950.  
  1951.   After  re-inserting  the card or resuming, you can restart your network soft-
  1952.   ware by typing the following at the DOS prompt:
  1953.       lsl
  1954.       tokencs
  1955.       ipxodi
  1956.      (route)
  1957.       netx
  1958.  
  1959.  
  1960.   1.9.2  OS/2 NDIS HOT-PLUGABILITY AND SUSPEND/RESUME
  1961.  
  1962.   To remove the card or go into Suspend, you must first shut down all  of  your
  1963.   applications  that  are using the card.  This could be any of IBM LAN Server,
  1964.   IBM Communications Manager/2, or IBM PC/3270 for Windows (running on the OS/2
  1965.   desktop).  After the applications have shut down, you can safely  remove  the
  1966.   card  or  go into suspend mode.  After you re-insert the card and resume, you
  1967.   can re-start your applications.
  1968.  
  1969.   If you experience a TRAP 0003 in the IBMS506$ device when you Resume  or  re-
  1970.   insert the adapter, you can either replace the BASEDEV=IBM1S506.ADD statement
  1971.   in  CONFIG.SYS  with  BASEDEV=IBMINT13.I13,  or  contact  IBM  for an updated
  1972.   IBM1S506.ADD.  As of this writing, an updated IBM1S506.ADD was under test.
  1973.  
  1974.   One scenario that does not work is suspending and  then  removing  the  card.
  1975.   The  card  will  not be recognized when it is re-inserted.  If you want to do
  1976.   something like this, you must first remove the card and then  suspend.    You
  1977.   can then resume later and re-insert the card later.
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.   30
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.   1.10  REMOTE PROGRAM LOAD (RPL)
  1998.   _______________________________
  1999.  
  2000.   The card supports the use of remote program load, the downloading of an oper-
  2001.   ating system from a server when you turn the computer on.
  2002.  
  2003.   NOTE 1: This is only possible on a computer that supports Remote Program
  2004.           Load with PCMCIA devices. Currently, the IBM PS/2 E and the
  2005.           ThinkPad 750 support RPL.
  2006.  
  2007.   NOTE 2:  You cannot use Card Services on the computer which has been IPLed
  2008.            remotely; you must use a Point Enabler such as POINTTR.SYS for the
  2009.            Token-ring card and for any other cards you want to use.
  2010.  
  2011.   From an IBM LAN Server, you may download either a DOS or an OS/2 image.
  2012.   If you are using a Novell Server, however, you can load only a DOS image.
  2013.  
  2014.  
  2015.   The IBM Token-Ring Credit Card Adapter II supports RPL from
  2016.   the following types of servers:
  2017.  
  2018.   o   OS/2 Lan Server 3.0
  2019.  
  2020.   o   Novell NetWare v3.11 and v4.
  2021.  
  2022.  
  2023.   1.10.1  RELATED DOCUMENTATION
  2024.  
  2025.   In addition to the instructions provided here, you may want to
  2026.   refer to "The IBM Token-Ring Network Remote Program Load User's
  2027.   Guide" for information regarding the operation of RPL.  You can
  2028.   obtain a copy of this booklet by ordering IBM
  2029.   publication No. SK2T-0333-00.
  2030.  
  2031.  
  2032.  
  2033.   1.10.2  CONFIGURING OS/2 LAN SERVER 3.0 FOR RPL SUPPORT
  2034.  
  2035.    NOTE to OS/2 users: To RIPL OS/2 to a requester with a token-ring credit
  2036.    card adapter, you must install OS/2 version 2.1 (or later) for RIPL on
  2037.    your server.  In addition, LAN Server 3.0 requires a patch to allow it
  2038.    to RIPL OS/2 2.1.  This patch can be found both on CompuServ and TALKLINK,
  2039.    as well as in 'IBM LAN Server Version 3.0 Select Pack IP07001'.  Please
  2040.    consult the README file that comes with the patch concerning how and when
  2041.    the patch is applied.
  2042.  
  2043.    SECTIONS:
  2044.       I) Installing LAN Adapter and Protocol Support
  2045.      II) Installing LAN Server 3.0 RIPL Workstation Support
  2046.     III) Copying Files to Support OS/2 RIPL Workstations
  2047.      IV) Setting Up RIPL Files
  2048.          A) Installing the Required Files
  2049.          B) Creating Files for DOS and OS/2 RIPL
  2050.          C) Updating Files for DOS RIPL
  2051.          D) Creating Files for OS/2 RIPL
  2052.  
  2053.  
  2054.                                                                    Contents  31
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.          E) Updating Files for OS/2 RIPL
  2065.       V) Starting the Server
  2066.      VI) Creating a Model for OS/2 Requester Profiles
  2067.     VII) Configuring a DOS RPL Requester Profile
  2068.    VIII) Configuring an OS/2 RPL Requester Profile
  2069.      IX) Configuring a Selectable Boot RPL Requester Profile
  2070.       X) Starting RIPL Service
  2071.      XI) Running the Token-Ring Credit Card Adapter Diagnostics
  2072.  
  2073.        (C) Copyright IBM Corp. 1993
  2074.  
  2075.    +--- WHERE TO START ---------------------------------------------+
  2076.    |                                                                |
  2077.    | o   If you are installing a new server, go to section I,       |
  2078.    |     "Installing LAN Adapter and Protocol Support".             |
  2079.    |                                                                |
  2080.    | o   If your server already has LAPS installed, but needs       |
  2081.    |     to have LS 3.0 DOS RIPL or OS/2 RIPL support installed,    |
  2082.    |     go to section II, "Installing LAN Server 3.0 RIPL          |
  2083.    |     Workstation Support".                                      |
  2084.    |                                                                |
  2085.    | o   If your server already has LAPS and LS 3.0 OS/2 RIPL       |
  2086.    |     support installed, but you need to RIPL a different        |
  2087.    |     version of OS/2, go to section III, "Copying Files to      |
  2088.    |     Support OS/2 RIPL Workstations".                           |
  2089.    |                                                                |
  2090.    | o   If the above conditions do not apply, go to section IV,    |
  2091.    |     "Setting Up RIPL Files".                                   |
  2092.    |                                                                |
  2093.    +----------------------------------------------------------------+
  2094.  
  2095.   --------------------------------------------------------------------------
  2096.   I) Installing LAN Adapter and Protocol Support
  2097.  
  2098.    To install LAN adapter and protocol support (LAPS), refer to the LAN
  2099.    Server 3.0 documentation for detailed information.  Be sure to shut
  2100.    down and restart the system before continuing with the next section.
  2101.  
  2102.   --------------------------------------------------------------------------
  2103.   II) Installing LAN Server 3.0 RIPL Workstation Support
  2104.  
  2105.    To install the LAN Server 3.0 RIPL workstation support, do the following:
  2106.  
  2107.    1.  Insert the "LAN Server 3.0 Install Disk" into drive A.
  2108.  
  2109.    2.  Run LANINST.EXE (located in the A:\ directory).
  2110.  
  2111.    3.  Select OK, then ADVANCED.
  2112.  
  2113.    4.  Select INSTALL OR CONFIGURE THIS WORKSTATION; then select OK.
  2114.  
  2115.    5.  If the message "HPFS partition not created" appears, select OK.
  2116.  
  2117.    6.  Choose the server type DOMAIN CONTROLLER; then select OK.
  2118.  
  2119.  
  2120.   32
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.    7.  Choose INSTALL OR REMOVE A COMPONENT; then select OK.
  2132.  
  2133.    8.  Select OS/2 REMOTE IPL and DOS REMOTE IPL.
  2134.  
  2135.    9.  Select INSTALL; then select OK.
  2136.  
  2137.    10. Select CONFIGURE A COMPONENT; then select OK.
  2138.  
  2139.    11. Select SERVER; then select CONFIGURE.
  2140.  
  2141.    12. Type your server name and domain name; then select OK.
  2142.  
  2143.    13. Select one of the following, then select OK:
  2144.        o   "START SERVER AUTOMATICALLY" to start the server at the time
  2145.            the machine is first started
  2146.  
  2147.        o   "DO NOT START THE SERVER AUTOMATICALLY" to not start the server
  2148.            at the time the machine is first started
  2149.  
  2150.    14. In the SERVER SERVICES panel:
  2151.        a.  Select REMOTE IPL; then select ON
  2152.  
  2153.        b.  Select OK
  2154.  
  2155.    15. Select OK to leave the CONFIGURE panel.
  2156.  
  2157.    16. Select APPLY THE CHANGES; then select OK.
  2158.  
  2159.    17. Insert the appropriate diskettes into drive A when prompted to do so;
  2160.        then select OK after inserting each diskette.
  2161.  
  2162.    18. Note the information in the FILE BACKUP panel; then select OK.
  2163.  
  2164.    19. Note the information in the DEFAULT USER ID AND PASSWORD panel;
  2165.        then select OK.
  2166.  
  2167.    20. Note the information in the SHUTDOWN REQUIREMENTS panel; then select
  2168.        OK.
  2169.  
  2170.    21. Remove any diskette remaining in drive A; then shut down and restart
  2171.        the workstation.
  2172.  
  2173.   --------------------------------------------------------------------------
  2174.   III) Copying Files to Support OS/2 RIPL Workstations
  2175.  
  2176.    NOTE: The following assumes that the LS 3.0 server is running OS/2 2.1,
  2177.    as opposed to running OS/2 2.0 with 2.1 RIPL support.  If your server is
  2178.    not running OS/2 2.1, please consult the README file in the LS 3.0 patch
  2179.    concerning the exact sequence needed to install OS/2 for RIPL support.
  2180.  
  2181.    To copy the files necessary to support OS/2 RIPL workstations, do the
  2182.    following:
  2183.  
  2184.  
  2185.  
  2186.                                                                    Contents  33
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.    1.  Restart the workstation.
  2197.  
  2198.    2.  Insert the "OS/2 2.1 Diskette 7" in drive A.
  2199.  
  2200.    3.  Enter CD OS2\INSTALL on the C disk to change the directory.
  2201.  
  2202.    4.  Run UNPACK A:\RIPLINST.
  2203.  
  2204.    5.  Run RIPLINST.EXE.  This program installs an OS/2 2.1 image on the hard
  2205.        disk drive.
  2206.  
  2207.    6.  Select INSTALL to accept the default directories listed in the panel.
  2208.  
  2209.    7.  Insert the appropriate diskettes into drive A when prompted to do so;
  2210.        then select OK after inserting each diskette.
  2211.  
  2212.    8.  When the installation is complete, remove the last diskette from drive
  2213.        A; then select OK followed by EXIT.
  2214.  
  2215.    9.  Run the command file contained in the LS 3.0 patch to install the
  2216.        OS/2 2.1 RIPL support code.
  2217.  
  2218.   --------------------------------------------------------------------------
  2219.   IV) Setting Up RIPL Files
  2220.  
  2221.    The following sections describe the procedures for installing, creating,
  2222.    and updating RIPL files.  Please note that the OS/2 token-ring credit
  2223.    card drivers are not installed; for OS/2 the standard token-ring driver
  2224.    IBMTOK.OS2 is used.
  2225.  
  2226.    A) Installing the Required Files
  2227.    --------------------------------
  2228.  
  2229.      Insert the adapter Options Diskette in drive A, and copy the following
  2230.      files:
  2231.  
  2232.      1.  From the A:\DOS subdirectory:
  2233.  
  2234.      +------------+----------------------------+
  2235.      |FILE NAME   | COPY TO SUBDIRECTORY       |
  2236.      +------------+----------------------------+
  2237.      |IBMTOKCS.DOS| C:\IBMLAN\RPL\DOS          |
  2238.      +------------+----------------------------+
  2239.      |LTG.MSG     | C:\IBMLAN\RPL\DOS          |
  2240.      +------------+----------------------------+
  2241.      |LTGH.MSG    | C:\IBMLAN\RPL\DOS          |
  2242.      +------------+----------------------------+
  2243.      |IBMTOKCS.NIF| C:\IBMLAN\RPL\DOS          |
  2244.      +------------+----------------------------+
  2245.  
  2246.  
  2247.    B) Creating Files for DOS RIPL
  2248.    ------------------------------
  2249.  
  2250.  
  2251.  
  2252.   34
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.      To create the necessary files for DOS RIPL, do the following:
  2263.  
  2264.      1.  In the C:\IBMLAN\RPL directory, copy the file DOSNDTR.CNF to
  2265.          DOSNTRCA.CNF.
  2266.  
  2267.      2.  Edit C:\IBMLAN\RPL\DOSNTRCA.CNF as follows:
  2268.  
  2269.          Line 1  Change "(IBM Token Ring)"
  2270.                      to "(IBM Token Ring Credit Card)".
  2271.  
  2272.          Line 8  Change "DAT DOS\TOKENRNG\PROTOCOL.INI"
  2273.                      to "DAT DOS\TOKENRGC\PROTOCOL.INI".
  2274.  
  2275.          Line 12 Change "DRV DOS\IBMTOK.DOS ~ ~ ~"
  2276.                      to "DRV DOS\IBMTOKCS.DOS ~ ~ ~".
  2277.  
  2278.                  Note: the driver statement *must* be followed by
  2279.                         "<sp>~<sp>~<sp>~", where "<sp>" is a single
  2280.                         blank space character.
  2281.  
  2282.          Line 6  Insert the following lines between lines 6 and 7:
  2283.                         "DAT DOS\LTG.MSG"
  2284.                         "DAT DOS\LTGH.MSG"
  2285.  
  2286.     3.  Save the modified file.
  2287.         NOTE:  This configuration does not support DOS 802.2.
  2288.  
  2289.     4.  In the C:\IBMLAN\RPL directory, copy the file DOSBBET.CNF to
  2290.         DOSNTR2C.CNF.
  2291.  
  2292.     5.  Edit C:\IBMLAN\RPL\DOSNTR2C.CNF as follows:
  2293.  
  2294.         Line 1  Change "(IBM PS/2 Adapters for Ethernet)"
  2295.                     to "(IBM Token Ring Credit Card/802.2)".
  2296.  
  2297.         Line 6  Change "DAT DOS\PROTOCOL.INI"
  2298.                     to "DAT DOS\TOKENRGC\PROTOCOL.INI".
  2299.  
  2300.         Line 11 Change "DRV DOS\MACETH.DOS ~ ~"
  2301.                     to "DRV DOS\IBMTOKCS.DOS ~ ~ ~".
  2302.  
  2303.                 NOTE:  The driver statement *must* be followed by
  2304.                        "<sp>~<sp>~<sp>~", where "<sp>" is a single
  2305.                        blank space character.
  2306.  
  2307.         Line 6  Insert the following lines between lines 6 and 7:
  2308.                        "DAT DOS\LTG.MSG"
  2309.                        "DAT DOS\LTGH.MSG"
  2310.  
  2311.     6.  Save the modified file.
  2312.  
  2313.     7.  Using XCOPY, copy the files in the C:\IBMLAN\RPL\DOS\TOKENRNG
  2314.         directory to a new directory C:\IBMLAN\RPL\DOS\TOKENRGC.
  2315.  
  2316.  
  2317.  
  2318.                                                                    Contents  35
  2319.  
  2320.  
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.     8.  Edit C:\IBMLAN\RPL\DOS\TOKENRGC\PROTOCOL.INI as follows:
  2329.  
  2330.         a.  Add the following statements before the [IBMTOK_MOD] section:
  2331.                 [DXME0_MOD]
  2332.                    DriverName = DXME0$
  2333.                    Bindings = IBMTOK_MOD
  2334.  
  2335.         b.  Edit the [IBMTOK_MOD] section as follows:
  2336.  
  2337.             1.  After the line "DriverName = IBMTOK$", add the line
  2338.                 "RingSpeed = <##>" (where "<##>" is either "4" or "16"
  2339.                 depending upon your ring speed).
  2340.  
  2341.     9.  Save the modified file.
  2342.  
  2343.  
  2344.    C) Updating Files for DOS RIPL
  2345.    ------------------------------
  2346.  
  2347.      To update the necessary files for DOS RIPL, do the following:
  2348.  
  2349.      1.  Edit C:\IBMLAN\RPL\RPL.MAP as follows:
  2350.  
  2351.          a.  Locate the line "YYYYYYYYYYYY DOSNDTR.CNF ..."; then copy and
  2352.              insert it as the next line just below itself.
  2353.  
  2354.          b.  Change this new line as follows:
  2355.              1)  Change "dosndtr.cnf"
  2356.                      to "dosntrca.cnf".
  2357.  
  2358.              2)  Change "DOS~TOKEN~RING~NDIS"
  2359.                      to "DOS~TR~CREDIT~CARD~NDIS".
  2360.  
  2361.              3)  Change "R_DTK_NDIS"
  2362.                      to "R_DTKCC_NDIS".
  2363.  
  2364.      2.  Save the modified file.
  2365.  
  2366.  
  2367.    D) Creating Files for OS/2 RIPL
  2368.    -------------------------------
  2369.  
  2370.      To create the necessary files for OS/2 RIPL, do the following:
  2371.  
  2372.      1.  In the C:\IBMLAN\RPL directory, copy the file OS221ET.CNF
  2373.          to OS221TRC.CNF.
  2374.  
  2375.      2.  Edit C:\IBMLAN\RPL\OS221TRC.CNF as follows:
  2376.  
  2377.          Line 1  Change "(IBM PS/2 Adapters for Ethernet)"
  2378.                      to "(IBM Token Ring Credit Card)".
  2379.  
  2380.          Line 8  Change "DAT DOS\PROTOCOL.INI"
  2381.                      to "DAT DOS\TOKENRGC\PROTOCOL.INI".
  2382.  
  2383.  
  2384.   36
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.          Line 14 Change "DRV DOS\MACETH.DOS ~ ~ ~"
  2396.                      to  DRV DOS\IBMTOKCS.DOS ~ ~ ~".
  2397.  
  2398.                  NOTE:  The driver statement *must* be followed by
  2399.                         "<sp>~<sp>~<sp>~", where "<sp>" is a single
  2400.                         blank space character.
  2401.  
  2402.          Line 7  Insert the following lines immediately below line 7:
  2403.                         "DAT DOS\LTG.MSG"
  2404.                         "DAT DOS\LTGH.MSG"
  2405.  
  2406.      3.  Save the modified file.
  2407.  
  2408.      4.  Using XCOPY, copy the files in the C:\IBMLAN\RPL\IBMCOM\TOKENRNG
  2409.          directory to a new directory C:\IBMLAN\RPL\IBMCOM\TOKENRGC.
  2410.  
  2411.      5.  Edit C:\IBMLAN\RPL\IBMCOM\TOKENRGC\CONFIG.20 as follows:
  2412.  
  2413.          Line 45     Delete the REM at the beginning of the statement.
  2414.  
  2415.          Line 47     Add a REM at the beginning of the statement.
  2416.  
  2417.          Lines 58-60 Delete the REM at the beginning of each line.
  2418.  
  2419.          Lines 63-66 Add a REM at the beginning of each line.
  2420.  
  2421.      6.  Save the modified file.
  2422.  
  2423.      7.  Edit C:\IBMLAN\RPL\IBMCOM\TOKENRGC\CONFIGRI.20 as follows:
  2424.  
  2425.          Lines 55, 57 and 60
  2426.                  Delete the REM at the beginning of each line.
  2427.  
  2428.          Lines 56, 58, 59 and 61
  2429.                  Add a REM at the beginning of each line.
  2430.  
  2431.      8.  Save the modified file.
  2432.  
  2433.      9.  Edit C:\IBMLAN\RPL\IBMCOM\TOKENRGC\PROTOCOL.INI as follows:
  2434.  
  2435.          1.  After the last parameter in the [IBMTOK_nif] section, add
  2436.              the line "ram = 0xd800".
  2437.  
  2438.      10. Save the modified file.
  2439.  
  2440.  
  2441.    E) Updating Files for OS/2 RIPL
  2442.    -------------------------------
  2443.  
  2444.      To update the necessary files for OS/2 RIPL, do the following:
  2445.  
  2446.      1.  Edit C:\IBMLAN\RPL\RPL.MAP as follows:
  2447.  
  2448.  
  2449.  
  2450.                                                                    Contents  37
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.  
  2460.          a.  Locate the line "YYYYYYYYYYYY OS221TR.CNF ..."; then copy
  2461.              and insert it as the next line just below itself.
  2462.  
  2463.          b.  Change this new line as follows:
  2464.  
  2465.              1)  Change "os221tr.cnf"
  2466.                      to "os221trc.cnf".
  2467.  
  2468.              2)  Change "OS2~2.1~TOKEN~RING"
  2469.                      to "OS2~2.1~TR~CREDIT~CARD".
  2470.  
  2471.              3)  Change "R_21_OTK"
  2472.                      to "R_21_OTKCC".
  2473.  
  2474.      2.  Save the modified file.
  2475.  
  2476.      3.  Edit C:\IBMLAN\RPL\NDISDD.PRO as follows:
  2477.  
  2478.          a.  Add the line, "IBMTOKCS.DOS TOKENRGC", before the line
  2479.              containing "IBMTOK.DOS TOKENRNG".
  2480.  
  2481.          b.  Leave one blank line at the end of the file.
  2482.  
  2483.      4.  Save the modified file.
  2484.  
  2485.   --------------------------------------------------------------------------
  2486.   V) Starting the Server
  2487.  
  2488.    To start the server, do the following:
  2489.  
  2490.    1.  Run NET START SRV if you didn't choose to automatically start the
  2491.        server during machine startup.
  2492.  
  2493.    2.  Run LOGON.EXE and log onto the network using a userid of USERID and
  2494.        a password of PASSWORD.
  2495.  
  2496.    3.  Run GETRPL.EXE.
  2497.  
  2498.    4.  From a full-screen OS/2 session, run NET.EXE.
  2499.  
  2500.        NOTE:  In the NET.EXE screens, use the Spacebar to select or
  2501.               deselect a list item.  Use function key F10 to switch to
  2502.               menu bar items.
  2503.  
  2504.   --------------------------------------------------------------------------
  2505.   VI) Creating a Model for OS/2 Requester Profiles
  2506.  
  2507.    To create a Family 1 (non-PS/2) OS/2 requester profile, you first need to
  2508.    create a model machine.  Do the following:
  2509.  
  2510.    1.  At the NET MAIN PANEL screen, select DEFINITIONS, and then
  2511.        MACHINE PARAMETERS.
  2512.  
  2513.    2.  Select --NEW--, ACTIONS, and CREATE.
  2514.  
  2515.  
  2516.   38
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.  
  2527.    3.  Select REMOTE IPL WORKSTATION.
  2528.  
  2529.    4.  Complete the following fields as shown:
  2530.  
  2531.             Machine Id            : FAM1_21
  2532.             Description           : Model for non-PS/2 RIPL workstation
  2533.             Network Adapter Number: (pick an adapter number that will not be
  2534.                                      used and that will not conflict any
  2535.                                      existing default model machines in
  2536.                                      C:\IBMLAN\RPL\RPL.MAP
  2537.                                      (example: 10005FFFFFFE))
  2538.             Remote IPL Server Id  : (the server's name)  (press F4 to list)
  2539.             Server Record Id      : R_21_OTK             (press F4 to list)
  2540.  
  2541.    5.  Press ENTER.
  2542.  
  2543.    6.  Complete the following field as shown:
  2544.  
  2545.             File Index Table to model: FITS\DEFALT21     (press F4 to list)
  2546.  
  2547.    7.  Press ENTER; then exit NET.EXE.
  2548.  
  2549.    8.  Edit C:\IBMLAN\RPL\FITS\FAM1_21.FIT as follows:
  2550.  
  2551.        a)  Insert a semicolon at the beginning of the line beneath
  2552.            "PS/2 Machines".
  2553.  
  2554.        b)  Remove the semicolon at the beginning of the line beneath
  2555.            "AT Machines".
  2556.  
  2557.    9.  Save the modified file.
  2558.  
  2559.    10. Edit C:\IBMLAN\RPL\MACHINES\FAM1_21\CONFIG.20 as follows:
  2560.  
  2561.        Line 45     Delete the REM at the beginning of the statement.
  2562.  
  2563.        Line 47     Add a REM at the beginning of the statement.
  2564.  
  2565.        Lines 58-60 Delete the REM at the beginning of each line.
  2566.  
  2567.        Lines 63-66 Add a REM at the beginning of each line.
  2568.  
  2569.    11. Save the modified file.
  2570.  
  2571.    12. Edit C:\IBMLAN\RPL\MACHINES\FAM1_21\CONFIGRI.20 as follows:
  2572.  
  2573.        Lines 55, 57 and 60
  2574.                Delete the REM at the beginning of each line.
  2575.  
  2576.        Lines 56, 58, 59 and 61
  2577.                Add a REM at the beginning of each line.
  2578.  
  2579.    13. Save the modified file.
  2580.  
  2581.  
  2582.                                                                    Contents  39
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.    14. Run NET.EXE from a full-screen OS/2 session.
  2594.  
  2595.    +--- WHAT TO DO NEXT --------------------------------------------+
  2596.    |                                                                |
  2597.    | o   If you want to configure a DOS RPL requester file,         |
  2598.    |     continue with the next section, "Configuring a DOS RPL     |
  2599.    |     Requester Profile".                                        |
  2600.    |                                                                |
  2601.    | o   If you want to configure an OS/2 RPL requester file, go    |
  2602.    |     to section VIII, "Configuring an OS/2 RPL Requester        |
  2603.    |     Profile".                                                  |
  2604.    |                                                                |
  2605.    | o   If you want to configure a selectable RPL requester file,  |
  2606.    |     go to section IX, "Configuring a Selectable Boot RPL       |
  2607.    |     Requester Profile".                                        |
  2608.    |                                                                |
  2609.    +----------------------------------------------------------------+
  2610.  
  2611.   --------------------------------------------------------------------------
  2612.   VII) Configuring a DOS RPL Requester Profile
  2613.  
  2614.    To configure a DOS RPL requester profile, do the following:
  2615.  
  2616.    1.  At the NET MAIN PANEL screen, select DEFINITIONS, followed by MACHINE
  2617.        PARAMETERS.
  2618.  
  2619.    2.  Select --NEW--, ACTIONS, and CREATE.
  2620.  
  2621.    3.  Select REMOTE IPL WORKSTATION.
  2622.  
  2623.    4.  Complete the following fields as shown:
  2624.  
  2625.             Machine Id            : (choose a unique machine ID)
  2626.             Network Adapter Number: (see the label on the adapter; it should
  2627.                                      begin with 10005AF or 08005AF)
  2628.             Remote IPL Server Id  : (the server's name)  (press F4 to list)
  2629.             Server Record Id      : R_DTKCC_NDIS         (press F4 to list)
  2630.  
  2631.    5.  Press ENTER.
  2632.  
  2633.    6.  Complete the following field as shown:
  2634.  
  2635.             Image Id              : STD3H500             (press F4 to list)
  2636.  
  2637.    7.  Press ENTER.
  2638.  
  2639.   --------------------------------------------------------------------------
  2640.   VIII) Configuring an OS/2 RPL Requester Profile
  2641.  
  2642.    To configure an OS/2 RPL requester profile, do the following:
  2643.  
  2644.    1.  At the NET MAIN PANEL screen, select DEFINITIONS, followed by MACHINE
  2645.        PARAMETERS.
  2646.  
  2647.  
  2648.   40
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.    2.  Select --NEW--, ACTIONS, and CREATE.
  2660.  
  2661.    3.  Select REMOTE IPL WORKSTATION.
  2662.  
  2663.    4.  Complete the following fields as shown:
  2664.  
  2665.             Machine Id            : (choose a unique machine ID)
  2666.             Network Adapter Number: (see the label on the adapter; it should
  2667.                                      begin with 10005AF or 08005AF)
  2668.             Remote IPL Server Id  : (the server's name)  (press F4 to list)
  2669.             Server Record Id      : R_21_OTKCC           (press F4 to list)
  2670.  
  2671.    5.  Press ENTER.
  2672.  
  2673.    6.  Complete the following field as shown:
  2674.  
  2675.             File Index Table to model: FITS\FAM1_21      (press F4 to list)
  2676.  
  2677.    7.  Press ENTER.
  2678.  
  2679.   --------------------------------------------------------------------------
  2680.   IX) Configuring a Selectable Boot RPL Requester Profile
  2681.  
  2682.    You can start both OS/2 and DOS on the same requester.  To configure a
  2683.    single RPL requester profile that allows you to start either OS/2 or DOS,
  2684.    do the following:
  2685.  
  2686.    NOTE:  This procedure assumes that an OS/2 requester profile has already
  2687.           been created for your RPL workstation.   If this is not the case,
  2688.           go back to section VIII, "Configuring an OS/2 RPL Requester
  2689.           Profile".
  2690.  
  2691.           Although in this procedure the OS/2 requester configuration is
  2692.           performed before the DOS requester configuration, either
  2693.           order will work.
  2694.  
  2695.    1.  Run NET.EXE from a full-screen OS/2 session.
  2696.  
  2697.    2.  At the NET MAIN PANEL screen, select DEFINITIONS, followed by MACHINE
  2698.        PARAMETERS.
  2699.  
  2700.    3.  At the MANAGE MACHINE PARAMETERS screen, select the requester profile
  2701.        name, then ACTIONS, then UPDATE.
  2702.  
  2703.    4.  Change the Server Record Id field from "R_21_OTKCC" to "R_DTKCC_NDIS".
  2704.  
  2705.        NOTE:  Press F4 while in the field to list the possible values.
  2706.  
  2707.    5.  Press ENTER.
  2708.  
  2709.    6.  Complete the following field as shown:
  2710.  
  2711.             Image Id              : STD3H500             (press F4 to list)
  2712.  
  2713.  
  2714.                                                                    Contents  41
  2715.  
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.    7.  Select your requester profile name, then ACTIONS, then DISABLE.
  2726.  
  2727.    8.  Select your requester profile name, then ACTIONS, then ENABLE.
  2728.  
  2729.    9.  Select which Server Record Id you want to use.
  2730.  
  2731.    10. Press ENTER.
  2732.  
  2733.   --------------------------------------------------------------------------
  2734.   X) Starting RIPL Service
  2735.  
  2736.    To start the RIPL service, do the following:
  2737.  
  2738.    1.  End NET.EXE.
  2739.  
  2740.    2.  Run NET START RPL or NET START REMOTEBOOT.  If more than one
  2741.        server is connected to your requester workstation, make sure that
  2742.        one of the following configurations exist:
  2743.  
  2744.        o   Each requester workstation's adapter address is configured on
  2745.            only one server
  2746.  
  2747.        o   All servers configured for a given requester workstation's
  2748.            adapter address are configured identically.
  2749.  
  2750.   --------------------------------------------------------------------------
  2751.   XI) Running the Token-Ring Credit Card Adapter Diagnostics
  2752.  
  2753.     The token-ring credit card diagnostics are currently run under DOS.  To
  2754.     run them, simply RIPL DOS to your requester, then run the diagnostics
  2755.     on the requester as you would any other program (from the diskette drive,
  2756.     from the server, etc.).
  2757.  
  2758.   ==========================================================================
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.   1.11  REQUESTING DEVICE ERROR/STATUS MESSAGES
  2765.   _____________________________________________
  2766.  
  2767.   Each type of message you may see on the requesting device display is shown on
  2768.   the sample screen below and described on the following pages.
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.   42
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.   +----------------------------------------------------------------------------------+
  2792.   |                                                                                  |
  2793.   | ET-00:00:45                                                                      |
  2794.   | ID-166                                                                           |
  2795.   | CE-0085                                                                          |
  2796.   | BU-0000                                                                          |
  2797.   | AA-10005A000567                                                                  |
  2798.   | AL-00 0000 B001253                                                               |
  2799.   | BL-00112233                                                                      |
  2800.   | MM-CC00 02                                                                       |
  2801.   | IO-8000                                                                          |
  2802.   | SR-D800 08                                                                       |
  2803.   | OP-0000 04                                                                       |
  2804.   |                                                                                  |
  2805.   | RQ-0001                                                                          |
  2806.   | SF-0001                                                                          |
  2807.   | SN-0023                                                                          |
  2808.   | DS-0080                                                                          |
  2809.   | RS-0040                                                                          |
  2810.   | PC-4020                                                                          |
  2811.   | AC-0040 0000 0000 0000                                                           |
  2812.   |                                                                                  |
  2813.   | AE-249 XX-0011                                                                   |
  2814.   |                                                                                  |
  2815.   +----------------------------------------------------------------------------------+
  2816.  
  2817.  
  2818.  
  2819.   1.11.1  REQUESTING DEVICE MESSAGE DESCRIPTIONS
  2820.  
  2821.   Each  error  message  is  presented  in the same order as shown on the sample
  2822.   screen.
  2823.  
  2824.  
  2825.   ET-00:00:45
  2826.  
  2827.         EXPLANATION:  Elapsed Time.   A continuously updated  field  indicating
  2828.         the elapsed time since the RPL Feature gained control.
  2829.  
  2830.   ID-166.
  2831.  
  2832.         EXPLANATION:   Identification.  An indication of which adapter is using
  2833.         the RPL function, where nnn is the adapter identifier.
  2834.                                 ___
  2835.  
  2836.         o   A value of 16n identifies all other Token-Ring adapters where:
  2837.                          _
  2838.  
  2839.             -   A value of 166 indicates the primary adapter.
  2840.             -   A value of 167 indicates the alternate adapter.
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.                                                                    Contents  43
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.   CE-0085
  2860.  
  2861.         EXPLANATION:   Configuration  Error.    A configuration error was found
  2862.         during the computer's Power-On Self Test (POST).   If this  message  is
  2863.         displayed,  you  will  continue to see this message every time the com-
  2864.         puter is powered on, unless you take action to correct your  computer's
  2865.         configuration.  To correct this error permanently, you need to use con-
  2866.         figuration   information   from  an  IBM  Personal  System/2  Reference
  2867.         Diskette.  Configuration information must be requested from the loading
  2868.         device.    This request is done automatically by the RPL Feature.(1) If
  2869.         this error occurs on a computer that has a Token-Ring adapter with 16/4
  2870.         Mbps capability, a message will be displayed in reverse video  and  you
  2871.         will  have  the opportunity to temporarily change the adapter data rate
  2872.         to match the ring data rate of the network.   Select the  adapter  data
  2873.         rate matching your network, using the F4 key to select a 4 Mbps rate or
  2874.         the  F6  key  to  select  a 16 Mbps rate.   To permanently correct this
  2875.         error, proceed as described above.
  2876.  
  2877.   BU-0000
  2878.  
  2879.         EXPLANATION:  Bring-Up.   This field is displayed  as  X'0000'  if  the
  2880.         adapter  has  been successfully initialized and opened.  If not, a code
  2881.         other than X'0000' is displayed and the field is highlighted.
  2882.  
  2883.   AA-10005A000567
  2884.  
  2885.         EXPLANATION:  Adapter Address.  The permanently encoded address of  the
  2886.         Token-Ring adapter in the requesting device.  This address is always 12
  2887.         hexadecimal characters (6 bytes) long.
  2888.  
  2889.   AL-00 0000 B001253
  2890.  
  2891.         EXPLANATION:   Adapter Level.  The Engineering Change (EC) level of the
  2892.         code on the IBM Token-Ring Network adapter.
  2893.  
  2894.   BL-00112233
  2895.  
  2896.         EXPLANATION:  BIOS Level (Module Level).  The Engineering  Change  (EC)
  2897.         level of the code in the RPL Feature.
  2898.  
  2899.   MM-CC00 02
  2900.  
  2901.         EXPLANATION:   Memory  (Read-Only Memory).   The first 4 digits are the
  2902.         hexadecimal ROM address set on the adapter.  The last 2 digits are  the
  2903.         interrupt  level set on the adapter.  See the operator's guide for your
  2904.         IBM Token-Ring Network adapter.  for more information.
  2905.  
  2906.  
  2907.  
  2908.  
  2909.   ---------------
  2910.  
  2911.   (1) If your requesting device has a diskette drive, you may reconfigure  your
  2912.       computer directly using an IBM Personal System/2 Reference Diskette.
  2913.  
  2914.  
  2915.   44
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.   IO-8000
  2926.  
  2927.         EXPLANATION:   I/O  Address.    This  field  specifies  the  base Micro
  2928.         Channel* address in the memory map.
  2929.  
  2930.   SR-D800 08
  2931.  
  2932.         EXPLANATION:  Shared RAM.   The first  4  digits  are  the  hexadecimal
  2933.         shared  RAM  address  that the adapter uses.  The last 2 digits are the
  2934.         shared RAM size (in decimal).   "08" indicates 8 kilobytes  (8  KB)  of
  2935.         memory, "16" indicates 16 KB of memory, "32" indicates 32 KB of memory,
  2936.         and "64" indicates 64 KB of memory.
  2937.  
  2938.         NOTE:
  2939.  
  2940.   OP-0000 04
  2941.  
  2942.         EXPLANATION:  Open Return Code.  The first 4 digits are X'0000' and the
  2943.         last  2  digits identify the adapter data rate, if the adapter has been
  2944.         successfully opened and attached to the ring.   If not,  a  code  other
  2945.         than X'0000' is displayed and the field is highlighted, flashing, or in
  2946.         reverse  video.    If  the field is shown in reverse video, the adapter
  2947.         data rate may not match the ring data rate of the  network.    You  may
  2948.         temporarily  correct  this  problem using the F4 key to select a 4 Mbps
  2949.         rate or the F6 key to select a 16 Mbps rate.  To correct  this  problem
  2950.         permanently, you need to use configuration information from an IBM Per-
  2951.         sonal System/2 Reference Diskette.
  2952.  
  2953.   RQ-0001
  2954.  
  2955.         EXPLANATION:   Request  Count  (FIND  Frame  Count).    The  number (in
  2956.         hexadecimal) of FIND frames that have been transmitted.   An  excessive
  2957.         request  count  (greater  than  10,  for  instance)  indicates that the
  2958.         loading device.  is either not present or is congested.
  2959.  
  2960.   SF-0001
  2961.  
  2962.         EXPLANATION:   SEND.FILE.REQUEST  Frame   Count.      The   number   of
  2963.         SEND.FILE.REQUEST  frames  that  have  been transmitted.   An excessive
  2964.         SEND.FILE.REQUEST frame count (greater than 10, for instance) indicates
  2965.         that the loading device.  is not responding after having been found.
  2966.  
  2967.   SN-0023
  2968.  
  2969.         EXPLANATION:  File Response Sequence Number.  This value  is  displayed
  2970.         when  the  loading  device  has responded to the SEND.FILE.REQUEST.  It
  2971.         indicates how many times  valid  FILE.DATA.RESPONSE  frames  have  been
  2972.         received.
  2973.  
  2974.  
  2975.  
  2976.  
  2977.  
  2978.  
  2979.  
  2980.  
  2981.                                                                    Contents  45
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.  
  2991.   DS-0080
  2992.  
  2993.         EXPLANATION:   DLC  Status.   The message provided by the adapter if an
  2994.         unexpected Data Link Control (DLC) condition occurs.
  2995.  
  2996.         NOTE:
  2997.  
  2998.         The values displayed are  useful  to  the  person  writing  the  loader
  2999.         program  or for analysis of a complex DLC problem on the network.  Some
  3000.         values may be displayed that are a combination  of  the  values  listed
  3001.         below.
  3002.  
  3003.         NOTE:
  3004.  
  3005.         +-------+--------------------------------------+----------------------+
  3006.         | HEX   |                                      | LOAD REQUESTER       |
  3007.         | VALUE | MEANING                              | ACTION               |
  3008.         +-------+--------------------------------------+----------------------+
  3009.         | X'8000| Link lost                            | Issue a close        |
  3010.         |       |                                      | station CCB          |
  3011.         +-------+--------------------------------------+----------------------+
  3012.         | X'4000| DM or DISC                           | Issue a close        |
  3013.         |       |                                      | station CCB          |
  3014.         +-------+--------------------------------------+----------------------+
  3015.         | X'2000| FRMR received                        | Issue a close        |
  3016.         |       |                                      | station CCB and      |
  3017.         |       |                                      | PROGRAM.ALERT frames |
  3018.         +-------+--------------------------------------+----------------------+
  3019.         | X'1000| FRMR sent                            | Issue a close        |
  3020.         |       |                                      | station CCB and      |
  3021.         |       |                                      | PROGRAM.ALERT frames |
  3022.         +-------+--------------------------------------+----------------------+
  3023.         | X'0800| SABME received                       | Issue a connect      |
  3024.         |       |                                      | station CCB          |
  3025.         +-------+--------------------------------------+----------------------+
  3026.         | X'0400| SABME received, link opened          | Issue a connect      |
  3027.         |       |                                      | station CCB          |
  3028.         +-------+--------------------------------------+----------------------+
  3029.         | X'0200| Remote is busy                       | Ignore               |
  3030.         +-------+--------------------------------------+----------------------+
  3031.         | X'0100| Remote not busy                      | Ignore               |
  3032.         +-------+--------------------------------------+----------------------+
  3033.         | X'0080| Inactivity Timer (Ti) expired        | Ignore               |
  3034.         +-------+--------------------------------------+----------------------+
  3035.         | X'0040| DLC overflow                         | Ignore               |
  3036.         +-------+--------------------------------------+----------------------+
  3037.         | X'0020| Priority change                      | Ignore               |
  3038.         +-------+--------------------------------------+----------------------+
  3039.         | X'0001| Local busy                           | Not set by requester |
  3040.         +-------+--------------------------------------+----------------------+
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.   46
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.   RS-0040
  3058.  
  3059.         EXPLANATION:   Ring Status.   This field displays a code indicating the
  3060.         status of the ring.  The field will be  highlighted  if  the  operation
  3061.         cannot continue; it will not be highlighted if processing can continue.
  3062.  
  3063.   PC-4020
  3064.  
  3065.         EXPLANATION:   IBM  Personal Computer or IBM Personal System/2 computer
  3066.         error.  This field displays an error code indicating that  the  adapter
  3067.         has  difficulty  in  functioning with the computer.  In most cases, the
  3068.         screen will be frozen and this field will be  highlighted  because  the
  3069.         adapter cannot continue.
  3070.  
  3071.   AC-0040 0000 0000 0000
  3072.  
  3073.         EXPLANATION:   Adapter  Check.    The  adapter has detected an internal
  3074.         error and cannot continue.
  3075.  
  3076.         Restart your computer.  If this problem persists  have  your  computer,
  3077.         including the adapter, serviced.  Record the adapter check code to give
  3078.         to the service person when the computer is serviced.
  3079.  
  3080.   AE-249 XX-0011
  3081.  
  3082.         EXPLANATION:   Adapter Error.  The adapter in the &rd. could not estab-
  3083.         lish communication with the &ld..  The adapter identifier is nnn, where
  3084.                                                                      ___
  3085.         nnn can have one of the following values:
  3086.         ___
  3087.  
  3088.         o   A value of 16n identifies all other Token-Ring adapters where:
  3089.                          _
  3090.  
  3091.             -   A value of 166 indicates the primary adapter.
  3092.             -   A value of 167 indicates the alternate adapter.
  3093.  
  3094.         The reason for this error is indicated in the XX message to  the  right
  3095.         of  AE-nnn  XX  may  be  either BU or OP.   The BU and OP messages were
  3096.                ___
  3097.         described previously.
  3098.  
  3099.   For a list of compatible notebook computers, dial 1-800-643-7409 (U.S.A.  and
  3100.   Canada).
  3101.  
  3102.   Toshiba is a trademark of Toshiba America, Incorporated.  Dell is a trademark
  3103.   of  Dell  Computer  Corp,  Incorporated.   AST is a trademark of AST Research
  3104.   Incorporated.  NCR is a trademark of the NCR Corporation.  INTEL is a  trade-
  3105.   mark of the INTEL Corporation.  NEC is a trademark of the NEC Corporation.
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.                                                                    Contents  47
  3118.  
  3119.  
  3120.  
  3121.