home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / REACTX.ZIP / REACTX25 / REACTX25.DOC
Text File  |  1991-12-06  |  3KB  |  81 lines
  1.  
  2.  
  3.  Version 1.0 (c) Copyright International Business Machines Corp., 1989, 1991
  4.  
  5.  
  6.  REACTX25 SAMPLE APPLICATION
  7.  
  8.  The REACTX25 sample program reactivates the X.25 adapter
  9.  when an adapter failure occurs.  Many adapter failures can
  10.  be recovered after the adapter is shut down.  This program
  11.  issues the SET_USER_LOG_QUEUE verb to wait for an error of
  12.  type 0017.  If this is a subtype 2 then either a link
  13.  failure or an adapter failure occured.  This module assumes
  14.  an adapter failed.  The DISCONNECT_PHYSICAL_LINK and
  15.  CONNECT_PHYSICAL_LINK verbs are then issued until the
  16.  CONNECT_PHYSICAL_LINK verb returns with a non zero return
  17.  code.  The Communications Manager periodically reactivates
  18.  the DLC so that when this X.25 is reconnected the DLC
  19.  should be automatically reactivated.  It is still up to the
  20.  application to reactivate the link either explicitly or by
  21.  attempting to use it again.
  22.  
  23.  The sample programs are designed to work in the OS/2 pro-
  24.  tected mode, with the Communications Manager of the OS/2
  25.  Extended Services.  The sample program source code and the
  26.  supporting files are for C only.
  27.  
  28.  PREREQUISITES
  29.  
  30.  To run the sample program, a user must be familiar with the
  31.  following things:
  32.  
  33.  1.  OS/2 installation and command prompt
  34.  
  35.  2.  Communications Manager installation
  36.  
  37.  3.  C language compiler
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  COMPILE and LINK
  46.  
  47.  There is only one sample program for reactivating the X.25
  48.  adapter.  Copy all the files with the filename of REACTX25
  49.  into the C source code subdirectory.  The files to be
  50.  copied are the Source code (.C extension), Module
  51.  definition (.DEF extension), Make file (no extension), and
  52.  the Link response (.LRF extension).
  53.  
  54.  This sample program will need to access ACSMGTC.H and
  55.  ACSSVC.H.  These include files should be in the \CMLIB
  56.  subdirectory.
  57.  
  58.  Set up the environment for the C compiler according to the
  59.  compilers instructions.
  60.  
  61.  
  62.  To compile and link the sample program, type the following
  63.  at the OS/2 command prompt:
  64.  
  65.  
  66.  [C:\SRC]make reactx25 [Press Enter]
  67.  
  68.  After the above procedure, the executable file REACTX25.EXE
  69.  will be created.
  70.  
  71.  
  72.  RUNNING THE SAMPLE PROGRAM
  73.  
  74.  The sample program can be either executed at the command
  75.  line or in the STARTUP.CMD file.  There are no parameters.
  76.  The sample program will display messages to the screen
  77.  indicating the status of the program.  If REACTX25.EXE is
  78.  started before the Communications Manager then it will wait
  79.  for Communications Manager to start.
  80.  
  81.