home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / REACTDLC.ZIP / reactdlc.doc < prev    next >
Text File  |  1992-12-21  |  4KB  |  94 lines
  1.  
  2. This program is intended to assist the Communications Manager in
  3. recovering from an adapter failure.  The source code may be included
  4. in more complex applications or it may run standalone.
  5.  
  6. An adapter failure causes the Communications Manager to close the
  7. adapter and it can not be used again until it is reopened.  There are
  8. many things that can happen that can cause an adapter failure,
  9. without a hardware failure occurring in the adapter.  Some failures
  10. however are Link failures and can be reestablished by the application
  11. attempting to use the link again.  In the case of an adapter
  12. failure manual intervention would normally be required without
  13. this program or one like it.
  14.  
  15. Notes:
  16.  
  17.     1. When an adapter fails this program will attempt
  18.        to reactivate the DLC at regular intervals.  If
  19.        the adapter is in a condition such that it can not
  20.        reactivated successfully then this program may
  21.        attempt many times.  Each attempt will cause one
  22.        or two errors to be logged.  For this reason the
  23.        error log is copied to another file for safe keeping.
  24.        Also the error log should be configured to WRAP
  25.        instead of extend as the error log could grow very
  26.        large in some unattended situations.
  27.  
  28.     2. Messages should be configured not to pop up because
  29.        adapter failures generate pop up messages and many
  30.        could get queued to the screen.
  31.  
  32.     3. The ACTIVATE_DLC verb is not officially 'external'.
  33.        Communications Manager reserves to right to modify
  34.        the verb control block if necessary.
  35.  
  36.     4. Link failures also create error log type 17 subtype 2
  37.        entries and this program does not distinguish
  38.        between the two.  If ACTIVATE_DLC is issued when
  39.        the DLC is open then no harm is done only a return
  40.        code indicating DUPLICATE_DLC.
  41.  
  42.     5. This program must be started before the adapter failure
  43.        occurs.  It will not recover from and adapter failure
  44.        if it is not active during the failure.
  45.  
  46.     6. This program runs in a fullscreen session and writes
  47.        status messages to the screen.  It may be started in
  48.        STARTUP.CMD.  It does require CM to be active and will
  49.        check every 30 seconds until it is available.
  50.  
  51.  
  52. Package Contents:
  53.  
  54.        REACTDLC CBIN     -  Source code for SDLC
  55.        REACTDLC DEFBIN   -  Def file
  56.        REACTDLC LRFBIN   -  Link response file
  57.        REACTDLC MAKBIN   -  Make file
  58.        REACTDLC EXEBIN   -  Exec version for SDLC adapter 0
  59.        REACTDLC DOC      -  This file
  60.        REACTTR  EXEBIN   -  Exec version for Token Ring adapter 0
  61.        REACTTW  EXEBIN   -  Exec version for Twinax adapter 0
  62.        REACTANY EXEBIN   -  New function  -  see below
  63.  
  64. Format:     REACTDLC time_interval
  65.  
  66.     time_interval - Time between attempts to restart the
  67.                     the adapter with ACTIVATE_DLC.  The
  68.                     time is in seconds and the minimum is
  69.                     45 seconds.  This allows time for the
  70.                     adapter to determine an error condition
  71.                     after reactivating.
  72.  
  73. Example:    REACTDLC 50
  74.  
  75.  
  76. **************************************************************
  77.  
  78.  
  79. New Function:   REACTANY EXEBIN
  80.  
  81.  This executable requires three parameters.
  82.  
  83.    1.  Time Interval  -  Number of seconds between 45 and 1000
  84.    2.  DLC Name       -  'IBMTRNET', 'IBMPCNET', 'ETHERAND',
  85.                          'SDLC', or 'TWINAX'
  86.    3.  Adapter number -  '0' or '1'
  87.  
  88. Example:    REACTANY 50 IBMTRNET 0
  89.  
  90.  Using this version any DLC and Adapter number combination can
  91.  be reactivated.  It still will only support one DLC and adapter
  92.  number combination.  It will not recover X.25 adapter failures.
  93.  
  94.