home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / arc_lbr / aview38.arc / AVIEWCOM.DOC < prev    next >
Text File  |  1990-01-27  |  35KB  |  783 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.       _____________________________________________________________________
  9.  
  10.                 AViewCom.Exe    Version 3.8, 4.4   01/27/90
  11.  
  12.                    Archive View to Console and Com port
  13.  
  14.              CopyRight (C) 1989, 1990 by Cygnus Data Systems
  15.                            Daniel A. Durbin
  16.       _____________________________________________________________________
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.         Contents
  26.         --------
  27.  
  28.                 Description ........................ 2
  29.                 Operation .......................... 2
  30.                 Files .............................. 3
  31.                 Setup .............................. 4
  32.                 Syntax ............................. 4
  33.                 AVIEWCOM /C (create CALLINFO.BBS)... 9
  34.                 AVIEWCOM /S (Setup Menu)............ 9
  35.                 AVIEWCOM /U (User Update)........... 10
  36.                 Command Priority ................... 11
  37.                 Display Files .......................11
  38.                 Configuration File ................. 12
  39.                 Exit Codes ......................... 13
  40.                 Credits and Acknowledgements ....... 13
  41.                 Disclaimer ......................... 14
  42.                 Bugs ............................... 14
  43.                 Future ............................. 14
  44.                 History ............................ 15
  45.  
  46.         AViewCom                        1
  47.  
  48.         DESCRIPTION
  49.         -----------
  50.  
  51.         AViewCom was inspired by the ArcView function in Perspective
  52.         Data Systems by Carey Nash.  Although the code for AViewCom
  53.         is completely my own, most of what I know about C was learned
  54.         through modifying the source code for Perspective.
  55.  
  56.         AViewCom allows BBS callers to view archive contents, read
  57.         ASCII files within archives, and download any file from within an
  58.         archive.  Callers may also create a temporary archive containing
  59.         any number of files from the original archive.  AViewCom supports
  60.         .arc, .pak, .zip, .zoo, .lzh, and some .exe and .com archives.
  61.  
  62.         AViewCom is written specifically with WildCat BBS in mind since
  63.         WildCat has a [V]iew Archive file function in the files menu which
  64.         makes a call to an external arcview program and passes the caller's
  65.         specified filename to VIEWCOMP.BAT as a DOS parameter %1.  However,
  66.         AViewCom may be used with other BBS's since if no filename is
  67.         specified, AViewCom will prompt the caller for the full pathname to
  68.         the archive file.  A configuration file may be used to specify
  69.         directories to be searched for the file.
  70.  
  71.         OPERATION
  72.         ---------
  73.  
  74.         AViewCom may be run directly from the command line.  Simply specify
  75.         the full pathname to the archive to be viewed.  You should try this
  76.         before adding AViewCom to your BBS.  The screen will clear and prompt
  77.         you for ANSI display.  After answering, the contents of the archive
  78.         will be displayed, and a command line prompt will appear.
  79.  
  80.         Then try adding it to your BBS.  If you're using WildCat, modify
  81.         your VIEWCOMP.BAT file to read:  AVIEWCOM %1 COM1.  Once you're sure
  82.         this is working okay, you may add other options, such as reading
  83.         caller information from the CALLINFO.BBS, a file which may be created
  84.         with AVIEWCOM /C.  Add the command AVIEWCOM /C to your VIEWCOMP.BAT
  85.         file before it calls AViewCom and include the '-w' parameter on the
  86.         AViewCom command line.  For example:
  87.  
  88.                 AVIEWCOM /C
  89.                 AVIEWCOM %1 COM1 -W
  90.  
  91.  
  92.         AViewCom                        2
  93.  
  94.  
  95.         Notice that case is not significant in command line parameters.
  96.         Once all this is working, you may wish to further review
  97.         the other options that are available as specified in the SETUP
  98.         section of this documentation.  If you have any trouble, start with
  99.         things as simple as possible.  Then add options one at a time and
  100.         verify that each is working properly.  Also, take time to read all
  101.         options and review all files included in this archive package.
  102.  
  103.         Review the files included and delete ALL that are not
  104.         applicable to your configuration.  Most WildCat systems can use the
  105.         VIEWCOMP.BAT file included.  Review the syntax listed below to
  106.         select options for your system.  You may choose to specify all
  107.         options on the command line, OR use AVIEWCOM /S, OR specify them
  108.         in the AVIEWCOM.CNF file, whichever is most comfortable for you to
  109.         use.  However, if you use the command line for specifying options,
  110.         please delete the .CFG and .CNF files to reduce confusion.  If you
  111.         use either the .CFG or .CNF file, do not use the command line
  112.         options.
  113.  
  114.  
  115.  
  116.         FILES
  117.         -----
  118.                 AVIEWCOM.CNF       A sample configuration file
  119.                 AVIEWCOM.DOC       This file
  120.                 AVIEWCOM.EXE       The ArcView program
  121.                 AVIEWCOM.HLP       Displayed when caller requests [H]elp
  122.                 AVIEWDSZ.BAT       How to use batch file to call DSZ
  123.                 DIGIFONE.TXT       A Telephone Answering System Ad
  124.                 VIEW.OVL           The ArcView overlay program
  125.                 VIEWCOMP.BAT       A sample batch file for WildCat
  126.                 WHATSUP.DOC        Information on the latest haps
  127.  
  128.         Not Included:
  129.  
  130.                 AVIEWCOM.SCR       Welcome screen for ANSI callers
  131.                 AVIEWCOM.BBS       Welcome screen for MONO callers
  132.                 AVIEWCOM.CFG       Created when using AVIEWCOM /S
  133.                 AVIEWCOM.LOG       Activity log for AVIEWCOM.EXE
  134.                 AVIEWCOM.USR       Saved user download information
  135.                 AVIEWTMP.???       Temporary archive used during downloading
  136.                 AVIEWDSZ.ERR       (see AVIEWDSZ.BAT)
  137.                 AVIEWCOM.DAT       Created and erased by AVIEWCOM.EXE
  138.         AViewCom                        3
  139.  
  140.         SETUP
  141.         -----
  142.         - Setup Procedure and Information:
  143.         AViewCom will display the contents of an archive to the local
  144.         console and to COM1, COM2, COM3, or COM4 as specified on the
  145.         command line.  If no COM port is specified, AViewCom enters the
  146.         local mode and no output is sent to the COM port.  When displaying
  147.         a text file, AViewCom makes a DOS call to an external extractor
  148.         which may be anywhere in the DOS path.  An extractor other than
  149.         PKUNZIP (the default) may be specified with the '-e' option.  The
  150.         SysOp may specify a temporary path to extract files to with the '-p'
  151.         parameter on the command line.  AViewCom can display ANSI color.
  152.         If the '-a1' parameter is included on the command line, the
  153.         contents are displayed in color locally and to the remote caller.
  154.         If ANSI is selected, an ANSI device driver is required for the host
  155.         computer.  However, a color monitor is not required.  You must have
  156.         a line in your CONFIG.SYS file resembling the following:
  157.  
  158.                   DEVICE=C:\DOS\ANSI.SYS
  159.  
  160.         If an ANSI driver is not installed and ANSI is selected the display
  161.         will be cluttered with ANSI escape sequences.
  162.  
  163.         AViewCom will allow BBS callers to read text files that are
  164.         contained within an archive file.  AViewCom will not display files
  165.         with .com, .exe, .obj, or .ovl extensions. The file is also checked
  166.         for nul characters contained within the first 255 bytes of the file
  167.         and will not display it if there are any.  If the file passes the
  168.         tests, it will be extracted by making a DOS call to an external
  169.         extractor which must reside somewhere in the DOS path (which
  170.         includes the current directory).  The file is then extracted to the
  171.         current directory or temporary path, displayed, and deleted.
  172.         However, if the file already exists before the call to the
  173.         extractor, it is displayed, but not deleted.
  174.  
  175.         AViewCom will allow BBS callers to download any file that is
  176.         contained within an archive file.  AViewCom makes a DOS call
  177.         to DSZ.COM which may be anywhere in the DOS path (which
  178.         includes the current directory).  The file is then extracted to
  179.         the current directory or temporary path, transfered, and deleted.
  180.         However, if the file already exists before the call to DSZ.COM,
  181.         it is sent, but not deleted.  Including '-d' on the command
  182.         line disables the downloading feature.
  183.  
  184.         AViewCom                        4
  185.  
  186.  
  187.         SYNTAX
  188.         ------
  189.  
  190.         Some special features of AViewCom are invoked by using ONE of
  191.         the following special parameters.
  192.  
  193. AViewCom [?] [/C] [/S] [/C]
  194.  
  195.         ?          If first and only parameter, displays syntax help screen.
  196.         /C         If first and only parameter, creates the CALLINFO.BBS file.
  197.         /S         If first and only parameter, inovkes the setup menu.
  198.         /U         If first and only parameter, updates the WildCat v2.0
  199.                    database files (available on AViewCom v4 only).
  200.  
  201.  
  202.         In the arcview mode, AViewCom accepts the following parameters on
  203.         the command line.  Each is detailed below.
  204.  
  205. AViewCom file [port] [-a#] [-c] [-d] [-e#] [-l] [-p{tpath}] [-t#] [-u] [-w]
  206.  
  207.         file       is a required parameter.  If omitted, there must be
  208.                    no other parameters on the command line and the caller
  209.                    will be prompted for a file to an archive file.  file
  210.                    is any valid DOS pathname to the file to be viewed.
  211.                    The archive extension is optional and is added if not
  212.                    included.  Some BBS's like WildCat! pass the file
  213.                    as a DOS parameter.  WildCat! uses %1.  If the character
  214.                    '*' use used as file, other options may be specified
  215.                    and the caller will be prompted for a file to view.
  216.  
  217.         port       is either 'com#' or 'local' where # is 1, 2, 3, or 4.
  218.                    This is an optional parameter and defaults to local.
  219.                    If neither of these are specified, local mode is entered
  220.                    and no transmission is sent to the com port.  In this
  221.                    manner, AViewCom may be run in the local mode.
  222.  
  223.         -a#        is an optional parameter where # either 0, 1, or 2:
  224.                       0 = no ANSI.  In this mode, all display is MONO.
  225.                       1 = ANSI color.  All display is in ANSI color.
  226.                       2 = prompt caller for ANSI color or not (default).
  227.  
  228.  
  229.  
  230.         AViewCom                        5
  231.  
  232.         -c         If -c is included on the command line, AViewCom will search
  233.                    through directories that are listed after the #search
  234.                    command in the AVIEWCOM.CNF file.  This option is included
  235.                    for non-WildCat systems which do not pass the filename to
  236.                    view as a DOS parameter.
  237.  
  238.         -d         disables the download option.  This is included for those
  239.                    systems which prefer not to allow downloading.  If not
  240.                    included, downloading is enabled and DSZ.COM must be
  241.                    somewhere in the DOS path.  Protocols supported are
  242.                    XmodemCRC, YmodemBatch, and Zmodem.
  243.  
  244.         -e#        Used to specify an extractor where # is as follows:
  245.  
  246.                         0        pkxarc.COM (NOT EXE!)
  247.                         1        pkunpak
  248.                         2        pak e
  249.                         3        arc e
  250.                         4        pkunzip [default]
  251.                         5        zoo
  252.                         6        lharc
  253.  
  254.                    If you use code 2, make sure that PAK.CNF is such that
  255.                    the archive will not be deleted after extracting it.  The
  256.                    specified extractor is also used to create the temporary
  257.                    archive which is assigned the name AVIEWTMP.
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.         AViewCom                        6
  277.  
  278.         -l         enables activity logging.  If this is included,
  279.                    AViewCom will create and maintain an activity log called
  280.                    AVIEWCOM.LOG which will contain dates and times of
  281.                    all arcviews and downloads that occur.
  282.                    The call to DSZ will contain port number, protocol
  283.                    (either sx, sb, or sz), and the filename.  %1="port",
  284.                    %2=port number, %3=protocol (sx, sb, sz), %4=filename
  285.  
  286.                    If you wish to include other options on call to DSZ.COM,
  287.                    you may do so in a batch file, BUT IS NOT REQUIRED!
  288.                    To do this, you must "set" the pathname to this batch
  289.                    file as a DOS environment string.
  290.  
  291.                         set AVIEWDSZ=pathname
  292.  
  293.                    where pathname is the full path to the batch file
  294.                    you have created to call DSZ.COM from (for an
  295.                    example, see AVIEWDSZ.BAT) AViewCom will look for
  296.                    the AVIEWDSZ string in the environment and call
  297.                    the batch file through a DOS system call.  The
  298.                    batch file should create a file called AVIEWDSZ.ERR
  299.                    DSZ returns an errorlevel greater than 1.  AViewCom
  300.                    will delete AVIEWDSZ.ERR after checking for its
  301.                    existance.
  302.  
  303.         tpath      is an optional parameter and if omitted, defaults
  304.                    to the current working directory.  tpath is any
  305.                    valid DOS path and specifies a temporary directory
  306.                    for the external extractor to use when extracting files.
  307.                    A useful tpath is a ramdrive.  The '-p' indicates
  308.                    that a DOS pathname follows.
  309.  
  310.         -t#        This parameter allows the SysOp to specify a maximum
  311.                    number of minutes that the caller will be allowed to spend
  312.                    in a session of AViewCom.  # is the number of minutes
  313.                    to be allowed.  In the WildCat mode, the time allowed
  314.                    is read from CALLINFO.BBS.
  315.  
  316.                    AViewCom computes file transfer times as if the file
  317.                    were transfered at 95% efficiency.  If the caller does
  318.                    not have enough time left for the file transfer, he
  319.                    will not be allowed to download the file.
  320.  
  321.  
  322.         AViewCom                        7
  323.  
  324.         -u         if included, instructs AViewCom to create a file called
  325.                    AVIEWCOM.USR which will contain the number of files and
  326.                    kilobytes the caller downloaded during the current session
  327.                    of AViewCom.  When AVIEWCOM /U is run, the WildCat databases
  328.                    will be updated (FILESEC.DAT and USERFILE.DAT) to reflect
  329.                    the number of downloads and total download kbytes.  However,
  330.                    AVIEWCOM /U must be run after the caller logs off and before
  331.                    midnight of the current day.
  332.  
  333.                    Available only for WildCat v2.0! and AViewCom v4.
  334.                    Version 3 of AViewCom does NOT write any information
  335.                    to USERFILE.DAT or FILESEC.DAT.  Version 4 does update
  336.                    the databases and is available only to registered users.
  337.  
  338.         -w         Read the CALLINFO.BBS file for caller information.
  339.                    With this option, the CALLINFO.BBS file is read for
  340.                    caller information and the caller's download ratio and
  341.                    number of downloaded kbytes are checked.  The caller will
  342.                    not be able to download files if the ratio has exceeded
  343.                    the values on CONFIGWC.BBS.  If CONFIGWC.BBS does not
  344.                    exist, the upload/download ratio is set to 1:20.
  345.  
  346.                    AViewCom will search the current directory for
  347.                    CALLINFO.BBS and CONFIGWC.BBS.  If you operate AViewCom
  348.                    from another directory, you will need to copy these two
  349.                    small files to that directory before calling AViewCom.
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.         AViewCom                        8
  369.  
  370.  
  371.         AVIEWCOM /C  (Create the CALLINFO.BBS file)
  372.         -------------------------------------------
  373.  
  374.         WildCat does NOT create the CALLINFO.BBS file when the caller
  375.         selects the [V]iew Archive function from the files menu.  AViewCom
  376.         will create this file when invoked with the /C parameter.  It will
  377.         then search the ACTIVITY.LOG to determine who the current caller is
  378.         and the baud rate or if the caller is on locally.  The USERFILE.DAT
  379.         file is then searched for the caller's record and the information is
  380.         read.  It then reads CONFIGWC.BBS to get the system default settings.
  381.         This information is then used to create CALLINFO.BBS.  This program
  382.         will ONLY work with WildCat v2.0.  I will update it as new versions of
  383.         WildCat are released.
  384.  
  385.         AVIEWCOM /S  (SETUP MENU)
  386.         -------------------------
  387.  
  388.         AVIEWCOM /S is provided for convenience only and is not required.
  389.         Normally, options are specified on the command line.  AVIEWCOM /S
  390.         allows you to store your default options in the AVIEWCOM.CFG file.
  391.         If you choose to use AVIEWCOM /S, you should not specify other
  392.         options on the AVIEWCOM command line.
  393.  
  394.         The default settings are:
  395.  
  396.                 setup.port        =        1;        COM1
  397.                 setup.ansi        =        0;        MONO
  398.                 setup.cnf         =        0;        NO .CNF FILE
  399.                 setup.down        =        1;        ALLOW DOWNLOADING
  400.                 setup.extractor   =        4;        PKUNZIP
  401.                 setup.log         =        0;        NO CALL LOGGING
  402.                 getcwd(setup.tpath, 80);             CURRENT WORKING DIR
  403.                 setup.left        =        45;       45 MINUTE TIME LIMIT
  404.                 setup.wildcat     =        0;        NOT WILDCAT
  405.                 setup.update      =        0;        DON'T CREATE AVIEWCOM.USR
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.         AViewCom                        9
  415.  
  416.  
  417.         The binary configuration file AVIEWCOM.CFG is created using
  418.         AVIEWCOM /S which is self explanitory.  The command line options are
  419.         summerized in AVIEWCOM.DOC and will be listed by typing AVIEWCOM ?.
  420.         Only comm port, caller ansi status, and caller time left options
  421.         are determined from CALLINFO.BBS.  The text file AVIEWCOM.CNF is
  422.         provided for NON-WILDCAT systems, but may also be used by WildCat
  423.         systems and may be edited with any ASCII editor.  The options are
  424.         outlined in AVIEWCOM.DOC and a sample AVIEWCOM.CNF file is
  425.         provided.  Remember that the commands entered in AVIEWCOM /S will
  426.         be overrided any listed in AVIEWCOM.CNF, the command line, and in
  427.         CALLINFO.BBS.
  428.  
  429.         AVIEWCOM /U  (UPDATE DATABASES)
  430.         -------------------------------
  431.  
  432.         AViewCom will now save information on the caller's downloading
  433.         activity.  If the caller has downloaded anything, the number of
  434.         downloads and the download kbytes are saved in a file called
  435.         AVIEWCOM.USR which is used by AVIEWCOM /U to update the WildCat
  436.         databases.  AVIEWCOM /U must be run while no one is online.  It
  437.         should be run directly after the caller logs off the system.  This
  438.         may be accomplished by running a daily event BEFORE midnight or
  439.         by dropping to errorlevel 60 after each caller.  I wanted to be able
  440.         to update the caller's information after exiting AViewCom but before
  441.         returning to WildCat but WildCat will overwrite the updated
  442.         information if I do it that way.  So the best I can do is wait until
  443.         the caller logs off.  WildCat v3.0 will alleviate this problem.
  444.  
  445.         There are 4 bits of information that are updated:
  446.  
  447.                 DailyDL
  448.                 DailyDK
  449.                 Downloads
  450.                 TotalDK
  451.  
  452.         If AVIEWCOM /U is run on the next calendar day from when the caller
  453.         downloaded from AViewCom, DailyDL and DailyDK are not altered.
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.         AViewCom                        10
  461.  
  462.  
  463.         Several problems have been brought to my attention regarding
  464.         AVIEWCOM /U.  Since there are multiple files to deal with, and
  465.         multiple different places they may be found, I'll include these
  466.         suggestions.  Run AVIEWCOM from its own directory.  For example,
  467.         C:\WILDCAT\AVIEWCOM.  The AVIEWCOM.USR file should be created
  468.         and found in that directory.  When you run AVIEWCOM /U, run it from
  469.         that directory, but include the pathname to CONFIGWC.BBS on the
  470.         command line.  AVIEWCOM /U will read it and determine the pathnames
  471.         to the USERFILE.DAT.  To summarize:
  472.  
  473.         You MUST Run AVIEWCOM /U from the same directory as AVIEWCOM.
  474.  
  475.         Enter the pathname to CONFIGWC.BBS on the command line.  ie:
  476.  
  477.                 AVIEWCOM /U C:\WILDCAT\CONFIGWC.BBS
  478.  
  479.         PRIORITY
  480.         --------
  481.  
  482.         AViewCom will accept options from (low to high priority):
  483.  
  484.                 lowest:    1)  defaults
  485.                            2)  a binary configuration file  (AVIEWCOM.CFG)
  486.                            3)  the command line
  487.                            4)  callinfo.bbs (port, ansi, timelimit only)
  488.                 highest:   5)  a text configuration file    (AVIEWCOM.CNF)
  489.  
  490.         The lowest priorty option settings are overwritten by the highest
  491.         option settings.  If you don't need the AVIEWCOM.CNF file, delete
  492.         it.  Most systems can do without it.  It is mainly included for
  493.         non-WildCat systems to list directories to search for the file.
  494.         For WildCat systems, you should be able to list all of the options
  495.         you need on the command line.
  496.  
  497.         DISPLAY FILES
  498.         -------------
  499.  
  500.         These files are not required, but if they exists, will be displayed.
  501.  
  502.         AViewCom.hlp        Displayed when the caller requests [H]elp
  503.         AViewCom.scr        Welcome screen, ANSI color version
  504.         AViewCom.bbs        Welcome screen, monochrome version
  505.  
  506.         AViewCom                        11
  507.  
  508.         CONFIGURATION FILE
  509.         ------------------
  510.  
  511.         If the file AVIEWCOM.CNF exists, options will be read
  512.         from a configuration file.  The configuration file may
  513.         contain ';' to indicate comments.  The rest of the line
  514.         after the ';' is ignored.  Lines beginning with '#' are
  515.         command lines.  Recognized commands are:
  516.  
  517.                 #search                   ;search directories
  518.                 #paths                    ;paths to search
  519.                 #port                     ;com port
  520.                 #video                    ;ANSI or MONO
  521.                 #temporary                ;extracting directory
  522.                 #extractor                ;type of extractor
  523.                 #nodownload               ;disables downloading
  524.                 #log                      ;enables activity log
  525.                 #timelimit                ;max minutes allowed
  526.                 #update                          ;create AVIEWCOM.USR
  527.                 #wildcat                  ;read CALLINFO.BBS
  528.  
  529.            After each command line, another line begins containing
  530.            options for the last command.  The paths command is used
  531.            to specify directories to search for the requested
  532.            archive file.  There is no limit to the number of
  533.            directories which may be searched.  See the included
  534.            AVIEWCOM.CNF file for further information.
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.         AViewCom                        12
  553.  
  554.         EXIT CODE
  555.         ---------
  556.  
  557.         A DOS errorlevel of 1 is returned when an error in command line
  558.         parameters is encountered, or upon any error during execution.
  559.  
  560.         AViewCom monitors carrier detect and returns a DOS errorlevel
  561.         of 2 upon loss of carrier detect.  It also monitors keyboard
  562.         inactivity.  If no keyboard activity occurs for 3 minutes while
  563.         waiting at a prompt, AViewCom exits with a DOS errorlavel of 3.
  564.  
  565.         CREDITS & ACKNOWLEDGEMENTS
  566.         --------------------------
  567.  
  568.         AViewCom was inspired by the ArcView function in Perspective
  569.         Data Systems by Carey Nash.  Original versions used his code,
  570.         but have since been replaced by my own.  AViewCom version
  571.         3 may be freely distributed but may not be sold for any
  572.         reason.  AViewCom version 4 may NOT be distributed and may
  573.         only be used on one system per registration.
  574.  
  575.         The comm port communications are interrupt driven.  The original
  576.         interrupt request vector is saved and replaced with a local
  577.         interrupt service routine.  The original ISR is replaced on exit.
  578.  
  579.         For ordering information, please see the file ORDER.FRM. If
  580.         you choose to order AViewCom, you will receive the latest version
  581.         of the program, and a printed manual.  In addition, I will be able
  582.         to continue to support AViewCom and provide additional features and
  583.         enhancements.  See future below.
  584.  
  585.                       Daniel Durbin
  586.                       6216 Agee Street #124
  587.                       San Diego, CA  92122
  588.                       (619) 457-2532 (voice)
  589.                       (629) 457-2665 (data)
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.         AViewCom                        13
  599.  
  600.         DISCLAIMER
  601.         ----------
  602.  
  603.         THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  604.         EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  605.         IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  606.         PARTICULAR PURPOSE.  THE AUTHOR WILL NOT BE LIABLE TO USERS
  607.         OF THIS PROGRAM FOR ANY DAMAGES, INCLUDING LOST PROFITS OR
  608.         LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES,
  609.         ARISING OUT OF USE OF THIS PROGRAM.
  610.  
  611.  
  612.         BUGS
  613.         ----
  614.  
  615.         AViewCom will not work with DesqView unless direct screen writes
  616.         are allowed.  The archive pathname is limited to 48 characters.
  617.         The temporary pathname is limited to 48 characters.
  618.         The re-list archive filenames function is limited to 255 filenames.
  619.  
  620.  
  621.         FUTURE
  622.         ------
  623.  
  624.         Version 4 updates WildCat's file and caller databases
  625.         to reflect the number of downloads made and limit the number of
  626.         downloads permitted.  Version 4 is available only to
  627.         registered users.
  628.  
  629.         I am working on adding more file transfer protocols.
  630.  
  631.         All suggestions are welcome and encouraged and may be mailed,
  632.         emailed or phoned to me anytime.  This is a continuation of AViewCom
  633.         and many enhancements and improvements will be added and supported.
  634.         I thank all those who have given me feedback and encouragement.
  635.  
  636.         If enough copies of AViewCom are registered, I will implement the
  637.         above features and enhancements, but I can not if you choose not
  638.         to register your copy of AViewCom.
  639.  
  640.         Cygnus X-1 BBS is moving to San Diego, CA and will be down during
  641.         the month of January, 1990 until the new phone is installed.  US Mail
  642.         may be sent to the San Luis Obispo, CA Post Office Box (see ORDER.FRM).
  643.  
  644.         AViewCom                        14
  645.  
  646.         HISTORY
  647.         -------
  648.  
  649.         Version 1.1  06/21/88   Added carrier detect check so that an
  650.                                 errorlevel 1 is returned and the program
  651.                                 is exited upon loss of carrier.
  652.  
  653.                                 Added a local feature that inhibits output
  654.                                 to the com port if the string local is found
  655.                                 anywhere on the command line.
  656.  
  657.         Version 1.2  06/27/88   Added internal interrupt driven comm port
  658.                                 interrupt service routines since WildCat
  659.                                 disables comm port communications during
  660.                                 a call to arc_view function.
  661.  
  662.         Version 1.3  06/30/88   Fixed interrupt vector bug in internal 
  663.                                 interrupt driven service routine.
  664.  
  665.         Version 1.4  01/22/89   Fixed divide by zero error upon encountering
  666.                                 an unknown storage type.
  667.  
  668.                                 Added detection of Crunched and Crushed
  669.                                 stowage types.
  670.  
  671.                                 Completely revised the modem/console
  672.                                 i/o routines.
  673.  
  674.         Version 2.0  01/23/89   Added option to read text files
  675.                                 within an archive.
  676.  
  677.         Version 2.1  01/31/89   Made the default mode local.
  678.                                 Added temporary extraction pathname.
  679.  
  680.         Version 2.2  02/07/89   Added the ability to download selected
  681.                                 files within an archive.  Made two status
  682.                                 lines to accomodate longer pathnames.
  683.  
  684.         Version 2.3  02/11/89   Extended number of possible filenames in
  685.                                 archive from 128 to 255.  Fixed problem
  686.                                 of negative numbers being assigned to
  687.                                 filenames.
  688.  
  689.  
  690.         AViewCom                        15
  691.  
  692.         Version 2.4  02/19/89   Removed Carey Nash's arcview code and
  693.                                 replaced it with my own which was derived
  694.                                 from descriptions of archive file headers.
  695.                                 Added support for zipfiles and .pak files.
  696.                                 Added ability to mark files and copy them
  697.                                 to a temporary archive for downloading.
  698.  
  699.         Version 2.5  02/19/89   Added activity log.  Added ability to
  700.                                 specify directories to search by reading
  701.                                 a configuration file.  Removed the system()
  702.                                 calls and replaced them with spawnlp(). The
  703.                                 result is smaller memory requirement and
  704.                                 faster operation.
  705.  
  706.         Version 2.6  03/04/89   Added feature to disable the activity log.
  707.                                 Added option to call dsz from a batch file
  708.                                 by putting the path to the batch file in
  709.                                 the environment.
  710.  
  711.         Version 2.7  03/11/89   Added option to ask for another filename to
  712.                                 view when using the /c parameter.  Fixed the
  713.                                 incorrect CRC display with .zip and .zoo files.
  714.  
  715.         Version 2.8  03/18/89   Aviewcom now searches through WildCat's
  716.                                 Activity.log file to determine who is online.
  717.  
  718.         Version 3.0  03/26/89   Removed the 'search activity.log' feature
  719.                                 and replaced it with a 'read CALLINFO.bbs'
  720.                                 feature.  AViewCom uses the information in
  721.                                 CALLINFO.bbs to limit the number of downloads
  722.                                 and the number of download kbytes.
  723.                                 Added LHARC (.lzh) format.
  724.  
  725.         Version 3.0b 04/01/89   Updated AVIEWCOM.DOC to reflect more changes.
  726.                                 Added AViewCom.scr as welcome screen.  Fixed
  727.                                 lzhview to prompt for more after 23 lines.
  728.  
  729.         Version 3.0c 04/07/89   Repaired lzhview to re-list archive filenames
  730.                                 correctly and included lharc as option in
  731.                                 aviewcom.cnf file.  Fixed problem with first
  732.                                 character of filename being displayed as
  733.                                 graphic character when it should be a number.
  734.                                 Added feature to retry download on error.
  735.  
  736.         AViewCom                        16
  737.  
  738.         Version 3.1  04/10/89   Repaired some bugs in the lzhview() function.
  739.                                 Packed some of the code into smaller segments.
  740.                                 Updated the CALLINFO.COM program to eliminate
  741.                                 lockups under some conditions.
  742.  
  743.         Version 3.2  04/13/89   Fixed bug that cause "cannot send \.zip"
  744.                                 message when attempting to download
  745.                                 aviewtmp.zip.
  746.  
  747.         Version 3.3  07/19/89   Fixed many lockup problems associated with
  748.                                 memory corruption by splitting AVIEWCOM into
  749.                                 two programs and using an overlay scheme.
  750.  
  751.         Version 3.4  09/30/89   Added support for Pkzip v1.01
  752.  
  753.         Version 4.0  09/30/89   Added support for WildCat v2.0.  Added feature
  754.                                 to update WildCat's file and caller databases to
  755.                                 reflect the caller's number of total downloads
  756.                                 and total download kbytes.
  757.  
  758.                                 Changed call logging to default to off.
  759.                                 Changed default extractor to PKUNZIP.
  760.  
  761.         Version 3.5  10/06/89
  762.         Version 4.1  10/06/89   Added support for self-extracting archives.
  763.                                 Added support for PAK v2.10.
  764.                                 Fixed MONO comming up in ANSI problem.
  765.  
  766.         Version 3.6
  767.         Version 4.2  12/01/89   Fixed rare bugs, including ANSI/MONO problem.
  768.  
  769.         Version 3.7
  770.         Version 4.3  12/15/89   Incorporated the functions of AVUSER.COM,
  771.                                 AVSETUP.COM, CALLINF2.COM into AViewCom.exe
  772.  
  773.         Daniel Durbin___________________________________________________
  774.         SysOp: Cygnus X-1 BBS                | CIS: 73447,1744
  775.         (619) 457-2665 (data)                | GEnie: D.DURBIN
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.         AViewCom                        17
  783.