home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / rxneterr.zip / neterr.doc < prev    next >
Text File  |  2001-01-01  |  3KB  |  108 lines
  1. - read and clear LAN errors from OS/2 LAN servers
  2.  
  3. 1. Introduction
  4.  
  5. The user is assumed to be familiar with the OS/2 LAN server
  6.  
  7.  History:
  8.  94/06/20 - original version by courtesy of WoFa93
  9.  
  10.  Function
  11.  - read and clear LAN errors
  12.  Call
  13.          NETERR        /optionlist
  14.  Options
  15.         Clear    - clear log (default: only read)
  16.         Verbose  - chat heavily
  17.         Quiet    - no chat      (default)
  18.         Logging  - write to logfile (default: no write)
  19.         LOCal    - local error file only (default: all servers)
  20.  ReturnCodes
  21.    0 - all done (boolean false)
  22.    1 - Help requested (boolean true)
  23.    2 - REXX Syntax error
  24.    3 - User interrupted
  25.  Notes
  26.    NONE
  27.  
  28.  
  29. 2. What is NETERR.CMD ?
  30.  
  31. NETERR.CMD reads the error log from OS/2 LAN servers, assigns
  32. the associated error message, and writes a file,displaying all
  33. entries found in the  error log, including raw data.
  34.  
  35. On request via /CLEAR switch, it deletes the error entries in the
  36. LAN server.
  37.  
  38. For each server found in the current domain, a file <ServerName.ERR>
  39. is written unless instructed otherwise with the LOCAL switch which
  40. only reads the local LAN error entries.
  41.  
  42.  
  43. 3. Corequisites/Prerequisites
  44.  
  45. The following DLLs are required:
  46.  
  47. - REXXUTIL (supplied with OS/2 operating system)
  48.   This must be installed with OS/2 classic REXX
  49. - LSRXUTIL (supplied with OS/2 LAN server)
  50.   This file LSRXUT.DLL is included in this package
  51.  
  52. The NETERR.TAB file must be placed in the directory, from which
  53. the NETERR command is invoked.
  54.  
  55. The NETERR.TAB file is an error table, containing prepared error
  56. numbers and their meanings. It is derived from the LAN Server
  57. source file \IBMLAN\ERROR.TXT by the command ERRTAB.
  58.  
  59. Other COs or PREs aren't known.
  60.  
  61.  
  62. 4. Installation:
  63.  
  64. Copy the NETERR.CMD file into a subdirectory which is included in
  65. the PATH statement in CONFIG.SYS.
  66.  
  67. Copy the NETERR.TAB file into the same subdirectory.
  68.  
  69. Assure that REXXUTIL.DLL and LSRXUTIL.DLL are in a subdirectory
  70. which is included in the LIBPATH statement in CONFIG.SYS.
  71.  
  72. That's all
  73.  
  74.  
  75. 5. What does NETERR ?
  76.  
  77. If all servers are requested, a list of servers is retrieved from
  78. then current domain controller. Otherwise, the program assumes
  79. that only the local error log should be scanned.
  80.  
  81. For each requested server, the error log is read. Each error entry
  82. consists of errordate, errornummber, and errordata.
  83.  
  84. The NETERR.TAB is scanned for the associated error message.
  85. A record is written to the file <servername.LOG>, where servername
  86. is derived from the list of servers found in this domain. If only
  87. local scanning is performed, servername matches the local machinename.
  88.  
  89. For ease of interpretation, the errordata is displayed in raw data
  90. form, including unreadable characters, and a hexadecimal representation.
  91.  
  92. If the /Clear switch is on, the error entries are deleted.
  93.  
  94.  
  95. 6. Parms and Options
  96.  
  97. No parameters are defined
  98.  
  99. Options are:
  100.  
  101. /Verbose - give messages during the run
  102. /Silent  - be quiet
  103. /Logging - write messages to a log file named yyddd.LOG
  104.            where yy is the current year
  105.            and  ddd is the current julian day of the year
  106. /Nirvana - when finished close the whole OS/2 session
  107.  
  108.