home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / EZROM21F.ZIP / EZ-HELP.TXT < prev    next >
Encoding:
Text File  |  1995-05-31  |  10.4 KB  |  223 lines
  1.  
  2.       *** Troubleshooting the EZ-ROM CD-ROM Door by Mike Robinson ***
  3.           May 31, 1995 (This document also applies to the SF-ROM Door)
  4.  
  5.       EZ-ROM writes error conditions to file ERROR.LOG in the current
  6.       directory. Check this file. If it says that EZ-ROM cannot find or
  7.       read a certain file, check your EZROM.MAS, EZROM.CFG, and batch files
  8.       to locate where this file is specified. Change the path to the file
  9.       or relocate the file. Check the spelling of the path and filename
  10.       carefully. A single misplaced character will cause an error. Verify
  11.       that the directories and files specified actually do exist. If you
  12.       set Debug OFF, then errors will not be written to ERROR.LOG
  13.  
  14.       If you use EZROM.MAS make sure that the DISKS area begins and ENDS
  15.       with the command word DISKS. If you leave out the second DISKS, then
  16.       all the commands after the disks will be ignored. This can cause all
  17.       sorts of problems.
  18.  
  19. ------------------------------------------------------------------------------
  20.  
  21.       *** PROBLEM: EZ-ROM works on local end but the caller sees nothing. ***
  22.  
  23.       This is always caused by a failure to open the com port.
  24.       Possible reasons:
  25.  
  26.       1. The wrong port is being used.
  27.       2. The wrong EZ-ROM comm driver is being used or the comm driver
  28.          is not loaded in memory.
  29.       3. The port is non-standard.
  30.       4. There is a conflict with other hardware/software on the system.
  31.  
  32.       EZ-ROM determines the port number to use by reading the
  33.       door drop file:
  34.  
  35.       DOOR.SYS       com port number is on line number 1  (EZ-ROM)
  36.       DORINFOx.DEF   com port number is on line number 4  (EZ-ROM)
  37.       SFFILE.DAT     com port number is on line number 6  (SF-ROM)
  38.  
  39.       In the batch file that runs EZ-ROM, the first parameter on the
  40.       command line should be the full path and file name of one of these
  41.       files. Check the door drop file to be sure that the correct com port
  42.       number is specified on the indicated file line. You can also force
  43.       EZ-ROM to use a certain port by using the ForceComPort command in
  44.       EZROM.MAS or NODEx.CFG (multi-disk mode) or in EZROM.CFG (single-disk
  45.       mode). This will override the port specified in the door drop file.
  46.  
  47.       If EZ-ROM starts, shows some of the initial displays, and then seems
  48.       to halt, this is almost always an IRQ conflict with another device or
  49.       software on the system. The most common such problem is an internal
  50.       modem and IO card trying to use the same IRQ number. Make sure that
  51.       nothing else on your system is using the IRQ and IO base address used
  52.       by EZ-ROM. Other devices which could cause conflicts are a mouse,
  53.       sound card, CD-ROM card, network card, tape backup card, scanner
  54.       card, or just about any other piece of "extra" hardware plugged into
  55.       the computer.
  56.  
  57.       SF-ROM uses the same IRQ and IO address as the Spitfire node. It
  58.       automatically reads this information from the Spitfire SFNODE.DAT
  59.       file.
  60.  
  61.       EZ-ROM uses the "standard" IBM PC clone com port settings which are:
  62.  
  63.       COM1   IRQ 4   $03F8
  64.       COM2   IRQ 3   $02F8
  65.       COM3   IRQ 4   $03E8
  66.       COM4   IRQ 3   $02E8
  67.  
  68.       If your com port does not use these settings, then it is called
  69.       non-standard. Which means that EZ-ROM does not know the correct
  70.       settings, so you must "tell" EZ-ROM which settings to use. The
  71.       commands to do this are:
  72.  
  73.       ForceComPort  2
  74.       ForceIrq  3
  75.       ForceBase  $02F8
  76.  
  77.       Put these commands in EZROM.MAS or NODEx.CFG (multi-disk mode) or in
  78.       EZROM.CFG (single-disk mode). The settings shown above are for a
  79.       standard COM2. You will have to adjust these to match the settings
  80.       used on your com port. Note the $ in front of number in the ForceBase
  81.       command. This $ indicates that it is a hexadecimal number (base16).
  82.       Also note that if you use a "true blue" IBM PS/2 made by IBM then
  83.       EZ-ROM detects the PS/2 and uses slightly different settings for COM3
  84.       and COM4 only.
  85.  
  86.       If you use a Fossil or DigiBoard driver, make sure it is properly
  87.       loaded in memory and activated before running EZ-ROM. Check the
  88.       local monitor status line to see if the comm driver used by EZ-ROM
  89.       is the driver you set in EZROM.MAS.
  90.  
  91.       EZ-ROM should work OK with multiport IO cards that use a shared IRQ.
  92.       For an intelligent DigiBoard (or compatible) set Driver DigiBoard.
  93.       All other multiport IO cards should use Driver Uart.
  94.  
  95. ------------------------------------------------------------------------------
  96.  
  97.       *** PROBLEM: No tag letters displayed when viewing file lists. ***
  98.  
  99.          See the TagChar command in EZROM.DOC. If a line in a file list has
  100.          a valid TagChar in the correct position, then that line is
  101.          displayed in color and assigned a tag letter. So all you need to
  102.          do is find a character that repeats in the same position on every
  103.          line which has a file name. Then use the TagChar command to
  104.          specify this character and position.
  105.  
  106.          Here are some examples:
  107.  
  108.          TagChar 26 -
  109.  
  110.          Lines which contain a dash(-) at position 26 will be colorized and
  111.          assigned a tag letter. Lines which do NOT contain this character
  112.          at this position are assumed to be header lines or extended
  113.          description lines.
  114.  
  115.          TagChar ALL
  116.  
  117.          Every line will be colorized and assigned a tag letter no matter
  118.          what is on the line.
  119.  
  120. ------------------------------------------------------------------------------
  121.  
  122.       *** PROBLEM: I registered EZ-ROM and now the <D>ownload command no
  123.                    longer appears on the menu and callers cannot download.
  124.  
  125.          The caller is either over his daily download limit or the daily
  126.          download limits are set too low. Now that EZ-ROM is registered, it
  127.          will enforce daily limits on number of files and bytes downloaded.
  128.          It gets these limits from DOOR.SYS lines 31 (kilobytes per day)
  129.          and line 46 (files per day). If your BBS puts the correct values
  130.          on these lines, then you are all set. Unfortunately, not all BBS
  131.          systems do this. Some are known to put a 0 on one or both of these
  132.          lines which causes EZ-ROM to enforce a limit of 0 and so it allows
  133.          no downloads. Some other systems put a very large value on one or
  134.          both of these lines, which causes the opposite problem of allowing
  135.          too many downloads. You did not experience this problem with the
  136.          unregistered version because EZ-ROM does not enforce any limits in
  137.          the unregistered version.
  138.  
  139.          These is a solution to this problem. See the LIMIT command in
  140.          EZROM.DOC. It will allow you to set your own limits in EZROM.MAS
  141.          or EZROM.CFG. The limits you set with the LIMIT command will
  142.          override the values in DOOR.SYS. Here is a brief example. If you
  143.          put this line in your EZROM.MAS or EZROM.CFG
  144.  
  145.          LIMIT  ALL  12  2000
  146.  
  147.          this will limit all callers to 12 files per day and 2000
  148.          kilobytes per day.
  149.  
  150.          LIMIT  20  8  1000
  151.  
  152.          this will limit only security level 20 to 8 files per day
  153.          and 1000 kilobytes per day.
  154.  
  155.          If you use DORINFOx.DEF then EZ-ROM will use the default limits
  156.          of 10 files and 2000K per day unless you use the LIMIT command.
  157.  
  158. ------------------------------------------------------------------------------
  159.  
  160.       *** PROBLEM: I just upgraded to Wildcat 4.0 and callers can not get
  161.                    into the disks.
  162.  
  163.          Wildcat 4.0 has a security level system where callers are assigned
  164.          security level names and these names have assigned numbers. The
  165.          default number for the names may be set to zero if you do not
  166.          specifically set them for each name. So the solution is to assign
  167.          security numbers in Wildcat which will allow access to EZ-ROM.
  168.          EZ-ROM controls access to each disk by security level number. In
  169.          the DISKS section of EZROM.MAS a disk might have an access control
  170.          of >1. This means only callers with a security number of greater
  171.          than 1 can get into that disk. These levels are only enforced when
  172.          running in the BBS. They are not enforced when you run local from
  173.          the DOS command line with the command EZROM LOCAL. When run in the
  174.          BBS, EZ-ROM gets the callers security level number from line 15 of
  175.          DOOR.SYS. So if the wrong number is put there by Wildcat, then the
  176.          caller may be denied access to a disk.
  177.  
  178. ------------------------------------------------------------------------------
  179.  
  180.       *** PROBLEM: I registered EZ-ROM, but it is not writing a log file
  181.                    of the caller's activities in the door.
  182.  
  183.          Reasons why log may not be written:
  184.  
  185.          1. Program running in local mode. Log not written in local mode.
  186.  
  187.          2. Program not registered.
  188.  
  189.          3. Log OFF command used.
  190.  
  191.          4. LogName command is spelled wrong.
  192.  
  193.          5. LogName command is preceded by a semicolon or it is not all the
  194.             way up against the left margin of EZROM.MAS.
  195.  
  196.          6. The directory specified for the log is spelled wrong and/or
  197.             does not exist.
  198.  
  199.          7. The name of the log file is spelled wrong and/or it is not a
  200.             legal DOS file name.
  201.  
  202.          8. Some other program is deleting the log. TriBBS uses a temporary
  203.             log for each node. After a caller logs off, the temporary log
  204.             is copied to the main log. The temporary log is then deleted.
  205.  
  206. ------------------------------------------------------------------------------
  207.  
  208.       *** PROBLEM: Invalid Function Number error. ***
  209.  
  210.       This is usually caused by running EZ-ROM in Microsoft Windows. There
  211.       is something unusual about the way Windows handles access to the DOS
  212.       SHARE functions. Windows actually indicates thet SHARE is loaded when
  213.       it is not. EZ-ROM tries to use a share function and since it is not
  214.       there, DOS returns an Invalid Function Number error. There are 2 easy
  215.       solutions:
  216.  
  217.       1. Use the command SHARE OFF in EZROM.MAS.
  218.  
  219.       2. Load DOS SHARE.EXE in your CONFIG.SYS or AUTOEXEC.BAT.
  220.  
  221. ------------------------------------------------------------------------------
  222.  
  223.