home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / EZROM21E.ZIP / UTILITY.ZIP / EZREQ.DOC next >
Text File  |  1994-10-08  |  12KB  |  259 lines
  1.  
  2.                               EZ-Request
  3.                              Version 1.00
  4.                           Released Feb 3, 1994
  5.  
  6.                      Copyright 1994 by Mike Robinson
  7.  
  8.                             The Soft Parade
  9.                         Shelton, Connecticut, USA
  10.                         1:141/485    203-924-5603
  11.                         1:141/486    203-922-1794
  12.               Fast Online registration using Visa or Mastercard
  13.  
  14.       EZ-Request is a free utility for registered versions of the EZ-ROM
  15.       and SF-ROM Doors. It is an automatic file request fulfillment manager
  16.       and file request database editor.
  17.  
  18. ----- PROGRAM OPERATION -------------------------------------------------
  19.  
  20.       Simply place EZREQ.EXE in the home directory of either EZ-ROM or
  21.       SF-ROM and run it. EZ-Request looks for either EZROM.REQ or SFROM.REQ
  22.       which is the request log database file created the first time a
  23.       caller requests a file. It first looks in the current directory, then
  24.       it looks in the directory that EZREQ.EXE is located in, and finally
  25.       it searches the DOS path. If neither .REQ file is found then
  26.       EZ-Request beeps, diplays an info screen, and then halts. EZROM.REQ
  27.       and SFROM.REQ are only created by registered versions of the EZ-ROM
  28.       and SF-ROM doors.
  29.  
  30.       The main program screen looks like this:
  31.  
  32.       EZ-Request Editor 1.00  Copyright 1994 Mike Robinson
  33.  
  34.       Record Number 12 of 33           There are 4 Requests Pending.
  35.  
  36.       <1> Reading File....... C:\CDROM\EZROM.REQ
  37.       <2> Use CD-ROM Drive... E
  38.       <3> Copy To Directory.. C:\CDROM\REQUEST
  39.       <4> Request Status..... REQUEST
  40.       <5> Request Date....... 01-31-94
  41.       <6> Caller Name........ John Smith
  42.       <7> CD Disk Name....... Night Owl 10
  43.       <8> Original CD Path... E:\DIR1\BIG-GAME.ZIP
  44.       <9> File Description... Action adventure game, excellent graphics
  45.  
  46.       <F> Fill Request
  47.       <S> Skip Request
  48.       <+> Next Record
  49.       <-> Previous Record
  50.       <Q> Quit
  51.  
  52.       Your Command: _
  53.  
  54.       The program is menu driven. Use the <Enter> + and - keys to move from
  55.       record to record. Enter any number from 1 to 9 to change the
  56.       corresponding field in the upper section. Enter F to fill the current
  57.       request, S to skip the current requests and advance to the next
  58.       record. Enter Q or <escape> to exit the program. Pressing escape at
  59.       any point aborts the current operation.
  60.  
  61.       The CD-ROM working drive is where the files will be copied from.
  62.       To change the CD-ROM drive enter 2. The default CD-ROM drive is
  63.       the same as the original CD-ROM drive in number <8>. In some cases
  64.       you may have requests from different drives, so the CD-ROM drive
  65.       letter will change to follow the original drive for that disk.
  66.       If you manually change the CD-ROM drive from inside the program,
  67.       from the DOS command line, or in the configuration file then the
  68.       CD-ROM drive will become fixed until the next time you manually
  69.       change it.
  70.  
  71.       Note to Pioneer CD-ROM disk changer owners: you can buy an additional
  72.       cartridge and load it with all your offline disks. So you might have
  73.       six online disks in one cartridge and six offline disks in the other.
  74.       When it comes time to fill the requests, you can just swap
  75.       cartridges and the working drive will automatically switch to the
  76.       correct drive letter.
  77.  
  78.       When filling a request, the program will fill the current request if
  79.       the status is REQUEST, othewise it will jump to the next REQUEST on
  80.       the same CD-ROM disk. Once all the requests on the same disk have
  81.       been presented, the program will jump to the next REQUEST on any
  82.       disk.
  83.  
  84.       Menu option <4> is the status of the current request, which will be
  85.       one of 3 possible status values:
  86.  
  87.       REQUEST ...The caller has requested the file, but the request has not
  88.                  yet been filled by the sysop.
  89.  
  90.       PENDING ...The sysop has filled the request, the file has been copied
  91.                  to the hard drive request holding directory (RequestDir).
  92.                  The caller will be notified that this file is available
  93.                  for download the next time the caller enters the door.
  94.  
  95.       DONE ......The caller has downloaded the file.
  96.  
  97.       You can change the status manually if required, but in general the
  98.       status will be automatically updated. EZ-Request will automatically
  99.       change the status from REQUEST to PENDING when it successfully copies
  100.       a file to the hard drive and fills a request. The door will change
  101.       the status from PENDING to DONE when the caller exits the door after
  102.       downloading the pending file.
  103.  
  104.       EZ-Request uses file sharing and record locking if you set Share ON
  105.       in EZREQ.CFG. If you have loaded DOS SHARE.EXE in your CONFIG.SYS or
  106.       AUTOEXEC.BAT, then it is safe to use EZ-Request while a caller is in
  107.       the door. But if you change a record that applies to the caller in
  108.       the door, the record may be changed again by the door when the caller
  109.       exits or places a request. Old records may also be overwritten (and
  110.       old pending files deleted) as part of the maintenance procedure that
  111.       occurs during exit from the door. Do NOT use EZ-Request with a caller
  112.       in the door if you do not have both Share ON in EZROM.REQ and DOS
  113.       SHARE.EXE loaded.
  114.  
  115.       The caller will only be notified that a file is ready for download if
  116.       the request status is PENDING when the caller enters the door. You
  117.       can fill a request with the caller in the door and then the caller
  118.       can download the files by using the Utility menu to check for
  119.       requested files.
  120.  
  121.  
  122. ----- COMMAND LINE (Optional) -------------------------------------------
  123.  
  124.       EZ-Request also accepts the following optional command line
  125.       parameters:
  126.  
  127.       EZREQ  [CD-ROM Drive Letter]  [Request Directory]  [Request Log]
  128.  
  129.       Examples:
  130.  
  131.       EZREQ
  132.       EZREQ  E
  133.       EZREQ  E  C:\CDROM\REQUEST
  134.       EZREQ  E  C:\CDROM\REQUEST  C:\CDROM\EZROM.REQ
  135.  
  136.       CD-ROM Drive Letter ..... The files will be copied from this drive.
  137.  
  138.       Request Directory ....... The files will be copied to this directory.
  139.                                 A trailing backslash is not required.
  140.                                 Use of this command is rarely necessary
  141.                                 since the RequestDir is saved in the .REQ
  142.                                 file when the caller makes a request.
  143.  
  144.       Request Log ............. Database file of all file requests.
  145.                                 Usually EZROM.REQ or SFROM.REQ.
  146.                                 Use of this command is not necessary if the
  147.                                 .REQ file is in the current directory.
  148.  
  149.       Because the command line parameters are separated by blank spaces, in
  150.       order to specify parameter 2, parameter 1 must also be specified. In
  151.       order to specify parameter 3, all of the parameters must be
  152.       specified.
  153.  
  154.       The command line overides any settings made in the configuration
  155.       file. All of the command line parameters and configuration file
  156.       parameters can be changed inside the program.
  157.  
  158.  
  159. ----- CONFIGURATION FILE EZREQ.CFG (Optional)----------------------------
  160.  
  161.       EZ-Request looks for the optional configuration file EZREQ.CFG in the
  162.       current directory, then it looks in the directory that EZREQ.EXE is
  163.       located in, and finally it searches the DOS path. If found, the
  164.       program reads each line and if it begins with a configuration
  165.       command, then the configuration is modified as directed by the
  166.       command. If a line begins with anything other than a letter, it is
  167.       ignored. The explanatory comments are on lines beginning with a
  168.       semicolon and are therefore ignored. The commands are NOT case
  169.       sensitive, but they must be spelled correctly. The order of the lines
  170.       is not important.
  171.  
  172.  
  173.    DRIVE  E
  174.  
  175.       Sets the CD-ROM drive letter.
  176.       Same as first command line parameter.
  177.       The files will be copied from this drive.
  178.       A trailing colon (like E:) is not required and will be ignored.
  179.       Default is drive E.
  180.  
  181.  
  182.    REQUESTDIR   C:\CDROM\REQUEST
  183.  
  184.       The files will be copied to this directory.
  185.       Same as the second command line parameter.
  186.       A trailing backslash is not required and will be ignored.
  187.       Use of this command is rarely necessary since the RequestDir is saved
  188.       in the .REQ file when the caller makes a request.
  189.  
  190.  
  191.    REQUESTLOG   C:\CDROM\EZROM.REQ
  192.  
  193.       Database file of all file requests.
  194.       Same as the third command line parameter.
  195.       Usually EZROM.REQ or SFROM.REQ.
  196.       Use of this command is not necessary if the .REQ file is in the
  197.       current directory.
  198.  
  199.  
  200.    MAPHOLDDRIVE  ON
  201.  
  202.       This command is primarily aimed at network users. If you run
  203.       EZ-Request from across a network, the request directory (RequestDir)
  204.       drive letter will be changed (mapped) to the apparent drive letter of
  205.       the drive containing EZROM.REQ. So if the machine with EZROM.REQ
  206.       "looks like" drive F from across the network, then the files will be
  207.       copied to the RequestDir directory on apparent drive F.
  208.       Set MapHoldDrive OFF to disable this behavior.
  209.       Default is MapHoldDrive ON.
  210.  
  211.  
  212.    SHARE ON
  213.    SHARE OFF
  214.  
  215.       Optional. Choose one. Turns file sharing and locking ON or OFF.
  216.       If you have more than 1 node, or you want to fill requests while a
  217.       caller is in the door, then set Share ON. In order for file sharing
  218.       and locking to work, you must use DOS 3.1 or higher, and DOS
  219.       SHARE.EXE must be loaded in your CONFIG.SYS or AUTOEXEC.BAT.
  220.       If file sharing is not required, then you may set Share OFF.
  221.       Default is Share OFF.
  222.  
  223.  
  224.    MAXBUFF 64000
  225.  
  226.       Optional. Determines the maximum file copy buffer size in bytes. Most
  227.       systems work well with the default value of 64000 bytes. This is the
  228.       maximum buffer size. The actual buffer is created just before copying
  229.       a file and is sized to fit within the DOS conventional (low) memory
  230.       available at that moment. Some networks, CD-ROM drives, and CD-ROM
  231.       software drivers may give better performance if you reduce the
  232.       MaxBuff. If you are experiencing a problem when the program copies
  233.       large files, then try reducing the MaxBuff to 32000 or 16000 bytes.
  234.       The smaller buffer may be a better match with the other CD-ROM
  235.       related buffers used in your system.
  236.       Values from 500 to 65500 bytes are allowed.
  237.       Default is 64000 bytes.
  238.  
  239.  
  240.    DIRECTVIDEO   ON
  241.    BIOSSCROLL    ON
  242.    CHECKSNOW     OFF
  243.  
  244.       The defaults are shown. These commands are the same as described in
  245.       EZROM.DOC or SFROM.DOC.
  246.  
  247.  
  248.       Special Note to PIONEER CD-ROM disk changer owners:
  249.       You can buy an additional cartridge and load it with all your offline
  250.       disks. So you might have six online disks in one cartridge and six
  251.       offline disks in the other. When it comes time to fill the requests,
  252.       you can just swap cartridges and the working drive will automatically
  253.       change to the correct disk. In order for this to work, you must NOT
  254.       manually change the specified working CD-ROM drive via the command
  255.       line, via the configuration file, or from inside the program. If you
  256.       change the working CD-ROM drive at any time, the working drive will
  257.       stick on that drive until the next time you manually change the drive.
  258.  
  259.