home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / AVIEW64F.ZIP / AVIEWCOM.DOC < prev    next >
Text File  |  1992-10-19  |  41KB  |  901 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.           
  11.      _________________________________________________________________
  12.  
  13.                     AViewCom.Exe    Version 6.4f     10/19/92
  14.  
  15.                       Archive View to Console and Comm port
  16.  
  17.            Copyright (C) 1989, 1990, 1991, 1992 by Cygnus Data Systems
  18.                                 Daniel A. Durbin
  19.           
  20.      _________________________________________________________________
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      AViewCom v6.4                                                       1
  64.  
  65.      Contents
  66.      --------
  67.                INSTALLATION . . . . . . . . . . . . . . . .  2
  68.                FILES. . . . . . . . . . . . . . . . . . . .  2
  69.                DISPLAY FILES. . . . . . . . . . . . . . . .  2
  70.                READING DOOR.SYS . . . . . . . . . . . . . .  3
  71.                ENVIRONMENT VARIABLES. . . . . . . . . . . .  3
  72.                DIRECTORIES. . . . . . . . . . . . . . . . .  3
  73.                MULTI-NODE SYSTEMS . . . . . . . . . . . . .  4
  74.                MULTITASKING SYSTEMS . . . . . . . . . . . .  4
  75.                RUNNING AVIEWCOM . . . . . . . . . . . . . .  4
  76.                SysOp COMMANDS . . . . . . . . . . . . . . .  5
  77.                ONLINE COMMANDS. . . . . . . . . . . . . . .  6
  78.                SYNTAX . . . . . . . . . . . . . . . . . . .  7
  79.                SETUP. . . . . . . . . . . . . . . . . . . . 10
  80.                COMM PORTS . . . . . . . . . . . . . . . . . 10
  81.                EXTRACTOR. . . . . . . . . . . . . . . . . . 10
  82.                ANSI COLOR . . . . . . . . . . . . . . . . . 10
  83.                PROTOCOL DEFINITION FILE . . . . . . . . . . 11
  84.                CONFIGURATION FILE . . . . . . . . . . . . . 12
  85.                PRIORITY . . . . . . . . . . . . . . . . . . 12
  86.                Update User's Information. . . . . . . . . . 12
  87.                Installing your Registration Number. . . . . 13
  88.                EXIT CODE. . . . . . . . . . . . . . . . . . 13
  89.                CREDITS & ACKNOWLEDGEMENTS . . . . . . . . . 13
  90.                DISCLAIMER . . . . . . . . . . . . . . . . . 14
  91.                BUGS and LIMITATIONS . . . . . . . . . . . . 14
  92.                FUTURE . . . . . . . . . . . . . . . . . . . 14
  93.  
  94.      DESCRIPTION
  95.      -----------
  96.      AViewCom allows BBS callers to view archive contents while online,
  97.      read ASCII files within archives, and download any file from within an
  98.      archive.  The ability to download files from within the archive is
  99.      useful when a caller wants to read a document file prior to
  100.      downloading the entire archive, or to retrieve one file that may have
  101.      been corrupted during a previous transfer.  Callers may also create a
  102.      temporary archive containing any number of files from the original
  103.      archive.  Aviewcom supports arj, arc, pak, zip, zoo, lzh, lha, and
  104.      some exe and com archives.
  105.  
  106.      AViewCom is written specifically with WildCat BBS in mind since
  107.      WildCat has a [V]iew Archive file function in the files menu which
  108.      makes a call to an external arcview program and passes the caller's
  109.      specified filename to VIEWCOMP.BAT as a DOS parameter %1.  However,
  110.      AViewCom may be used with other BBS's which do not pass a filename as
  111.      a DOS parameter.  In this case, AViewCom may be run as a DOOR program. 
  112.      In the batch file, simply replace the [filename] parameter with an
  113.      asterisk ('*').  AViewCom will then prompt the caller for the full
  114.      pathname to the archive file.  A configuration file may be used to
  115.      specify directories to be searched for the file, so that only the
  116.      filename without the path need be specified.
  117.  
  118.  
  119.      AViewCom v6.4
  120.      AViewCom v6.4                                                       2
  121.  
  122.      INSTALLATION
  123.      ------------
  124.      Make a subdirectory on your hard disk such as C:\WC30\AVIEWCOM and
  125.      extract the distribution archive into that subdirectory.  Modify the
  126.      VIEWCOMP.BAT file to fit your configuration.  Review the AVIEWCOM.CNF
  127.      file and its uses and delete it if not needed.  If you're not running
  128.      WildCat, then modify it to include the sub-directories where you keep
  129.      the archives posted on your BBS.  Review the AVIEWCOM.PRO file and
  130.      modify it as necessary.  Make sure that all required archive utilities
  131.      (e.g. PKUNZIP, PKZIP, ARJ, LHA, PAK) and your file transfer protocols
  132.      (DSZ) are in a subdirectory which is included in your path statement
  133.      (e.g. C:\UTIL or C:\WC30\PROTOCOL and C:\WC30\UTIL).
  134.  
  135.      FILES
  136.      -----
  137.      Included:
  138.  
  139.           AVIEWCOM.CNF   A sample configuration file
  140.           AVIEWCOM.DOC   This file
  141.           AVIEWCOM.EXE   The ArcView program
  142.           AVIEWCOM.HLP   Displayed when caller requests [H]elp
  143.           AVIEWCOM.HST   History of revisions
  144.           AVIEWCOM.BYE   Displayed after ALT-G hot-key logoff
  145.           AVIEWCOM.PRO   External Protocol Definition File
  146.           DIGIFONE.TXT   A Telephone Answering System Ad
  147.           VIEWCOMP.BAT   A sample batch file for WildCat
  148.           WHATSUP.DOC    Information on the latest haps
  149.           ORDER.FRM      Order Form
  150.  
  151.      Not Included:
  152.  
  153.           AVIEWCOM.SCR   Welcome screen for ANSI callers
  154.           AVIEWCOM.BBS   Welcome screen for MONO callers
  155.           AVIEWCOM.LOG   Activity log for AVIEWCOM.EXE
  156.           AVIEWLST.nnn   Temporary archive filename list
  157.           AVIEWnnn.???   Temporary archive used during downloading
  158.           AVIEWCOM.DAT   Created and erased by AVIEWCOM.EXE
  159.           AVIEWCOM.STD   Created when shelling to external programs
  160.           USERINFO.DAT   Created by WildCat - update by AVIEWCOM.EXE
  161.           DOOR.SYS       Created by WildCat - read by AVIEWCOM.EXE
  162.  
  163.      The file AVIEWCOM.CNF is primarily intended for Non-Wildcat systems. 
  164.      If you are entering all your options on the command line, then please
  165.      delete this file to prevent AViewCom from reading options from it.
  166.  
  167.      DISPLAY FILES
  168.      -------------
  169.      You may use your editor to create the welcome screen files. AViewCom
  170.      will display the appropriate file depending on their color setting. 
  171.      If they have color selected but the .SCR file does not exist, the .BBS
  172.      file will be displayed instead.  AViewCom will expect to find these
  173.      files in its "home directory" which is where  AVIEWCOM.EXE resides.
  174.  
  175.      These files are not required, but if they exists, will be displayed.
  176.           AVIEWCOM.HLP   Displayed when the caller requests [H]elp
  177.           AVIEWCOM.SCR   Welcome screen, ANSI color version
  178.           AVIEWCOM.BBS   Welcome screen, monochrome version
  179.      AViewCom v6.4
  180.      AViewCom v6.4                                                       3
  181.  
  182.      READING DOOR.SYS
  183.      ----------------
  184.      AViewCom will read DOOR.SYS and USERINFO.DAT (registered version
  185.      only), which MUST be in the current directory.  AViewCom will search
  186.      the current directory for DOOR.SYS and USERINFO.DAT.  If you CD to any
  187.      other directory, you will need to copy these files to that directory
  188.      before calling AViewCom. The shareware version will not read the
  189.      DOOR.SYS file.  You should however be able to use AViewCom normally. 
  190.      If you are using a non-standard comm port, you may use the -i and -b
  191.      parameters to specify the comm port irq and base address.
  192.  
  193.      ENVIRONMENT VARIABLES
  194.      ---------------------
  195.      AViewCom needs more information than is provided in the DOOR.SYS and
  196.      USERINFO.DAT files.  It reads from the environment:
  197.  
  198.           WCPORTID=CommPort        (Comm Port Number)
  199.           WCBASEID=CommBase        (Comm Port Base Address)
  200.           WCIRQID=CommIRQ          (Comm Port IRQ Number)
  201.  
  202.      Information that is not available from DOOR.SYS, USERINFO.DAT, and the
  203.      environment include:
  204.  
  205.           WCRATIO=UD Ratio Limit        (Sec Level U/D Ratio Limit)
  206.  
  207.      This is number of downloads divided by number of uploads.  For
  208.      example, WCRATIO=20 would mean limit to 20 downloads for every upload.
  209.  
  210.      DIRECTORIES
  211.      -----------
  212.      Because of the number of files AViewCom uses, it is suggested that
  213.      AViewCom reside in its own directory, although this is optional. 
  214.      While in its own directory, it should be run from the main WildCat
  215.      directory, or from the node subdirectory for multi-node installations.
  216.      This is done by simply adding the full pathname to AViewCom in the
  217.      VIEWCOMP.BAT file.  For example:
  218.  
  219.           C:\WC30\AVIEWCOM\AVIEWCOM %1 COM1 -W
  220.  
  221.      AViewCom is smart and knows which directory it is being run from and
  222.      will look in that directory for its operating files.
  223.  
  224.      When AViewCom goes to extract files from archives, it will look in the
  225.      working directory to check if the filename already exists.  If it
  226.      does, the file will not be extracted and the existing file will be
  227.      displayed.  When done, the pre-existing file will not be deleted. The
  228.      best approach is to specify a temporary working directory which is
  229.      normally empty in which AViewCom can extract and display files which
  230.      will then be deleted when finished.  The temporary working directory
  231.      is specified with the '-p' option on the command line. For example:
  232.  
  233.           AVIEWCOM %1 COM1 -pC:\TEMP
  234.  
  235.      Please note that the directory pathname immediately proceeds the -p
  236.      characters.  You should make certain that the specified directory
  237.      actually exists.
  238.  
  239.      AViewCom v6.4
  240.      AViewCom v6.4                                                       4
  241.  
  242.      MULTI-NODE SYSTEMS
  243.      ------------------
  244.      WildCat places the DOOR.SYS file in the node subdirectory.  Since
  245.      AViewCom expects to find this file in the current directory, you must
  246.      CD to the node directory in the VIEWCOMP.BAT file.  You may keep the
  247.      VIEWCOMP.BAT file in the C:\WC30 directory and use the %WCNODEID%
  248.      environment variable in your CD statement to specify the appropriate
  249.      directory.  For example:
  250.  
  251.           CD C:\WC30\WCWORK\NODE%WCNODEID%
  252.  
  253.      MULTITASKING SYSTEMS
  254.      --------------------
  255.      If your system is running a multitasking software, be especially aware
  256.      of memory requirements.  The multitasker, BBS, AViewCom and the
  257.      extractor could all be resident simultaneously.  AViewCom has been
  258.      known to lock up tight with the combination of newer versions of
  259.      DesqView, WildCat, AViewCom, and pkunzip.  Older versions of DesqView
  260.      present no problem.  There ARE several Multi-Node systems now running
  261.      under DesqView that use AViewCom successfully.  If you are
  262.      experiencing difficulties, please review your setup, make sure you
  263.      have sufficient memory available to AViewCom, and try again. If you
  264.      still have trouble, check the DesqView message folder on the CatHouse
  265.      for current information regarding running under DesqView.
  266.  
  267.      RUNNING AVIEWCOM
  268.      ----------------
  269.      AViewCom may be run directly from the command line.  Simply specify
  270.      the full pathname to the archive to be viewed (with no comm port
  271.      specified, AViewCom will default to the local mode).  You should try
  272.      this before adding AViewCom to your BBS.  The screen will clear and a
  273.      prompt appears for ANSI display, then the filename to view.  After
  274.      answering, the contents of the archive will be displayed, and a
  275.      command line prompt will appear.
  276.  
  277.      Then try adding it to your BBS.  If you're using WildCat, modify your
  278.      VIEWCOMP.BAT file to read:  AVIEWCOM %1 COM1 (or whatever comm port
  279.      you are using for your BBS).  Once you're sure this is working okay,
  280.      you may add other options, such as reading caller information from the
  281.      DOOR.SYS (registered version only), a file which is created by Wildcat
  282.      when shelling to an archive viewer.  Add the '-w' parameter to the
  283.      AViewCom command line.  For example:
  284.  
  285.           AVIEWCOM %1 COM1 -W
  286.  
  287.      When using the -W parameter, AViewCom will read the WCBASEID and
  288.      WCIRQID from the environment and the COM1 on the command line serves
  289.      as a dummy variable which must still be present but will be ignored.
  290.  
  291.      Notice that case is not significant in command line parameters. Once
  292.      all this is working, you may wish to further review the other options
  293.      that are available as specified in the SETUP section of this
  294.      documentation.  If you have any trouble, start with things as simple
  295.      as possible.  Then add options one at a time and verify that each is
  296.      working properly.  Also, take time to read all options and review all
  297.      files included in this archive package.
  298.  
  299.      AViewCom v6.4
  300.      AViewCom v6.4                                                       5
  301.  
  302.      Review the files included and delete ALL that are not applicable to
  303.      your configuration.  Most WildCat systems can use the VIEWCOMP.BAT
  304.      file included.  Review the syntax listed below to select options for
  305.      your system.  You may choose to specify all options on the command
  306.      line, OR specify them in the AVIEWCOM.CNF file, whichever is most
  307.      comfortable for you to use. 
  308.  
  309.      However, if you use the command line for specifying options, please 
  310.      delete the .CNF files to reduce confusion.  If you use the .CNF file,
  311.      do not use the command line options.
  312.  
  313.      SysOp COMMANDS
  314.      --------------
  315.      These commands are available ONLY in the registered version. The SysOp
  316.      commands are read directly from the keyboard and are NOT accessible to
  317.      the caller online.  There is no possibility of the caller being able
  318.      to drop to DOS.
  319.  
  320.      While the caller is online, the following commands are available to
  321.      the SysOp.  I will add any other commands you may desire - just make
  322.      the suggestion!
  323.  
  324.           UP        add 1 minute to caller's time.
  325.           DOWN      subtract 1 minute from caller's time.
  326.           PG-UP     add 5 minutes to caller's time.
  327.           PG-DOWN   subtract 5 minutes from caller's time.
  328.           ALT-D     drop to DOS.
  329.           ALT-C     chat with caller
  330.           ALT-Q     goodbye to caller (terminate aviewcom session)
  331.           ALT-G     Drop DTR and HANGUP on caller!
  332.  
  333.      The caller time adjustment does not carry through to WildCat when the
  334.      caller returns to the BBS.  This may change in the future.
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.      AViewCom v6.4
  360.      AViewCom v6.4                                                       6
  361.  
  362.      ONLINE COMMANDS
  363.      ---------------
  364.      AViewCom will allow BBS callers to read text files that are contained
  365.      within an archive file.  AViewCom will not display files with .com,
  366.      .exe, .obj, or .ovl extensions.  The file is also checked for nul
  367.      characters contained within the first 255 bytes of the file and will
  368.      not display it if there are any.  If the file passes the tests, it
  369.      will be extracted by making a DOS call to an external extractor which
  370.      must reside somewhere in the DOS path (which includes the current
  371.      directory).  The file is then extracted to the current directory or
  372.      temporary path, displayed, and deleted. However, if the file already
  373.      exists before the call to the extractor, it is displayed, but not
  374.      deleted.  AViewCom displays the contents of archives in the following
  375.      format.
  376.  
  377. Performing ArcView on [Aview63c.zip]
  378.  
  379.   #  FileName      Stowage   UnZIP Sz  ZIP Size  Pct  Date      Time   CRC 
  380. ═══  ════════════  ════════  ════════  ════════  ═══  ════════  ═════  ════════
  381.   1  av-pif.dvp    Implode        416       126  70%  03/29/92  12:15  A3D5C9F9
  382.   2  aviewcom.hlp  Implode      11777      3801  68%  03/30/92  16:22  46B0F659
  383.   3  aviewcom.doc  Implode      39398     13231  67%  04/17/92  16:57  5CB9CB7D
  384.   4  aviewcom.bye  Stored          50        50   0%  03/29/92  12:15  FFCA0810
  385.   5  aviewcom.pro  Shrunk         195       134  32%  03/29/92  12:15  ED85789B
  386.   6  aviewcom.hst  Implode      15643      4559  71%  04/16/92  22:50  A1431DCE
  387.   7  aviewcom.cnf  Implode       1718      1014  41%  03/29/92  12:15  32F790DE
  388.   8  order.frm     Implode       2623       991  63%  03/30/92  16:19  49C97D97
  389.   9  viewcomp.bat  Implode       1220       712  42%  03/29/92  12:15  CFFD0EBF
  390.  10  digifone.txt  Implode       3260      1489  55%  03/29/92  12:15  C2CA5418
  391.  11  aviewcom.exe  Implode      51698     31780  39%  04/18/92  01:29  87F04665
  392.  12  whatsup.doc   Implode       8291      3770  55%  04/15/92  21:00  6B8379D3
  393. ───  ────────────            ────────  ────────  ───
  394.  12  File(s)   Pkunzip Total   136786     62037  55%
  395.  
  396. Enter [filename] or [#] to read, [D]ownLoad, [M]ark, [V]iew, [L]ist, or [H]elp
  397. [45] Mins Left [ # [filename] D M V L H [Return] to Quit]? 
  398.  
  399.      The viewer is then presented with the above command prompt. The viewer
  400.      may enter the filename as it appears in the view listing, or may enter
  401.      the number associated with the filename (shown on the very left of the
  402.      listing).
  403.  
  404.           [file]    full filename of the file to view
  405.           [D]       download a file or marked files from the archive
  406.           [M]       mark a file
  407.           [V]       re-View the archive showing detailed information
  408.           [L]       list filenames, dates, and marked status
  409.           [H]       display AVIEWCOM.HLP
  410.           [Return]  terminate AViewCom session
  411.  
  412.      Not shown is the S command.  This command displays the caller's
  413.      "Statistics".  This command is provided to check that AViewCom has
  414.      properly read the caller's information from DOOR.SYS.  For more
  415.      details on Operation, please see the accompanying text file
  416.      AVIEWCOM.HLP.
  417.  
  418.  
  419.      AViewCom v6.4
  420.      AViewCom v6.4                                                       7
  421.  
  422.      SYNTAX
  423.      ------
  424.      AViewCom [?]
  425.  
  426.      ?    If first and only parameter, displays syntax help screen.
  427.  
  428.      In the arcview mode, AViewCom accepts the following parameters on
  429.      the command line.  Each is detailed below.
  430.  
  431.      AViewCom file [port] [-a#] [-b#] [-c] [-d] [-e#] [-i] [-l] [-p{tpath}]
  432.                           [-q] [-r#] [-t#] [-u] [-w]
  433.  
  434.      file is a required parameter.  If omitted, there must be no other
  435.           parameters on the command line and the caller will be prompted
  436.           for a file to an archive file.  file is any valid DOS pathname to
  437.           the file to be viewed.  The archive extension is optional and is
  438.           added if not included.  Some BBS's such as WildCat! pass the file
  439.           as a DOS parameter.  WildCat! uses %1.  If the character '*' use
  440.           used as file, other options may be specified and the caller will
  441.           be prompted for a file to view.  file may also be a filelist of
  442.           files to view if preceeded with an '@'.  eg @file.lst.
  443.  
  444.      port is either 'com#' or 'local' where # is from 1 to 22 This is an
  445.           optional parameter and defaults to local.  If neither of these
  446.           are specified, local mode is entered and no transmission is sent
  447.           to the comm port.  In this manner, AViewCom may be run in the
  448.           local mode.
  449.  
  450.      -a#  is an optional parameter where # either 0, 1, or 2:
  451.  
  452.                0 = no ANSI.  In this mode, all display is MONO.
  453.                1 = ANSI color.  All display is in ANSI color.
  454.                2 = prompt caller for ANSI color or not (default).
  455.  
  456.           For WildCat systems, this parameter is not needed if the -w
  457.           switch is used, since this information will be read from DOOR.SYS
  458.           (registered version only).
  459.  
  460.      -b#  4 digit hexidecimal comm port base address.  This option is
  461.           included if for some reason the information cannot be read from
  462.           another source.  For example: -b02E8.
  463.  
  464.      -c   If -c is included on the command line, AViewCom will read options
  465.           from AVIEWCOM.CNF file.  If an asterisk is entered as the
  466.           filename, AViewCom will search through directories that are
  467.           listed after the #search command in the AVIEWCOM.CNF file.  This
  468.           option is included for non-WildCat systems which do not pass the
  469.           filename to view as a DOS parameter.
  470.  
  471.      -d   disables the download option.  This is included for those systems
  472.           which prefer not to allow downloading.  If not included,
  473.           downloading is enabled and external protocol programs must be
  474.           somewhere in the DOS path.
  475.  
  476.      -q   Disables prompt before shelling to external program while running
  477.           under a DesqView environment.  Use this if your system doesn't crash
  478.           when reading a text file and you are running DesqView.
  479.      AViewCom v6.4
  480.      AViewCom v6.4                                                       8
  481.  
  482.      -e#  Used to specify an archiver where # is as follows:
  483.  
  484.                0    pkarc (.COM or .EXE)
  485.                1    pkpak
  486.                2    pak
  487.                3    arc
  488.                4    pkzip [default]
  489.                5    zoo
  490.                6    lha
  491.                7    arj
  492.  
  493.           If you use code 2, make sure that PAK.CNF is such that the
  494.           archive will not be deleted after extracting it.  The specified
  495.           extractor is also used to create the temporary archive which is
  496.           assigned the name AVIEWnnn.???.
  497.           Archiver versions supported (up to and including):
  498.  
  499.                PKXARC       v3.61
  500.                PKUNPAK      v3.61
  501.                PAK          v2.51
  502.                ARC          v6.02
  503.                PKUNZIP      v1.10        (v1.93 is still alpha testing)
  504.                ZOO          v2.01
  505.                LHA          v2.13
  506.                ARJ          v2.30
  507.  
  508.           Please let me know if an archiver has a more current version.
  509.  
  510.      -i   comm port IRQ number.  The registered version of AViewCom reads
  511.           the comm port information including IRQ and port base address
  512.           from the environment.  The -i parameter is provided for systems
  513.           not using WildCat, or for the shareware version.
  514.  
  515.      -l   enables activity logging.  If this is included, AViewCom will
  516.           create and maintain an activity log called AVIEWCOM.LOG which
  517.           will contain dates and times of all arcviews and downloads that
  518.           occur.
  519.  
  520.      -n#  is an optional parameter if omitted, defaults to no limit.  If #
  521.           is specified, it limits the maximum size of archive files created
  522.           for download to #.
  523.  
  524.      -ptpath   is an optional parameter and if omitted, defaults to the
  525.           current working directory.  tpath is any valid DOS path and
  526.           specifies a temporary directory for the external extractor to use
  527.           when extracting files.  A useful tpath is a ramdrive.  The '-p'
  528.           indicates that a DOS pathname follows.
  529.  
  530.      -r#  Define the connection baud rate for file xfer calculations where
  531.           # is 300, 1200, 2400, 9600, 19200, or 38400.
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.      AViewCom v6.4
  540.      AViewCom v6.4                                                       9
  541.  
  542.      -spassword   Normally, no password is required for the local sysop to
  543.           drop to dos (not the caller!).  If the -s parameter appears on the
  544.           command line with no password, then drop to dos is disabled.  If
  545.           -spassword appears where password is any 15 character printable
  546.           character (case IS significant), then the local sysop will be
  547.           prompted for this password before they are allowed to drop to dos.
  548.           If an incorrect password is given, a log entry is made and drop
  549.           to dos is not allowed.
  550.  
  551.      -t#  This parameter allows the SysOp to specify a maximum number of
  552.           minutes that the caller will be allowed to spend in a session of
  553.           AViewCom.  # is the number of minutes to be allowed.  In the
  554.           WildCat mode, the time allowed is read from DOOR.SYS.
  555.  
  556.           AViewCom computes file transfer times as if the file were
  557.           transfered at 95% efficiency.  If the caller does not have enough
  558.           time left for the file transfer, they will not be allowed to
  559.           download the file.
  560.  
  561.      -u   if included, instructs AViewCom to update the USERINFO.DAT file
  562.           which contains the number of files and kilobytes the caller
  563.           downloaded during the current session of AViewCom.
  564.                      
  565.           This option is available only for registered callers using
  566.           WildCat v3.n.  The ShareWare version AViewCom does NOT write any
  567.           information to USERINFO.DAT.
  568.  
  569.      -v   Disable direct screen writes.  AViewCom uses bios writes for
  570.           everything except saving the screen when dropping to DOS and
  571.           shelling out ext prots or any archiver/extractor.  Disabling
  572.           direct screen writes provides compatibility with programs like
  573.           DesqView and is not normally necessary.  Also, disabling direct
  574.           screen writes slows down the capture of the screen considerably.
  575.  
  576.      -w   Read the DOOR.SYS file for caller information.  With this option,
  577.           the DOOR.SYS file is read for caller information and the caller's
  578.           download ratio and number of downloaded kbytes are checked.  The
  579.           caller will not be able to download files if the ratio has
  580.           exceeded the values set for ratio limit.  If no limit is defined,
  581.           the upload/download ratio is set to 1:20.
  582.  
  583.           AViewCom will search the current directory for DOOR.SYS.  If you
  584.           CD to any other directory, you will need to copy this file to
  585.           that directory before calling AViewCom.
  586.  
  587.           This parameter is active ONLY in the registered version.
  588.  
  589.      -z   This is a temporary parameter used to override LINE 30 in DOOR.SYS
  590.           which is incorrectly written by WildCat and sometimes causes
  591.           AViewCom to report that the user has exceeded the download kbyte
  592.           limit.  This bug exists in v3.00, v3.01, and v3.02 of WildCat.
  593.           Including this parameter on the command line will ZERO the caller's
  594.           DAILY DOWNLOAD KBYTES.  Therefore, if the caller has exceeded the
  595.           daily downlaod kbyte limit, AViewCom will still allow downloads.
  596.           However, the TOTAL KBYTE LIMIT is still in effect.  Note:  WildCat
  597.           v3.50 corrected this problem.
  598.  
  599.      AViewCom v6.4
  600.      AViewCom v6.4                                                      10
  601.      SETUP
  602.      -----
  603.      COMM PORTS
  604.      ----------
  605.      AViewCom will display the contents of an archive to the local console
  606.      and to COM1 through COM22 as specified on the command line. If no comm
  607.      port is specified, AViewCom enters the local mode and no output is
  608.      sent to the comm port.  Standard IRQ and Base Address are used for
  609.      comm ports 1 to 4.  Extended comm port numbers are assigned IRQ and
  610.      Base Address as listed below.  These defaults may be overridden on the
  611.      command line with the '-b' and '-i' parameters, or by specifying the
  612.      '-w' parameter on the command line and using the environment variables
  613.      for wildcat to specify the base address and irq number. Specifying
  614.      COM0: forces AViewCom to the local mode.
  615.           BASE, IRQ =    PORT #         BASE, IRQ =    PORT #
  616.           LOCAL          COM0           0x0368, 7 =    COM11
  617.           0x03F8, 4 =    COM1           0x0368, 9 =    COM12
  618.           0x02F8, 3 =    COM2           0x0278, 5 =    COM13
  619.           0x03E8, 4 =    COM3           0x03E8, 7 =    COM14
  620.           0x02E8, 3 =    COM4           0x03E8, 9 =    COM15
  621.           0x0378, 7 =    COM5           0x03E8, 5 =    COM16
  622.           0x0278, 9 =    COM6           0x02E8, 7 =    COM17
  623.           0x0368, 5 =    COM7           0x02E8, 9 =    COM18
  624.           0x0278, 7 =    COM8           0x02E8, 5 =    COM19
  625.           0x0378, 9 =    COM9           0x0268, 7 =    COM20
  626.           0x0378, 5 =    COM10          0x0268, 9 =    COM21
  627.                                         0x0268, 5 =    COM22
  628.      EXTRACTOR
  629.      ---------
  630.      AViewCom does not require any external programs to display the
  631.      filenames within the archive.  It does require an external extractor
  632.      to display text files and extract files for downloading. Before
  633.      displaying a text file, AViewCom makes a DOS call to an external
  634.      extractor which may be anywhere in the DOS path.  AViewCom examines
  635.      the archive extension to determine which extractor to use. The SysOp
  636.      may specify a temporary path to extract files to with the '-p'
  637.      parameter on the command line.  Review the '-e' command below for
  638.      further information on extractors.  Please be aware that the BBS
  639.      shells to AViewCom which shells to an extractor.
  640.      If AViewCom will display the archive contents, but will not display a
  641.      text file, then the trouble must be in shelling out to the extractor -
  642.      possibly not enough memory (different extractors require different
  643.      amounts of memory), or the archiver is not in the DOS path.
  644.      ANSI COLOR
  645.      ----------
  646.      AViewCom can display ANSI color.  If the '-a1' parameter is included
  647.      on the command line, the contents are displayed in color locally and
  648.      to the remote caller.  If ANSI is selected, an ANSI device driver is
  649.      required for the host computer.  However, a color monitor is not
  650.      required.  You must have a line in your CONFIG.SYS file resembling the
  651.      following:
  652.                DEVICE=C:\DOS\ANSI.SYS
  653.  
  654.      If an ANSI driver is not installed and ANSI is selected the display
  655.      will be cluttered with ANSI escape sequences. When running under
  656.      DesqView, you need to install the DesqView ANSI driver (DVANSI.COM) by
  657.      calling it from the batch file that starts up WildCat.  Please refer
  658.      to your DesqView manual for info on DVANSI.COM.
  659.      AViewCom v6.4
  660.      AViewCom v6.4                                                      11
  661.  
  662.      PROTOCOL DEFINITION FILE
  663.      ------------------------
  664.      AViewCom will allow BBS callers to download any file that is contained
  665.      within an archive file.  AViewCom makes a DOS call to external
  666.      protocols which may be anywhere in the DOS path (including the current
  667.      directory).  External protocols can be specified in the file
  668.      AVIEWCOM.PRO which is included with a few standard protocols. The file
  669.      is then extracted to the current directory or temporary path,
  670.      transfered, and deleted.  However, if the file already exists before
  671.      the call to the protocol, it is sent, but not deleted. Including '-d'
  672.      on the command line disables the downloading feature.  If the caller
  673.      has marked several files for downloading, AViewCom will extract these
  674.      files and archive them into a temporary file called AVIEWnnn.??? using
  675.      the default archiver PKZIP, and nnn is a number chosen to distinguish
  676.      temporary filenames.  An archiver other than PKZIP may be specified
  677.      with the '-e' option.
  678.  
  679.      AVIEWCOM.PRO:  This file defines the command line switches to be used
  680.      with external protocols.  Each line in the file is a definition for
  681.      different protocols.  Every line MUST follow the following format:
  682.  
  683.      Title,key,pathname,args
  684.  
  685.      Title     =  Protocol name displayed to the caller (spaces okay).
  686.      key       =  Letter designation entered by caller during selection
  687.      pathname  =  External Protocol Filename.  This may be as simple as "dsz" or
  688.                may contain the extension "dsz.exe" or may also contain the full
  689.                pathname "c:\util\dsz.exe".
  690.      args      =  command line arguements passed to the external protocol to
  691.                specify the type of file transfer.  This may be any number of
  692.                switches which MAY be include spaces.
  693.  
  694.      Parameters
  695.      ----------
  696.  
  697.      %1 = comm port number
  698.      %2 = ADDR,IRQ (eg 3E8,1) base address and irq number of comm port
  699.      %3 = filename
  700.      %4 = baud rate
  701.  
  702.      The comm port number is passed as %1.  The ADDR,IRQ numbers are passed
  703.      as %2 in the form compatible with that required by the DSZ PORTX
  704.      parameter.  For example "3E8,1" for com3. These fields MUST be
  705.      separated by one comma and NO spaces!  Any other format will cause
  706.      unpredictable results!  Please refer to the AVIEWCOM.PRO file included
  707.      as an example.  The filename is always provided automatically as the
  708.      last arguement passed to the external protocol.  You MUST include comm
  709.      port number!  The filename to be transfered is passed as %3.  If %3 is
  710.      omitted, then the filename will be appended to the end of the parameter
  711.      list.
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.      AViewCom v6.4
  720.  
  721.      AViewCom v6.4                                                      12
  722.  
  723.      CONFIGURATION FILE
  724.      ------------------
  725.      The text file AVIEWCOM.CNF is provided for NON-WILDCAT systems, but
  726.      may also be used by WildCat systems and may be edited with any ASCII
  727.      editor.  The options are outlined in AVIEWCOM.DOC and a sample
  728.      AVIEWCOM.CNF file is provided.
  729.  
  730.      If the file AVIEWCOM.CNF exists, options will be read from a
  731.      configuration file.  The configuration file may contain ';' to
  732.      indicate comments.  The rest of the line after the ';' is ignored.
  733.      Lines beginning with '#' are command lines. 
  734.      Recognized commands are:
  735.              #search                   ;search directories
  736.              #paths                    ;paths to search
  737.              #port                     ;com port
  738.              #video                    ;ANSI or MONO
  739.              #temporary                ;extracting directory
  740.              #extractor                ;type of extractor
  741.              #nodownload               ;disables downloading
  742.              #log                      ;enables activity log
  743.              #timelimit                ;max minutes allowed
  744.              #update                   ;update USERINFO.DAT
  745.              #wildcat                  ;read DOOR.SYS
  746.      After each command line, another line begins containing options for
  747.      the last command.  The paths command is used to specify directories to
  748.      search for the requested archive file.  There is no limit to the
  749.      number of directories which may be searched.  See the included
  750.      AVIEWCOM.CNF file for further information.
  751.  
  752.      PRIORITY
  753.      --------
  754.      AViewCom will accept options from (low to high priority):
  755.  
  756.              lowest:    1)  defaults
  757.                         2)  the command line
  758.                         3)  DOOR.SYS (port, ansi, timelimit only)
  759.                         4)  wildcat configuration (environment SET)
  760.              highest:   5)  a text configuration file    (AVIEWCOM.CNF)
  761.  
  762.      The lowest priority option settings are overwritten by the highest
  763.      option settings.  If you don't need the AVIEWCOM.CNF file, delete it. 
  764.      Most systems can do without it.  It is mainly included for non-WildCat
  765.      systems to list directories to search for the file. For WildCat
  766.      systems, you should be able to list all of the options you need on the
  767.      command line.
  768.  
  769.      Update User's Information
  770.      -------------------------
  771.      AViewCom will now save information on the caller's downloading
  772.      activity.  If the caller has downloaded anything, the number of
  773.      downloads and the download kbytes are saved in a file called
  774.      USERINFO.DAT which is used by WildCat to update the user databases.
  775.  
  776.      There are 2 types of information that are updated:
  777.  
  778.              Downloads        (Line 17)
  779.              Download Kbytes  (Line 18)
  780.      AViewCom v6.4
  781.  
  782.      AViewCom v6.4                                                      13
  783.  
  784.      Installing your Registration Number
  785.      -----------------------------------
  786.  
  787.      If you have registered AViewCom, you will receive a registration
  788.      number which will appear on your diskette label, and on the receipt
  789.      you receive from Cygnus Data Systems.  Use this number with the
  790.      registration program included on the distribution diskette.  If you do
  791.      not have this program, and you have registered AViewCom, you may call
  792.      my BBS listed at the end of this document and download it. If you do
  793.      not have an account on my BBS, I will first have to validate your
  794.      account and give you access to the registered directory.  You may then
  795.      use this same program to install your registration number into all
  796.      future releases of AViewCom.
  797.  
  798.      These functions are enabled when AViewCom is registered:
  799.  
  800.      1)   A "Registered to" message is displayed with your BBS name
  801.      2)   The User Update function
  802.      3)   Will read WCPORTID, WCIRQID, WCBASEID from environment
  803.      4)   Will read DOOR.SYS and USERINFO.DAT files
  804.      5)   Will remove "Please register" message upon exiting
  805.      6)   Will enable the SysOp functions
  806.  
  807.      Please note:  WildCat v3.00 incorrectly writes line 30 of DOOR.SYS
  808.      which should the user's daily download kbyte total.  It instead writes
  809.      the same value as in line 48 which is total download kbytes (from day
  810.      one!).  This WildCat bug may cause AViewCom to give the message
  811.      "Sorry, you have exceeded your daily download ratio".
  812.  
  813.      EXIT CODE
  814.      ---------
  815.  
  816.      A DOS errorlevel of 1 is returned when an error in command line
  817.      parameters is encountered, or upon any error during execution.
  818.  
  819.      AViewCom monitors carrier detect and returns a DOS errorlevel of 2
  820.      upon loss of carrier detect.  It also monitors keyboard inactivity. 
  821.      If no keyboard activity occurs for 3 minutes while waiting at a
  822.      prompt, AViewCom exits with a DOS errorlavel of 3.
  823.  
  824.      CREDITS & ACKNOWLEDGEMENTS
  825.      --------------------------
  826.  
  827.      AViewCom was inspired by the ArcView function in Perspective Data
  828.      Systems by Carey Nash.  Original versions used his code, but have
  829.      since been replaced by my own.  The ShareWare version may be freely
  830.      distributed but may not be sold for any reason. The registered version
  831.      may NOT be distributed and may only be used on one system per
  832.      registration.
  833.  
  834.      The comm port communications are interrupt driven.  The original
  835.      interrupt request vector is saved and replaced with a local interrupt
  836.      service routine.  The original ISR is replaced on exit.
  837.  
  838.  
  839.  
  840.  
  841.      AViewCom v6.4
  842.      AViewCom v6.4                                                      14
  843.  
  844.      To register your copy of AViewCom, print the file ORDER.FRM.  You may
  845.      wish to use your editor to fill in the blanks before printing the
  846.      form.  If you choose to register AViewCom, you will receive the latest
  847.      version of the program, and a printed manual. In addition, I will be
  848.      able to continue to support AViewCom and provide additional features
  849.      and enhancements.  See future below.
  850.  
  851.                    Daniel Durbin
  852.                    6216 Agee Street #124
  853.                    San Diego, CA  92122-3533
  854.                    (619) 457-2532 (voice) (evenings)
  855.                    (619) 457-2665 (data)
  856.  
  857.  
  858.  
  859.  
  860.      DISCLAIMER
  861.      ----------
  862.      THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
  863.      EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED
  864.      WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. 
  865.      THE AUTHOR WILL NOT BE LIABLE TO USERS OF THIS PROGRAM FOR ANY
  866.      DAMAGES, INCLUDING LOST PROFITS OR LOST SAVINGS OR OTHER INCIDENTAL OR
  867.      CONSEQUENTIAL DAMAGES, ARISING OUT OF USE OF THIS PROGRAM.
  868.  
  869.      BUGS and LIMITATIONS
  870.      --------------------
  871.  
  872.      FUTURE
  873.      ------
  874.  
  875.      All suggestions are welcome and encouraged and may be mailed, emailed
  876.      or phoned to me anytime.  This is a continuation of AViewCom and many
  877.      enhancements and improvements will be added and supported. I thank all
  878.      those who have given me feedback and encouragement.
  879.  
  880.      * An optional menu file supporting WildCat control codes.
  881.  
  882.      * Option to ignore form feed, or to clear screen for each one.
  883.  
  884.      Daniel Durbin_______________________________________________
  885.      SysOp: Cygnus X-1 BBS                | CIS: 73447,1744
  886.      (619) 457-2665 (data)                | GEnie: D.DURBIN
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.      AViewCom v6.4