home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / mail / jet114.zip / JETMAIL.FIX < prev    next >
Text File  |  1992-10-20  |  14KB  |  293 lines
  1. JetMail Diagnostic Reference
  2. ----------------------------
  3.  
  4. If JetMail shuts down due to a fatal error, it may be as simple as a
  5. missing Spitfire system file, JetMail system file, or a problem in the
  6. DOS environment.  If the fatal/shutdown error message refers to one of
  7. the system files, please check your configuration.  If JetMail has an
  8. error otherwise, the error value should correspond to one of the items
  9. below.
  10.  
  11.   0  Error 0
  12.   1  Invalid function number
  13.   2  File not found
  14.   3  Path not found
  15.   7  Memory blocks destroyed
  16.   9  Invalid memory block address
  17.  10  Invalid environment
  18.  11  Invalid format
  19.  12  Invalid access code
  20.  13  Invalid data
  21.  15  Invalid drive specified
  22.  16  Attempt to remove CurDir
  23.  17  Not same device
  24.  18  No more files
  25.  
  26.   2  No such file or directory
  27.   4  Too many open files
  28.   5  Permission denied
  29.   6  Bad file number
  30.   8  Not enough core
  31.  15  No such device
  32.  19  Invalid argument
  33.  20  Arg list too long
  34.  21  Exec format error
  35.  22  Cross-device link
  36.  33  Math argument
  37.  34  Result too large
  38.  35  File already exists
  39.  
  40. Should JetMail return with one of the following error messages, here
  41. are some common diagnosis:
  42.  
  43. * Error opening JetMail DOOR [code 3]
  44.         JetMail must be passed the DOOR.SYS filename as the first
  45.         parameter. The filename must be named DOOR.SYS. You may specify
  46.         a path to that file, e.g. \SF\DOOR.SYS .
  47.  
  48. ERROR: Unable to open file!
  49.         One of the basic files needed for JetMail operation is missing.
  50.         This could be the JETMENU.BBS/.CLR files, if no menu is showing
  51.         up in JetMail.  Make sure the JETMENU.BBS file exists in the
  52.         JetMail home directory.
  53.  
  54. * Error opening system file SFSYSTEM.DAT.
  55.         JetMail is unable to open the SFSYSTEM.DAT file.  Is another
  56.         node on the network editing this file?
  57.  
  58. * Memory allocation error.
  59.         Not enough memory to run JetMail.  If running under DesqView,
  60.         try to allocate more memory to the node.  If that doesn't work,
  61.         then it may be an idiosyncracy with your DOS not allocating
  62.         memory in a manner compatible with JetMail.  Refer to next error
  63.         message for another remedy.
  64.  
  65. * Error [5] during spawn: Permission denied
  66.         When the SWAP= parameter is specified, JetMail will try to swap
  67.         its code onto the disk drive. If there is not enough disk space,
  68.         or if the drive & path specified for SWAP= is invalid, this
  69.         error message will quickly flash on your screen.
  70.  
  71. * Tried to allocate <x> bytes, with <y> available.
  72.         If <y> is greater than <x>, or <y> is negative, chances are that
  73.         JetMail has a memory management problem with your DOS.  This was
  74.         discovered in a pre-release version of JetMail, which somehow
  75.         triggered this idiosyncracy.  JetMail will open a memory buffer
  76.         of 64K for importing and exporting messages. This will cover a
  77.         message over 5000 lines long (even though Spitfire limits
  78.         messages to 99 lines, it might be possible in the future to
  79.         allow longer message and/or a Fidonet mail tosser might allow
  80.         more than 99 lines of text; other echo network softwares may
  81.         also allow long messages).
  82.  
  83. * Error building CONTROL.DAT file.
  84.         Common error message when JetMail is unable to access the
  85.         temporary work directory.
  86.  
  87. * Error locating user in Spitfire database.
  88.         JetMail needs to find the Spitfire user record number to
  89.         properly access the SFMSG<x>.LMR file, which contains the users'
  90.         last message read pointers for each conference.  JetMail uses
  91.         these message pointers to scan for new messages. JetMail
  92.         searches the SFUSERS.PTR file for the user named in DOOR.SYS.
  93.         You may have a corrupt DOOR.SYS, or a non-existing user using
  94.         JetMail.
  95.  
  96. * User name mismatched in SFUSERS.DAT.
  97.         This may indicate a corrupt DOOR.SYS or Spitfire users file.
  98.         This error only occurs when using the user record number to
  99.         access the SFUSERS.DAT results in a mismatched between the name
  100.         in the Spitfire database and in the DOOR.SYS.  Possibly solution
  101.         is to regenerate the AUTOJET.SYS if you are using Auto-Pilot
  102.         with a local copy of DOOR.SYS in the JetMail home directory,
  103.         which has a user record number out of sync due to a newly packed
  104.         user database.
  105.  
  106. * Error opening system file SFUSERS.DAT.
  107.         Is the user file being edited by another node?
  108.  
  109. * Error creating MESSAGES.DAT file.
  110.         JetMail writes all the new messages scanned into a file named
  111.         MESSAGES.DAT, in the QWK format.  If JetMail is unable to create
  112.         this file, it may have problems with disk space in the JetMail
  113.         work directory.
  114.  
  115. * Error building .PNT pointers file.
  116.         Unable to build the .PNT file, perhaps because of disk space.
  117.  
  118. * Error reading .PNT pointers file.
  119.         Uploaded pointers file was probably corrupt.
  120.  
  121. * Error copying .QWK packet to local destination.
  122.         JetMail was unable to copy the file to the destination, probably
  123.         disk space error.
  124.  
  125. * REP packet not found.
  126.         JetMail detected a successful file transfer, but isn't able to
  127.         find a .REP in the JetMail temporary work directory.  Be sure to
  128.         receive the .REP file into the JetMail temporary work directory
  129.         (or get the .REP file copied to the JetMail work directory).
  130.  
  131. * Error copying .REP packet from local directory.
  132.         No .REP packet was found in the specified directory during local
  133.         JetMail use.
  134.  
  135. * Error Transferring Packet
  136.         JetMail detected a non-zero exit code from the transfer protocol
  137.         program (i.e. DSZ.COM). Caller may have aborted file transfer,
  138.         file transfer timed out, or carrier lost.
  139.  
  140. * QWK not found.  Unable to run compression utility?
  141.         JetMail shells out to compress the contents of a QWK packet,
  142.         based on the PACK<x>QWK command lines specified in the JetMail
  143.         .CNF configuration, where <x> can be 1 to 3.  After returning
  144.         from the shell, JetMail finds no .QWK generated.  The selected
  145.         compression utility is needing more memory than what is
  146.         available after JetMail is loaded.  You may need to run JetMail
  147.         from the Spitfire Doors menu instead of as a menu extension.
  148.         [The command line of the PACK1QWK is passed two parameters by
  149.         JetMail, the first parameter is path and filename of the .QWK
  150.         packet to generate, and the second parameter is *.* of the
  151.         JetMail work directory.  If your compression utility is unable
  152.         to use these parameters, please contact author.]
  153.  
  154. * Error opening LMR file for Conf # <x>, or
  155. * Error reading LMR file for Conf # <x>
  156.         Spitfire automatically generates SFMSG<x>.LMR files when new
  157.         conferences are added.  If a LMR file is doesn't exist for
  158.         conference numbered <x>, check your Spitfire's message path to
  159.         make sure the conference message files are intact.  If you just
  160.         added some conferences to Spitfire, login to Spitfire first,
  161.         before running JetMail, to have Spitfire generate the LMR files
  162.         appropriately.
  163.  
  164. * Error reading user's last msg read pointer, or
  165. * Error writing user's last msg read pointer.
  166.         JetMail uses Spitfire's user record number to access the
  167.         corresponding last message read pointer for the user.  The
  168.         SFMSG<x>.LMR file may have been generated, but it wasn't
  169.         adjusted in size for the new JetMail user.
  170.  
  171. * Error building index file for .QWK packet, or
  172. * Error writing to index file.
  173.         JetMail builds <x>.NDX files for the QWK packet, which are index
  174.         files used by the offline mail reader.  The indices point to
  175.         where the messages for each conference are; actual messages are
  176.         stored in MESSAGES.DAT.  May be a disk space problem.
  177.  
  178. * Error building Personal msgs index file, or
  179. * Error writing to Personal msgs index file.
  180.         JetMail builds a PERSONAL.NDX file for the QWK packet, which are
  181.         index files used by the offline mail reader to locate messages
  182.         addressed to the user.  If there are no personal messages, the
  183.         .QWK will not have a PERSONAL.NDX.  May be a disk space problem.
  184.  
  185. * Error building MESSAGES.DAT file.
  186.         Disk space problem? Make sure the work directory you specify for
  187.         JetMail has plenty of disk space for building .QWK packets.
  188.  
  189. * PNT packet not found.
  190.         When using JetMail's "P" command to upload a pointers file, the
  191.         transfer may have been aborted, or during local use, the .PNT
  192.         file was not found in the designated directory.
  193.  
  194. * Error opening replies file.
  195.         When a .REP packet is received, JetMail will try to process that
  196.         packet for message replies to post into the Spitfire
  197.         conferences.  The .MSG file may simply be corrupt, but more
  198.         likely the compression utility used to make the .REP packet
  199.         doesn't match the user's currently configured compression
  200.         utility in JetMail.
  201.  
  202. * Error opening message base
  203.         JetMail tried to read Spitfire's conference message bases and
  204.         encountered an error.  Make sure your SFMSG<x>.* files are
  205.         intact in the Spitfire messages path.
  206.  
  207. Detected Truncated Message.
  208.         While JetMail is processing a .REP packet, it may encounter a
  209.         message reply that is corrupt.  Check the offline reader to make
  210.         sure the .REP packet generated is intact.
  211.  
  212. * Error opening JetMail configuration file.
  213.         JetMail is unable to open the default JETMAIL.CNF in the JetMail
  214.         home directory (which should be the current directory, when
  215.         JetMail is first started).  This error may also occur if the
  216.         .CNF file specified on the JetMail command line doesn't exist.
  217.         Check your batch file to make sure JetMail knows which
  218.         configuration file it is trying to read.
  219.  
  220. * Unable to find JetMail users file.
  221.         When a new user enters JetMail, JetMail records the users name
  222.         in the JetMail users database file named USERS.JET in the
  223.         JetMail home directory.  Before JetMail returns to Spitfire,
  224.         JetMail tries to write the user's JetMail configuration to the
  225.         users database.  However, if it can't find the user's name in
  226.         the users database, JetMail gets confused - after all, it was
  227.         supposed to have written the users name to the users database
  228.         when the door was first opened.
  229.  
  230. * Unable to create JetMail users file, or
  231. * Error creating JetMail users file.
  232.         Disk space error?  JetMail creates a USERS.JET user database
  233.         file to keep track of user's JetMail configuration.
  234.  
  235. * Unable to find protocols list.
  236.         JetMail tries to locate JETXFER.DAT in the JetMail home
  237.         directory by default. If you have specified the XFERDATA=
  238.         parameter, then JetMail will look for the filename specified in
  239.         the JetMail home directory; that is, if XFERDATA=JETXFER1.DAT,
  240.         then JetMail was unable to find JETXFER1.DAT in the JetMail home
  241.         directory.
  242.  
  243. * JetMail is for use with SPITFIRE 3.x only!
  244.         JetMail only works with Spitfire 3.x versions.  JetMail does
  245.         use the DOOR.SYS which Spitfire generates.
  246.  
  247. * Error making temporary JetMail work directory.
  248.         When no WORKDIR= is specified in the JetMail configuration file,
  249.         JetMail makes its own temporary work directory off of the
  250.         JetMail home directory.  However, an error was encountered
  251.         trying to make this directory, usually named TMP1.$$$ or
  252.         something like that.  Please use the WORKDIR= parameter in the
  253.         JetMail .CNF configuration file and specify a temporary work
  254.         directory for proper JetMail operation.
  255.  
  256. Unable to find SFFILES.BBS for File Area # <x>
  257.         When the user is configured for scanning new files in JetMail,
  258.         JetMail looks for the SFFILES.BBS in the file directories and
  259.         looks for new files.  This error means that JetMail couldn't
  260.         find a directory file SFFILES.BBS for the designated File Area.
  261.         Check your path specification in SFFAREA.DAT.
  262.  
  263. - Error locating SPITFIRE system file.  Notify Sysop.
  264.         JetMail uses a number of Spitfire system files, including
  265.         SFMCONF.DAT, SFFAREA.DAT, SFNODE.DAT, SFSYSTEM.DAT, SFUSERS.DAT.
  266.         Make sure the paths specified in SFNODE.DAT are correct for the
  267.         current node.
  268.  
  269. * Error removing temporary work directory.
  270.         When no WORKDIR= is specified in the JetMail configuration file,
  271.         JetMail makes its own temporary work directory off of the JetMail
  272.         home directory.  JetMail will automatically remove this
  273.         directory upon exiting the door; however, an error was
  274.         encountered trying to remove this directory, usually named
  275.         TMP1.$$$ or something like that.  You may safely delete the
  276.         files in this directory and the directory once JetMail is done.
  277.  
  278. Invalid argument: Invalid argument
  279.  
  280.         This error is only shown locally.  JetMail encountered a DOS
  281.         error when trying to determine the file date on the bulletins
  282.         and/or newsletter, or determining file size prior to .QWK
  283.         transfer.  JetMail can encounter this error in an unexpected
  284.         DOS environment, or conflict with TSR (memory resident)
  285.         utilities.  Try to not load unnecessary memory resident
  286.         utilities and this should clear up.
  287.  
  288. Error creating New Files list.
  289.         Disk space problem?  When the user is configured in JetMail to
  290.         scan for new files, JetMail will generate a text file named
  291.         NEWFILES.DAT in the JetMail temporary work directory.
  292.  
  293.