home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / ps2_202e.zip / PALMSCAN.DOC < prev    next >
Text File  |  1996-04-30  |  176KB  |  5,388 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                   PalmScan v2.02
  30.  
  31.  
  32.                      The Ultimate Archive Conversion Utility
  33.  
  34.  
  35.                                     User guide
  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.                                   PalmScan v2.02
  64.  
  65.  
  66.                      The Ultimate Archive Conversion Utility
  67.  
  68.  
  69.                                   April 30, 1996
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.               Software and documentation written by Steven Hendriks
  91.  
  92.                      Copyright (C) 1993,96 by Steven Hendriks
  93.  
  94.                                All rights reserved.
  95.  
  96.  
  97.                      All information in this documentation is
  98.                       subject to change without prior notice
  99.       PalmScan v2.02                                             User guide
  100.       ---------------------------------------------------------------------
  101.  
  102.       Table of Contents
  103.       -----------------
  104.  
  105.       1  Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  106.          1.1  Copyright and License Agreement . . . . . . . . . . . . . . 6
  107.          1.2  Contacting the author . . . . . . . . . . . . . . . . . . . 7
  108.          1.3  What is PalmScan  . . . . . . . . . . . . . . . . . . . . . 7
  109.          1.4  Features  . . . . . . . . . . . . . . . . . . . . . . . . . 8
  110.          1.5  System requirements . . . . . . . . . . . . . . . . . . .  10
  111.          1.6  Logging . . . . . . . . . . . . . . . . . . . . . . . . .  10
  112.          1.7  The distribution package  . . . . . . . . . . . . . . . .  11
  113.          1.8  Runtime . . . . . . . . . . . . . . . . . . . . . . . . .  11
  114.          1.9  Extended Wildcards  . . . . . . . . . . . . . . . . . . .  12
  115.  
  116.       2  Installation . . . . . . . . . . . . . . . . . . . . . . . . .  13
  117.          2.1  First time installation . . . . . . . . . . . . . . . . .  13
  118.               2.2.1  Installing PalmScan in FileDoor  . . . . . . . . .  13
  119.               2.2.2  Installing PalmScan in SuperBBS  . . . . . . . . .  13
  120.               2.2.3  Installing PalmScan in Allfix  . . . . . . . . . .  14
  121.               2.2.4  Installing PalmScan in RemoteAccess 2.xx . . . . .  14
  122.               2.2.5  Installing PalmScan in RAFT  . . . . . . . . . . .  14
  123.               2.2.6  Installing PalmScan in Maximus . . . . . . . . . .  15
  124.               2.2.7  Installing PalmScan in Ezycom  . . . . . . . . . .  16
  125.               2.2.8  Installing PalmScan in Concord . . . . . . . . . .  17
  126.               2.2.9  Installing PalmScan in ProBoard  . . . . . . . . .  17
  127.          2.3  Commandline . . . . . . . . . . . . . . . . . . . . . . .  18
  128.          2.4  Watchdog, CTTY, ANSI.SYS  . . . . . . . . . . . . . . . .  24
  129.          2.5  Errorlevels . . . . . . . . . . . . . . . . . . . . . . .  24
  130.  
  131.       3  The configuration  . . . . . . . . . . . . . . . . . . . . . .  25
  132.          3.1  PALMSCAN.CFG  . . . . . . . . . . . . . . . . . . . . . .  25
  133.          3.2  PSetup  . . . . . . . . . . . . . . . . . . . . . . . . .  26
  134.               3.2.1  Commandline  . . . . . . . . . . . . . . . . . . .  26
  135.               3.2.2  Starting PSetup  . . . . . . . . . . . . . . . . .  26
  136.               3.2.3  Keys . . . . . . . . . . . . . . . . . . . . . . .  26
  137.          3.3  System data . . . . . . . . . . . . . . . . . . . . . . .  27
  138.               3.3.1  Site Information . . . . . . . . . . . . . . . . .  27
  139.                      BBS name . . . . . . . . . . . . . . . . . . . . .  27
  140.                      SysOp name . . . . . . . . . . . . . . . . . . . .  27
  141.                      Key number . . . . . . . . . . . . . . . . . . . .  27
  142.               3.3.2  Screen settings  . . . . . . . . . . . . . . . . .  28
  143.                      Redirect screen output of external programs  . . .  28
  144.                      Normal color . . . . . . . . . . . . . . . . . . .  28
  145.                      Highlighted color  . . . . . . . . . . . . . . . .  28
  146.                      Background color . . . . . . . . . . . . . . . . .  29
  147.                      Edit color . . . . . . . . . . . . . . . . . . . .  29
  148.                      Edit background  . . . . . . . . . . . . . . . . .  29
  149.               3.3.3  Pathnames  . . . . . . . . . . . . . . . . . . . .  30
  150.                      Temporary directory  . . . . . . . . . . . . . . .  30
  151.                      Bad files directory  . . . . . . . . . . . . . . .  30
  152.                      Infected files directory . . . . . . . . . . . . .  30
  153.                      Hacked files directory . . . . . . . . . . . . . .  31
  154.                      Old files directory  . . . . . . . . . . . . . . .  31
  155.                      Bad GIF files directory  . . . . . . . . . . . . .  31
  156.                      Substitute drive . . . . . . . . . . . . . . . . .  32
  157.               3.3.4  Files Lists  . . . . . . . . . . . . . . . . . . .  33
  158.                      Hacked files list  . . . . . . . . . . . . . . . .  33
  159.                      Skip files list  . . . . . . . . . . . . . . . . .  33
  160.                      Pack Unpacked files list . . . . . . . . . . . . .  33
  161.                      Remove files list  . . . . . . . . . . . . . . . .  34
  162.       PalmScan v2.02                                             User guide
  163.       ---------------------------------------------------------------------
  164.  
  165.                      Add files list . . . . . . . . . . . . . . . . . .  34
  166.                      Password list  . . . . . . . . . . . . . . . . . .  34
  167.               3.3.5  Message System . . . . . . . . . . . . . . . . . .  35
  168.                      Net address  . . . . . . . . . . . . . . . . . . .  35
  169.                      Messagebase path . . . . . . . . . . . . . . . . .  35
  170.                      Messagebase format . . . . . . . . . . . . . . . .  36
  171.                      Message area number  . . . . . . . . . . . . . . .  36
  172.                      MessageArea configuration keyword  . . . . . . . .  37
  173.               3.3.6  File-database  . . . . . . . . . . . . . . . . . .  38
  174.                      File-database  . . . . . . . . . . . . . . . . . .  38
  175.                      Uploader name  . . . . . . . . . . . . . . . . . .  39
  176.                      BBS system directory . . . . . . . . . . . . . . .  39
  177.                      Update FILES.BBS   . . . . . . . . . . . . . . . .  40
  178.                      Extended descriptions character  . . . . . . . . .  40
  179.                      Spaces to indent . . . . . . . . . . . . . . . . .  41
  180.                      Download counters  . . . . . . . . . . . . . . . .  41
  181.                      FILES.BBS Filename . . . . . . . . . . . . . . . .  42
  182.                      Online Import  . . . . . . . . . . . . . . . . . .  42
  183.               3.3.7  Miscellaneous  . . . . . . . . . . . . . . . . . .  43
  184.                      Log file . . . . . . . . . . . . . . . . . . . . .  43
  185.                      Log style  . . . . . . . . . . . . . . . . . . . .  43
  186.                      No disk space check  . . . . . . . . . . . . . . .  44
  187.                      Exec timeout . . . . . . . . . . . . . . . . . . .  44
  188.          3.4  File Processing . . . . . . . . . . . . . . . . . . . . .  45
  189.               3.4.1  General settings . . . . . . . . . . . . . . . . .  45
  190.                      Only process new files . . . . . . . . . . . . . .  45
  191.                      Only process listed files  . . . . . . . . . . . .  46
  192.                      Process embedded archives  . . . . . . . . . . . .  46
  193.                      New archive date . . . . . . . . . . . . . . . . .  47
  194.               3.4.2  Archive Conversion . . . . . . . . . . . . . . . .  48
  195.                      Archive conversion . . . . . . . . . . . . . . . .  48
  196.                      SFX  . . . . . . . . . . . . . . . . . . . . . . .  48
  197.                      Only Main Archives . . . . . . . . . . . . . . . .  48
  198.                      Don't convert secure archives  . . . . . . . . . .  49
  199.                      Only convert embedded archives with normal extensions
  200.                             . . . . . . . . . . . . . . . . . . . . . .  49
  201.                      ArchiveConversion configuration keyword  . . . . .  50
  202.                      Convert ALL archives . . . . . . . . . . . . . . .  50
  203.               3.4.3  Self-Extracting Archives . . . . . . . . . . . . .  51
  204.                      Process SFX archives . . . . . . . . . . . . . . .  51
  205.                      Do not convert self-extracting archives  . . . . .  51
  206.                      Process UC2 self-extracting archives . . . . . . .  51
  207.                      UC2 SFX commandline options  . . . . . . . . . . .  52
  208.                      Only process sealed UC2 self-extracting archives .  52
  209.                      UC2SFX configuration keyword . . . . . . . . . . .  52
  210.                      UC2 SFX seal test command  . . . . . . . . . . . .  53
  211.                      Scan SFX archives for viruses  . . . . . . . . . .  53
  212.               3.4.4  Archive Headers  . . . . . . . . . . . . . . . . .  54
  213.                      Archive header file  . . . . . . . . . . . . . . .  54
  214.                      Alternative header file  . . . . . . . . . . . . .  54
  215.                      Put FILE_ID description in archive header  . . . .  55
  216.                      No title in headers  . . . . . . . . . . . . . . .  55
  217.               3.4.5  Descriptions . . . . . . . . . . . . . . . . . . .  56
  218.                      Import FILE_ID description . . . . . . . . . . . .  56
  219.                      One line FILE_ID . . . . . . . . . . . . . . . . .  56
  220.                      Filter high ASCII  . . . . . . . . . . . . . . . .  56
  221.                      Filter control codes . . . . . . . . . . . . . . .  57
  222.                      Filter drawings  . . . . . . . . . . . . . . . . .  57
  223.                      Maximum Width  . . . . . . . . . . . . . . . . . .  57
  224.                      Maximum Length . . . . . . . . . . . . . . . . . .  58
  225.       PalmScan v2.02                                             User guide
  226.       ---------------------------------------------------------------------
  227.  
  228.                      FileID configuration keyword . . . . . . . . . . .  58
  229.                      Describe MOD's . . . . . . . . . . . . . . . . . .  59
  230.          3.5  Archivers . . . . . . . . . . . . . . . . . . . . . . . .  60
  231.               3.5.1  Archiver commands  . . . . . . . . . . . . . . . .  60
  232.                      Compression  . . . . . . . . . . . . . . . . . . .  61
  233.                      Decompression  . . . . . . . . . . . . . . . . . .  61
  234.                      Add Header . . . . . . . . . . . . . . . . . . . .  62
  235.                      Alternative header . . . . . . . . . . . . . . . .  62
  236.                      Test . . . . . . . . . . . . . . . . . . . . . . .  63
  237.                      Multi-Volume Compression . . . . . . . . . . . . .  63
  238.                      Multi-Volume Decompression . . . . . . . . . . . .  64
  239.                      Example archiver commands  . . . . . . . . . . . .  64
  240.               3.5.2  Archive Protection . . . . . . . . . . . . . . . .  66
  241.                      UC2 protection . . . . . . . . . . . . . . . . . .  66
  242.                      RAR lock . . . . . . . . . . . . . . . . . . . . .  66
  243.          3.6  Virus scan  . . . . . . . . . . . . . . . . . . . . . . .  67
  244.               3.6.1  Files to scan  . . . . . . . . . . . . . . . . . .  67
  245.               3.6.2  Virus scanners . . . . . . . . . . . . . . . . . .  67
  246.                      Scanner name . . . . . . . . . . . . . . . . . . .  67
  247.                      Command  . . . . . . . . . . . . . . . . . . . . .  68
  248.                      Low Errorlevel . . . . . . . . . . . . . . . . . .  68
  249.                      High Errorlevel  . . . . . . . . . . . . . . . . .  69
  250.                      Other Errorlevel . . . . . . . . . . . . . . . . .  69
  251.                      File specifications  . . . . . . . . . . . . . . .  69
  252.                      Scanner configuration keyword  . . . . . . . . . .  70
  253.               3.6.3  Options  . . . . . . . . . . . . . . . . . . . . .  71
  254.                      Complete scan  . . . . . . . . . . . . . . . . . .  71
  255.                      Fast scan  . . . . . . . . . . . . . . . . . . . .  71
  256.                      No DOS scanners  . . . . . . . . . . . . . . . . .  71
  257.          3.7  Hacked Files  . . . . . . . . . . . . . . . . . . . . . .  72
  258.          3.8  Skip Files  . . . . . . . . . . . . . . . . . . . . . . .  72
  259.          3.9  Pack Unpacked . . . . . . . . . . . . . . . . . . . . . .  73
  260.               File specifications . . . . . . . . . . . . . . . . . . .  73
  261.               Minimum size  . . . . . . . . . . . . . . . . . . . . . .  73
  262.          3.10 Remove Files  . . . . . . . . . . . . . . . . . . . . . .  74
  263.          3.11 Add Files . . . . . . . . . . . . . . . . . . . . . . . .  75
  264.               Add CRC file list . . . . . . . . . . . . . . . . . . . .  75
  265.          3.12 Archive Passwords . . . . . . . . . . . . . . . . . . . .  76
  266.          3.13 GIF settings  . . . . . . . . . . . . . . . . . . . . . .  77
  267.               Add GIF specifications to descriptions  . . . . . . . . .  77
  268.               GIF pack  . . . . . . . . . . . . . . . . . . . . . . . .  78
  269.               Do not convert embedded graphics files. . . . . . . . . .  78
  270.               JFIF unpack . . . . . . . . . . . . . . . . . . . . . . .  79
  271.               JPEG unpack . . . . . . . . . . . . . . . . . . . . . . .  79
  272.               GIFblast unpack . . . . . . . . . . . . . . . . . . . . .  79
  273.               Repack JFIF files . . . . . . . . . . . . . . . . . . . .  80
  274.               Repack JPEG files . . . . . . . . . . . . . . . . . . . .  80
  275.               Repack GIFblast files . . . . . . . . . . . . . . . . . .  80
  276.               Minimum resolution  . . . . . . . . . . . . . . . . . . .  81
  277.               GIF test command / failures . . . . . . . . . . . . . . .  81
  278.          3.14 Old files . . . . . . . . . . . . . . . . . . . . . . . .  82
  279.          3.15 Include Configurations  . . . . . . . . . . . . . . . . .  83
  280.  
  281.       4  Registration . . . . . . . . . . . . . . . . . . . . . . . . .  84
  282.  
  283.       5  Credits  . . . . . . . . . . . . . . . . . . . . . . . . . . .  85
  284.  
  285.       I  Index  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  86
  286.       PalmScan v2.02                                             User guide
  287.       ---------------------------------------------------------------------
  288.  
  289.       1  Introduction
  290.       ---------------
  291.  
  292.       1.1  Copyright and License Agreement
  293.       ------------------------------------
  294.  
  295.       'PalmScan' refers to all executables and documentation as distributed
  296.       in the compressed file in which the package was released.
  297.  
  298.       Users of PalmScan must accept this disclaimer of warranty:
  299.  
  300.       -    PalmScan is copyrighted material by Steven Hendriks. It may only
  301.            be used in agreement with the conditions set out in this license
  302.            agreement.
  303.  
  304.       -    PalmScan is released as shareware.
  305.  
  306.       -    You may use PalmScan for an evaluation period of one month.
  307.            After this period you MUST either register PalmScan or stop
  308.            using it.
  309.  
  310.       -    Registration is REQUIRED for commercial usage (in a commercial
  311.            environment, such as business, governmental organization,
  312.            association, school, foundation, or any other form of juridical
  313.            person, or any system where PalmScan is directly or indirectly
  314.            used to make profit).
  315.  
  316.       -    The evaluation version of PalmScan may be distributed freely
  317.            provided no money or any other compensation is asked or accepted
  318.            without prior written permission from the author.
  319.  
  320.       -    PalmScan is supplied as is, without warranty or guarantee of any
  321.            kind, either expressed or implied, as to the fitness for a
  322.            particular purpose or quality or performance of this program,
  323.            except that PalmScan will occupy some disk space.
  324.  
  325.       -    In no event shall Steven Hendriks be liable to you or anyone
  326.            else for any damages or cost, including, but not limited to, any
  327.            lost profits, lost savings or lost income which may result from
  328.            the use or inability to use PalmScan.
  329.  
  330.       -    In no way is Steven Hendriks obligated to you or anyone else to
  331.            provide future versions of, or support for PalmScan.
  332.  
  333.       -    Steven Hendriks reserves the right not to release future
  334.            shareware versions of PalmScan, but switch to a commercial
  335.            marketing concept instead.
  336.  
  337.       -    It is forbidden to modify, adapt, translate, reverse engineer,
  338.            decompile and/or disassemble the software in this package.
  339.            Patching the medium at places that carry the software
  340.            (including, but not limited to, RAM memory and physical media)
  341.            is seen as a program change and is also forbidden.
  342.  
  343.       -    Your use of PalmScan constitutes your agreement to this license
  344.            and disclaimer and your release of the author from any form of
  345.            liability or litigation.
  346.  
  347.  
  348.                                       - 6 -
  349.       PalmScan v2.02                                             User guide
  350.       ---------------------------------------------------------------------
  351.  
  352.       1.2  Contacting the author
  353.       --------------------------
  354.  
  355.       If you have any questions about PalmScan, problems with it, or if you
  356.       wish to contact the author for suggestions etcetera, you can:
  357.  
  358.       -    Call Oasis BBS (300 - 28800 bps) at +31-181-453132
  359.  
  360.       -    Send a NetMail message to Steven Hendriks at:
  361.            Fidonet         2:2802/140
  362.            VirNet             9:310/1
  363.            SIGnet         27:1331/401
  364.            OASE            200:3110/0
  365.  
  366.       -    Send E-Mail to:
  367.            0340278@ptfe22.hro.nl
  368.  
  369.       -    Send an echomail message in the OASISSOFT support echo.
  370.  
  371.       -    Send an echomail message in an appropriate area in one of the
  372.            above networks (I cannot read _all_ areas, especially not all
  373.            Fidonet areas, use netmail if you are not sure whether I'm
  374.            reading an area or not).
  375.  
  376.       -    Send a letter to this address:
  377.            Steven Hendriks
  378.            Hoofd 22
  379.            3214 AH  Zuidland
  380.            the Netherlands
  381.  
  382.  
  383.       1.3  What is PalmScan
  384.       ---------------------
  385.  
  386.       PalmScan is the conversion utility to convert almost any archive to
  387.       another format. It can check for viruses inside the archives while
  388.       converting (with up to 20 virus scanners), get file descriptions,
  389.       process embedded archives, remove/add files from/to archives, full
  390.       support for GIF packing, and lots more! PalmScan has full FileDoor,
  391.       FILES.BBS and RemoteAccess, Ezycom and Concord file-database support,
  392.       works with any door.sys or dorinfo supporting bbs system, works great
  393.       in Allfix and many other programs, or stand-alone!
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.                                       - 7 -
  412.       PalmScan v2.02                                             User guide
  413.       ---------------------------------------------------------------------
  414.  
  415.       1.4  Features
  416.       -------------
  417.  
  418.       -    A very flexible configuration. You can configure almost anything
  419.            the way you want it.
  420.  
  421.       -    Detects these archive types:
  422.  
  423.            - ARC
  424.            - ARJ  SFX AV MV PW
  425.            - HAP
  426.            - HYP
  427.            - LZH  SFX
  428.            - PAK  SFX
  429.            - RAR  SFX AV MV PW
  430.            - SQZ  SFX
  431.            - UC2  SFX AV
  432.            - ZIP  SFX AV    PW
  433.            - ZOO
  434.  
  435.            SFX  Self-extracting archives are supported.
  436.            AV   Security envelopes / authenticity validations / seals are
  437.                 supported.
  438.            MV   Multi-volume archives are supported.
  439.            PW   Password-protected archives are supported.
  440.  
  441.            PalmScan can detect other archives by looking at the archive
  442.            extension. Other archivers could be added when needed. To get an
  443.            archiver added, send a request for this to the author of
  444.            PalmScan, along with the archiving program and a contact address
  445.            for technical information on the archiver format.
  446.  
  447.       -    Supports up to 30 different archive types.
  448.  
  449.       -    Supports GIF, PNG, JFIF, JPEG and GIFblast graphics images.
  450.  
  451.       -    Full support for these file-databases:
  452.  
  453.            - RemoteAccess (both 2.0x and 2.5x)
  454.            - Ezycom (both 1.02 and 1.10)
  455.            - Concord
  456.  
  457.       -    Full support for online features in Concord, Ezycom and
  458.            Filedoor.
  459.  
  460.       -    Special FILES.BBS support.
  461.  
  462.       -    Full support for the RemoteAccess 2.0x, RemoteAccess 2.5x,
  463.            Ezycom 1.02, Ezycom 1.10 and Concord file-databases, including
  464.            an advanced maintenance feature.
  465.  
  466.       -    Virus scanning with up to 20 virus scanners.
  467.  
  468.       -    Checking files in a hacklist.
  469.  
  470.       -    Reject files which are too old.
  471.  
  472.       -    Compress un-archived files with your favourite archiver.
  473.  
  474.                                       - 8 -
  475.       PalmScan v2.02                                             User guide
  476.       ---------------------------------------------------------------------
  477.  
  478.       -    Get file descriptions from FILE_ID.DIZ and DESC.SDI.
  479.  
  480.       -    Describes music files, like MOD, ScreamTracker, organ files,
  481.            etc.
  482.  
  483.       -    Describes Compuserve GIF pictures, portable network graphics
  484.            (PNG), JFIF and JPEG graphics.
  485.  
  486.       -    Tests GIF pictures.
  487.  
  488.       -    Ability to notify the system operator about infected, bad,
  489.            hacked and old archives and bad GIF files. PalmScan supports
  490.            Fido (*.msg), Hudson, Squish, Ezycom (both 1.02 and 1.10) and
  491.            JAM messagebases.
  492.  
  493.       -    Add and remove files to/from archives.
  494.  
  495.       -    Add file list with CRC-32's.
  496.  
  497.       -    Writes a complete log file.
  498.  
  499.       -    Runs under any BBS system which supports the DOOR.SYS or
  500.            DORINFO.DEF dropfile format. Without one of these dropfiles,
  501.            PalmScan can be run in local-only mode.
  502.  
  503.       -    Supports both ANSI and ASCII when running in online mode.
  504.  
  505.       -    Built-in Fossil support and carrier detection.
  506.  
  507.       -    Very user-friendly; virtually anything can be configured.
  508.  
  509.       -    A very easy-to-use setup program is included.
  510.  
  511.       -    High quality performance, very low registration fee.
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.                                       - 9 -
  538.       PalmScan v2.02                                             User guide
  539.       ---------------------------------------------------------------------
  540.  
  541.       1.5  System requirements
  542.       ------------------------
  543.  
  544.       DOS version:
  545.  
  546.       -    IBM PC, XT, AT or compatible.
  547.  
  548.       -    IBM PC-DOS / Microsoft MS-DOS 3.0 (or compatible), or higher.
  549.  
  550.       -    At least 20 file handles ('FILES=20' in your CONFIG.SYS). A
  551.            lower value can cause 'Out of file handles' errors.
  552.  
  553.       -    At least 350 KB conventional memory available.
  554.  
  555.       -    At least one of the following compression utilities:
  556.            PKARC, PKZIP, LZH, ZOO, SQZ, Hyper, ARJ, HAP, PAK, UC2, RAR.
  557.  
  558.       -    A disk cache can improve performance, but is not required. If
  559.            you are not using a disk cache, make sure that the number of DOS
  560.            buffers is at least 30 ('BUFFERS=30' in your CONFIG.SYS) to
  561.            improve performance.
  562.  
  563.  
  564.       OS/2 version:
  565.  
  566.       -    OS/2 2.1 or higher.
  567.  
  568.  
  569.       1.6  Logging
  570.       ------------
  571.  
  572.       PalmScan can keep track of its activity in a log file. When no
  573.       filename is given in the configuration, logging is turned off.
  574.  
  575.       The following characters are used in the log, to make things a bit
  576.       clearer:
  577.  
  578.       !  : Fatal error
  579.       ?  : Other (non-fatal) error or an infected/hacked/bad archive has
  580.            been found
  581.       $  : User information
  582.       #  : Other information
  583.       +  : Statistics
  584.       ·  : Debug information
  585.       ■  : Debug information, external programs execution
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.                                       - 10 -
  601.       PalmScan v2.02                                             User guide
  602.       ---------------------------------------------------------------------
  603.  
  604.       1.7  The distribution package
  605.       -----------------------------
  606.  
  607.       PalmScan is distributed in a self-extracting RAR archive. The
  608.       original distribution archive, and all embedded archives, contain an
  609.       authenticity validation. If you obtained a version without this
  610.       authenticity validation, please check with one of the registration
  611.       sites for the original distribution archive.
  612.  
  613.  
  614.       When unpacking the archive, it should show:
  615.  
  616.        Verifying authenticity information ...  Ok
  617.  
  618.       and:
  619.  
  620.        modified at (time)  30 Apr 1996
  621.        by Steven Hendriks
  622.  
  623.  
  624.       This package includes:
  625.  
  626.       PALMSCAN.EXE   The main program
  627.       PALMSCAN.OVR   Overlay file for the message system (DOS version only)
  628.       PALMSCAN.DOC   This documentation
  629.       PALMSCAN.HLP   Commandline help
  630.       PSETUP.EXE     PalmScan SETUP program
  631.       PSREG.EXE      Self-extracting archive containing the registration
  632.                      forms
  633.       EXAMPLE.EXE    Self-extracting archive containing an example
  634.                      configuration file
  635.       PALMSCAN.ANS   Ansi advertisement
  636.       FILE_ID.DIZ    Package description
  637.       UPDATE.LOG     Update log
  638.       README.1ST     Last-minute information
  639.       PUPDATE.EXE    Program to update PalmScan v1.xx configuration to
  640.                      v2.02.
  641.  
  642.  
  643.       1.8  Runtime
  644.       ------------
  645.  
  646.       While PalmScan is running, no user input is required.
  647.       To abort processing of files, you can press escape. PalmScan will
  648.       then finish the file which is currently being processed, and after
  649.       that ask whether you wish to continue processing or not.
  650.  
  651.       PalmScan displays a spinning cursor when it's working. In the DOS
  652.       version, this will not be shown when an external program is being
  653.       executed. In the OS/2 version, it will always be shown when the
  654.       output of external programs is redirected to NUL (RedirectOutput
  655.       configuration keyword).
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.                                       - 11 -
  664.       PalmScan v2.02                                             User guide
  665.       ---------------------------------------------------------------------
  666.  
  667.       1.9  Extended Wildcards
  668.       -----------------------
  669.  
  670.       PalmScan has support for extended wildcards. This means that any
  671.       number of '?' and '*' characters can be used in file-specifications
  672.       which support wildcards. For example, 'P*SCAN*' would match
  673.       'PALMSCAN.EXE'.
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.                                       - 12 -
  727.       PalmScan v2.02                                             User guide
  728.       ---------------------------------------------------------------------
  729.  
  730.       2  Installation
  731.       ---------------
  732.  
  733.       2.1  First time installation
  734.       ----------------------------
  735.  
  736.       PalmScan and all files included can be placed either in a separate
  737.       directory, or in the BBS directory. the most common way is creating a
  738.       sub-directory under the BBS directory, and place the files there.
  739.       After placing all files in a directory, edit PALMSCAN.CFG.
  740.  
  741.  
  742.       2.2.1  Installing PalmScan in FileDoor
  743.       --------------------------------------
  744.  
  745.       The most common way for installing PalmScan in FileDoor is the
  746.       following:
  747.  
  748.       ExitAfterUpload1 C:\PALMSCAN\PALMSCAN.EXE $U\*.* $N $M
  749.  
  750.       $U\*.*    tells PalmScan which files to process.
  751.       $N        tells FileDoor to execute PalmScan only when files are
  752.                 received.
  753.       $M        tells FileDoor to swap to disk/EMS before executing
  754.                 PalmScan.
  755.  
  756.       I recommend using the 'Online Filedoor' keyword in the configuration,
  757.       PalmScan will then tell FileDoor the new filename when a file has
  758.       been converted, and the original size of the archive. By using
  759.       'FileID' also, PalmScan will also tell FileDoor the description (when
  760.       found in FILE_ID.DIZ or DESC.SDI). You should never use 'FilesBBS'
  761.       when running under FileDoor.
  762.  
  763.  
  764.       2.2.2  Installing PalmScan in SuperBBS
  765.       --------------------------------------
  766.  
  767.       The most common way for installing PalmScan in SuperBBS is the
  768.       following:
  769.  
  770.       Virus scanner: c:\xfd\palmscan\palmscan.exe %1 *S
  771.  
  772.       %1   tells PalmScan which file to process.
  773.       *S   tells SuperBBS to swap to disk/EMS before executing PalmScan.
  774.  
  775.       You should not use archive conversion when PalmScan is used as virus
  776.       scanner in SuperBBS. After uploads, SuperBBS would not be
  777.       able to find the file back when it has got another filename.
  778.       For using archive conversion, you should run PalmScan in an event,
  779.       with 'FilesBBS' and 'OnlyNewFiles' switched on.
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.                                       - 13 -
  790.       PalmScan v2.02                                             User guide
  791.       ---------------------------------------------------------------------
  792.  
  793.       2.2.3  Installing PalmScan in Allfix
  794.       ------------------------------------
  795.  
  796.       Allfix version 4.21 (and later) and Allfix/2 version 1.00 (and later)
  797.       have the option to use an external archive conversion utility. The
  798.       most common way for installing PalmScan in Allfix at this option is
  799.       the following:
  800.  
  801.       EAC : PALMSCAN.EXE @1 /L
  802.  
  803.       /L   tells PalmScan to run in local-only mode (Allfix doesn't have a
  804.            user online anyway...) .
  805.       @1   tells PalmScan which file to process.
  806.  
  807.       The errorlevels should be configured like this:
  808.  
  809.       (EAC) virus errorlevel 198
  810.       (EAC) error errorlevel 1
  811.  
  812.       PalmScan returns errorlevel 203 for bad archives (archives which
  813.       can't be unpacked), errorlevel 212 for hacked files and errorlevel
  814.       213 for virus-infected archives.
  815.       With these errorlevel settings in Allfix, it will move the file to
  816.       the bad directory if one of these occur.
  817.  
  818.       You should not configure a 'BadPath' and 'InfectedPath' in the
  819.       PalmScan configuration, Allfix will move bad or infected archives to
  820.       the BadTick directory (when the errorlevels are configured as above).
  821.       Also, 'FilesBBS', 'FDB' and 'FileDoor' should not be used, else
  822.       PalmScan would create files which are of no use for Allfix.
  823.  
  824.  
  825.       2.2.4  Installing PalmScan in RemoteAccess 2.xx
  826.       -----------------------------------------------
  827.  
  828.       The commandline for using PalmScan in the upload scan option in
  829.       RemoteAccess 2.xx should be:
  830.  
  831.       PALMSCAN.EXE @ *M
  832.  
  833.       If you are using the file-database in RemoteAccess 2.xx, you should
  834.       also enable this option ('FDB RA') in the PalmScan configuration.
  835.  
  836.  
  837.       2.2.5  Installing PalmScan in RAFT (The Remote Access Filearea Tools)
  838.       ---------------------------------------------------------------------
  839.  
  840.       The commandline for using PalmScan in the ARCCONV option in The
  841.       Remote Access Filearea Tools is:
  842.  
  843.       PALMSCAN.EXE %F @1 /L
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.                                       - 14 -
  853.       PalmScan v2.02                                             User guide
  854.       ---------------------------------------------------------------------
  855.  
  856.       2.2.6  Installing PalmScan in Maximus
  857.       -------------------------------------
  858.  
  859.       If you don't already use the VirusCheck option in Maximus, you should
  860.       first uncomment the following line in MAX.CTL:
  861.  
  862.            Upload Check Virus   Vircheck.Bat
  863.  
  864.       If you want to use the DORINFOx.DEF support of PalmScan, you should
  865.       also make a few changes to the MENUS.CTL file. Usually the upload
  866.       command is looking like this:
  867.  
  868.            Upload                                  Limited "Upload (send)"
  869.  
  870.       Maximus includes a mecca script called DORINFO.MEC, which produces a
  871.       DORINFO1.DEF. The new structure of the upload command should be as
  872.       follows:
  873.  
  874.                      Display_File C:\Max\Dorinfo   Limited "Upload (send)"
  875.            NoDsp     Upload                        Limited "U"
  876.  
  877.       This way whenever a user begins the upload procedure, a DORINFO1.DEF
  878.       file is created.
  879.       You can now edit the VIRCHECK.BAT to include the following:
  880.  
  881.            PalmScan %1%2%3 /NoConversion /D[path to DORINFOx.DEF]
  882.  
  883.       If you don't want to use the DORINFOx.DEF support, it should be this
  884.       way:
  885.  
  886.            PalmScan %1%2%3 /NoConversion /L
  887.  
  888.       Warning! Do not use spaces between the commandline variables (%1,%2
  889.       and %3) or nothing will work properly.
  890.  
  891.       You can find the location where the DORINFOx.DEF file will be created
  892.       by viewing the DORINFO.MEC file, located in the Misc directory.
  893.  
  894.       You must not forget to SILT (compile) the configuration after
  895.       changing the .CTL files.
  896.  
  897.       When PalmScan finds the archive to be bad or infected, it will remove
  898.       it from the upload directory. After returning to the BBS, Maximus
  899.       will then not find the file present and it won't credit the user for
  900.       it, and the file won't be placed in the FILES.BBS.
  901.       The 'ArchiveConversion' keyword should not be used in the PalmScan
  902.       configuration for running PalmScan inside Maximus, while Maximus
  903.       would think the file is missing when the filename is changed. You can
  904.       also use the /NOCONVERSION commandline option for PalmScan instead of
  905.       disabling the ArchiveConversion keyword (this can be especially
  906.       useful when using PalmScan to convert the archives in an event, and
  907.       using only one configuration for PalmScan).
  908.  
  909.       For doing archive conversions, FileID insertion and FILES.BBS update
  910.       options, run PalmScan in an event or just after exiting Maximus, with
  911.       the 'OnlyNewFiles', 'FileID' and 'FilesBBS' keywords turned on.
  912.  
  913.  
  914.  
  915.                                       - 15 -
  916.       PalmScan v2.02                                             User guide
  917.       ---------------------------------------------------------------------
  918.  
  919.       2.2.7  Installing PalmScan in Ezycom
  920.       ------------------------------------
  921.  
  922.       There are various ways of using PalmScan with Ezycom. When using
  923.       PalmScan in one of the conversion batch-files used by Ezycom,
  924.       PalmScan will not update the Ezycom file-database. Ezycom will handle
  925.       this itself, so you should disable 'FDB Ezycom' when PalmScan is
  926.       started from one of those batch-files.
  927.       When using PalmScan with UPCONV.BAT, the commandline should be as
  928.       follows for Ezycom 1.02:
  929.  
  930.       PalmScan.Exe %1%4.%6 /NoFDB /NoFilesBBS
  931.  
  932.       For Ezycom 1.10, the commandline should be:
  933.  
  934.       PalmScan.Exe %2%5.%7 /N%1 /T%6 /NoFDB /NoFilesBBS
  935.  
  936.       'Online Ezycom' can be used to make PalmScan pass on the file
  937.       description to Ezycom.
  938.  
  939.       When used in DOCONV.BAT, /L should be added to that.
  940.       The best way to use PalmScan with Ezycom is by not using it in these
  941.       batch-files, but running it in an event with the FDB maintenance
  942.       feature (/FDBMAINT commandline option). You could also run PalmScan
  943.       after every caller, processing only the upload directory
  944.       (/FDBMAINT<areanr>).
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.                                       - 16 -
  979.       PalmScan v2.02                                             User guide
  980.       ---------------------------------------------------------------------
  981.  
  982.       2.2.8  Installing PalmScan in Concord
  983.       -------------------------------------
  984.  
  985.       The best way to use PalmScan with Concord is to use the file-database
  986.       maintenance feature (/FDBmaint commandline option). PalmScan will
  987.       then process all files which have not been processed yet, and update
  988.       the Concord file-database. This can also be done while the user is
  989.       still on-line, by creating a simple menu which first executes the
  990.       upload feature of Concord, and then runs the PalmScan file-database
  991.       maintenance for the specific upload area.
  992.  
  993.       To install PalmScan in the upload checker feature, this has to be
  994.       configured in the Concord configuration:
  995.  
  996.       -    At the file-system section, the extended upload checker should
  997.            be turned ON.
  998.       -    At the paths section, PalmScan should be configuration as virus
  999.            scanner. At the time this documentation is being written, it is
  1000.            not yet known how Concord calls the upload checker, please
  1001.            consult the Concord manual for that.
  1002.  
  1003.       PalmScan should not update the Concord file-database when running as
  1004.       upload checker, so FDB Concord should not be used, or /NoFDB should
  1005.       be added to the PalmScan commandline. You should use 'Online Concord'
  1006.       if you want PalmScan to pass on the file description to Concord.
  1007.  
  1008.  
  1009.       2.2.9  Installing PalmScan in ProBoard
  1010.       --------------------------------------
  1011.  
  1012.       By using PalmUpload, a ProBoard extension (PEX) file, it is very easy
  1013.       to use PalmScan as upload checker under ProBoard.
  1014.  
  1015.       PalmUpload must be installed as a menu function 60 (Run ProBoard SDK
  1016.       file), which should replace the regular upload feature.
  1017.       Menu Data : PUPLOAD [PalmScan path]
  1018.       You must specify the directory where PalmScan.EXE can be found at the
  1019.       data field. Example : PUPLOAD C:\PALMSCAN
  1020.       That's really all there is to it... PalmUpload will first perform the
  1021.       upload as regular (it will use the default upload directory as
  1022.       configured in the ProBoard configuration). After that, PalmScan will
  1023.       be started, which can then do anything you want with the uploaded
  1024.       files. After PalmScan has finished processing all uploaded files,
  1025.       PalmUpload will check if the files have passed. If they haven't
  1026.       (because of a bad archive, infected files found, etc.), the file will
  1027.       be subtracted from the user's number of uploaded files and kilobytes.
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.                                       - 17 -
  1042.       PalmScan v2.02                                             User guide
  1043.       ---------------------------------------------------------------------
  1044.  
  1045.       2.3  Commandline
  1046.       ----------------
  1047.  
  1048.       The PalmScan commandline consists of:
  1049.  
  1050.       PALMSCAN.EXE [FileSpecs|@ListFile|Command] <Options>
  1051.  
  1052.       [..] is mandatory
  1053.       <..> is optional
  1054.  
  1055.       [FileSpecs]    must be valid DOS file-specifications. At least one
  1056.                      should be given, up to 30 can be given.
  1057.                      File-specifications can be either filenames or
  1058.                      directories. In the last case, all files in that
  1059.                      directory will be processed.
  1060.  
  1061.       Example :      PalmScan *.ZIP
  1062.  
  1063.       [@ListFile]    Instead of (a) file-specification(s), you can also use
  1064.                      a listfile. This listfile should contain valid
  1065.                      file-specifications (see above). PalmScan will process
  1066.                      all file-specifications in the listfile (there is no
  1067.                      maximum size for the listfile!). The
  1068.                      file-specifications should be placed on the first part
  1069.                      of each line, 2everything behind it will be ignored.
  1070.  
  1071.                      Example listfile:
  1072.  
  1073.                      d:\files\upload     This is the upload directory
  1074.                      d:\files\incoming   This is the incoming files
  1075.                                          directory
  1076.  
  1077.                      In this example, all files in the directory's
  1078.                      d:\files\upload and d:\files\incoming, will be
  1079.                      processed (except for those files configured with the
  1080.                      SkipFile keyword in the PalmScan configuration). The
  1081.                      comments behind the directory's will be ignored.
  1082.                      You can also use FLSEARCH.CTL (QuickBBS format) with
  1083.                      this option.
  1084.  
  1085.       Example :      PalmScan @C:\BBS\FLSEARCH.CTL
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.                                       - 18 -
  1105.       PalmScan v2.02                                             User guide
  1106.       ---------------------------------------------------------------------
  1107.  
  1108.       [Command] :
  1109.  
  1110.       /FDBmaint<areanr<-areanr>>
  1111.  
  1112.            Usage   : Run Ezycom/RemoteAccess/Concord file-database
  1113.                      maintenance. PalmScan will first search the
  1114.                      file-database for files which have not been processed,
  1115.                      and place them in a file called FILEINFO.FIX. After
  1116.                      that, the PalmScan FileInfo system will take over and
  1117.                      those files will be processed. Files will be converted
  1118.                      to the archiver configured in the file-area
  1119.                      configuration. When no archiver is configured for an
  1120.                      area, PalmScan will not process files in that area.
  1121.                      (Except for Concord, at this moment no archiver can be
  1122.                      configured in the file-area configuration so all areas
  1123.                      will be processed).
  1124.                      When running with Ezycom or Concord, PalmScan will use
  1125.                      the checked bit in the file-database to determine
  1126.                      wether a file has been processed or not.
  1127.                      When running with RemoteAccess, PalmScan uses
  1128.                      LASTSCAN.PS in the file-database directory to store
  1129.                      the last time when the FDB maintenance has been run.
  1130.                      All files which have an upload date after the date of
  1131.                      that file will be processed.
  1132.                      When running with Concord, PalmScan will only do
  1133.                      virus-scanning when that's configured in the file-area
  1134.                      configuration.
  1135.  
  1136.                      <areanr-<areanr>>   The area numbers which should be
  1137.                                          processed. A range of areas can be
  1138.                                          given here (eg. 10-20) or just one
  1139.                                          area can be given.
  1140.                                          When no area number is specified,
  1141.                                          PalmScan will process all areas
  1142.                                          which have a destination archiver
  1143.                                          configured.
  1144.  
  1145.                      Any file specifications given on the commandline will
  1146.                      be used to determine wether a file should be processed
  1147.                      or not.
  1148.  
  1149.            Options : /All      Process all files in the specified areas,
  1150.                                even if they have already been processed.
  1151.  
  1152.                      /AnyArea  Process any area, instead of only areas
  1153.                                which have a target archiver set.
  1154.  
  1155.            Example : PalmScan.Exe /L /FDBMAINT50-99 /ALL *.ARJ
  1156.                         - This will process all *.ARJ files which are in
  1157.                           the file-database in areas in the range 50 to 99
  1158.                           which have a destination archiver configured in
  1159.                           the file-area configuration.
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.                                       - 19 -
  1168.       PalmScan v2.02                                             User guide
  1169.       ---------------------------------------------------------------------
  1170.  
  1171.       /Fix<+>
  1172.  
  1173.            Usage   : Use the PalmScan FileInfo system. This system
  1174.                      accomplishes an enhanced communication between
  1175.                      PalmScan and programs using PalmScan. When using /FIX,
  1176.                      PalmScan will use the FileInfo system in Read-Only
  1177.                      mode, the FileInfo file (FILEINFO.FIX) will be deleted
  1178.                      when all files have been processed.
  1179.                      When using /FIX+, PalmScan will use the FileInfo
  1180.                      system in Read/Write mode. PalmScan will update the
  1181.                      FileInfo file with some information that can be used
  1182.                      by the program which is calling PalmScan.
  1183.                      Technical information about the FileInfo system can be
  1184.                      found in FILEINFO.INC, which is included in the
  1185.                      PalmScan package.
  1186.  
  1187.  
  1188.       <options> :
  1189.  
  1190.       /L
  1191.  
  1192.            Usage   : Local operation. When this switch is NOT used,
  1193.                      PalmScan will search for DOOR.SYS and/or DORINFO?.DEF
  1194.                      to get the user information from.
  1195.  
  1196.  
  1197.       /C[configuration-filename]
  1198.  
  1199.            Usage   : By default, PalmScan will search for it's
  1200.                      configuration file in the same directory where
  1201.                      PALMSCAN.EXE is placed, with the filename
  1202.                      PALMSCAN.CFG. With this commandline option, you can
  1203.                      tell PalmScan to use an alternate configuration file.
  1204.  
  1205.            Example : /Cc:\palmscan\afixpalm.cfg
  1206.  
  1207.       /D[dorinfo-filename]
  1208.  
  1209.            Usage   : When your BBS-package creates a DORINFO file with a
  1210.                      filename that can't be found by searching for
  1211.                      DORINFO?.DEF (ie. Ezycom can create DORINF85.DEF for
  1212.                      line 85), you can specify this filename here.
  1213.  
  1214.            Example : /Ddorinf85.def
  1215.  
  1216.       /N[node]
  1217.  
  1218.            Usage   : When the node number is specified with this
  1219.                      commandline option, PalmScan's multi-line support is
  1220.                      enabled. This makes sure that PalmScan will run
  1221.                      without problems when running on more nodes at the
  1222.                      same time on multi-node systems.
  1223.                      This commandline option is required when using the
  1224.                      EzyFileID configuration keyword.
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.                                       - 20 -
  1231.       PalmScan v2.02                                             User guide
  1232.       ---------------------------------------------------------------------
  1233.  
  1234.       /NoChanges
  1235.  
  1236.            Usage   : When this option is used, no archiving will be done at
  1237.                      all. This means that no archive will be converted,
  1238.                      there won't be any file removal or file adding, no
  1239.                      music modules will be described, and the archive
  1240.                      header will not be updated. This can be especially
  1241.                      useful for running PalmScan as online virus scanner
  1242.                      (when the archive conversion is done in an event), or
  1243.                      for just updating file descriptions in FILES.BBS with
  1244.                      the 'FileID' keyword used.
  1245.  
  1246.       /NoConversion
  1247.  
  1248.  
  1249.            Usage   : When this option is used, archive conversion is not
  1250.                      done. All other function will be performed.
  1251.  
  1252.       /T[archiver]
  1253.  
  1254.            Usage   : Override the configured destination archiver.
  1255.                      When no archiver is configured in the PalmScan
  1256.                      configuration, PalmScan will only convert the main
  1257.                      archives, no embedded archives. When there is an
  1258.                      archiver configured in the PalmScan configuration,
  1259.                      those settings will be used for SFX/Secure/Embedded
  1260.                      archives.
  1261.                      When used when running the file-database maintenance,
  1262.                      PalmScan will still only process those areas which
  1263.                      have a destination archiver configured (in the
  1264.                      Ezycom/RemoteAccess file-area configuration). This
  1265.                      commandline option does override that configured
  1266.                      archiver, though.
  1267.  
  1268.            Example : /TARJ
  1269.  
  1270.            Note    : This is a bonus feature, which is available in the
  1271.                      registered version only.
  1272.  
  1273.       /NoFDB
  1274.  
  1275.            Usage   : Temporary disable the file-database support.
  1276.  
  1277.            Note    : This is a bonus feature, which is available in the
  1278.                      registered version only.
  1279.  
  1280.       /NoFilesbbs
  1281.  
  1282.            Usage   : Temporary disable the files.bbs support.
  1283.  
  1284.            Note    : This is a bonus feature, which is available in the
  1285.                      registered version only.
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.                                       - 21 -
  1294.       PalmScan v2.02                                             User guide
  1295.       ---------------------------------------------------------------------
  1296.  
  1297.       /S
  1298.  
  1299.            Usage   : When this option is used, PalmScan will search all
  1300.                      sub-directory's of the given file-specifications for
  1301.                      files to be processed. Together with the
  1302.                      ProcessListedOnly configuration keyword, this option
  1303.                      can very well be used to process all files on a
  1304.                      bulletin board.
  1305.  
  1306.       /Unlisted
  1307.  
  1308.            Usage   : When this option is used, PalmScan will only process
  1309.                      files which are not listed in FILES.BBS and/or the
  1310.                      RemoteAccess/Ezycom/Concord file-database. This
  1311.                      commandline option overrides the ProcessListedOnly
  1312.                      configuration keyword.
  1313.  
  1314.       /Move[Path]
  1315.  
  1316.            Usage   : When a file has been processed and is ok, it can be
  1317.                      moved to another directory.
  1318.  
  1319.                      [Path]    The directory where good files will be moved
  1320.                                to.
  1321.  
  1322.            Note    : This is a bonus feature, which is available in the
  1323.                      registered version only.
  1324.  
  1325.       /V[Size]
  1326.  
  1327.            Usage   : To use the multi-volume packing (MultiVolumePack
  1328.                      configuration keyword), the target size must be
  1329.                      specified on the PalmScan commandline, using this
  1330.                      commandline option.
  1331.  
  1332.                      [Size]    The target size of the multi-volume
  1333.                                archives. This parameter is passed on
  1334.                                directly to the archiver when PalmScan
  1335.                                starts packing the archives.
  1336.  
  1337.       /NoMove
  1338.  
  1339.            Usage   : Temporary disable the moving of files to the BadPath,
  1340.                      InfectedPath, HackPath, OldPath and BadGifPath. When
  1341.                      needed, PalmScan will exit with an errorlevel instead
  1342.                      of moving any files.
  1343.  
  1344.            Note    : This is a bonus feature, which is available in the
  1345.                      registered version only.
  1346.  
  1347.       /NoScan
  1348.  
  1349.            Usage   : Temporary disable virus-scanning.
  1350.  
  1351.            Note    : This is a bonus feature, which is available in the
  1352.                      registered version only.
  1353.  
  1354.  
  1355.  
  1356.                                       - 22 -
  1357.       PalmScan v2.02                                             User guide
  1358.       ---------------------------------------------------------------------
  1359.  
  1360.       /Mono
  1361.  
  1362.            Usage   : Forces monochrome mode.
  1363.  
  1364.       /NoCls
  1365.  
  1366.            Usage   : Do not clear the screen at startup.
  1367.  
  1368.       /Debug
  1369.  
  1370.            Usage   : This will log some more information on the execution
  1371.                      of external programs (such as virus scanners,
  1372.                      archivers, etc.) and virtually anything which is
  1373.                      displayed on the screen.
  1374.  
  1375.       /P[priority]
  1376.  
  1377.            Usage   : This option is only available in the OS/2 version of
  1378.                      PalmScan. The priority of the process can be set using
  1379.                      this commandline option.
  1380.  
  1381.                      [priority]     This is a percentage of the normal
  1382.                                     priority. It can be a value from 0 to
  1383.                                     257. The default priority is 100.
  1384.  
  1385.       /Interactive
  1386.  
  1387.            Usage   : When this option is used, PalmScan can ask some
  1388.                      questions when needed. When running in on-line mode,
  1389.                      the user who is on-line can also type an answer.
  1390.                      PalmScan will time-out when no input is given within a
  1391.                      minute.
  1392.                      Interactive mode is currently only used for obtaining
  1393.                      passwords for password protected archives.
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.                                       - 23 -
  1420.       PalmScan v2.02                                             User guide
  1421.       ---------------------------------------------------------------------
  1422.  
  1423.       2.4  Watchdog, CTTY, ANSI.SYS
  1424.       -----------------------------
  1425.  
  1426.       CTTY and WATCHDOG, or similar utilities, are not required and should
  1427.       not be used with this program. PalmScan has its own communication
  1428.       routines which monitor the COM port.
  1429.  
  1430.       ANSI.SYS is not required for this program. When running under
  1431.       DESQview, DVANSI is not required either. It won't do any harm if
  1432.       either one is loaded however.
  1433.  
  1434.  
  1435.       2.5  Errorlevels
  1436.       ----------------
  1437.  
  1438.       PalmScan returns the following errorlevels:
  1439.  
  1440.       1    -    Error
  1441.       203  -    Bad archive found
  1442.       204  -    Old file found
  1443.       205  -    Bad GIF file found
  1444.       212  -    Hacked archive found
  1445.       213  -    Infected file found
  1446.  
  1447.       The errorlevels 203, 204, 205, 212 and 213 will only be returned when
  1448.       no directory is configured to move those files to.
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.                                       - 24 -
  1483.       PalmScan v2.02                                             User guide
  1484.       ---------------------------------------------------------------------
  1485.  
  1486.       3  The configuration
  1487.       --------------------
  1488.  
  1489.       3.1  PALMSCAN.CFG
  1490.       -----------------
  1491.  
  1492.       The PALMSCAN.CFG file is a normal (ASCII) text-file. You can create
  1493.       this file with any ASCII-editor. PalmScan will search for its
  1494.       configuration file in the directory containing PALMSCAN.EXE, or the
  1495.       configuration file specified on the commandline (see chapter 2.7).
  1496.  
  1497.       If no configuration file is found, PalmScan will terminate
  1498.       abnormally.
  1499.  
  1500.       PALMSCAN.CFG contains many options. Some of them are optional, others
  1501.       are not. The general format for the PALMSCAN.CFG file is:
  1502.  
  1503.       {statement} [mandatory parameter] <optional parameter>
  1504.  
  1505.       There are no restrictions to the position you start the parameters,
  1506.       but the parameters have to be separated with one or more spaces. The
  1507.       {statement} must start on position 1 of each line.
  1508.  
  1509.       When there should be spaces in a parameter (like in the virus scanner
  1510.       commands), you can use underscores ('_') for that, PalmScan will
  1511.       translate those to spaces.
  1512.  
  1513.       You can insert comment-lines into PALMSCAN.CFG by putting a '%' or a
  1514.       ';' character on position 1 of the desired line(s). Also empty lines
  1515.       are considered as comment.
  1516.  
  1517.       PalmScan will also ignore all lines starting with 'PT'. This makes it
  1518.       possible to use one configuration file for both PalmScan and PalmTick
  1519.       FeatherLight.
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.                                       - 25 -
  1546.       PalmScan v2.02                                             User guide
  1547.       ---------------------------------------------------------------------
  1548.  
  1549.       3.2  PSetup
  1550.       -----------
  1551.  
  1552.       Besides editing the configuration file with an ASCII editor, you can
  1553.       also configure PalmScan with PSetup. PSetup uses the same ASCII
  1554.       text-file as PalmScan.
  1555.  
  1556.  
  1557.       3.2.1  Commandline
  1558.       ------------------
  1559.  
  1560.       The PSetup commandline consists of:
  1561.  
  1562.       PSETUP [configuration-filename] </A|-A>
  1563.  
  1564.       [configuration-filename]
  1565.  
  1566.            Usage   : By default, PSetup will search for it's configuration
  1567.                      file in the same directory where PSETUP.EXE is placed,
  1568.                      with the filename PALMSCAN.CFG. With this commandline
  1569.                      option, you can tell PSetup to use an alternate
  1570.                      configuration file.
  1571.  
  1572.       </A|-A>
  1573.  
  1574.            Usage   : When PSetup is started with /A or -A on the
  1575.                      commandline, it will use an alternate colorset.
  1576.  
  1577.       Example : PSETUP c:\palmscan\afixpalm.cfg /A
  1578.  
  1579.  
  1580.       3.2.2  Starting PSetup
  1581.       ----------------------
  1582.  
  1583.       When you run PSetup, it will look for the configuration file as
  1584.       stated in paragraph 3.2.1. When no configuration file is found, it
  1585.       will inform you of this. The configuration file will then be created
  1586.       when you exit PSetup.
  1587.  
  1588.  
  1589.       3.2.3  Keys
  1590.       -----------
  1591.  
  1592.       PSetup uses pop-up menus. You can use the cursor up and down keys to
  1593.       move through the menus, and select an option by pressing Enter. The
  1594.       Escape key will take you back to a previous level.
  1595.       In all edit fields, Escape aborts and F10 keeps changes immediately
  1596.       (if you didn't select the 'Cancel' button).
  1597.       Cursor-Down and Tab moves the cursor to the next field, Cursor-Up and
  1598.       Shift-Tab moves the cursor to the previous field.
  1599.       Enter will move the cursor to the next field when on an edit field,
  1600.       and press a button when that button is currently selected.
  1601.       The space bar toggles on/off settings, Cursor-Left/Right will move
  1602.       through selection fields.
  1603.       F1 will display the relevant part of the PalmScan documentation when
  1604.       the cursor is located on a data entry. PalmScan.Doc must be located
  1605.       in the same directory where PSetup.Exe is located for this function
  1606.       to work.
  1607.  
  1608.                                       - 26 -
  1609.       PalmScan v2.02                                             User guide
  1610.       ---------------------------------------------------------------------
  1611.  
  1612.       3.3  System data
  1613.       ----------------
  1614.  
  1615.       3.3.1  Site Information
  1616.       -----------------------
  1617.  
  1618.       BBS name
  1619.       --------
  1620.  
  1621.       This option informs PalmScan of your BBS name. This option is only of
  1622.       use when you registered PalmScan and also filled in the key number.
  1623.  
  1624.       Example   :    Oasis BBS
  1625.  
  1626.       Keyword   :    BBSname [BBS_name]
  1627.  
  1628.            [BBS_name]     This is your BBS name.
  1629.  
  1630.            Example   :    BBSname Oasis_BBS
  1631.  
  1632.  
  1633.       SysOp name
  1634.       ----------
  1635.  
  1636.       This option informs PalmScan of the name of the system operator. When
  1637.       writing a message, PalmScan will write it to this name. When no name
  1638.       is configured, the message will be addressed to 'SysOp'.
  1639.  
  1640.       Example   :    Steven Hendriks
  1641.  
  1642.       Keyword   :    SysopName [Sysop_Name]
  1643.  
  1644.            [Sysop_Name]   The name of the system operator.
  1645.  
  1646.            Example   :    SysopName Steven_Hendriks
  1647.  
  1648.  
  1649.       Key number
  1650.       ----------
  1651.  
  1652.       When you registered PalmScan, you received a key for use with
  1653.       PalmScan. This key must be entered here, to make PalmScan work in
  1654.       registered mode. You must also use the registered version for this to
  1655.       work. If you don't have the registered version, please contact your
  1656.       local registration site or the main registration site for more
  1657.       information. If you have not already registered PalmScan, please see
  1658.       the registration form for details on how to register.
  1659.  
  1660.       Example   :    12345678901234567890123456789012
  1661.  
  1662.       Keywords  :    RegKey [Key number]
  1663.                      OS2key [Key number]
  1664.  
  1665.                 [Key number]   This is your key number as you receive it
  1666.                                after registering PalmScan.
  1667.  
  1668.                 Examples  :    RegKey 12345678901234567890123456789012
  1669.                                OS2key 12345678901234567890123456789012
  1670.  
  1671.                                       - 27 -
  1672.       PalmScan v2.02                                             User guide
  1673.       ---------------------------------------------------------------------
  1674.  
  1675.       3.3.2  Screen settings
  1676.       ----------------------
  1677.  
  1678.       Redirect screen output of external programs
  1679.       -------------------------------------------
  1680.  
  1681.       PalmScan can redirect output of external programs (archivers and
  1682.       virus-scanners) to NUL. This means that those programs will display
  1683.       nothing to the local screen. Some programs, however, will still get
  1684.       output on the screen (like TBScan and F-Prot). When that happens,
  1685.       PalmScan will restore the screen to it's original looks after the
  1686.       external program has been executed. Enabling this option will cause
  1687.       the display on the local screen to be exactly the same as the display
  1688.       on the user screen (when running in on-line mode).
  1689.  
  1690.       Example   :    X
  1691.  
  1692.       Keyword   :    RedirectOutput
  1693.  
  1694.            Example   :    RedirectOutput
  1695.  
  1696.  
  1697.       Normal color
  1698.       ------------
  1699.  
  1700.       With this option, you can configure the color of normal text in
  1701.       PalmScan.
  1702.  
  1703.       Example   :    3
  1704.  
  1705.       Keyword   :    ColorNormal [c]
  1706.  
  1707.            [c]            This is the color number. This can be any value
  1708.                           from 0 to 15.
  1709.  
  1710.            Example   :    ColorNormal 3
  1711.  
  1712.  
  1713.       Highlighted color
  1714.       -----------------
  1715.  
  1716.       With this option, you can configure the color of highlighted text in
  1717.       PalmScan.
  1718.  
  1719.       Example   :    11
  1720.  
  1721.       Keyword   :    ColorHighlight [c]
  1722.  
  1723.            [c]            This is the color number. This can be any value
  1724.                           from 0 to 15.
  1725.  
  1726.            Example   :    ColorHighlight 11
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.                                       - 28 -
  1735.       PalmScan v2.02                                             User guide
  1736.       ---------------------------------------------------------------------
  1737.  
  1738.       Background color
  1739.       ----------------
  1740.  
  1741.       With this option, you can configure the background color in PalmScan.
  1742.  
  1743.       Example   :    0
  1744.  
  1745.       Keyword   :    ColorBackground [c]
  1746.  
  1747.            [c]            This is the color number. This can be any value
  1748.                           from 0 to 7.
  1749.  
  1750.            Example   :    ColorBackground 0
  1751.  
  1752.  
  1753.  
  1754.       Edit color
  1755.       ----------
  1756.  
  1757.       With this option, you can configure the color of edit fields which
  1758.       are used in interactive mode.
  1759.  
  1760.       Example   :    15
  1761.  
  1762.       Keyword   :    ColorEdit [c]
  1763.  
  1764.            [c]            This is the color number. This can be any value
  1765.                           from 0 to 15.
  1766.  
  1767.            Example   :    ColorEdit 15
  1768.  
  1769.  
  1770.       Edit background
  1771.       ---------------
  1772.  
  1773.       With this option, you can configure the background color of edit
  1774.       fields which are used in interactive mode.
  1775.  
  1776.  
  1777.       Example   :    1
  1778.  
  1779.       Keyword   :    ColorEditBackground [c]
  1780.  
  1781.            [c]            This is the color number. This can be any value
  1782.                           from 0 to 7.
  1783.  
  1784.            Example   :    ColorEditBackground 1
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.                                       - 29 -
  1798.       PalmScan v2.02                                             User guide
  1799.       ---------------------------------------------------------------------
  1800.  
  1801.       3.3.3  Pathnames
  1802.       ----------------
  1803.  
  1804.       Temporary directory
  1805.       -------------------
  1806.  
  1807.       This should point to a directory where PalmScan can store temporary
  1808.       files. This directory is necessary for running PalmScan.
  1809.       When no temporary directory is configured, PalmScan will use the TEMP
  1810.       environment variable (when available). For more information about
  1811.       environment variables, consult your DOS or OS/2 documentation.
  1812.  
  1813.       Example   :    C:\TEMP
  1814.  
  1815.       Keyword   :    TempPath [d:\path]
  1816.  
  1817.            [d:\path]      This is the directory where the temporary files
  1818.                           will be stored.
  1819.  
  1820.            Example   :    TempPath C:\TEMP
  1821.  
  1822.  
  1823.       Bad files directory
  1824.       -------------------
  1825.  
  1826.       When a bad file has been encountered (ie. the file cannot be unpacked
  1827.       although it is an archive), PalmScan can move it to this directory.
  1828.       When this option is not used, PalmScan will exit with errorlevel 203
  1829.       instead of moving the bad archive.
  1830.  
  1831.       Example   :    C:\FILES\BAD
  1832.  
  1833.       Keyword   :    BadPath [d:\path]
  1834.  
  1835.            [d:\path]      This is the directory where PalmScan will move
  1836.                           bad files to.
  1837.  
  1838.            Example   :    BadPath C:\FILES\BAD
  1839.  
  1840.  
  1841.       Infected files directory
  1842.       ------------------------
  1843.  
  1844.       When a virus has been found, PalmScan will move the file so you can
  1845.       investigate it further. When this keyword is not used, PalmScan will
  1846.       exit with errorlevel 213 instead of moving the infected file.
  1847.  
  1848.       Example   :    C:\FILES\INFECTED
  1849.  
  1850.       Keyword   :    InfectedPath [d:\path]
  1851.  
  1852.            [d:\path]      This is the directory where PalmScan will move
  1853.                           infected files to.
  1854.  
  1855.            Example   :    InfectedPath C:\FILES\INFECTED
  1856.  
  1857.  
  1858.  
  1859.  
  1860.                                       - 30 -
  1861.       PalmScan v2.02                                             User guide
  1862.       ---------------------------------------------------------------------
  1863.  
  1864.       Hacked files directory
  1865.       ----------------------
  1866.  
  1867.       When a file has been found in the hacklist, PalmScan will move this
  1868.       file so you can investigate it further. When this keyword is not
  1869.       used, PalmScan will exit with errorlevel 212 instead of moving the
  1870.       hacked file.
  1871.  
  1872.       Example   :    C:\FILES\HACKED
  1873.  
  1874.       Keyword   :    HackPath [d:\path]
  1875.  
  1876.            Example   :    HackPath C:\FILES\HACKED
  1877.  
  1878.  
  1879.       Old files directory
  1880.       -------------------
  1881.  
  1882.       PalmScan can check for files which are too old. When this check is
  1883.       configured (see the Old files section), old files will be moved to
  1884.       the path configured with this option. When no directory is configured
  1885.       here, PalmScan will exit with errorlevel 204 when encountering files
  1886.       which are too old.
  1887.  
  1888.       Example   :    C:\FILES\OLD
  1889.  
  1890.       Keyword   :    OldPath [d:\path]
  1891.  
  1892.            Example   :    OldPath C:\FILES\OLD
  1893.  
  1894.  
  1895.       Bad GIF files directory
  1896.       -----------------------
  1897.  
  1898.       When a bad graphics image (a graphics image with a resolution which
  1899.       is too low (MinimumResolution configuration keyword) or which failed
  1900.       the GIF test (GIFtest configuration keyword), the file will be moved
  1901.       to the directory configured here. When no directory is configured
  1902.       here, PalmScan will exit with errorlevel 205 on bad graphics images.
  1903.  
  1904.       Keyword   :    BadGifPath [d:\path]
  1905.  
  1906.            Example   :    BadGifPath C:\FILES\BADGIF
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.                                       - 31 -
  1924.       PalmScan v2.02                                             User guide
  1925.       ---------------------------------------------------------------------
  1926.  
  1927.       Substitute drive
  1928.       ----------------
  1929.  
  1930.       When archiving files with sub-directory's, some archivers add
  1931.       complete path names instead of only the sub-directory's names to the
  1932.       archives. PalmScan can use a substituted drive for the archive
  1933.       conversion to make sure the correct directory names are in the
  1934.       archives. PalmScan will then call SUBST before every pack/unpack
  1935.       command.
  1936.       With the default archiver settings, this option is not necessary.
  1937.  
  1938.       Note      :    This option is not available in the OS/2 version of
  1939.                      PalmScan, while the SUBST command is not available in
  1940.                      OS/2.
  1941.  
  1942.       Example   :    F
  1943.  
  1944.       Keyword   :    SubstDrive [Drive letter]
  1945.  
  1946.            [Drive letter] The drive letter must be an unused drive and
  1947.                           should be available when PalmScan is running
  1948.                           (please test it with the SUBST command before
  1949.                           using it in PalmScan). When an error occurs while
  1950.                           SUBST is being called, PalmScan will use the
  1951.                           normal pathname.
  1952.  
  1953.            Example   :    SubstDrive F
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.                                       - 32 -
  1987.       PalmScan v2.02                                             User guide
  1988.       ---------------------------------------------------------------------
  1989.  
  1990.       3.3.4  Files Lists
  1991.       ------------------
  1992.  
  1993.       Here a number of files-lists can be configured. When the files-list
  1994.       have been configured here, they can be edited using PSetup.
  1995.  
  1996.  
  1997.       Hacked files list
  1998.       -----------------
  1999.  
  2000.       PalmScan can check a HackList (eg. 'The Hack Report') for dangerous
  2001.       or unwanted files. This HackList contains filenames or file-
  2002.       specifications which PalmScan will reject. When a filename without an
  2003.       extension is configured, PalmScan will assume '.*' (without quotes).
  2004.       The hacklist can contain other information after a comma, which will
  2005.       be ignored by PalmScan.
  2006.  
  2007.       Example   :    C:\PALMSCAN\PALMSCAN.HCK
  2008.  
  2009.       Keyword   :    HackList [d:\path\filename.ext]
  2010.  
  2011.            [d:\path\filename.ext]   This is the full path and filename of
  2012.                                     the HackList to use.
  2013.  
  2014.            Example : HackList C:\PALMSCAN\PALMSCAN.HCK
  2015.  
  2016.  
  2017.       Skip files list
  2018.       ---------------
  2019.  
  2020.       The skip files list can be used to make PalmScan skip certain files.
  2021.       Both normal file-specifications and directories with file-
  2022.       specifications can be used in the skip files list.
  2023.  
  2024.       Example   :    C:\PALMSCAN\PALMSCAN.SKP
  2025.  
  2026.       Keyword   :    SkipFilesList [d:\path\filename.ext]
  2027.  
  2028.            [d:\path\filename.ext]   This is the full path and filename of
  2029.                                     the skip files list to use.
  2030.  
  2031.            Example   :    SkipFilesList C:\PALMSCAN\PALMSCAN.SKP
  2032.  
  2033.  
  2034.       Pack Unpacked files list
  2035.       ------------------------
  2036.  
  2037.       PalmScan will pack all files which are not yet archived, which are
  2038.       specified in this list.
  2039.  
  2040.       Example   :    C:\PALMSCAN\PALMSCAN.PCK
  2041.  
  2042.       Keyword   :    PackUnpackedFilesList [d:\path\filename.ext]
  2043.  
  2044.            [d:\path\filename.ext]   This is the full path and filename of
  2045.                                     the pack unpacked files list to use.
  2046.  
  2047.            Example   :    PackUnpackedFilesList C:\PALMSCAN\PALMSCAN.PCK
  2048.  
  2049.                                       - 33 -
  2050.       PalmScan v2.02                                             User guide
  2051.       ---------------------------------------------------------------------
  2052.  
  2053.       Remove files list
  2054.       -----------------
  2055.  
  2056.       With this list, you can tell PalmScan to remove certain files from
  2057.       archives. For example, this can be used to remove other bbs's
  2058.       advertisements.
  2059.  
  2060.       Example   :    C:\PALMSCAN\PALMSCAN.RMV
  2061.  
  2062.       Keyword   :    RemoveFilesList [d:\path\filename.ext]
  2063.  
  2064.            [d:\path\filename.ext]   This is the full path and filename of
  2065.                                     the remove files list to use.
  2066.  
  2067.            Example   :    RemoveFilesList C:\PALMSCAN\PALMSCAN.RMV
  2068.  
  2069.  
  2070.       Add files list
  2071.       --------------
  2072.  
  2073.       In this list, files which must be added to archives can be
  2074.       configured. File-specifications are not allowed in this list, only
  2075.       path\filenames.
  2076.  
  2077.       Example   :    C:\PALMSCAN\PALMSCAN.ADD
  2078.  
  2079.       Keyword   :    AddFilesList [d:\path\filename.ext]
  2080.  
  2081.            [d:\path\filename.ext]   This is the full path and filename of
  2082.                                     the add files list to use.
  2083.  
  2084.            Example   :    AddFilesList C:\PALMSCAN\PALMSCAN.ADD
  2085.  
  2086.  
  2087.       Password list
  2088.       -------------
  2089.  
  2090.       This files-list can contain paths and file-specifications for
  2091.       archives, and passwords which should be used to unpack those
  2092.       archives.
  2093.  
  2094.       Example   :    C:\PALMSCAN\PALMSCAN.PWL
  2095.  
  2096.       Keyword   :    PasswordList [d:\path\filename.ext]
  2097.  
  2098.            [d:\path\filename.ext]   This is the full path and filename of
  2099.                                     the password list to use.
  2100.  
  2101.            Example   :    PasswordList C:\PALMSCAN\PALMSCAN.PWL
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.                                       - 34 -
  2113.       PalmScan v2.02                                             User guide
  2114.       ---------------------------------------------------------------------
  2115.  
  2116.       3.3.5  Message System
  2117.       ---------------------
  2118.  
  2119.       In this section, the PalmScan message system can be configured.
  2120.  
  2121.       Because of the large code size consumption, the message system has
  2122.       been placed in an overlay file (PALMSCAN.OVR). If you do not use the
  2123.       message system and have a shortage of disk space, the overlay file
  2124.       can be removed. The OS/2 version of PalmScan does not use an overlay.
  2125.       Memory limits aren't an issue in that version.
  2126.  
  2127.       At the moment of the v2.02 release, the OS/2 version of PalmScan does
  2128.       not support Ezycom messagebases. We are currently working on adding
  2129.       this before the release of v2.03.
  2130.  
  2131.  
  2132.       Net address
  2133.       -----------
  2134.  
  2135.       Here you can specify you main network address, as installed in your
  2136.       mailer configuration. This is only used for messages created when bad
  2137.       or infected archives are found. If you don't have any network
  2138.       address, you don't have to enter anything here either.
  2139.  
  2140.       Example   :    2:2802/140
  2141.  
  2142.       Keyword   :    NetAddress [Zone:Net/Node<.Point>]
  2143.  
  2144.            [Zone:Net/Node<.Point>]  Your network address. 
  2145.                                     <.Point> is optional.
  2146.  
  2147.            Example   :    NetAddress 2:2802/140
  2148.  
  2149.  
  2150.       Messagebase path
  2151.       ----------------
  2152.  
  2153.       When an infected file or a bad archive has been found, PalmScan can
  2154.       post a message to the system operator, describing which archive
  2155.       contains infected file(s), which scanner(s) reported this, what
  2156.       action has been taken and which user was online at the time (when
  2157.       running in online mode). In addition to this, reports created by the
  2158.       virus scanner(s) which detected one or more virus(es) can be added to
  2159.       the message.
  2160.       By specifying a message area, this feature is enabled. When no
  2161.       message area is configured here, the message system is disabled.
  2162.  
  2163.       Example   :    C:\BBS\MSGBASE
  2164.  
  2165.       Keyword   :    MessageArea [Type]<Number>[Path]
  2166.  
  2167.            For more information about the MessageArea keyword, please read
  2168.            the section about that keyword.
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.                                       - 35 -
  2176.       PalmScan v2.02                                             User guide
  2177.       ---------------------------------------------------------------------
  2178.  
  2179.       Messagebase format
  2180.       ------------------
  2181.  
  2182.       When using the message system, PalmScan has to know what kind of
  2183.       messagebase you want it to use. Here you can select the messagebase
  2184.       format.
  2185.  
  2186.       Example   :    Hudson
  2187.  
  2188.       Keyword   :    MessageArea [Type]<Number>[Path]
  2189.  
  2190.            For more information about the MessageArea keyword, please read
  2191.            the section about that keyword.
  2192.  
  2193.  
  2194.       Message area number
  2195.       -------------------
  2196.  
  2197.       When using a Hudson or Ezycom messagebase, a message area number must
  2198.       be configured also. For Fido, Squish and JAM areas, this isn't
  2199.       needed.
  2200.  
  2201.       Example   :    1
  2202.  
  2203.       Keyword   :    MessageArea [Type]<Number>[Path]
  2204.  
  2205.            For more information about the MessageArea keyword, please read
  2206.            the section about that keyword.
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.                                       - 36 -
  2239.       PalmScan v2.02                                             User guide
  2240.       ---------------------------------------------------------------------
  2241.  
  2242.       MessageArea configuration keyword
  2243.       ---------------------------------
  2244.  
  2245.       The MessageArea configuration keyword combines the previous three
  2246.       configuration fields.
  2247.  
  2248.       PalmScan supports these messagebase types:
  2249.  
  2250.       Fido           :    F followed by the message path.
  2251.                           Example : FC:\FD\NETMAIL
  2252.  
  2253.       Hudson         :    H followed by a 3 digit area number followed by
  2254.                           the messagebase path.
  2255.                           Example : H001C:\SBBS\MSGBASE
  2256.  
  2257.       Squish         :    S followed by the full path and filename of the
  2258.                           message area.
  2259.                           Example : SC:\MAX\MSG\PALMSCAN
  2260.  
  2261.       Ezycom 1.02    :    E followed by the 4 digit area number followed by
  2262.                           the messagebase path.
  2263.                           Example : E0001C:\EZY\MSGBASE
  2264.  
  2265.       Ezycom 1.10    :    Z followed by the 4 digit area number followed by
  2266.                           the messagebase path.
  2267.                           Example : Z0001C:\EZY\MSGBASE
  2268.  
  2269.       JAM            :    J followed by the full path and filename of the
  2270.                           message area.
  2271.                           Example : JC:\RA\MSG\PALMSCAN
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.                                       - 37 -
  2302.       PalmScan v2.02                                             User guide
  2303.       ---------------------------------------------------------------------
  2304.  
  2305.       3.3.6  File-database
  2306.       --------------------
  2307.  
  2308.       File-database
  2309.       -------------
  2310.  
  2311.       PalmScan has full support for the RemoteAccess, Ezycom and Concord
  2312.       file-databases. With this option, the file-database feature can be
  2313.       enabled.
  2314.  
  2315.       Example   :    RemoteAccess
  2316.  
  2317.       Keyword   :    FDB [RA|Ezycom|Concord]
  2318.  
  2319.            [RA]      PalmScan will use the RemoteAccess 2.xx file-database.
  2320.                      When an infected file is found, PalmScan will use the
  2321.                      normal procedure to either move the file or exit with
  2322.                      an errorlevel, and besides that it will mark the file
  2323.                      as deleted, unlisted and/or not available, according
  2324.                      to the settings in the RemoteAccess configuration.
  2325.                      When an archive cannot be unpacked, PalmScan will also
  2326.                      use the normal procedure, and it will mark the file as
  2327.                      not available in the file-database.
  2328.  
  2329.            [Ezycom]  PalmScan will use the Ezycom 1.02 or 1.10
  2330.                      file-database. PalmScan will detect the used version
  2331.                      when reading the Ezycom configuration.
  2332.                      When a bad archive (infected, cannot be unpacked,
  2333.                      etc.) is found, PalmScan will use the normal procedure
  2334.                      to either move the file or exit with an errorlevel,
  2335.                      and it will mark the file as offline in the Ezycom
  2336.                      file-database.
  2337.                      When the FileID keyword is used with Ezycom 1.02,
  2338.                      PalmScan will filter out all ascii control codes and
  2339.                      all high ascii, and place the first non-empty line at
  2340.                      the description in the Ezycom file-database. When
  2341.                      using it with Ezycom 1.10, all description
  2342.                      manipulation features are available.
  2343.  
  2344.            [Concord] PalmScan will use the Concord file-database.
  2345.                      When a bad archive (infected, cannot be unpacked,
  2346.                      etc.) is found, PalmScan will use the normal procedure
  2347.                      to either move the file or exit with an errorlevel,
  2348.                      and besides that it will mark the file as deleted,
  2349.                      unlisted and offline.
  2350.  
  2351.            Example   :    FDB RA
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.                                       - 38 -
  2365.       PalmScan v2.02                                             User guide
  2366.       ---------------------------------------------------------------------
  2367.  
  2368.       To prevent problems, here is some inside information about the file-
  2369.       database feature:
  2370.       *    When you are using one directory for different file areas,
  2371.            PalmScan will always use the FIRST area which uses that
  2372.            directory.
  2373.       *    When PalmScan adds a description to the file-database, the old
  2374.            description will not be removed from the database text. It will
  2375.            not be used for the file anymore, but will remain on your disk.
  2376.            To remove the old description you should use the maintenance
  2377.            utility included in your bbs package (for more information,
  2378.            consult your bbs manual).
  2379.       *    When PalmScan adds an unlisted file to the RemoteAccess file-
  2380.            database, it will add the default settings found in the file-
  2381.            area configuration.
  2382.  
  2383.  
  2384.       Uploader name
  2385.       -------------
  2386.  
  2387.       By default, PalmScan uses 'PalmScan' and the version number as
  2388.       uploader name for files added to the RemoteAccess/Ezycom/Concord
  2389.       file-database. With this option, you can specify an other name to use
  2390.       as uploader name.
  2391.  
  2392.       Example   :    Steven Hendriks
  2393.  
  2394.       Keyword   :    UploaderName [Name]
  2395.  
  2396.            [Name]         The name to be used as uploader name.
  2397.  
  2398.            Example   :    UploaderName Steven Hendriks
  2399.  
  2400.       Note      :    This is a bonus feature, which is available in the
  2401.                      registered version only.
  2402.  
  2403.  
  2404.       BBS system directory
  2405.       --------------------
  2406.  
  2407.       When using the RemoteAccess/Ezycom/Concord file-database, PalmScan
  2408.       has to read some information from the RemoteAccess/Ezycom/Concord
  2409.       configuration. Either the RA/EZY/CONCORD environment variable or this
  2410.       keyword must be configured to be able to use the file-database.
  2411.  
  2412.       Example   :    C:\BBS
  2413.  
  2414.       Keyword   :    BBSpath [d:\path]
  2415.  
  2416.            [d:\path]      The bbs system directory.
  2417.  
  2418.            Example   :    BBSpath C:\BBS
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.                                       - 39 -
  2428.       PalmScan v2.02                                             User guide
  2429.       ---------------------------------------------------------------------
  2430.  
  2431.       Update FILES.BBS 
  2432.       ----------------
  2433.  
  2434.       When this option is set, PalmScan will update the entry in the
  2435.       FILES.BBS files list when archive conversion is done, and, in
  2436.       cooperation with the FileID importing function, put the description
  2437.       of the file in this files list.
  2438.  
  2439.       Example   :    X
  2440.  
  2441.       Keyword   :    FilesBBS [c]
  2442.  
  2443.            [c]            For using extended descriptions (descriptions
  2444.                           consisting of multiple lines), PalmScan should
  2445.                           know the character which is used by you BBS
  2446.                           system for this option. SuperBBS uses '>',
  2447.                           RemoteAccess 1.xx uses '+'. By default, no
  2448.                           extended descriptions character is used.
  2449.  
  2450.            Example   :    FilesBBS >
  2451.  
  2452.  
  2453.       Extended descriptions character
  2454.       -------------------------------
  2455.  
  2456.       When using a FILES.BBS files list, and descriptions which cover more
  2457.       than one line are used, an extended descriptions character can be
  2458.       used. This character is placed before each additional description
  2459.       line.
  2460.  
  2461.       Example   :    +
  2462.  
  2463.       Keyword   :    FilesBBS [c]
  2464.  
  2465.            [c]            For using extended descriptions (descriptions
  2466.                           consisting of multiple lines), PalmScan should
  2467.                           know the character which is used by you BBS
  2468.                           system for this option. SuperBBS uses '>',
  2469.                           RemoteAccess 1.xx uses '+'. By default, no
  2470.                           extended descriptions character is used.
  2471.  
  2472.            Example   :    FilesBBS >
  2473.  
  2474.            Note      :    When no extended descriptions character is used,
  2475.                           PalmScan cannot remove extended descriptions when
  2476.                           adding a new description.
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.                                       - 40 -
  2491.       PalmScan v2.02                                             User guide
  2492.       ---------------------------------------------------------------------
  2493.  
  2494.       Spaces to indent
  2495.       ----------------
  2496.  
  2497.       With this option, you can set the number of spaces that should be
  2498.       indented in the FILES.BBS, before extended descriptions.
  2499.  
  2500.       Example   :    1
  2501.  
  2502.       KeyWord   :    IndentSpaces [nn]
  2503.  
  2504.            [nn]           The number of spaces to indent.
  2505.  
  2506.            Example   :    IndentSpaces 1
  2507.  
  2508.  
  2509.       Download counters
  2510.       -----------------
  2511.  
  2512.       When a file which was not already listed has been added to the
  2513.       FILES.BBS files list, and when an extended description has been
  2514.       added, PalmScan will also update the download counter when this
  2515.       option has been configured.
  2516.  
  2517.       Example   :    [ ] 3
  2518.  
  2519.       Keyword   :    DownloadCounter [l] [r] [nnn]
  2520.  
  2521.            [l]            This is the character that is being used as left
  2522.                           bracket in the download counters.
  2523.  
  2524.            [r]            This is the character that is being used as right
  2525.                           bracket in the download counters.
  2526.  
  2527.            [nnn]          This is the number of characters (numbers) that
  2528.                           should be used in between the brackets.
  2529.  
  2530.            Example   :    DownloadCounter [ ] 3
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.                                       - 41 -
  2554.       PalmScan v2.02                                             User guide
  2555.       ---------------------------------------------------------------------
  2556.  
  2557.       FILES.BBS Filename
  2558.       ------------------
  2559.  
  2560.       By default, PalmScan will use the file FILES.BBS in the same
  2561.       directory as the processed files, when the FILES.BBS feature is used.
  2562.       With this option, you can configure the filename for this files list.
  2563.       When it is configured to another name than FILES.BBS, PalmScan will
  2564.       first try this file, and if that fails it will still use the normal
  2565.       FILES.BBS. This option can be used for 4DOS DESCRIPT.ION files, or
  2566.       when you have your files list in a sub-directory of the directory
  2567.       where the files are located. When the latter is used, PalmScan will
  2568.       use this sub-directory for the files list, and when the sub-directory
  2569.       does not exist, the normal FILES.BBS will be used.
  2570.  
  2571.       Example   :    DESCRIPT.ION
  2572.  
  2573.       Keyword   :    FilesBBSname [<path\>filename.ext]
  2574.  
  2575.            [<path\>filename.ext]    The filename of the FILES.BBS file to
  2576.                                     use. <path\> is optional.
  2577.  
  2578.            Example   :    FilesBBSname DESCRIPT.ION
  2579.  
  2580.  
  2581.       Online Import
  2582.       -------------
  2583.  
  2584.       When running online under Concord, Ezycom or Filedoor, PalmScan can
  2585.       place the description in a temporary file, which will then be used by
  2586.       Concord, Ezycom or FileDoor.
  2587.       To use this feature with Ezycom, the node on which PalmScan is
  2588.       running must be specified on the commandline with the /N[node]
  2589.       commandline option.
  2590.       The FILE_ID import function must be used in the PalmScan
  2591.       configuration for this feature to work. The OneLine, Filter, FiltLow
  2592.       and FiltDraw options also work with this function.
  2593.       The Ezycom or Concord file-database feature should not be used with
  2594.       this, or the /NoFDB commandline option should be used, while the bbs
  2595.       program will update the file-database itself.
  2596.       When using the Filedoor online import feature, PalmScan will also
  2597.       inform Filedoor of the changes in filesizes and filenames.
  2598.  
  2599.       When running in local-only mode (/L commandline option), PalmScan
  2600.       will never create the temporary description file.
  2601.  
  2602.       Example   :    Concord
  2603.  
  2604.       Keyword   :    Online [Concord|Ezycom|Filedoor]
  2605.  
  2606.            [Concord]      Use the Concord file_id.diz importing function.
  2607.  
  2608.            [Ezycom]       Use the Ezycom file_id.<node> importing function.
  2609.  
  2610.            [Filedoor]     Use the Filedoor description importing function.
  2611.  
  2612.            Example   :    Online Concord
  2613.  
  2614.  
  2615.  
  2616.                                       - 42 -
  2617.       PalmScan v2.02                                             User guide
  2618.       ---------------------------------------------------------------------
  2619.  
  2620.       3.3.7  Miscellaneous
  2621.       --------------------
  2622.  
  2623.       Log file
  2624.       --------
  2625.  
  2626.       PalmScan can keep track of its activity in a logfile. When this
  2627.       option is not used, no logging will be done.
  2628.  
  2629.       Example   :    C:\LOG\PALMSCAN.LOG
  2630.  
  2631.       Keyword   :    LogFile [d:\path\filename.ext] <Compact|Expanded>
  2632.  
  2633.            [d:\path\filename.ext]   This is the full path and filename of
  2634.                                     the logfile PalmScan should maintain.
  2635.                                     When running on a multi-node system,
  2636.                                     PalmScan can use different log files
  2637.                                     for different nodes. %N in the log
  2638.                                     filename will be replaced by the node
  2639.                                     number on which PalmScan is running
  2640.                                     (this node number must be specified
  2641.                                     with the /N commandline option).
  2642.                                     When only a filename (no path) is
  2643.                                     configured, PalmScan will put the log
  2644.                                     file in the same directory as where
  2645.                                     PalmScan.Exe is located.
  2646.  
  2647.            Example   :    LogFile C:\LOG\PALMSCAN.LOG
  2648.  
  2649.  
  2650.       Log style
  2651.       ---------
  2652.  
  2653.       The log file created by PalmScan can be written in two styles:
  2654.  
  2655.       Compact   :    ----------  Tue 30 Apr 96, PalmScan ...
  2656.                      $ 12:34:56  Local operation
  2657.  
  2658.       Expanded  :    $ 30-Apr 12:34:56 PSCN PalmScan ...
  2659.                      $ 30-Apr 12:34:56 PSCN Local operation
  2660.  
  2661.       Example   :    Expanded
  2662.  
  2663.       Keyword   :    LogFile [d:\path\filename.ext] <Compact|Expanded>
  2664.  
  2665.            <Compact>      This is the default log style.
  2666.  
  2667.            <Expanded>     This is the alternative log style.
  2668.  
  2669.            Example   :    LogFile C:\LOG\PSCAN%N.LOG Expanded
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.                                       - 43 -
  2680.       PalmScan v2.02                                             User guide
  2681.       ---------------------------------------------------------------------
  2682.  
  2683.       No disk space check
  2684.       -------------------
  2685.  
  2686.       Before copying and unpacking files, PalmScan will first check for the
  2687.       available disk space. If it is not sufficient, the operation is
  2688.       cancelled. However, on large partitions (above 2 GB), DOS could
  2689.       return an incorrect value, which could result in incorrect behaviour
  2690.       by PalmScan. To avoid this problem, the disk space check can be
  2691.       disabled.
  2692.       Disabling the disk space check will result in some speed reduction
  2693.       when there is not enough space available (PalmScan will find out
  2694.       while copying / unpacking a file).
  2695.  
  2696.       Example   :    X
  2697.  
  2698.       Keyword   :    NoDiskSpaceCheck
  2699.  
  2700.            Example   :    NoDiskSpaceCheck
  2701.  
  2702.  
  2703.       Exec timeout
  2704.       ------------
  2705.  
  2706.       With this option a timeout value for external programs can be
  2707.       configured. When an external program (like an archiver, virus
  2708.       scanner, etcetera) exceeds this time, PalmScan/2 assumes it hangs,
  2709.       and terminates the process in which the external program is running.
  2710.       The default timeout value is 600 seconds. So when a program takes
  2711.       longer than 10 minutes, PalmScan/2 will terminate it. The minimum
  2712.       value is 60 seconds.
  2713.       Please note that this value should not be set too low, while a
  2714.       program still needs some time to do it's job.
  2715.       This feature is available in the OS/2 version only, while DOS does
  2716.       not support multi-threaded programs.
  2717.  
  2718.       Example   :    600
  2719.  
  2720.       Keyword   :    ExecTimeOut [seconds]
  2721.  
  2722.            [seconds]      The number of seconds before PalmScan/2 should
  2723.                           terminate the external program.
  2724.  
  2725.            Example   :    ExecTimeOut 600.
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.                                       - 44 -
  2743.       PalmScan v2.02                                             User guide
  2744.       ---------------------------------------------------------------------
  2745.  
  2746.       3.4  File Processing
  2747.       --------------------
  2748.  
  2749.       3.4.1  General settings
  2750.       -----------------------
  2751.  
  2752.       Only process new files
  2753.       ----------------------
  2754.  
  2755.       For running PalmScan in a daily event, it's possible to process only
  2756.       new files. PalmScan can use three methods to determine whether a file
  2757.       is new:
  2758.  
  2759.       Archive Attr   When this option is used, PalmScan will only process
  2760.                      files with the archive attribute set, and remove this
  2761.                      attribute when a file has been processed, thus
  2762.                      processing files only once.
  2763.  
  2764.       FileDate       In this case, PalmScan will only process files which
  2765.                      have a file date and time later than the last time a
  2766.                      file has been processed in that directory. PalmScan
  2767.                      will store the date in a file called LASTSCAN.PS, in
  2768.                      the directory where the file was found.
  2769.                      Because LASTSCAN.PS only contains the last date and
  2770.                      time a file has been processed, it will affect the
  2771.                      processing of ALL files in that directory.
  2772.                      This method will use a directory entry (0-byte file)
  2773.                      for each processed directory.
  2774.  
  2775.       DataFile       In this case, PalmScan will only process files which
  2776.                      are not found in the data file, and files with a
  2777.                      changed size, date or time. The file which is used to
  2778.                      store the data is called PALMSCAN.DAT. PalmScan uses
  2779.                      separate datafiles for separate directory's, so when a
  2780.                      file is being moved, it will also be processed.
  2781.                      This method uses 12 bytes of disk space for each
  2782.                      processed file (and a directory entry in each
  2783.                      processed directory).
  2784.  
  2785.                      The DataFile method is the most secure method; The
  2786.                      archive attribute method fails on systems where the
  2787.                      archive attribute is being reset by another program
  2788.                      (some backup programs do that), and the file date
  2789.                      method affects complete directory's, where this method
  2790.                      affects only the file which is processed.
  2791.  
  2792.       Example   :    Data File
  2793.  
  2794.       Keyword   :    OnlyNewFiles <FileDate|DataFile>
  2795.  
  2796.            <FileDate>     Use the File Date method.
  2797.  
  2798.            <DataFile>     Use the Data File method.
  2799.  
  2800.            When no method is specified, PalmScan will use the archive
  2801.            attribute method.
  2802.  
  2803.            Example   :    OnlyNewFiles DataFile
  2804.  
  2805.                                       - 45 -
  2806.       PalmScan v2.02                                             User guide
  2807.       ---------------------------------------------------------------------
  2808.  
  2809.       Only process listed files
  2810.       -------------------------
  2811.  
  2812.       By default, all files which comply with the given file specifications
  2813.       (and are not specified with in the Skip files list) will be
  2814.       processed. With this keyword, you can tell PalmScan to only process
  2815.       files which are listed in the FILES.BBS files list (when the
  2816.       FILES.BBS feature is used) and/or the RemoteAccess/Ezycom/Concord
  2817.       file-database (when the file-database feature is used).
  2818.  
  2819.       Example   :    X
  2820.  
  2821.       Keyword   :    ProcessListedOnly
  2822.  
  2823.            Example   :    ProcessListedOnly
  2824.  
  2825.       Note      :    This is a bonus feature, which is available in the
  2826.                      registered version only.
  2827.  
  2828.  
  2829.       Process embedded archives
  2830.       -------------------------
  2831.  
  2832.       PalmScan has the ability to process embedded archives. With this
  2833.       statement you can enable this feature. When there isn't enough memory
  2834.       available to start processing an embedded archive, PalmScan will swap
  2835.       itself to XMS, EMS or disk, and startup another copy of itself. The
  2836.       OS/2 version will never startup another copy of itself, while there
  2837.       always is enough memory available.
  2838.       PalmScan will not do some things with those embedded archives, which
  2839.       are done with main archives. It will not add archive headers or move
  2840.       infected or bad archives. When an infected embedded archive has been
  2841.       found, the main archive will be handled as being infected.
  2842.  
  2843.       Example   :    X
  2844.  
  2845.       Keyword   :    ArchInArch
  2846.  
  2847.            Example   :    ArchInArch
  2848.  
  2849.            Note      :    This is the main switch for embedded archive
  2850.                           processing. When this is not used, all
  2851.                           OnlyMainArchive switches will have no meaning.
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.                                       - 46 -
  2869.       PalmScan v2.02                                             User guide
  2870.       ---------------------------------------------------------------------
  2871.  
  2872.       New archive date
  2873.       ----------------
  2874.  
  2875.       When an archive has been processed, PalmScan can touch the file date
  2876.       and time on the archive. These options are available:
  2877.  
  2878.       Original            :    The processed archive will get the same date
  2879.                                and time as the original archive. This is
  2880.                                the default setting.
  2881.  
  2882.       Today               :    The processed archive will get the current
  2883.                                date and time.
  2884.  
  2885.       Latest              :    The processed archive will get the date and
  2886.                                time of the latest (newest) file in the
  2887.                                archive.
  2888.  
  2889.       Oldest              :    The processed archive will get the date and
  2890.                                time of the oldest file in the archive.
  2891.  
  2892.       Reset future dates  :    The processed archive will get today's date
  2893.                                only when the original archive's date is a
  2894.                                future date. When the original archive's
  2895.                                date is a correct (older) date, the new
  2896.                                archive will get the same date as the
  2897.                                original archive.
  2898.  
  2899.       Example   :    Reset future dates
  2900.  
  2901.       Keyword   :    Touch <Original|Today|Latest|Oldest|ResetFuture>
  2902.  
  2903.            <Original>     The processed archive will get the same date and
  2904.                           time as the original archive. This is the default
  2905.                           setting.
  2906.  
  2907.            <Today>        The processed archive will get the current date
  2908.                           and time.
  2909.  
  2910.            <Latest>       The processed archive will get the date and time
  2911.                           of the latest (newest) file in the archive.
  2912.  
  2913.            <Oldest>       The processed archive will get the date and time
  2914.                           of the oldest file in the archive.
  2915.  
  2916.            <ResetFuture>  The processed archive will get today's date only
  2917.                           when the original archive's date is a future
  2918.                           date. When the original archive's date is a
  2919.                           correct (older) date, the new archive will get
  2920.                           the same date as the original archive.
  2921.  
  2922.            Example   :    Touch ResetFuture
  2923.  
  2924.       Note      :    This is a bonus feature, which is available in the
  2925.                      registered version only.
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.                                       - 47 -
  2932.       PalmScan v2.02                                             User guide
  2933.       ---------------------------------------------------------------------
  2934.  
  2935.       3.4.2  Archive Conversion
  2936.       -------------------------
  2937.  
  2938.       Archive conversion
  2939.       ------------------
  2940.  
  2941.       This option sets the target archive system. When no target archive
  2942.       system is set, no archive conversion will be done. The archive system
  2943.       configured here, must also be configured at the archivers section.
  2944.  
  2945.       Example   :    RAR
  2946.  
  2947.       Keyword   :    ArchiveConversion [Archiver] <OnlyMainArchive> <NoSFX>
  2948.                      <NoSecure> <ToSFX> <EmbeddedOnlyNormalNames>
  2949.  
  2950.            For more information about the ArchiveConversion keyword, please
  2951.            read the section about that keyword.
  2952.  
  2953.  
  2954.       SFX
  2955.       ---
  2956.  
  2957.       When converting archives to self-extracting archives, this switch
  2958.       should be used. PalmScan will then use .EXE as the extension instead
  2959.       of the default extension which is configured for that archiver.
  2960.  
  2961.       Example   :    X
  2962.  
  2963.       Keyword   :    ArchiveConversion [Archiver] <OnlyMainArchive> <NoSFX>
  2964.                      <NoSecure> <ToSFX> <EmbeddedOnlyNormalNames>
  2965.  
  2966.            For more information about the ArchiveConversion keyword, please
  2967.            read the section about that keyword.
  2968.  
  2969.       Note      :    This is a bonus feature, which is available in the
  2970.                      registered version only.
  2971.  
  2972.  
  2973.       Only Main Archives
  2974.       ------------------
  2975.  
  2976.       When this switch is selected, only  main archives will be converted
  2977.       to the target archive type. Embedded archives will still be processed
  2978.       for other options when the embedded archive processing is enabled,
  2979.       but those archives will not be converted.
  2980.  
  2981.       Example   :    Only Main Archives
  2982.  
  2983.       Keyword   :    ArchiveConversion [Archiver] <OnlyMainArchive> <NoSFX>
  2984.                      <NoSecure> <ToSFX> <EmbeddedOnlyNormalNames>
  2985.  
  2986.            For more information about the ArchiveConversion keyword, please
  2987.            read the section about that keyword.
  2988.  
  2989.  
  2990.  
  2991.  
  2992.  
  2993.  
  2994.                                       - 48 -
  2995.       PalmScan v2.02                                             User guide
  2996.       ---------------------------------------------------------------------
  2997.  
  2998.       Don't convert secure archives
  2999.       -----------------------------
  3000.  
  3001.       When this switch is used, secure archives (archives with a security
  3002.       envelope, authenticity verification or seal) will not be converted,
  3003.       no files will be removed or added, no music modules will be
  3004.       described, and an archive header will not be added to secured ARJ and
  3005.       UC2 archives. Also, the archives embedded in secure archives will not
  3006.       be altered in any way.
  3007.       PalmScan can detect ARJ security envelopes, ZIP and RAR authenticity
  3008.       verifications and UC2 seals.
  3009.  
  3010.       Example   :    X
  3011.  
  3012.       Keyword   :    ArchiveConversion [Archiver] <OnlyMainArchive> <NoSFX>
  3013.                      <NoSecure> <ToSFX> <EmbeddedOnlyNormalNames>
  3014.  
  3015.            For more information about the ArchiveConversion keyword, please
  3016.            read the section about that keyword.
  3017.  
  3018.       Note      :    This is a bonus feature, which is available in the
  3019.                      registered version only.
  3020.  
  3021.  
  3022.       Only convert embedded archives with normal extensions
  3023.       -----------------------------------------------------
  3024.  
  3025.       When this switch is used, PalmScan will only convert embedded
  3026.       archives which have a normal extension. This can be useful for
  3027.       archives which contain an installation program, which then uses the
  3028.       embedded archives to install a software product. Usually, those
  3029.       embedded archives do not have a normal extension, so they will not be
  3030.       converted by PalmScan when this option is used.
  3031.       The main archive will be converted as usual.
  3032.  
  3033.       Example   :    X
  3034.  
  3035.       Keyword   :    ArchiveConversion [Archiver] <OnlyMainArchive> <NoSFX>
  3036.                      <NoSecure> <ToSFX> <EmbeddedOnlyNormalNames>
  3037.  
  3038.            For more information about the ArchiveConversion keyword, please
  3039.            read the section about that keyword.
  3040.  
  3041.       Note      :    This is a bonus feature, which is available in the
  3042.                      registered version only.
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.                                       - 49 -
  3058.       PalmScan v2.02                                             User guide
  3059.       ---------------------------------------------------------------------
  3060.  
  3061.       ArchiveConversion configuration keyword
  3062.       ---------------------------------------
  3063.  
  3064.       Keyword   :    ArchiveConversion [Archiver] <OnlyMainArchive> <NoSFX>
  3065.                      <NoSecure> <ToSFX> <EmbeddedOnlyNormalNames>
  3066.  
  3067.            [Archiver]     This sets the target. You can supply all values
  3068.                           you configured with the Archiver statement.
  3069.  
  3070.            <OnlyMainArchive>             Do not convert embedded archives.
  3071.  
  3072.            <NoSFX>                       Do not convert self-extracting
  3073.                                          archives.
  3074.  
  3075.            <NoSecure>                    Do not convert secure archives.
  3076.  
  3077.            <ToSFX>                       The selected archiver creates
  3078.                                          self-extracting archives.
  3079.  
  3080.            <EmbeddedOnlyNormalNames>     Only convert embedded archives
  3081.                                          which have a normal extension.
  3082.  
  3083.            Example   :    ArchiveConversion RAR OnlyMainArchive NoSecure
  3084.  
  3085.  
  3086.       Convert ALL archives
  3087.       --------------------
  3088.  
  3089.       Normally, PalmScan will only convert archives of other types than the
  3090.       target archive system. With this option you can tell PalmScan to
  3091.       convert all archives, even if it's already of the target archive
  3092.       type.
  3093.       When Only Main Archives is selected, only main archives which are
  3094.       already in the target archive type will be converted. Embedded
  3095.       archives which are already in the target archive will not be
  3096.       converted.
  3097.  
  3098.       Example   :    Yes
  3099.  
  3100.       Keyword   :    ConvertAll <OnlyMainArchive>
  3101.  
  3102.            <OnlyMainArchive>   Only convert main archives which are already
  3103.                                in the target format.
  3104.  
  3105.            Example   :    ConvertAll OnlyMainArchive
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.                                       - 50 -
  3121.       PalmScan v2.02                                             User guide
  3122.       ---------------------------------------------------------------------
  3123.  
  3124.       3.4.3  Self-Extracting Archives
  3125.       -------------------------------
  3126.  
  3127.       Process SFX archives
  3128.       --------------------
  3129.  
  3130.       By default, self-extracting (SFX) archives, are not recognised as
  3131.       being archives. With this switch, you can tell PalmScan to process
  3132.       self-extracting archives, just like every other archive. PalmScan can
  3133.       detect ZIP, LZH, SQZ, ARJ, PAK, RAR and UC2 self-extracting archives.
  3134.  
  3135.       Example   :    X
  3136.  
  3137.       Keyword   :    ProcessSFX
  3138.  
  3139.            Example : ProcessSFX
  3140.  
  3141.  
  3142.       Do not convert self-extracting archives
  3143.       ---------------------------------------
  3144.  
  3145.       When this switch is specified, self-extracting archives will not be
  3146.       converted to the target archive type, and no files will be removed
  3147.       from those archives. Also, embedded archives will not be altered.
  3148.  
  3149.       Example   :    X
  3150.  
  3151.       Keyword   :    ArchiveConversion [Archiver] <OnlyMainArchive> <NoSFX>
  3152.                      <NoSecure> <ToSFX> <EmbeddedOnlyNormalNames>
  3153.  
  3154.            For more information about the ArchiveConversion keyword, please
  3155.            read the section about that keyword.
  3156.  
  3157.  
  3158.       Process UC2 self-extracting archives
  3159.       ------------------------------------
  3160.  
  3161.       While UC2 itself (UC.EXE) cannot unpack them, UC2 self-extracting
  3162.       archives have to be executed to extract files from it. By default,
  3163.       PalmScan will not unpack UC2 SFX archives. The reason is simple, it's
  3164.       just not safe (the file can be infected by viruses, or it could be a
  3165.       trojan). To make PalmScan unpack UC2 SFX archives, this switch must
  3166.       be used.
  3167.  
  3168.       When one or more virus scanner(s) have been configured (Scanner
  3169.       keyword), and *.EXE or anything implying *.EXE should be scanned
  3170.       (VirusScan keyword), PalmScan will scan the UC2 self-extracting
  3171.       archive for viruses before it will be unpacked.
  3172.  
  3173.       Example   :    X
  3174.  
  3175.       Keyword   :    UC2SFX [Commandline] <SecureOnly>
  3176.  
  3177.            For more information about the UC2SFX keyword, please read the
  3178.            section about that keyword.
  3179.  
  3180.  
  3181.  
  3182.  
  3183.                                       - 51 -
  3184.       PalmScan v2.02                                             User guide
  3185.       ---------------------------------------------------------------------
  3186.  
  3187.       UC2 SFX commandline options
  3188.       ---------------------------
  3189.  
  3190.       The commandline which should be passed on to the UC2 self-extracting
  3191.       archive (.EXE), when executing it, must be configured here when the
  3192.       Process UC2 self-extracting archives option has been enabled.
  3193.  
  3194.       Example   :    -o .
  3195.  
  3196.       Keyword   :    UC2SFX [Commandline] <SecureOnly>
  3197.  
  3198.            For more information about the UC2SFX keyword, please read the
  3199.            section about that keyword.
  3200.  
  3201.  
  3202.       Only process sealed UC2 self-extracting archives
  3203.       ------------------------------------------------
  3204.  
  3205.       When this option is used, PalmScan will only unpack (execute) UC2
  3206.       self-extracting archives which have been sealed.
  3207.  
  3208.       Example   :    X
  3209.  
  3210.       Keyword   :    UC2SFX [Commandline] <SecureOnly>
  3211.  
  3212.            For more information about the UC2SFX keyword, please read the
  3213.            section about that keyword.
  3214.  
  3215.       Note      :    This is a bonus feature, which is available in the
  3216.                      registered version only.
  3217.  
  3218.  
  3219.       UC2SFX configuration keyword
  3220.       ----------------------------
  3221.  
  3222.       Keyword   :    UC2SFX [Commandline] <SecureOnly>
  3223.  
  3224.            [Commandline]  The commandline which should be passed on to the
  3225.                           UC2 self-extracting archive (.EXE), when
  3226.                           executing it.
  3227.  
  3228.            <SecureOnly>   When this option is used, PalmScan will only
  3229.                           unpack (execute) UC2 self-extracting archives
  3230.                           which have been sealed.
  3231.  
  3232.  
  3233.            Example : UC2SFX -o_. SecureOnly
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.                                       - 52 -
  3247.       PalmScan v2.02                                             User guide
  3248.       ---------------------------------------------------------------------
  3249.  
  3250.       UC2 SFX seal test command
  3251.       -------------------------
  3252.  
  3253.       When only sealed UC2 SFX archives may be processed, PalmScan can test
  3254.       the seal before the UC2 self-extracting archive will be unpacked. The
  3255.       command to test the seal can be specified here.
  3256.  
  3257.       Example   :    USAFE.EXE
  3258.  
  3259.       Keyword   :    UC2SealTest [Command]
  3260.  
  3261.            [Command] The command to execute to test UC2 seals.
  3262.  
  3263.            Example : UC2SealTest USAFE.EXE
  3264.  
  3265.       Note      :    This is a bonus feature, which is available in the
  3266.                      registered version only.
  3267.  
  3268.  
  3269.       Scan SFX archives for viruses
  3270.       -----------------------------
  3271.  
  3272.       When one or more virus scanner(s) have been configured to scan *.EXE
  3273.       or anything implying *.EXE, and this feature is used, PalmScan will
  3274.       scan all self-extracting archives prior to processing them.
  3275.       When this option is not used, PalmScan will still scan UC2 self-
  3276.       extracting archives will still be scanned (see UC2SFX keyword).
  3277.  
  3278.       Example   :    X
  3279.  
  3280.       Keyword : ScanSFX
  3281.  
  3282.            Example   :    ScanSFX
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307.  
  3308.  
  3309.                                       - 53 -
  3310.       PalmScan v2.02                                             User guide
  3311.       ---------------------------------------------------------------------
  3312.  
  3313.       3.4.4  Archive Headers
  3314.       ----------------------
  3315.  
  3316.       Archive header file
  3317.       -------------------
  3318.  
  3319.       PalmScan can add a header to your archives. When this filename points
  3320.       to a valid ASCII textfile, this file will be used as header for the
  3321.       archive.
  3322.  
  3323.       When using UC2 as archiver, PalmScan can also add multimedia headers.
  3324.       The file configured with this option will be added as TXT header. For
  3325.       multimedia headers, you should put the GIF/JPG/MOD/ASK files in the
  3326.       same directory and filename as the configured archive header, and
  3327.       with extension GIF/JPG/MOD/ASK. If you don't want to use the TXT
  3328.       header, but do want to use other headers, you should put the filename
  3329.       of the other headers at the ArchiveHeader keyword without extension
  3330.       or with an extension of a non-existing file (never put GIF/JPG/MOD
  3331.       extensions there, PalmScan will then add these files as archive
  3332.       header as if they were normal text files).
  3333.  
  3334.       Example   :    C:\PALMSCAN\HEADER.ASC
  3335.  
  3336.       Keyword   :    ArchiveHeader [d:\path\filename.ext]
  3337.  
  3338.            [d:\path\filename.ext]   This is the full path and filename to
  3339.                                     the header text file.
  3340.  
  3341.            Example   :    ArchiveHeader C:\PALMSCAN\HEADER.ASC
  3342.  
  3343.  
  3344.       Alternative header file
  3345.       -----------------------
  3346.  
  3347.       Just like with the archive header file option, PalmScan can add this
  3348.       header to your archives. This archive header will only be used with
  3349.       the archive type(s) which have the alternative header switch set.
  3350.       This can be very useful for adding an ANSI header to archives which
  3351.       support it, and add a normal text file to all other archives.
  3352.  
  3353.       Example   :    C:\PALMSCAN\HEADER.ANS
  3354.  
  3355.       Keyword   :    AnsiHeader [d:\path\filename.ext] <Archivers>
  3356.  
  3357.            [d:\path\filename.ext]   This is the full path and filename to
  3358.                                     the header text file.
  3359.  
  3360.            <Archivers>              The archiver(s) with which this archive
  3361.                                     header should be used.
  3362.  
  3363.            Example   :    AnsiHeader C:\PALMSCAN\HEADER.ANS RAR
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.  
  3371.  
  3372.                                       - 54 -
  3373.       PalmScan v2.02                                             User guide
  3374.       ---------------------------------------------------------------------
  3375.  
  3376.       Put FILE_ID description in archive header
  3377.       -----------------------------------------
  3378.  
  3379.       When this switch is on, PalmScan will add the description from
  3380.       FILE_ID.DIZ or DESC.SDI to the archive header. When an archive header
  3381.       is already being added, the description will be appended to it.
  3382.  
  3383.       Example   :    X
  3384.  
  3385.       Keyword   :    FileIDarchiveHdr
  3386.  
  3387.            Example   :    FileIDarchiveHdr
  3388.  
  3389.  
  3390.       No title in headers
  3391.       -------------------
  3392.  
  3393.       By default, PalmScan will add it's title to archive headers, when an
  3394.       archive header is added. With this option, you can disable it.
  3395.  
  3396.       Example   :    X
  3397.  
  3398.       Keyword   :    NoTitleInHdr
  3399.  
  3400.            Example   :    NoTitleInHdr
  3401.  
  3402.       Note      :    This is a bonus feature, which is available in the
  3403.                      registered version only.
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.                                       - 55 -
  3436.       PalmScan v2.02                                             User guide
  3437.       ---------------------------------------------------------------------
  3438.  
  3439.       3.4.5  Descriptions
  3440.       -------------------
  3441.  
  3442.       Import FILE_ID description
  3443.       --------------------------
  3444.  
  3445.       When this switch is set, PalmScan will import the description from
  3446.       FILE_ID.DIZ or DESC.SDI file online or to FILES.BBS and/or the file-
  3447.       database.
  3448.  
  3449.       Example   :    X
  3450.  
  3451.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3452.                      <MaxLines=value>
  3453.  
  3454.            For more information about the FileID keyword, please read the
  3455.            section about that keyword.
  3456.  
  3457.  
  3458.       One line FILE_ID
  3459.       ----------------
  3460.  
  3461.       When this switch is enabled, PalmScan will place descriptions from
  3462.       FILE_ID.DIZ or DESC.SDI on one long line, instead of on multiple
  3463.       lines.
  3464.  
  3465.       Example   :    X
  3466.  
  3467.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3468.                      <MaxLines=value>
  3469.  
  3470.            For more information about the FileID keyword, please read the
  3471.            section about that keyword.
  3472.  
  3473.  
  3474.       Filter high ASCII
  3475.       -----------------
  3476.  
  3477.       PalmScan can filter out high ASCII (characters 128 to 255) from
  3478.       FILE_ID.DIZ or DESC.SDI descriptions. When this switch is used, all
  3479.       high ASCII characters will be removed from the description, and empty
  3480.       lines (which can be caused by removing high ASCII characters when a
  3481.       line consists of only those characters) will be removed.
  3482.  
  3483.       Example   :    X
  3484.  
  3485.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3486.                      <MaxLines=value>
  3487.  
  3488.            For more information about the FileID keyword, please read the
  3489.            section about that keyword.
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.  
  3496.  
  3497.  
  3498.                                       - 56 -
  3499.       PalmScan v2.02                                             User guide
  3500.       ---------------------------------------------------------------------
  3501.  
  3502.       Filter control codes
  3503.       --------------------
  3504.  
  3505.       PalmScan can filter out ASCII control-codes (characters 0 to 31) in
  3506.       FILE_ID.DIZ or DESC.SDI descriptions before importing them.
  3507.  
  3508.       Example   :    X
  3509.  
  3510.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3511.                      <MaxLines=value>
  3512.  
  3513.            For more information about the FileID keyword, please read the
  3514.            section about that keyword.
  3515.  
  3516.  
  3517.       Filter drawings
  3518.       ---------------
  3519.  
  3520.       PalmScan can filter out standard ASCII drawings (for which characters
  3521.       within the range 32 to 126 are used) in descriptions. This works a
  3522.       bit different than the control codes and high ASCII filter functions,
  3523.       while not everything should be filtered out. PalmScan detects
  3524.       drawings by looking at character sequences on complete lines.
  3525.  
  3526.       Example   :    X
  3527.  
  3528.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3529.                      <MaxLines=value>
  3530.  
  3531.            For more information about the FileID keyword, please read the
  3532.            section about that keyword.
  3533.  
  3534.  
  3535.       Maximum Width
  3536.       -------------
  3537.  
  3538.       The maximum width of imported descriptions can be configured with
  3539.       this option.
  3540.  
  3541.       Example   :    50
  3542.  
  3543.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3544.                      <MaxLines=value>
  3545.  
  3546.            For more information about the FileID keyword, please read the
  3547.            section about that keyword.
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.                                       - 57 -
  3562.       PalmScan v2.02                                             User guide
  3563.       ---------------------------------------------------------------------
  3564.  
  3565.       Maximum Length
  3566.       --------------
  3567.  
  3568.       The maximum number of lines of imported descriptions can be
  3569.       configured with this option.
  3570.  
  3571.       Example   :    25
  3572.  
  3573.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3574.                      <MaxLines=value>
  3575.  
  3576.            For more information about the FileID keyword, please read the
  3577.            section about that keyword.
  3578.  
  3579.  
  3580.       FileID configuration keyword
  3581.       ----------------------------
  3582.  
  3583.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3584.                      <MaxLines=value>
  3585.  
  3586.            <OneLine>           Import extended descriptions on one (long)
  3587.                                line.
  3588.  
  3589.            <Filter>            Filter out high ASCII (characters 127-255)
  3590.                                from descriptions when importing them.
  3591.  
  3592.            <FiltLow>           Filter out ASCII control codes (characters
  3593.                                0-31) from descriptions when importing them.
  3594.  
  3595.            <FiltDraw>          Filter out standard ASCII drawings from
  3596.                                descriptions when importing them.
  3597.  
  3598.            <MaxWidth=value>    The maximum width of imported descriptions.
  3599.  
  3600.            <MaxLines=value>    The maximum number of lines of imported
  3601.                                descriptions.
  3602.  
  3603.            Example   :    FileID OneLine Filter FiltLow FiltDraw
  3604.                           MaxWidth=50 MaxLines=25
  3605.  
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.                                       - 58 -
  3625.       PalmScan v2.02                                             User guide
  3626.       ---------------------------------------------------------------------
  3627.  
  3628.       Describe MOD's
  3629.       --------------
  3630.  
  3631.       PalmScan has the ability to describe MOD, NST, STM (ScreamTracker
  3632.       Modules), 669, JMusic and Organ music files. PalmScan will put the
  3633.       description of those files in a FILE_ID.DIZ descriptions file, which
  3634.       will be packed with the other files in the archive. This will only be
  3635.       done when no executables are found in the archive (ie. the archive
  3636.       only consists of music files), or when a FILE_ID.DIZ already exists
  3637.       in the archive (PalmScan will add the descriptions of the music files
  3638.       to this FILE_ID.DIZ in this case). With this keyword, you can enable
  3639.       this option.
  3640.       When Only Main Archives is selected, only modules in the main archive
  3641.       will be described. When embedded archives are being processed,
  3642.       modules in those archives will be ignored. This is only valid when
  3643.       the embedded archive processing is enabled.
  3644.  
  3645.       Example   :    Yes
  3646.  
  3647.       Keyword   :    DescribeMod <OnlyMainArchive>
  3648.  
  3649.            Example : DescribeMod OnlyMainArchive
  3650.  
  3651.  
  3652.  
  3653.  
  3654.  
  3655.  
  3656.  
  3657.  
  3658.  
  3659.  
  3660.  
  3661.  
  3662.  
  3663.  
  3664.  
  3665.  
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.                                       - 59 -
  3688.       PalmScan v2.02                                             User guide
  3689.       ---------------------------------------------------------------------
  3690.  
  3691.       3.5  Archivers
  3692.       --------------
  3693.  
  3694.       The archivers are essential for PalmScan's operation. They are needed
  3695.       to extract files from archives, pack archives, add headers and test
  3696.       archives. This section explains what the commands are used for.
  3697.  
  3698.  
  3699.       3.5.1  Archiver commands
  3700.       ------------------------
  3701.  
  3702.       In the configuration file, every archiver takes up multiple lines.
  3703.       First, there must be an Archiver keyword:
  3704.  
  3705.       Keyword   :    Archiver [ext]
  3706.  
  3707.            [ext]          This is the normal extension of archives created
  3708.                           by this archiver. This will also be used as the
  3709.                           name of the archive within PalmScan.
  3710.  
  3711.            Example   :    ZIP
  3712.  
  3713.       After the Archiver keyword, all commands can be specified. There are
  3714.       several keywords available which must be used to pass on parameters
  3715.       to the archivers:
  3716.  
  3717.       @Archive       Will be replaced by the full path and filename of the
  3718.                      archive which is being processed. When the path and/or
  3719.                      filename contains spaces, PalmScan will add a '"'
  3720.                      (without quotes) before and after the path\filename.
  3721.  
  3722.       @Path          Will be replaced by the directory, without trailing
  3723.                      backlash ('\'), where files should be unpacked to or
  3724.                      packed from. This keyword usually is not necessary
  3725.                      with most archivers, while PalmScan will always make
  3726.                      this directory the current directory before executing
  3727.                      an archiver command.
  3728.  
  3729.       @Filename      Will be replaced by the filename to be unpacked,
  3730.                      packed or added as archive header. This can be either
  3731.                      *.* or a normal filename.
  3732.  
  3733.       @Filenames     Will be replaced by the filenames to be unpacked,
  3734.                      packed or added as archive header. This can be either
  3735.                      *.*, a normal filename, or multiple normal filenames
  3736.                      (separated by spaces). This keyword should never be
  3737.                      used in conjunction with @Path, while only the first
  3738.                      filename would get the path in front of it then. It
  3739.                      should only be used when the archiver supports
  3740.                      multiple filenames on it's commandline.
  3741.  
  3742.       @Size          Will be replaced by the target size when packing a
  3743.                      multi-volume archive. Therefor, this keyword is only
  3744.                      available at the multi-volume compression commands.
  3745.  
  3746.  
  3747.  
  3748.  
  3749.  
  3750.                                       - 60 -
  3751.       PalmScan v2.02                                             User guide
  3752.       ---------------------------------------------------------------------
  3753.  
  3754.       @Password      Will be replaced by the password needed to unpack or
  3755.                      test a password protected archive. When no password is
  3756.                      needed, it will be replaced by an empty string, and
  3757.                      the commandline option directly in front of this
  3758.                      keyword will be removed.
  3759.                      This option is available at the Unpack, OS2unpack,
  3760.                      MVunpack, OS2MVunpack, Test and OS2test commands.
  3761.                      When this keyword is not used, PalmScan will never try
  3762.                      to unpack or test a password protected archive.
  3763.  
  3764.       For each command, there are two versions: A DOS command and an OS/2
  3765.       command. The DOS version of PalmScan will only use the DOS commands.
  3766.       The OS/2 version will use the OS/2 command when configured, and the
  3767.       DOS command when no OS/2 command is available. The OS/2 version will
  3768.       also use the DOS unpack and/or test commands when a password
  3769.       protected archive is being processed, and the @Password keyword is
  3770.       not used with the OS/2 unpack and/or test commands, and is used with
  3771.       the DOS unpack and/or test commands.
  3772.  
  3773.       In the following sections, ZIP will be used as examples at most
  3774.       commands, RAR is used at the multi-volume commands. A complete list
  3775.       of commands is listed at the end of this chapter.
  3776.  
  3777.  
  3778.       Compression
  3779.       -----------
  3780.  
  3781.       This is the full command for the current archiver to compress files.
  3782.  
  3783.       Example   :    pkzip -ex -r -p @Archive @Filenames
  3784.  
  3785.       Keywords  :    Pack [command]
  3786.                      OS2pack [command]
  3787.  
  3788.            Examples  :    Pack pkzip -ex -r -p @Archive @Filenames
  3789.                           OS2pack zip -r -9 -S @Archive @Filenames
  3790.  
  3791.  
  3792.       Decompression
  3793.       -------------
  3794.  
  3795.       This is the full command for the current archiver to extract
  3796.       archives.
  3797.  
  3798.       Example   :    pkunzip -o -d -s@Password @Archive @Filenames
  3799.  
  3800.       Keywords  :    Unpack [command]
  3801.                      OS2unpack [command]
  3802.  
  3803.            Examples  :    Unpack pkunzip -o -d -s@Password @Archive
  3804.                           @Filenames
  3805.                           OS2unpack unzip -o @Archive @Filenames
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.                                       - 61 -
  3814.       PalmScan v2.02                                             User guide
  3815.       ---------------------------------------------------------------------
  3816.  
  3817.       Add Header
  3818.       ----------
  3819.  
  3820.       This is the full command for the current archiver to add a header to
  3821.       an archive.
  3822.  
  3823.       Example   :    pkzip -z<@Path\@Filename @Archive
  3824.  
  3825.       Keywords  :    Header [command]
  3826.                      OS2header [command]
  3827.  
  3828.            Examples  :    Header pkzip -z<@Path\@Filename @Archive
  3829.                           OS2header zip -z<@Path\@Filename @Archive
  3830.  
  3831.       Besides using it for adding an archive header, this feature can also
  3832.       be used to add an authenticity validation. For example, this can be
  3833.       used for ZIP:
  3834.  
  3835.            Header C:\PALMSCAN\ZIPAV.BAT @Path\@Filename @Archive
  3836.  
  3837.       Where ZIPAV.BAT would contain this:
  3838.  
  3839.            copy C:\PALMSCAN\AVEXTRA.TXT .\
  3840.            pkzip -! -ex -xAVEXTRA.TXT %2
  3841.            pkzip -z<%1 %2
  3842.  
  3843.  
  3844.       Alternative header
  3845.       ------------------
  3846.  
  3847.       Check this switch to use the alternative archive header with this
  3848.       archiver.
  3849.  
  3850.       Example   :    X
  3851.  
  3852.       Keyword   :    AnsiHeader [d:\path\filename.ext] <Archivers>
  3853.  
  3854.            Example   :    AnsiHeader C:\PALMSCAN\HEADER.ANS RAR
  3855.  
  3856.  
  3857.  
  3858.  
  3859.  
  3860.  
  3861.  
  3862.  
  3863.  
  3864.  
  3865.  
  3866.  
  3867.  
  3868.  
  3869.  
  3870.  
  3871.  
  3872.  
  3873.  
  3874.  
  3875.  
  3876.                                       - 62 -
  3877.       PalmScan v2.02                                             User guide
  3878.       ---------------------------------------------------------------------
  3879.  
  3880.       Test
  3881.       ----
  3882.  
  3883.       When an archive cannot be unpacked, PalmScan will test the archive
  3884.       when a test command has been configured. This can be useful for
  3885.       archives which have been created with another file-system (e.g. HPFS
  3886.       long filenames cannot be unpacked in DOS). Normally, PalmScan will
  3887.       mark those archives as bad, but when the archive test feature is
  3888.       used, it will only be marked as bad when it also fails the archive
  3889.       test.
  3890.  
  3891.       This feature should be used with caution! When an archive cannot be
  3892.       unpacked, and it does pass the archive test, these actions will not
  3893.       be performed:
  3894.       -    Virus scan
  3895.       -    Embedded archive processing
  3896.       -    Old files check will only be done when configured to check the
  3897.            original date
  3898.       -    Removal of unwanted files
  3899.       -    Adding files
  3900.       -    Music files descriptions
  3901.       -    Adding CRC-32 file list
  3902.  
  3903.       In brief, you should only use this feature when necessary. I.e., if
  3904.       you never or hardly ever receive any files which are marked as bad
  3905.       because of the filenames in the archive, you should not use this
  3906.       feature.
  3907.  
  3908.       Example   :    pkzip -t -s@Password @Archive
  3909.  
  3910.       Keywords  :    Test [command]
  3911.                      OS2test [command]
  3912.  
  3913.            Examples  :    Test pkzip -t -s@Password @Archive
  3914.                           OS2test zip -T @Archive
  3915.  
  3916.       Note      :    This is a bonus feature, which is available in the
  3917.                      registered version only.
  3918.  
  3919.  
  3920.       Multi-Volume Compression
  3921.       ------------------------
  3922.  
  3923.       This is the full command for the current archiver to create a multi-
  3924.       volume archive.
  3925.  
  3926.       Example   :    rar a -r -y -o- -std -m5 -v@Size @Archive @Filenames
  3927.  
  3928.       Keywords  :    MVpack [command]
  3929.                      OS2MVpack [command]
  3930.  
  3931.            Examples  :    MVpack rar a -r -y -o- -std -m5 -v@Size @Archive
  3932.                           @Filenames
  3933.                           OS2MVpack rar a -r -y -o- -std -m5 -v@Size
  3934.                           @Archive @Filenames
  3935.  
  3936.  
  3937.  
  3938.  
  3939.                                       - 63 -
  3940.       PalmScan v2.02                                             User guide
  3941.       ---------------------------------------------------------------------
  3942.  
  3943.       Multi-Volume Decompression
  3944.       --------------------------
  3945.  
  3946.       This is the full command for the current archiver to unpack multi-
  3947.       volume archives.
  3948.  
  3949.       Example   :    rar x -r -y -o- -std -c- -p@Password @Archive
  3950.                      @Filenames
  3951.  
  3952.       Keywords  :    MVunpack [command]
  3953.                      OS2MVunpack [command]
  3954.  
  3955.            Examples  :    MVunpack rar x -r -y -o- -std -c- -p@Password
  3956.                           @Archive @Filenames
  3957.                           OS2MVunpack rar x -r -y -o- -std -c- -p@Password
  3958.                           @Archive @Filenames
  3959.  
  3960.  
  3961.       Example archiver commands
  3962.       -------------------------
  3963.  
  3964.       Here follows a list of archiver commands which can be used in
  3965.       PalmScan. Please note that this list is not complete. It contains
  3966.       only those commands that have been tested with PalmScan. The Test
  3967.       commands have intentionally been left out, while those should not be
  3968.       used by unexperienced users.
  3969.  
  3970.  
  3971.       Archiver ARC
  3972.       Pack pkarc a @Archive @Filenames
  3973.       OS2pack arc a @Archive @Filenames
  3974.       Unpack pak e /wa @Archive @Filenames
  3975.       OS2unpack arc xo @Archive @Filenames
  3976.       Header pkarc x<@Path\@Filename @Archive
  3977.  
  3978.       Archiver ZIP
  3979.       Pack pkzip -ex -r -p @Archive @Filenames
  3980.       OS2pack zip -k -r -9 -S @Archive @Filenames
  3981.       Unpack pkunzip -o -d -s@Password @Archive @Filenames
  3982.       OS2unpack unzip -o @Archive @Filenames
  3983.       Header pkzip -z<@Path\@Filename @Archive
  3984.       OS2header zip -z<@Path\@Filename @Archive
  3985.  
  3986.       Archiver LZH
  3987.       Pack lha a /rxpat @Archive @Filenames
  3988.       Unpack lha x /c @Archive @Filenames
  3989.  
  3990.       Archiver ZOO
  3991.       Pack zoo aPh @Archive @Filenames
  3992.       Unpack zoo eO// @Archive @Filenames
  3993.       Header zoo cA<@Path\@Filename @Archive
  3994.  
  3995.       Archiver SQZ
  3996.       Pack sqz a /p3 /s @Archive @Filenames
  3997.       Unpack sqz x -o1 @Archive @Filenames
  3998.  
  3999.  
  4000.  
  4001.  
  4002.                                       - 64 -
  4003.       PalmScan v2.02                                             User guide
  4004.       ---------------------------------------------------------------------
  4005.  
  4006.       Archiver HYP
  4007.       Pack hyper -a @Archive @Filenames
  4008.       Unpack hyper -xo @Archive @Filenames
  4009.  
  4010.       Archiver ARJ
  4011.       Pack arj a -r -y @Archive @Filenames
  4012.       Unpack arj x -y -g@Password @Archive @Filenames
  4013.       OS2unpack unarj X @Archive @Filenames
  4014.       MVpack arj a -r -y -v@Size @Archive @Filenames
  4015.       MVunpack arj x -y -v -g@Password @Archive @Filenames
  4016.       Header arj c -z@Path\@Filename @Archive
  4017.  
  4018.       Archiver HAP
  4019.       Pack hap a @Archive @Filenames
  4020.       Unpack pah e @Archive @Filenames
  4021.  
  4022.       Archiver PAK
  4023.       Pack pak a /i @Archive @Filenames
  4024.       Unpack pak e /wa @Archive @Filenames
  4025.       Header pak h<@Path\@Filename @Archive
  4026.  
  4027.       Archiver UC2
  4028.       Pack uc a -s -tst -f -b @Archive @Filenames
  4029.       Unpack uc e -s -f !ban=off @Archive @Filenames
  4030.       Header uc a -tt -f -b @Archive @Path\@Filename
  4031.  
  4032.       Archiver RAR
  4033.       Pack rar a -r -y -o- -std -m5 @Archive @Filenames
  4034.       OS2pack rar a -r -y -o- -std -m5 @Archive @Filenames
  4035.       Unpack rar x -r -y -o- -std -c- -p@Password @Archive @Filenames
  4036.       OS2unpack rar x -r -y -o- -std -c- -p@Password @Archive @Filenames
  4037.       MVpack rar a -r -y -o- -std -m5 -v@Size @Archive @Filenames
  4038.       OS2MVpack rar a -r -y -o- -std -m5 -v@Size @Archive @Filenames
  4039.       MVunpack rar x -r -y -o- -std -c- -p@Password @Archive @Filenames
  4040.       OS2MVunpack rar x -r -y -o- -std -c- -p@Password @Archive @Filenames
  4041.       Header rar c -y -std @Archive =@Path\@Filename
  4042.       OS2header rar c -y -std @Archive =@Path\@Filename
  4043.  
  4044.       Archiver DWC
  4045.       Pack dwc a @Archive @Filenames
  4046.       Unpack dwc e @Archive @Filenames
  4047.  
  4048.  
  4049.  
  4050.  
  4051.  
  4052.  
  4053.  
  4054.  
  4055.  
  4056.  
  4057.  
  4058.  
  4059.  
  4060.  
  4061.  
  4062.  
  4063.  
  4064.  
  4065.                                       - 65 -
  4066.       PalmScan v2.02                                             User guide
  4067.       ---------------------------------------------------------------------
  4068.  
  4069.       3.5.2  Archive Protection
  4070.       -------------------------
  4071.  
  4072.       UC2 protection
  4073.       --------------
  4074.  
  4075.       When an archive has been converted to UC2, PalmScan can add all
  4076.       available UC2 protections to it. By default, no protection will be
  4077.       added.
  4078.  
  4079.       Keyword   :    UC2protection <BasicUpdates> <Delete> <Add> <Optimize>
  4080.                      <Unprotect> <ReviseComment>
  4081.  
  4082.            <BasicUpdates>      Disable basic updates on processed archives.
  4083.            <Delete>            Disable deleting files in processed
  4084.                                archives.
  4085.            <Add>               Disable adding files to processed archives.
  4086.            <Optimize>          Disable optimize on processed archives.
  4087.            <Unprotect>         Disable unprotect on processed archives.
  4088.            <ReviseComment>     Disable comment revising on processed
  4089.                                archives.
  4090.  
  4091.            Example   :    UC2protection Add Unprotect ReviseComment
  4092.  
  4093.  
  4094.       RAR lock
  4095.       --------
  4096.  
  4097.       When an archive has been converted to RAR, PalmScan can add a lock to
  4098.       it. By default, RAR archives will not be locked.
  4099.  
  4100.       Keywords  :    RARlock [command]
  4101.                      OS2RARlock [command]
  4102.  
  4103.            [command]      To enable RAR archive locking, the command to
  4104.                           lock a RAR archive must be configured here. When
  4105.                           you are a registered RAR user, an authenticity
  4106.                           validation can also be added here.
  4107.  
  4108.            Example   :    RARlock RAR_k_-av
  4109.  
  4110.  
  4111.  
  4112.  
  4113.  
  4114.  
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.                                       - 66 -
  4129.       PalmScan v2.02                                             User guide
  4130.       ---------------------------------------------------------------------
  4131.  
  4132.       3.6  Virus scan
  4133.       ---------------
  4134.  
  4135.       3.6.1  Files to scan
  4136.       --------------------
  4137.  
  4138.       In this list, file specifications of files which should be scanned
  4139.       for viruses, can be entered. When one or more files which comply to
  4140.       the file specifications configured here, PalmScan will start the
  4141.       virus scan.
  4142.  
  4143.       Examples  :    *.EXE
  4144.                      *.COM
  4145.                      *.OV?
  4146.                      *.DLL
  4147.  
  4148.       Keyword   :    VirusScan <filespec> <filespecs>
  4149.  
  4150.            <filespec>     This can be any valid DOS or OS/2 file
  4151.                           specification.
  4152.                           When you give a file specification, PalmScan will
  4153.                           only execute the virus scanner(s) when one or
  4154.                           more file(s) have been found that meet the
  4155.                           requirements of these file specifications.
  4156.                           When no file specifications are given, and the
  4157.                           VirusScan keyword is used, PalmScan will always
  4158.                           execute the virus scanner(s). In PSetup, there
  4159.                           must always be at least one file specification,
  4160.                           e.g. *.*.
  4161.  
  4162.            Example   :    VirusScan *.EXE *.COM *.OVR *.OVL
  4163.  
  4164.  
  4165.       3.6.2  Virus scanners
  4166.       ---------------------
  4167.  
  4168.       Here up to 20 virus scanners can be configured. There are two
  4169.       keywords available for this: Scanner and OS2scanner. The DOS version
  4170.       always uses the Scanner keyword, the OS/2 uses the OS2scanner keyword
  4171.       and, when no OS/2 scanner is configured with the same name, the
  4172.       Scanner keyword.
  4173.  
  4174.       Scanner name
  4175.       ------------
  4176.  
  4177.       This is the name of the virus scanner.
  4178.  
  4179.       Keywords  :    Scanner [name] [command] [lll] <[hhh] <[nnn]
  4180.                      <filespecs>>>
  4181.                      OS2scanner [name] [command] [lll] <[hhh] <[nnn]
  4182.                      <filespecs>>>
  4183.  
  4184.            For more information about the Scanner keyword, please read the
  4185.            section about that keyword.
  4186.  
  4187.  
  4188.  
  4189.  
  4190.  
  4191.                                       - 67 -
  4192.       PalmScan v2.02                                             User guide
  4193.       ---------------------------------------------------------------------
  4194.  
  4195.       Command
  4196.       -------
  4197.  
  4198.       This is the command for the virus scanner to be executed. The
  4199.       path/filename(s) of the file(s) to be scanned will NOT be
  4200.       automatically added to the commandline. There are some keywords which
  4201.       will be replaced with the correct string by PalmScan:
  4202.  
  4203.       @PATH     The directory that should be scanned (without trailing
  4204.                 backlash).
  4205.  
  4206.       @FILENAME The filename of the file(s) to be scanned.
  4207.  
  4208.       @FULL     The path and filename of the file(s) to be scanned.
  4209.                 (@FULL = @PATH\@FILENAME)
  4210.  
  4211.       @SPECIAL  This meta-command is a special one; it will act like @FULL
  4212.                 when a specific file should be scanned, and  like @PATH
  4213.                 when all files in a directory should be scanned.
  4214.  
  4215.       @REPORT   When a virus has been found, PalmScan will include the
  4216.                 report created by the virus scanner(s) which found one or
  4217.                 more virus(es) in the message which is posted to the system
  4218.                 operator. To use this feature, @REPORT must be included on
  4219.                 the virus scanner commandline, along with the appropriate
  4220.                 command for that program to create the report.
  4221.                 PalmScan will replace @REPORT with a filename for the
  4222.                 report.
  4223.  
  4224.       Keywords  :    Scanner [name] [command] [lll] <[hhh] <[nnn]
  4225.                      <filespecs>>>
  4226.                      OS2scanner [name] [command] [lll] <[hhh] <[nnn]
  4227.                      <filespecs>>>
  4228.  
  4229.            For more information about the Scanner keyword, please read the
  4230.            section about that keyword.
  4231.  
  4232.  
  4233.       Low Errorlevel
  4234.       --------------
  4235.  
  4236.       This is the lowest errorlevel the virus scanner will return when a
  4237.       virus has been found.
  4238.  
  4239.       Keywords  :    Scanner [name] [command] [lll] <[hhh] <[nnn]
  4240.                      <filespecs>>>
  4241.                      OS2scanner [name] [command] [lll] <[hhh] <[nnn]
  4242.                      <filespecs>>>
  4243.  
  4244.            For more information about the Scanner keyword, please read the
  4245.            section about that keyword.
  4246.  
  4247.  
  4248.  
  4249.  
  4250.  
  4251.  
  4252.  
  4253.  
  4254.                                       - 68 -
  4255.       PalmScan v2.02                                             User guide
  4256.       ---------------------------------------------------------------------
  4257.  
  4258.       High Errorlevel
  4259.       ---------------
  4260.  
  4261.       This is the highest errorlevel the virus scanner will return when a
  4262.       virus has been found. When it is not set, PalmScan assumes the virus
  4263.       scanner will only return the low errorlevel when a virus has been
  4264.       found.
  4265.  
  4266.       Keywords  :    Scanner [name] [command] [lll] <[hhh] <[nnn]
  4267.                      <filespecs>>>
  4268.                      OS2scanner [name] [command] [lll] <[hhh] <[nnn]
  4269.                      <filespecs>>>
  4270.  
  4271.            For more information about the Scanner keyword, please read the
  4272.            section about that keyword.
  4273.  
  4274.  
  4275.       Other Errorlevel
  4276.       ----------------
  4277.  
  4278.       This is the errorlevel that the virus scanner will return when
  4279.       nothing is wrong. Most virus scanners return errorlevel 0 when there
  4280.       are no problems, but there are some scanners which return another
  4281.       errorlevel just because there are no executables found. With this
  4282.       option you can make PalmScan simply ignore that errorlevel.
  4283.  
  4284.       Keywords  :    Scanner [name] [command] [lll] <[hhh] <[nnn]
  4285.                      <filespecs>>>
  4286.                      OS2scanner [name] [command] [lll] <[hhh] <[nnn]
  4287.                      <filespecs>>>
  4288.  
  4289.            For more information about the Scanner keyword, please read the
  4290.            section about that keyword.
  4291.  
  4292.  
  4293.       File specifications
  4294.       -------------------
  4295.  
  4296.       Up to 5 file specifications can optionally be given. First, PalmScan
  4297.       will check the global file specifications (configured in the files to
  4298.       scan section). When there are files which comply with those, the
  4299.       virus scanning will start. Before executing each virus scanner,
  4300.       PalmScan will check the file specifications for those virus scanners,
  4301.       and only execute them when there are no file specifications
  4302.       configured at that virus scanner or when there are files which comply
  4303.       with those specifications.
  4304.  
  4305.       Keywords  :    Scanner [name] [command] [lll] <[hhh] <[nnn]
  4306.                      <filespecs>>>
  4307.                      OS2scanner [name] [command] [lll] <[hhh] <[nnn]
  4308.                      <filespecs>>>
  4309.  
  4310.            For more information about the Scanner keyword, please read the
  4311.            section about that keyword.
  4312.  
  4313.  
  4314.  
  4315.  
  4316.  
  4317.                                       - 69 -
  4318.       PalmScan v2.02                                             User guide
  4319.       ---------------------------------------------------------------------
  4320.  
  4321.       Scanner configuration keyword
  4322.       -----------------------------
  4323.  
  4324.       Keyword : Scanner [name] [command] [lll] <[hhh] <[nnn] <filespecs>>>
  4325.  
  4326.            [name]    The name of the virus scanner.
  4327.  
  4328.            [command] The command to start this virus scanner.
  4329.  
  4330.            [lll]     The lowest errorlevel the virus scanner returns when a
  4331.                      virus has been found.
  4332.  
  4333.            <hhh>     The highest errorlevel the virus scanner returns when
  4334.                      a virus has been found.
  4335.  
  4336.            <nnn>     The errorlevel that the virus scanner returns when
  4337.                      nothing is wrong.
  4338.  
  4339.            <filespecs>    Up to 5 scanner-specific file specifications.
  4340.  
  4341.            Examples :     Scanner McAfee_Scan
  4342.                           SCAN_/NOEXPIRE_/NOMEM_/REPORT_@REPORT_/SUB_@FULL
  4343.                           13 13 14
  4344.  
  4345.                           OS2scanner McAfee_Scan
  4346.                           OS2SCAN_/NOEXPIRE_/REPORT_@REPORT_/SUB_@FULL 13
  4347.                           13 14
  4348.  
  4349.                           Scanner ThunderByte_Scan
  4350.                           TBSCAN_AF_NB_NM_BA_IN_NA_OLD_LOG_LOGNAME=@REPORT_
  4351.                           @SPECIAL 2 127 1
  4352.  
  4353.                           Scanner F-Prot
  4354.                           F-PROT_/ALL_/COMMAND_/NOMEM_/OLD_/NOBOOT_/REPORT=
  4355.                           @REPORT_ @FULL 3 3 0
  4356.  
  4357.                           Scanner AVScan AVSCAN_/NM_/NC_/Q_/R_/S_@FULL 100
  4358.                           255 0 *.exe *.com
  4359.  
  4360.  
  4361.  
  4362.  
  4363.  
  4364.  
  4365.  
  4366.  
  4367.  
  4368.  
  4369.  
  4370.  
  4371.  
  4372.  
  4373.  
  4374.  
  4375.  
  4376.  
  4377.  
  4378.  
  4379.  
  4380.                                       - 70 -
  4381.       PalmScan v2.02                                             User guide
  4382.       ---------------------------------------------------------------------
  4383.  
  4384.       3.6.3  Options
  4385.       --------------
  4386.  
  4387.       Complete scan
  4388.       -------------
  4389.  
  4390.       Normally, PalmScan will not process embedded archives when a virus
  4391.       has already been found. This feature enables the processing of those
  4392.       embedded archives, which is especially useful when using the message
  4393.       system. PalmScan will then create a complete overview of all infected
  4394.       files in an archive.
  4395.  
  4396.       Example   :    X
  4397.  
  4398.       Keyword   :    CompleteScan
  4399.  
  4400.            Example   :    CompleteScan
  4401.  
  4402.  
  4403.       Fast scan
  4404.       ---------
  4405.  
  4406.       PalmScan can scan for viruses in the main archive and in all embedded
  4407.       archives in one run. When this feature is used, PalmScan will unpack
  4408.       all embedded archives right after the main archive has been unpacked.
  4409.       The virus scan is done at the point where it would normally scan for
  4410.       viruses in the main archive. All other embedded archive processing is
  4411.       done the same as without this feature.
  4412.       For the fast scan feature to work properly, your virus scanners must
  4413.       be configured to scan the current directory and all subdirectories.
  4414.       (The example virus scanner commands will do this properly).
  4415.       When this feature is not used, PalmScan will scan each embedded
  4416.       archive separately.
  4417.  
  4418.       Example   :    X
  4419.  
  4420.       Keyword   :    FastScan
  4421.  
  4422.            Example   :    FastScan
  4423.  
  4424.       Note      :    This is a bonus feature, which is available in the
  4425.                      registered version only.
  4426.  
  4427.  
  4428.       No DOS scanners
  4429.       ---------------
  4430.  
  4431.       When this keyword is used, the OS/2 version of PalmScan will ignore
  4432.       the configured DOS virus scanners, and only use the OS/2 virus
  4433.       scanners. This keyword has no effect on the operation of the DOS
  4434.       version.
  4435.  
  4436.       Example   :    X
  4437.  
  4438.       Keyword   :    NoDOSscanners
  4439.  
  4440.            Example   :    NoDOSscanners
  4441.  
  4442.  
  4443.                                       - 71 -
  4444.       PalmScan v2.02                                             User guide
  4445.       ---------------------------------------------------------------------
  4446.  
  4447.       3.7  Hacked Files
  4448.       -----------------
  4449.  
  4450.       In this list, file-specifications of files which are dangerous or
  4451.       unwanted can be configured.
  4452.       Files which are found in this list, will be moved to the hacked files
  4453.       directory, or, when no hacked files directory is configured, PalmScan
  4454.       will exit with an errorlevel.
  4455.       For this feature to work properly, a hacked files list must be
  4456.       configured in the files lists section.
  4457.  
  4458.  
  4459.       Example   :    PKZIP201.*
  4460.  
  4461.  
  4462.       3.8  Skip Files
  4463.       ---------------
  4464.  
  4465.       In this list, file-specifications of files which should not be
  4466.       processed can be configured. Full path names can also be included in
  4467.       these file specifications.
  4468.       For this feature to work properly, a skip files list must be
  4469.       configured in the files lists section.
  4470.  
  4471.       Examples  :    BIMODEM.LOG
  4472.                      D:\FILES\SKIP\*.*
  4473.  
  4474.  
  4475.  
  4476.  
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.  
  4485.  
  4486.  
  4487.  
  4488.  
  4489.  
  4490.  
  4491.  
  4492.  
  4493.  
  4494.  
  4495.  
  4496.  
  4497.  
  4498.  
  4499.  
  4500.  
  4501.  
  4502.  
  4503.  
  4504.  
  4505.  
  4506.                                       - 72 -
  4507.       PalmScan v2.02                                             User guide
  4508.       ---------------------------------------------------------------------
  4509.  
  4510.       3.9  Pack Unpacked
  4511.       ------------------
  4512.  
  4513.       File specifications
  4514.       -------------------
  4515.  
  4516.       In this list, file-specifications of unpacked files which should be
  4517.       packed can be configured. All files which comply to one or more of
  4518.       the configured file-specifications, and are not archives, will be
  4519.       archived with the archiver configured at the archive conversion
  4520.       feature.
  4521.       For this feature to work properly, a pack unpacked files list must be
  4522.       configured in the files lists section.
  4523.  
  4524.       Example   :    *.TXT
  4525.  
  4526.  
  4527.       Minimum size
  4528.       ------------
  4529.  
  4530.       The minimum size (in bytes) for unpacked files which should be
  4531.       packed, can be configured with this option. This option is available
  4532.       so very small files will not be packed, which would otherwise cause
  4533.       an archive which is larger than the original file.
  4534.       Another use can be that files which fit into one allocation block (on
  4535.       FAT partitions, this often is 8192 bytes) will not get packed. It
  4536.       might result in a smaller file when a file which is smaller than one
  4537.       allocation block is packed, but wouldn't result in reduction in disk
  4538.       space usage.
  4539.  
  4540.       Example   :    2048
  4541.  
  4542.       Keyword   :    PackUnpackedSize [size]
  4543.  
  4544.            [size]         This is the minimum size in bytes.
  4545.  
  4546.            Example   :    PackUnpackedSize 2048
  4547.  
  4548.  
  4549.  
  4550.  
  4551.  
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.  
  4559.  
  4560.  
  4561.  
  4562.  
  4563.  
  4564.  
  4565.  
  4566.  
  4567.  
  4568.  
  4569.                                       - 73 -
  4570.       PalmScan v2.02                                             User guide
  4571.       ---------------------------------------------------------------------
  4572.  
  4573.       3.10 Remove Files
  4574.       -----------------
  4575.  
  4576.       Many archives contain some files which have no relation with the
  4577.       actual archive, like advertisements added at bulletin boards. This
  4578.       can eventually take up a large part of your available disk space.
  4579.       PalmScan can remove these files from the archives.
  4580.       In this list, file-specifications of files which should be removed
  4581.       from archives, can be configured. Optional for each file-
  4582.       specification, a filesize and CRC-32 can be configured. When a
  4583.       filesize and/or CRC-32 is configured for a file-specification, only
  4584.       those files which comply to the file-specification and have the
  4585.       filesize and/or CRC-32 as configured for this file-specification,
  4586.       will be removed. This can be useful for removing advertisements which
  4587.       have another filename every time, but have the same contents (thus
  4588.       have the same filesize and CRC-32). It can also be used to remove
  4589.       empty files by configuring the filesize to 0.
  4590.       For this feature to work properly, a remove files list must be
  4591.       configured in the files lists section.
  4592.  
  4593.       Examples  :    OASISBBS.ADV
  4594.                      CALL.* /SIZE=248 /CRC=23a86bf9
  4595.                      *.* /SIZE=0
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.  
  4602.  
  4603.  
  4604.  
  4605.  
  4606.  
  4607.  
  4608.  
  4609.  
  4610.  
  4611.  
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.  
  4628.  
  4629.  
  4630.  
  4631.  
  4632.                                       - 74 -
  4633.       PalmScan v2.02                                             User guide
  4634.       ---------------------------------------------------------------------
  4635.  
  4636.       3.11 Add Files
  4637.       --------------
  4638.  
  4639.       Just like PalmScan can remove files from archives, it can also add
  4640.       files to them. This can be used to add an advertisement for your
  4641.       bulletin board, or whatever you want added to the archives.
  4642.       Only full path and filenames can be configured in this list. PalmScan
  4643.       will add these files in the home directory of the main archive.
  4644.       For this feature to work properly, an add files list must be
  4645.       configured in the files lists section.
  4646.  
  4647.       Example   :    C:\PALMSCAN\OASISBBS.ADV
  4648.  
  4649.  
  4650.       Add CRC file list
  4651.       -----------------
  4652.  
  4653.       PalmScan can create a list with all filenames, sizes, dates and
  4654.       CRC-32's of all files in the archive. This file will look like this:
  4655.  
  4656.            CRC-32 files list for : ARCHIVE.EXT
  4657.            Created by PalmScan v2.02 on BBS name
  4658.  
  4659.            File         Size     Date       Time  CRC-32
  4660.            -----------------------------------------------
  4661.            FILENAME.EXT XXXXXXXX XX-XX-XXXX XX:XX XXXXXXXX
  4662.            -----------------------------------------------
  4663.  
  4664.       The filename of the list will be the same as the archive filename,
  4665.       with extension .CRC.
  4666.  
  4667.       Example   :    Only Main Archive
  4668.  
  4669.       Keyword   :    AddCRCfile <OnlyMainArchive>
  4670.  
  4671.            <OnlyMainArchive>   When this switch is specified, PalmScan will
  4672.                                only create a CRC-32 list in the main
  4673.                                archive. Embedded archives will not get a
  4674.                                CRC-32 list.
  4675.  
  4676.            Example   :    AddCRCfile OnlyMainArchive
  4677.  
  4678.       Note      :    The BBS name will only be added when using the
  4679.                      registered version of PalmScan.
  4680.  
  4681.  
  4682.  
  4683.  
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.  
  4691.  
  4692.  
  4693.  
  4694.  
  4695.                                       - 75 -
  4696.       PalmScan v2.02                                             User guide
  4697.       ---------------------------------------------------------------------
  4698.  
  4699.       3.12 Archive Passwords
  4700.       ----------------------
  4701.  
  4702.       This files-list can contain paths and file-specifications for
  4703.       archives, and passwords which should be used to unpack those
  4704.       archives.
  4705.  
  4706.       When a password protected archive is found in this list, PalmScan
  4707.       will use the password configured here to unpack or test the archive.
  4708.  
  4709.       When the archive is not found in this list, and PalmScan is running
  4710.       in interactive mode (/Interactive commandline option), PalmScan will
  4711.       ask for the password before it starts to unpack or test the archive.
  4712.  
  4713.       When an archive is not found in this list, and PalmScan is not
  4714.       running in interactive mode, it will never try to unpack or test an
  4715.       archive.
  4716.  
  4717.       Example   :    ALLFIX.* /Password=FINALLY
  4718.  
  4719.  
  4720.  
  4721.  
  4722.  
  4723.  
  4724.  
  4725.  
  4726.  
  4727.  
  4728.  
  4729.  
  4730.  
  4731.  
  4732.  
  4733.  
  4734.  
  4735.  
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.                                       - 76 -
  4759.       PalmScan v2.02                                             User guide
  4760.       ---------------------------------------------------------------------
  4761.  
  4762.       3.13 GIF settings
  4763.       -----------------
  4764.  
  4765.       Add GIF specifications to descriptions
  4766.       --------------------------------------
  4767.  
  4768.       PalmScan will add GIF/PNG (resolution and colors) and JFIF/JPEG
  4769.       (resolution and color/gray) specifications to descriptions when this
  4770.       keyword is used. Optional are the characters that are used in the
  4771.       descriptions, but when specifying one of them, both others must be
  4772.       specified too. By default, these characters are used : ( x )
  4773.       When used with FILES.BBS or a file-database, PalmScan will first
  4774.       check if the specifications already exist in the description, and
  4775.       only add them when they do not already exist.
  4776.  
  4777.       Example   :    X
  4778.  
  4779.       Keyword   :    GIFspecs <[left bracket] ['by' character] [right
  4780.                      bracket]>
  4781.  
  4782.            Example   :    GIFspecs < * >
  4783.  
  4784.  
  4785.  
  4786.  
  4787.  
  4788.  
  4789.  
  4790.  
  4791.  
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.  
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.                                       - 77 -
  4822.       PalmScan v2.02                                             User guide
  4823.       ---------------------------------------------------------------------
  4824.  
  4825.       GIF pack
  4826.       --------
  4827.  
  4828.       To convert GIF pictures to another format, this feature can be used.
  4829.  
  4830.       The title is only used to display to what format the file is being
  4831.       converted, but must be configured when using this feature.
  4832.  
  4833.       The command that should be executed to convert the GIF picture must
  4834.       also be configured when using this feature.
  4835.  
  4836.       PalmScan will by default add the original filename and extension to
  4837.       the GIFpack commandline. This is configurable with these options:
  4838.  
  4839.       @FILENAME      Will be replaced by the original filename.
  4840.  
  4841.       @EXT           Will be replaced by the original extension.
  4842.  
  4843.       If you do not want embedded graphics files to be converted, 'Do NOT
  4844.       convert embedded graphics files' should be selected. Some archives
  4845.       contain graphics files which are used by the program(s) inside the
  4846.       archive. Converting those graphics files would result in the programs
  4847.       not finding the graphics files when they are needed.
  4848.  
  4849.       Programs which replace the original file (e.g. GIFlite) can be used
  4850.       with this feature.
  4851.  
  4852.       Example   :    X
  4853.                      JFIF
  4854.                      CJPEG.EXE @FILENAME.@EXT @FILENAME.JPG
  4855.  
  4856.       Keyword   :    GIFpack [title] [command] <NoEmbedded>
  4857.  
  4858.            [title]        The title of the configured GIF pack utility.
  4859.  
  4860.            [command]      The command that should be executed to pack the
  4861.                           GIF file.
  4862.  
  4863.            <NoEmbedded>   Do not convert embedded graphics files.
  4864.  
  4865.            Example   :    GIFpack JFIF CJPEG.EXE @FILENAME.@EXT
  4866.                           @FILENAME.JPG
  4867.  
  4868.  
  4869.  
  4870.  
  4871.  
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.  
  4880.  
  4881.  
  4882.  
  4883.  
  4884.                                       - 78 -
  4885.       PalmScan v2.02                                             User guide
  4886.       ---------------------------------------------------------------------
  4887.  
  4888.       JFIF unpack
  4889.       -----------
  4890.  
  4891.       PalmScan will use this command to convert JFIF files to GIF. JFIF
  4892.       files are standard JFIF/JPEG files, which can be created by CJPEG and
  4893.       some other graphics conversion utilities.
  4894.  
  4895.       Example   :    DJPEG.EXE
  4896.  
  4897.       Keyword   :    JFIFunpack [command]
  4898.  
  4899.            [command]      This is the command that should be executed to
  4900.                           convert the JFIF file.
  4901.  
  4902.            Example   :    JFIFunpack DJPEG.EXE
  4903.  
  4904.  
  4905.       JPEG unpack
  4906.       -----------
  4907.  
  4908.       This is almost the same as JFIF unpack, with the difference that JPEG
  4909.       files are files which are incompatible with standard JFIF/JPEG files.
  4910.       Files created by (older versions of) GIF2JPG are such JPEG files.
  4911.       When this command is not configured, and JFIF unpack is configured,
  4912.       PalmScan will try to convert JPEG files to GIF using the command
  4913.       configured at JFIF unpack.
  4914.  
  4915.       Example   :    JPG2GIF.EXE
  4916.  
  4917.       Keyword   :    JPEGunpack [command]
  4918.  
  4919.            [command]      This is the command that should be executed to
  4920.                           convert the JPEG file.
  4921.  
  4922.            Example   :    JPEGunpack JPG2GIF.EXE
  4923.  
  4924.  
  4925.       GIFblast unpack
  4926.       ---------------
  4927.  
  4928.       PalmScan will use this command to convert GIFblast files to GIF.
  4929.  
  4930.       Example   :    GIFBLAST.EXE -D
  4931.  
  4932.       Keyword   :    GIFBLASTunpack [command]
  4933.  
  4934.            [command]      This is the command that should be executed to
  4935.                           convert the GIFblast file.
  4936.  
  4937.            Example   :    GIFBLASTunpack GIFBLAST.EXE_-D
  4938.  
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.                                       - 79 -
  4948.       PalmScan v2.02                                             User guide
  4949.       ---------------------------------------------------------------------
  4950.  
  4951.       Repack JFIF files
  4952.       -----------------
  4953.  
  4954.       When this option is selected, JFIF files will first be converted to
  4955.       GIF, and then converted using the command configured with the GIFpack
  4956.       keyword.
  4957.  
  4958.       Example   :    X
  4959.  
  4960.       Keyword   :    JFIFrepack
  4961.  
  4962.            Example   :    JFIFrepack
  4963.  
  4964.  
  4965.       Repack JPEG files
  4966.       -----------------
  4967.  
  4968.       hen this option is selected, JPEG files will first be converted to
  4969.       GIF, and then converted using the command configured with the GIFpack
  4970.       keyword.
  4971.  
  4972.       Example   :    X
  4973.  
  4974.       Keyword   :    JPEGrepack
  4975.  
  4976.            Example   :    JPEGrepack
  4977.  
  4978.  
  4979.       Repack GIFblast files
  4980.       ---------------------
  4981.  
  4982.       When this option is selected, GIFblast files will first be converted
  4983.       to GIF, and then converted using the command configured with the
  4984.       GIFpack keyword.
  4985.  
  4986.       Example   :    X
  4987.  
  4988.       Keyword   :    GIFBLASTrepack
  4989.  
  4990.            Example   :    GIFBLASTrepack
  4991.  
  4992.  
  4993.  
  4994.  
  4995.  
  4996.  
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.  
  5003.  
  5004.  
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010.                                       - 80 -
  5011.       PalmScan v2.02                                             User guide
  5012.       ---------------------------------------------------------------------
  5013.  
  5014.       Minimum resolution
  5015.       ------------------
  5016.  
  5017.       PalmScan can reject GIF, PNG, JFIF, JPEG and GIFblast files which
  5018.       have a resolution which is too low. When either one of the resolution
  5019.       values is lower than the configured value, PalmScan will move the
  5020.       file to the directory configured as bad GIF directory. When no bad
  5021.       GIF directory is configured, PalmScan will exit with errorlevel 205.
  5022.       When a message area is configured, a message to the system operator
  5023.       will also be posted.
  5024.  
  5025.       Example   :    320x200x256
  5026.  
  5027.       Keyword   :    MinimumResolution [horizontal]x[vertical]x[colors]
  5028.  
  5029.            [horizontal]   The minimum horizontal resolution (width).
  5030.  
  5031.            [vertical]     The minimum vertical resolution (height).
  5032.  
  5033.            [colors]       The minumum number of colors.
  5034.  
  5035.            Example   :    MinimumResolution 320x200x256
  5036.  
  5037.  
  5038.       GIF test command / failures
  5039.       ---------------------------
  5040.  
  5041.       PalmScan can use an external GIF testing program to test all GIF
  5042.       files. Up to ten errorlevels can be configured, which will cause
  5043.       PalmScan to treat the file as bad GIF file.
  5044.  
  5045.       Example   :    GIFTEST.EXE /M:320x200x256
  5046.                      1    20   25
  5047.  
  5048.       Keyword   :    GIFtest [command] <errorlevels>
  5049.  
  5050.            [command]      The command to execute to test GIF files.
  5051.  
  5052.            <errorlevels>  Up to 10 errorlevels can be configured. When the
  5053.                           result from [command] is one of the configured
  5054.                           errorlevels, PalmScan will move the file to the
  5055.                           BadGifPath, or exit with errorlevel 205 when no
  5056.                           BadGifPath is configured. When a message area is
  5057.                           configured, a message to the system operator will
  5058.                           also be posted.
  5059.  
  5060.            Example   :    GIFtest GIFTEST.EXE_/M:320x200x256 1 20 25
  5061.  
  5062.  
  5063.  
  5064.  
  5065.  
  5066.  
  5067.  
  5068.  
  5069.  
  5070.  
  5071.  
  5072.  
  5073.                                       - 81 -
  5074.       PalmScan v2.02                                             User guide
  5075.       ---------------------------------------------------------------------
  5076.  
  5077.       3.14 Old files
  5078.       ---------------
  5079.  
  5080.       PalmScan can check for files which are too old. Either the maximum
  5081.       age in days or a date can be used for this check.
  5082.       The date that will be checked can also be selected. Original means
  5083.       PalmScan will check the original date of the archive. Oldest means
  5084.       PalmScan will check the oldest date of all files in the archive.
  5085.       Latest means PalmScan will check the latest date of all files in the
  5086.       archive.
  5087.       PalmScan will check for old files right after embedded archives have
  5088.       been processed. When an old file has been encountered, it will be
  5089.       moved to the directory configured as old files directory. When no old
  5090.       files directory is configured, PalmScan will exit with errorlevel
  5091.       204. When a message area is configured, a message to the system
  5092.       operator will also be posted.
  5093.  
  5094.       Example   :    01-01-1995
  5095.  
  5096.       Keyword   :    OldFiles [[-days]|[dd-mm-yyyy]]
  5097.                      <Original|Latest|Oldest>
  5098.  
  5099.            [-days]        The maximum age of a file, in days.
  5100.  
  5101.            [dd-mm-yyy]    The oldest allowed date of a file, in
  5102.                           date-month-year format.
  5103.  
  5104.            <Original>     PalmScan will use the original archive's date.
  5105.  
  5106.            <Latest>       Use the latest date of the files inside the
  5107.                           archive.
  5108.  
  5109.            <Oldest>       Use the oldest date of the files inside the
  5110.                           archive.
  5111.  
  5112.            Example   :    OldFiles -90 Latest
  5113.  
  5114.  
  5115.  
  5116.  
  5117.  
  5118.  
  5119.  
  5120.  
  5121.  
  5122.  
  5123.  
  5124.  
  5125.  
  5126.  
  5127.  
  5128.  
  5129.  
  5130.  
  5131.  
  5132.  
  5133.  
  5134.  
  5135.  
  5136.                                       - 82 -
  5137.       PalmScan v2.02                                             User guide
  5138.       ---------------------------------------------------------------------
  5139.  
  5140.       3.15 Include Configurations
  5141.       ----------------------------
  5142.  
  5143.       In this list, configuration files which should be included in the
  5144.       configuration, can be configured. PSetup will not read the included
  5145.       configuration files (else those would be combined to one
  5146.       configuration file when saving it).
  5147.       PalmScan will read included configuration files before reading the
  5148.       entries in the original configuration file, thus options in the
  5149.       original configuration file can override options in included
  5150.       configuration files.
  5151.  
  5152.       Example   :    C:\PALMSCAN\ARCHIVER.CFG
  5153.  
  5154.       Keyword   :    Include [configuration-filename]
  5155.  
  5156.            [configuration-filename] This is the full path and filename of
  5157.                                     the configuration file to be included.
  5158.  
  5159.            Example   :    Include C:\PALMSCAN\ARCHIVER.CFG
  5160.  
  5161.  
  5162.  
  5163.  
  5164.  
  5165.  
  5166.  
  5167.  
  5168.  
  5169.  
  5170.  
  5171.  
  5172.  
  5173.  
  5174.  
  5175.  
  5176.  
  5177.  
  5178.  
  5179.  
  5180.  
  5181.  
  5182.  
  5183.  
  5184.  
  5185.  
  5186.  
  5187.  
  5188.  
  5189.  
  5190.  
  5191.  
  5192.  
  5193.  
  5194.  
  5195.  
  5196.  
  5197.  
  5198.  
  5199.                                       - 83 -
  5200.       PalmScan v2.02                                             User guide
  5201.       ---------------------------------------------------------------------
  5202.  
  5203.       4  Registration
  5204.       ---------------
  5205.  
  5206.       After you have evaluated PalmScan for the period of one month, you
  5207.       must either register or discontinue using PalmScan. PalmScan is
  5208.       released as 'try before you buy', so please buy it if you like it.
  5209.  
  5210.       As long as you don't register, PalmScan will remind you that you have
  5211.       not registered when PalmScan is started up.
  5212.  
  5213.       To register, fill out the registration form and send it to the
  5214.       registration site.
  5215.  
  5216.       For information about prices and registration sites, see the
  5217.       registration forms included in this package.
  5218.  
  5219.  
  5220.  
  5221.  
  5222.  
  5223.  
  5224.  
  5225.  
  5226.  
  5227.  
  5228.  
  5229.  
  5230.  
  5231.  
  5232.  
  5233.  
  5234.  
  5235.  
  5236.  
  5237.  
  5238.  
  5239.  
  5240.  
  5241.  
  5242.  
  5243.  
  5244.  
  5245.  
  5246.  
  5247.  
  5248.  
  5249.  
  5250.  
  5251.  
  5252.  
  5253.  
  5254.  
  5255.  
  5256.  
  5257.  
  5258.  
  5259.  
  5260.  
  5261.  
  5262.                                       - 84 -
  5263.       PalmScan v2.02                                             User guide
  5264.       ---------------------------------------------------------------------
  5265.  
  5266.       5  Credits
  5267.       ----------
  5268.  
  5269.       Thanks to all registered users and beta testers, for registering and
  5270.       testing this software, and for all suggestions I got from you.
  5271.  
  5272.       All brand and product names are copyrighted (C) by and/or trademarks
  5273.       (TM) or registered trademarks (R) of their respective holders:
  5274.  
  5275.       4DOS                          JP Software Inc.
  5276.       Allfix                        Harald Harms
  5277.       ARJ                           Robert K. Jung
  5278.       AVScan                        H+BEDV Datentechnik GmbH
  5279.       CJPEG, DJPEG                  Thomas G. Lane
  5280.       Concord                       Pasi Talliniemi
  5281.       Ezycom                        Peter Davies
  5282.       F-Prot                        Frisk Software International
  5283.       Fido                          Tom Jennings and Fido Software
  5284.       FileDoor                      Robert W. van Hoeven
  5285.       GIF                           CompuServe Incorporated
  5286.       GIF2JPG, JPG2GIF              Handmade Software, Inc.
  5287.       GIFblast                      Isaac Dimitrovsky
  5288.       GIFtest                       Max Bernard and Dave Navarro, Jr.
  5289.       HAP, PAH                      Harald Feldmann
  5290.       Hudson messagebase            Adam Hudson
  5291.       Hyper                         P. Sawatzki and K.P. Nischke
  5292.       IBM, OS/2, PC-DOS             International Business Machines Corp.
  5293.       JAM                           Joaquim Homrighausen, Andrew Milner,
  5294.                                     Mats Birch, Mats Wallin
  5295.       LHA                           Haruyasu Yoskizaki
  5296.       Microsoft, MS-DOS             Microsoft Corporation
  5297.       PAK                           NoGate Consulting
  5298.       PKARC, PKZIP                  PKWARE, Inc.
  5299.       ProBoard                      Philippe Leybaert
  5300.       QuickBBS                      Pegasus Software
  5301.       RAFT                          Chris Buijs
  5302.       RAR                           Eugene Roshal
  5303.       RemoteAccess                  Wantree Development and Andrew Milner
  5304.       SQZ                           J.I. Hammarsberg
  5305.       SuperBBS                      Aki Antman and Risto Virkkala
  5306.       TBScan                        Thunderbyte BV
  5307.       UltraCompressor II, UC2       Ad Infinitum Programs
  5308.       ViruScan                      McAfee Associates
  5309.       ZOO                           Rahul Dhesi
  5310.  
  5311.  
  5312.  
  5313.  
  5314.  
  5315.  
  5316.  
  5317.  
  5318.  
  5319.  
  5320.  
  5321.  
  5322.  
  5323.  
  5324.  
  5325.                                       - 85 -
  5326.       PalmScan v2.02                                             User guide
  5327.       ---------------------------------------------------------------------
  5328.  
  5329.       I  Index
  5330.       --------
  5331.  
  5332.       /All  . . . . . .   19              . . .  55  RegKey  . . . . .   27
  5333.       /AnyArea  . . . .   19  FilesBBS  . . . .  40  RemoveFilesList .  34,
  5334.       /C[configuration-file   FilesBBSname  . .  42                      74
  5335.                 name] .   20  GIFBLASTrepack  .  80  Scanner . . . . .   70
  5336.       /Debug  . . . . .   23  GIFBLASTunpack  .  79  ScanSFX . . . . .   53
  5337.       /D[dorinfo-filename]    GIFpack . . . . .  78  SkipFilesList . .  33,
  5338.                   . . .   20  GIFspecs  . . . .  77                      72
  5339.       /FDBmaint<areanr<-are   GIFtest . . . . .  81  SubstDrive  . . .   32
  5340.                 anr>> .   19  HackList  . .  33, 72  SysopName . . . .   27
  5341.       /Fix<+> . . . . .   20  HackPath  . . . .  31  TempPath  . . . .   30
  5342.       /Interactive  . .   23  Header  . . . . .  62  Test  . . . . . .   63
  5343.       /L  . . . . . . .   20  Include . . . . .  83  Touch . . . . . .   47
  5344.       /Mono . . . . . .   23  IndentSpaces  . .  41  UC2protection . .   66
  5345.       /Move[Path] . . .   22  InfectedPath  . .  30  UC2SealTest . . .   53
  5346.       /NoChanges  . . .   21  JFIFrepack  . . .  80  UC2SFX  . . . . .   52
  5347.       /NoCls  . . . . .   23  JFIFunpack  . . .  79  Unpack  . . . . .   61
  5348.       /NoConversion . .   21  JPEGrepack  . . .  80  VirusScan . . . .   67
  5349.       /NoFDB  . . . . .   21  JPEGunpack  . . .  79
  5350.       /NoFilesbbs . . .   21  LogFile . . . . .  43
  5351.       /NoMove . . . . .   22  MessageArea . . .  37
  5352.       /NoScan . . . . .   22  MinimumResolution
  5353.       /N[node]  . . . .   20              . . .  81
  5354.       /P[priority]  . .   23  MVpack  . . . . .  63
  5355.       /S  . . . . . . .   22  MVunpack  . . . .  64
  5356.       /T[archiver]  . .   21  NetAddress  . . .  35
  5357.       /Unlisted . . . .   22  NoDiskSpaceCheck
  5358.       /V[Size]  . . . .   22              . . .  44
  5359.       AddCRCfile  . . .   75  NoDOSscanners . .  71
  5360.       AddFilesList  . .  34,  NoTitleInHdr  . .  55
  5361.                           75  OldFiles  . . . .  82
  5362.       AnsiHeader  . . .   54  OldPath . . . . .  31
  5363.       ArchInArch  . . .   46  Online  . . . . .  42
  5364.       ArchiveConversion       OnlyNewFiles  . .  45
  5365.                   . . .   50  OS2header . . . .  62
  5366.       ArchiveHeader . .   54  OS2key  . . . . .  27
  5367.       Archiver  . . . .   60  OS2MVpack . . . .  63
  5368.       BadGifPath  . . .   31  OS2MVunpack . . .  64
  5369.       BadPath . . . . .   30  OS2pack . . . . .  61
  5370.       BBSname . . . . .   27  OS2RARlock  . . .  66
  5371.       BBSpath . . . . .   39  OS2test . . . . .  63
  5372.       ColorBackground .   29  OS2unpack . . . .  61
  5373.       ColorEdit . . . .   29  Pack  . . . . . .  61
  5374.       ColorEditBackground     PackUnpackedFilesList
  5375.                   . . .   29              . . .  73
  5376.       ColorHighlight  .   28  PackUnpackedList
  5377.       ColorNormal . . .   28              . . .  33
  5378.       CompleteScan  . .   71  PackUnpackedSize
  5379.       ConvertAll  . . .   50              . . .  73
  5380.       DescribeMod . . .   59  PasswordList  . . 34,
  5381.       DownloadCounter .   41                     76
  5382.       ExecTimeOut . . .   44  ProcessListedOnly
  5383.       FastScan  . . . .   71              . . .  46
  5384.       FDB . . . . . . .   38  ProcessSFX  . . .  51
  5385.       FileID  . . . . .   58  RARlock . . . . .  66
  5386.       FileIDarchiveHdr        RedirectOutput  .  28
  5387.  
  5388.                                       - 86 -