home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / WIZ13D.ZIP / WIZARD.DOC < prev    next >
Text File  |  1994-09-15  |  91KB  |  2,625 lines

  1.      File Wizard 1.3                                                    Page 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.                         A Bulletin Board File Area Manager
  30.   
  31.   
  32.   
  33.                             (c) 1994 by Oliver Weindl
  34.   
  35.   
  36.   
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.   ────────────────────────────────────────────────────────────────────────────
  62.                           (c) 1993,94 by Oliver Weindl                        
  63.  
  64.  
  65.      File Wizard 1.3                                                    Page 2
  66.   ════════════════════════════════════════════════════════════════════════════
  67.  
  68.   
  69.    1.1. Some words before ... PLEASE READ CAREFULLY !!
  70.   
  71.   Please read this part carefully. There are some important hints 
  72.   for using File Wizard.
  73.   
  74.   File Wizard was born with the idea to help the SysOps of a mail
  75.   box to make the daily maintenance of the files as easy as possible.
  76.   Most of the functions seem not be very visible, but after a short 
  77.   period of training, this shouldn't be any problem.
  78.   You normally used different tools to manage your filebase, like
  79.   a tool to creat the daily filelist, something to sort the areas,
  80.   another one to move/copy files, .... etc.
  81.   File Wizard completes all these different functions in ONE packet.
  82.   This way you only need one configuartion file to handle all the
  83.   daily maintenance in one run.
  84.   
  85.   Known bugs :
  86.   
  87.   * Keyboards / special keys
  88.   This was found during the beta tests. There are some systems with 
  89.   different keydrivers, that show problems in using combination of
  90.   keystrokes like CTRL-Y, CTRL-Z, and CTRL-C. If you find something
  91.   not working, you can change your keys by calling Wizard with the
  92.   parameter /K. Then you have the possibilty to change the keys to
  93.   your needs.
  94.   
  95.   * Packer ARJ
  96.   Since the change to version 2.4x of this famous packer, there are
  97.   some changes in structures, which are not included with this version
  98.   of File Wizard. Special files like those packed with the security
  99.   envelope may result in an error. But we're working on it.
  100.   
  101.   Since version 1.3 this problems should be solved, but nevertheless...
  102.   
  103.   
  104.    1.2. Licensing Information
  105.   
  106.   
  107.   File Wizard is distributed as "Shareware", i.e. you may copy
  108.   and distribute this archive as often as you like, as long as
  109.   you don't change its contents and as long as you don't charge
  110.   any money for it!
  111.   However, "Shareware" is definitely not the same as "Public Domain"!
  112.   After a trial period of 30 days, in which you can use File Wizard
  113.   as often as you like, you _must_ register this programme, if you
  114.   you continue to use it. For details please refer to the enclosed
  115.   text file REGFORM.DOC. There are also some other regforms enclose
  116.   e.g. one for creditcards etc. Please take a look at the distribution
  117.   package ("DIR REGFORM.*").
  118.   
  119.   File Wizard is no Cripple-Ware, that means there are neither handicaped
  120.   functions, nor any delay times at the normal runtime. So you can test
  121.   the program for 30 days without any restrictions.
  122.   
  123.   
  124.  
  125.   ────────────────────────────────────────────────────────────────────────────
  126.                           (c) 1993,94 by Oliver Weindl                        
  127.  
  128.  
  129.      File Wizard 1.3                                                    Page 3
  130.   ════════════════════════════════════════════════════════════════════════════
  131.  
  132.    1.3. Disclaimer
  133.   
  134.   If you use FileWizard, you do this at your own risk!!!
  135.   
  136.   The only guarantee I can give is, that File Wizard will occupy a certain
  137.   amount of space on your hard disk and that File Wizard - when run - will
  138.   also need a certain amount of RAM!
  139.   
  140.   I am in no case to be made responsible for any loss of data or any
  141.   other trouble, problems, damages etc. that might occcur when you run
  142.   File Wizard!
  143.   
  144.   
  145.    1.4. Memory Management
  146.   
  147.   For optimizing memory requirements, please refer to the DPMI.DOC file
  148.   in this distribution packet.
  149.   If you're not familiar with DPMI memory management, i advise you NOT
  150.   to change the default setting !
  151.   
  152.    1.5. Changes to previous versions
  153.   
  154.   All changes to previous versions are documented in the file HISTORY.TXT.
  155.   
  156.    1.6. What you need
  157.   
  158.   File Wizard is designed to use DMPI (DOS-Protected-Mode-Interface). Due
  159.   to that fact, Wizard is able to use the whole RAM and the all above
  160.   memory, which is available as XMS. To run this mode you need a PC with
  161.   a 286/386 processor and 1,2 MB free XMS memory. A special version for
  162.   a XT or a pc with only 1 MB RAM isn't available.
  163.   
  164.   
  165.    2. What does File Wizard do?
  166.   
  167.   File Wizard is a file area manager for several BBS programmes. In this
  168.   current version 1.0 the following programmes are supported:
  169.   
  170.      * SuperBBS
  171.      * WME (Beta mit FILES.BBS)
  172.      * RemoteAccess 1.11
  173.      * RemoteAccess 2.0x (Filebase)
  174.      * RemoteAccess 2.0x (FILES.BBS)
  175.      * LoraBBS
  176.      * ProBoard
  177.      * QuickBBS
  178.      * Maximus
  179.      * FLSEARCH.CTL mit FILES.BBS
  180.      * FLSEARCH.BBS mit FILES.BBS
  181.      * FILECFG.PRO mit FILES.BBS
  182.      * FILES.RA
  183.   
  184.   
  185.   Features:   - interactive file area editor, capable of one-step-editing
  186.                 and copying, using standard editor commands
  187.               - user-definable key-combinations for all functions
  188.  
  189.   ────────────────────────────────────────────────────────────────────────────
  190.                           (c) 1993,94 by Oliver Weindl                        
  191.  
  192.  
  193.      File Wizard 1.3                                                    Page 4
  194.   ════════════════════════════════════════════════════════════════════════════
  195.  
  196.               - different colours to accentuate different information
  197.                 (missing files, file descriptions, etc.)
  198.               - command-specific online help
  199.               - support of file descriptions longer than one line
  200.               - copy/move files from one area to another
  201.               - access upload directory by just one keystroke
  202.               - import of file descriptions using other BBS's file lists
  203.                 or the decriptions contained in archives
  204.               - built-in macro recorder to load/save frequently used
  205.                 commands
  206.               - evaluation of archives/pictures directly from within the
  207.                 editor
  208.               - decompression and testing of archives by just one keystroke
  209.               - insert information about GIFs or MODs with just one
  210.                 keystroke
  211.               - sort file list (or part of it) from within the editor
  212.               - include missing files into the file list
  213.               - mark "dupe" files
  214.               - search functions (e.g. search/search again)
  215.               - 8 user-definable external programmes can be started from
  216.                 within the editor by a simple keystroke (e.g. MTA.EXE)
  217.               - up to 50 different extensions are recognized and can be
  218.                 assigned to different programmes
  219.               - renaming of files
  220.               - "touching" of files
  221.               - missing files are displayed in another color and can be
  222.                 deleted with a simple keystroke
  223.               - creation of file list/newfiles list
  224.               - automatic sorting of file areas (multi-line descriptions
  225.                 are supported), in each area any number of sub-areas can be
  226.                 established, which are given special attention when sorting
  227.               - insert file headers above each file area (optional)
  228.               - adjusting of multiline descriptions to make the download
  229.                 counter more visible
  230.               - ex- and import of files from any path
  231.               - tag and pack files from your disk to an archive
  232.               - add temporary fileareas inside of File Wizard
  233.               - tag files with date
  234.               - create "old file" lists, which helps to delete old files
  235.               - create own area headers
  236.               - add request information to each area
  237.               - create newfiles list with real date
  238.               - update the request paths of your mailer. At the moment it
  239.                 runs with D'Bridge, FrontDoor, InterMail and Binkley
  240.               - create TOP files and area statistics files (ANS/ASC)
  241.               - maintenance of new files independ of the file date
  242.               - announce of new files via .PKT
  243.               - formats long descriptions
  244.               - group maintenance to create easy selections
  245.               - runs with different LOG files to make different lists
  246.               - dupechecker for your fileareas
  247.               - variable filelist creation
  248.               - archive-conversion
  249.   
  250.   
  251.   
  252.  
  253.   ────────────────────────────────────────────────────────────────────────────
  254.                           (c) 1993,94 by Oliver Weindl                        
  255.  
  256.  
  257.      File Wizard 1.3                                                    Page 5
  258.   ════════════════════════════════════════════════════════════════════════════
  259.  
  260.    3. Configuration file WIZARD.CTL
  261.   
  262.   
  263.   This config file is pure ASCII and can be edited using the editor
  264.   of your choice. Lines starting with a % (per cent) are comment lines
  265.   and will be ignored by File Wzard. There is a file called WIZ_CTL.ENG
  266.   in the distribution package,which contains a WIZARD.CTL file in the
  267.   english language.
  268.   
  269.   
  270.   - FileListPath <path+filename>
  271.   
  272.   
  273.        Name of subdirectory where you keep uncompressed file lists of other
  274.        BBS's. When looking for file descriptions only lists found in this
  275.        path will be searched.
  276.        To obtain the best results, these lists should be structured as
  277.        follows:
  278.   
  279.   FILENAME.EXT <size> <date>   description (first line)
  280.                                description (second line)
  281.                                .
  282.                                .
  283.                                .
  284.   
  285.        Multi-line descriptions are exported correctly by File Wizard and
  286.        will later be inserted into your file list.
  287.   
  288.        e.g.
  289.        FileListPath C:\LISTEN\*.*
  290.        FileListPath D:\FIDOLIST\*.LST
  291.        etc...
  292.   
  293.   - German_Help_File
  294.   
  295.        This option brings up the online help in German.
  296.   
  297.   
  298.   - Select_Description
  299.   
  300.        File Wizard is capable of looking for the description of a single
  301.        file, as well as for the descriptions of a number of previously
  302.        marked files. You can - after the search has been carried out - make
  303.        your choice among the found descriptions. If you want to do this,
  304.        then this command should be enabled.
  305.   
  306.   - BBSTYPE definition
  307.   
  308.        As File Wizard needs to know what kind of BBS programme you use, it
  309.        is necessary to choose the correct type.
  310.        Possible choices:
  311.   
  312.        BBSTYPE SBBS
  313.        BBSTYPE WME
  314.        BBSTYPE RA
  315.        BBSTYPE RA200
  316.  
  317.   ────────────────────────────────────────────────────────────────────────────
  318.                           (c) 1993,94 by Oliver Weindl                        
  319.  
  320.  
  321.      File Wizard 1.3                                                    Page 6
  322.   ════════════════════════════════════════════════════════════════════════════
  323.  
  324.        BBSTYPE RA200TXT
  325.        BBSTYPE MAXIMUS
  326.        BBSTYPE GENERIC
  327.        BBSTYPE PROBOARD
  328.        BBSTYPE LORABBS
  329.        BBSTYPE QBBS
  330.   
  331.        To set one a BBSTYPE inactive, please just put a percent character (%)
  332.        before the type.
  333.   
  334.        The new filebase of SuperBBS 1.18 is in development.
  335.        I don't know the future development of SBBS, so don't rely
  336.        on this future extension !
  337.   
  338.   
  339.   - BBSTYPE GENERIC <path+name>
  340.   
  341.        If you chose GENERIC for your BBS programme, this parameter is
  342.        necessary to tell File Wizard where to find FLSEARCH.CTL.
  343.        This file is structured as follows:
  344.   
  345.        <path> <security level> <decription_with_undercores>
  346.   
  347.        Example:
  348.   
  349.        C:\BBS\AREA1 5  Name_of_first_area
  350.        C:\BBS\AREA2 10 Name_of_second_area
  351.   
  352.        When using this FLSEARCH.CTL file, all your file areas must contain
  353.        a FILES.BBS in the standard FILES.BBS format.
  354.   
  355.        File Wizard supports additionally a filename at the pathdescription.
  356.        e.g.
  357.   
  358.        C:\BBS\AREA1\FILES.BBS 5  Name_of_first_area
  359.        C:\BBS\AREA2\FILES.DES 10 Name_of_second_area
  360.   
  361.        This filename (if you use one) must have an extension. If no
  362.        Filename is specified, File Wizard will assume FILES.BBS .
  363.   
  364.   
  365.   - BBSTYPE SBBS <path+name>
  366.   
  367.        Path and name of FLSEARCH.BBS for SuperBBS.
  368.        For more information about this: RTFM, please....  (;->
  369.   
  370.   
  371.   - BBSTYPE WME <path+name>
  372.   
  373.        File Wizard supports the new version of WME (Windowed Modem
  374.        Environment) with FILES.BBS alike description files.
  375.        At <path+name> you have to specify the first .WME cataloge
  376.        file in your BBS-config.
  377.   
  378.   
  379.   - BBSTYPE RA <path+name>
  380.  
  381.   ────────────────────────────────────────────────────────────────────────────
  382.                           (c) 1993,94 by Oliver Weindl                        
  383.  
  384.  
  385.      File Wizard 1.3                                                    Page 7
  386.   ════════════════════════════════════════════════════════════════════════════
  387.  
  388.   
  389.        Specifys path and filename for RA 1.11
  390.   
  391.        e.g. BBSTYPE RA J:\RA\FILES.RA
  392.   
  393.   
  394.   - BBSTYPE RA200 <path+name>
  395.   
  396.        Specifys path and filename for RA 2.0x
  397.   
  398.        e.g. BBSTYPE RA200 J:\RA\FILES.RA
  399.   
  400.        There is an additional
  401.        parameter needed, which is described later on.
  402.   
  403.   
  404.   - BBSTYPE QBBS <path>
  405.   
  406.        Defines bbstype Quickbbs.
  407.   
  408.        <path> ONLY points to path of QuickBBS.
  409.   
  410.   
  411.   - BBSTYPE PROBOARD <path+name>
  412.   
  413.        <path+name> specifys path and filename for ProBoard are configuration,
  414.   
  415.   - BBSTYPE LORABBS <path>
  416.   
  417.        <path> Points to the directory of LoraBBS
  418.   
  419.   
  420.   - LORA_PATH_PREFIX <path>
  421.   
  422.        This one shows, which character will be put before the area paths
  423.        only for LoraBBS.
  424.   
  425.   
  426.   - RA200_FILEBASE       D:\RA\FILEBASE
  427.   
  428.        This command points to the filebase of RA 2.00
  429.   
  430.   
  431.   - BBSTYPE FREETYPE <path+filename> <BBS-name>
  432.   
  433.        This option allowes you to use any BBS-software, which uses
  434.        FILES.BBS alike file descriptions.
  435.   
  436.        <path+filename> specifies the BBS filearea configuration file
  437.   
  438.        <BBS-name>      name of the BBS package (e.g. MYBBS)
  439.   
  440.        If File Wizard should read this areakonfiguration, you must tell
  441.        File Wizard the structure of this file. You need to know:
  442.   
  443.        - Structure of the areaconfig file (usually included in every
  444.  
  445.   ────────────────────────────────────────────────────────────────────────────
  446.                           (c) 1993,94 by Oliver Weindl                        
  447.  
  448.  
  449.      File Wizard 1.3                                                    Page 8
  450.   ════════════════════════════════════════════════════════════════════════════
  451.  
  452.          BBS dirstribution package)
  453.        - How to calculate the structure for byte-positions.
  454.   
  455.   
  456.        Also you HAVE TO INCLUDE following commands in the WIZARD.CTL file:
  457.   
  458.   
  459.        FreeBlockSize <value>
  460.   
  461.        size of a single structure in the file.
  462.   
  463.   
  464.        FreeTypePath  <Pos> <Len> <P or C>  // Path to the filearea
  465.        FreeTypeDesc  <Pos> <Len> <P or C>  // Description of the filearea
  466.        FreeTypeList  <Pos> <Len> <P or C>  // Name+path of the FILES.BBS file
  467.        FreeTypeSec   <Pos>                 // Security of this filearea
  468.   
  469.        <Pos>    is a value between 1 and FreeBlockSize
  470.        <Len>    tells File Wizard how many bytes a certain variable
  471.                 uses in the structure
  472.        <P or C> tells File Wizard wether it is an so called "Pascal
  473.                 String" = "P" or an zero-terminated string = "C"
  474.   
  475.        I want to explain you the use of this statements with a small
  476.        example. This structure is used by SuperBBS:
  477.   
  478.   =========================================================================
  479.     FLSearchRec  = Record                               (* FLSEARCH.BBS *)
  480.                      Name:               String [60];
  481.                      Directory:          String [79];
  482.                      Security:           Integer;
  483.                      Flags:              Flagtype;
  484.                      PFilesSec:          Integer;   { Not yet used }
  485.                      PFlags:             Flagtype;  { Not yet used }
  486.                      Attrib:             Byte;
  487.                      Age:                Byte;
  488.                      ListName:           String [67];
  489.                      ExtraSpace:         Array [1..30] Of Byte;
  490.                    End;
  491.   =========================================================================
  492.   
  493.   Now you have to calculate the byte-positions for each variable:
  494.   
  495.   
  496.   Name:String[60]      starts at position 1, and has a length of
  497.                        61 bytes (60 chars + 1 length-char because
  498.                        it's Pascal)
  499.   
  500.   Directory:String[79] starts at position 62, and has a length of 80 bytes
  501.   
  502.   Security:Integer     starts at position 142 (62+80) and has a length of
  503.                        2 bytes (Integer/Word = 2 Bytes)
  504.   
  505.   So you can define following parameters:
  506.   
  507.   FreeTypeDesc 1   60 P
  508.  
  509.   ────────────────────────────────────────────────────────────────────────────
  510.                           (c) 1993,94 by Oliver Weindl                        
  511.  
  512.  
  513.      File Wizard 1.3                                                    Page 9
  514.   ════════════════════════════════════════════════════════════════════════════
  515.  
  516.   FreeTypePath 62  80 P
  517.   FreeTypeSec  142
  518.   
  519.   You see, it's quite difficult to define an own structuretype to include
  520.   some rare used BBS softwares. If you're not familiar with programming,
  521.   please contact some of your friends to help you with this problem.
  522.   
  523.   
  524.   - Real_Areas
  525.   
  526.        This allowes you to display the unused areas of RA 1.11
  527.        or ProBoard.
  528.   
  529.   
  530.   - MULTILINESTRING " >"
  531.     MULTILINESTRING " +"
  532.     MULTILINESTRING " |"
  533.   
  534.   
  535.        In order to handle multi-line descriptions correctly, File Wizard
  536.        needs to know the characters such descriptions starts with. If you
  537.        use SuperBBS, these characters consist of a <space> followed by a
  538.        <bigger than>, as it is shown above. In order not to "lose" any
  539.        spaces, these characters should to be put into quotation marks.
  540.        There 10 differentdefinitions possible, but the first should be
  541.        the standard definition of your mail box.
  542.   
  543.   
  544.   
  545.   -DEFAULT_GROUP 0
  546.   
  547.        To which group a new area should be added automatically. Each area
  548.        HAS TO BE connect to one at least one group, cause it won't be
  549.        shown in any filelist.
  550.   
  551.        To work with different groups, you should create different CTL-files,
  552.        for example
  553.   
  554.        GROUP 1 ALLFILES.CTL
  555.        GROUP 2 SORT1.CTL
  556.        GROUP 3 SORT2.CTL
  557.        GROUP 4 WINNET.CTL
  558.   
  559.        *** ATTENTION ***
  560.   
  561.        Please never name a CTL file "WIZARD.CTL", cause your original 
  562.        would be overwritten.
  563.   
  564.   - Ask_When_Delete
  565.   
  566.        To prevent from deleting marked files, you can add this parameter,
  567.        so Wizard will ask before deleting.
  568.   
  569.   - Own_Cursor
  570.   
  571.        In some configuartion we've found that there are problems with
  572.  
  573.   ────────────────────────────────────────────────────────────────────────────
  574.                           (c) 1993,94 by Oliver Weindl                        
  575.  
  576.  
  577.      File Wizard 1.3                                                   Page 10
  578.   ════════════════════════════════════════════════════════════════════════════
  579.  
  580.        the cursur. If you have one too, please set this parameter active.
  581.        We've found those espacially in systems running with DeskView.
  582.   
  583.   
  584.   - HIGHLIGHT_MISSING
  585.   
  586.        If you want File Wizard to mark missing files by showing them in
  587.        a different colour, this switch must be used.
  588.        If you do so, however, this will result in a considerable loss of
  589.        speed as the checking of all the files will take quite a lot of time.
  590.   
  591.   - Search_AB
  592.   
  593.        When File Wizard searches for available drives, you can enable
  594.        the search for floppydrives with the above command. Please consider
  595.        that the search of the floppydevices takes a long time !
  596.   
  597.   
  598.   - Directory_Search_String <Wildcard>
  599.   
  600.        Whenever File Wizard scans the structure of a drive you can
  601.        speed up this search by setting above "wildcard" to "*.".
  602.        If you have directories _with_ extension i.e. SUBDIR.DIR,
  603.        you have to set the wildcard to "*.*"
  604.   
  605.   
  606.   - Make_BAK_Files
  607.   
  608.        Should File Wizard create BackupFiles from your arealist files?
  609.   
  610.   
  611.   - Min_Free 1000
  612.   
  613.        How much space should be left on the target drive before moving
  614.        files.
  615.   
  616.        
  617.   - Explode_Delay 10
  618.   
  619.        This command determines the time you will have to wait for the
  620.        "exploding" windows to complete. The smaller you set this value,
  621.        the shorter it takes to complete the screens. As this totally
  622.        depends on your personal taste, this value was kept user-definable.
  623.   
  624.   
  625.   - Ex-Import_Path  C:\
  626.   
  627.        This parameter tells Wizard on which path exports and imports are
  628.        called from.
  629.   
  630.   
  631.   - DEFAULTAREAPATH E:\AREA\AREA2\
  632.   
  633.        This should default to a subdirectory which is often looked into,
  634.        e.g. the path where user uploads are stored.
  635.        By defining this path, you will later be able to access this
  636.  
  637.   ────────────────────────────────────────────────────────────────────────────
  638.                           (c) 1993,94 by Oliver Weindl                        
  639.  
  640.  
  641.      File Wizard 1.3                                                   Page 11
  642.   ════════════════════════════════════════════════════════════════════════════
  643.  
  644.        subdirectory by pressing a single key in the ditor.
  645.   
  646.   
  647.   - MACRO_ALT-F?
  648.   
  649.        This parameter is used to define macros for key combinations
  650.        <ALT-F1> to <ALT-F4>.
  651.        These macros are saved as "filename" (without path and extension,
  652.        the extension .MAC will be added automatically by File Wizard).
  653.        File Wizard will create a subdirectory called MACROS in its own
  654.        directory, where all these macros are stored.
  655.   
  656.        Examples:
  657.   
  658.        Macro_ALT-F1 MACRO1
  659.        Macro_ALT-F2 MACRO2
  660.        Macro_ALT-F3 MACRO3
  661.        Macro_ALT-F4 MACRO4
  662.        Macro_ALT-F5 MACRO5
  663.        Macro_ALT-F6 MACRO6
  664.        Macro_ALT-F7 MACRO7
  665.        Macro_ALT-F8 MACRO8
  666.   
  667.   
  668.   - External_List C:\UTILITY\LIST.COM
  669.   
  670.        Path and name of your favourite ASCCI/Binary list programme which
  671.        will be used to view texts etc., when in the editor.
  672.   
  673.   
  674.   - ???Packer <path+name> [switches] [macros]
  675.   
  676.        In order to enable File Wizard's decompression features you have
  677.        to insert the complete path, name and extension of your packing
  678.        programme here!
  679.        The macros listed below can be used to pass certain information
  680.        to this compression programme:
  681.   
  682.        Macros:
  683.   
  684.        ~@   path and file name where all the tagged files are to be found
  685.        ~D   path and filename of the file at cursor position
  686.        ~V   path to current file area
  687.        ~F   path and name of current FILES.BBS (GENERIC & SBBS only)
  688.        ~B   description of current file
  689.        ~E   target directory
  690.        ~A   files to be extracted from archive
  691.        ~X   path and name of archive
  692.   
  693.        Example:
  694.   
  695.        ARJPacker K:\DB\PACKER\ARJ.EXE e -y ~X ~E ~A
  696.   
  697.        will be expanded to the following commandline:
  698.   
  699.                                                   ~X            ~E     ~A
  700.  
  701.   ────────────────────────────────────────────────────────────────────────────
  702.                           (c) 1993,94 by Oliver Weindl                        
  703.  
  704.  
  705.      File Wizard 1.3                                                   Page 12
  706.   ════════════════════════════════════════════════════════════════════════════
  707.  
  708.                                            /---------------\ /-----\ /-----\
  709.        ARJPacker K:\DB\PACKER\ARJ.EXE e -y C:\AREA1\TEST.ARJ C:\TEMP READ.ME
  710.   
  711.   
  712.   - PackCommand <Packername> [switches] [macros]
  713.   
  714.        Inside File Wizard you can tag files from your harddisks an
  715.        copy this files into a new archive. Above command defines
  716.        the syntax for your prefered packer.
  717.   
  718.        Following macros are allowed:
  719.   
  720.        ~D Path and Filename of the destinationarchive
  721.        ~E Path of the files to pack
  722.   
  723.   - PackDriveA / PackDriveB <switches>
  724.   
  725.        File Wizard can pack whole disks into an archive and add
  726.        this file to the actual filearea.
  727.   
  728.        There is only one macro available for this function, ~N.
  729.        ~N specifies the path and name of the destination archive.
  730.   
  731.        e.g.
  732.        PackDriveA PKZIP.EXE ~D -ex -rp -$A a:\*.*
  733.        PackDriveB PKZIP.EXE ~D -ex -rp ~N -$B ~N B:\*.*
  734.   
  735.   
  736.   - PackerExtension <extension>
  737.   
  738.        According to the defined PackCommand, define the extension
  739.        which your packer will produce.
  740.   
  741.   
  742.   - GuessArchiveName
  743.   
  744.        If this switch is defined, File Wizard will try tu guess the
  745.        Name of the destination archive.
  746.   
  747.   
  748.   - DefaultPackPath <path>
  749.   
  750.        In which directory File Wizard should start, when "Tag and Pack"
  751.        is selected ?
  752.   
  753.   
  754.   - CTRL-F? <path+name> [Switches] [Macros]
  755.   
  756.        Up to 8 external programmes can be called from File Wizard to
  757.        help maintaining the archives in file areas.
  758.        In order to pass necessary information to these programmes, there
  759.        are also a number of macros which can be used.
  760.   
  761.        Macros:
  762.   
  763.        ~@   path and file name where all the tagged files are to be found
  764.  
  765.   ────────────────────────────────────────────────────────────────────────────
  766.                           (c) 1993,94 by Oliver Weindl                        
  767.  
  768.  
  769.      File Wizard 1.3                                                   Page 13
  770.   ════════════════════════════════════════════════════════════════════════════
  771.  
  772.        ~D   path and filename of the file at cursor position
  773.        ~V   path to current file area
  774.        ~F   path and name of current FILES.BBS (GENERIC & SBBS only)
  775.        ~B   description of current file
  776.   
  777.        Example:
  778.   
  779.        CTRL-F1 J:\MTA\MTA.EXE /@~@ /LVL0 /ZIP
  780.   
  781.        will be expanded to the following commandline:
  782.   
  783.                                         ~@
  784.                                /------------------\
  785.        CTRL-F1 J:\MTA\MTA.EXE /@C:\WIZARD\WIZARD.FLS /LVL0 /ZIP
  786.   
  787.   
  788.   - External_View <extension> <path+name> [Switches] [Macros]
  789.   
  790.        File Wizard can automatically connect up to 50 different extensions
  791.        to certain external viewing or listing programmes. These external
  792.        programmes must be defined here with there complete path, file name
  793.        and extension.
  794.        These External_View parameters do indeed have a high priority! If e.g.
  795.        you insert the extension ARJ here, an external programme (e.g.
  796.        ArcMaster) will be called instead of File Wizard's built-in archive
  797.        management functions.
  798.   
  799.        Macros:
  800.   
  801.        ~@   path and file name where all the tagged files are to be found
  802.        ~D   path and filename of the file at cursor position
  803.        ~V   path to current file area
  804.        ~F   path and name of current FILES.BBS (GENERIC & SBBS only)
  805.        ~B   description of current file
  806.   
  807.        Examples:
  808.   
  809.        External_View GIF C:\UTILITY\VPIC.EXE ~D /a
  810.        External_View BMP C:\UTILITY\VPIC.EXE ~D /a
  811.        External_View PCX C:\UTILITY\VPIC.EXE ~D /a
  812.   
  813.   
  814.   - Tag_Whole_Description
  815.   
  816.        This command is used to determine if, when tagging a file, a multi-
  817.        line description should automatically be tagged, too (i.e. if it
  818.        exists). When you have descriptions that are longer than just a
  819.        single line, this can save a lot of work.
  820.   
  821.   
  822.   - Dos-Shell_Area
  823.   
  824.        This command tells File Wizard which subdirectory to default to, when
  825.        jumping into a DOS shell. If this command is not active, you will
  826.        find yourself in the directory where File Wizard resides when jumping
  827.        into DOS.
  828.  
  829.   ────────────────────────────────────────────────────────────────────────────
  830.                           (c) 1993,94 by Oliver Weindl                        
  831.  
  832.  
  833.      File Wizard 1.3                                                   Page 14
  834.   ════════════════════════════════════════════════════════════════════════════
  835.  
  836.   
  837.   
  838.   - FREEDIR <path>
  839.   
  840.        One of File Wizard's options allows you to decompress the current
  841.        archive into a certain subdirectory in order to test it. This
  842.        subdirectory is determined using this command.
  843.        For best results this should point to a RAM disk.
  844.        Attention: _ALL_ files in this subdirectory will automatically be
  845.        deleted when you return to File Wizard!
  846.   
  847.   
  848.   - FileDesc <filename>
  849.   
  850.        In many archives a text file can be found, that contains the
  851.        description of the programme in this archive. File Wizard can extract
  852.        this text file and insert the description into the file list of
  853.        this file area. File Wizard can manage up to 20 different names
  854.        of those file description text files.
  855.   
  856.        Common names of these text files are:
  857.   
  858.        FileDesc FILE_ID.DIZ
  859.        FileDesc DESCRIPT.ION
  860.        FileDesc DESC.SDI
  861.        FileDesc FILEID.DIZ
  862.   
  863.   
  864.   - DC_LeftBracket  <character>
  865.   
  866.        When using download counters, this switch tells File Wizard the
  867.        character that is used for the beginning of the download counter.
  868.        In most cases this will be a "[".
  869.   
  870.   
  871.   - DC_RightBracket <character>
  872.   
  873.        Character used at the end of download counters.
  874.        In most cases this will be a "]".
  875.   
  876.   
  877.   Following parameters are needed if you want to create a filelist of
  878.   your "old" files.
  879.   
  880.   - OldStuffDate <Date>
  881.   
  882.        Here you define the date for old stuff. If you define i.e 01.01.90,
  883.        all files older than that date will be added to the list.
  884.   
  885.   - OldStuffGroups <Group>
  886.   
  887.        Here you define the groups which should be searched for old files.
  888.   
  889.   - OldStuffCount <Counter>
  890.   
  891.        With this parameter you define the highest count of a file. Only
  892.  
  893.   ────────────────────────────────────────────────────────────────────────────
  894.                           (c) 1993,94 by Oliver Weindl                        
  895.  
  896.  
  897.      File Wizard 1.3                                                   Page 15
  898.   ════════════════════════════════════════════════════════════════════════════
  899.  
  900.        files below that count are added to the list. This only works, if
  901.        you work with download counters.
  902.   
  903.   
  904.   - SubAreaString "<string>"
  905.   
  906.        File Wizard can manage file areas containing multiple sub areas.
  907.        The beginning of a new sub area is determined by one of lines in
  908.        the text that starts with the <string> defined above.
  909.        You can have as many sub areas as you like. When sorting the file
  910.        areas (from the main menue, or via command line swith /ASORT) these
  911.        sub areas are taken into account, and the alphabetical sorting will
  912.        only be done in each sub area and will not make a mess out of the
  913.        whole file area!
  914.   
  915.        An example for sub areas in a FILES.BBS, using the SubAreaString " -"
  916.   
  917.   === FILES.BBS === Area DFUE-Utilities
  918.   
  919.    - Terminal programmes
  920.   
  921.   TELIX.ARJ    Terminal programme
  922.   TELEMATE.ARJ Terminal programme
  923.   
  924.    - External protocols
  925.   
  926.   DSZ.ARJ      External X/Y/Z Modem protocol
  927.   GSZ.ARJ      External X/Y/Z Modem protocol with graphics
  928.   
  929.    - BBS programmes
  930.   
  931.   SBBS.ARJ     SuperBBS
  932.   WME.ARJ      Windowed Modem Environment
  933.   
  934.   
  935.   =================
  936.   
  937.        This sub area option does allow you to keep your file areas tidy,
  938.        functional and clear.
  939.   
  940.   
  941.   - Make_Area_Header
  942.   
  943.        If you want File Wizard to insert a header above the selected file
  944.        area when sorting, this command must be used. The contents of this
  945.        header can be changed in file WIZARD.HDR (registered versions only).
  946.        More information about area headers can be found later in this manual.
  947.   
  948.   
  949.   - Header_Left_Margin <value>
  950.   
  951.        Determines the left margin where you want the header to start.
  952.        Minimum: 1.
  953.        When using WME as a BBS programme, this value _MUST_ be set to at
  954.        least 13!
  955.   
  956.  
  957.   ────────────────────────────────────────────────────────────────────────────
  958.                           (c) 1993,94 by Oliver Weindl                        
  959.  
  960.  
  961.      File Wizard 1.3                                                   Page 16
  962.   ════════════════════════════════════════════════════════════════════════════
  963.  
  964.   
  965.   - Header_Size <value>
  966.   
  967.        Determines the number of characters per line in the header.
  968.        Depending on the information in the header, this should be set to
  969.        a value from 40 to 78!
  970.   
  971.   
  972.   - TOUCH_FILES_BBS
  973.   
  974.        In SuperBBS there is an option to limit the search in the
  975.        fileareas (in NEWFILES scan) only to this areas, which contain
  976.        a FILES.BBS with a newer date. With the above option,
  977.        File Wizard will touch the date of a FILES.BBS with the newest
  978.        file in the filearea. This works only when sorting the fileareas !
  979.   
  980.   
  981.   
  982.   - ALLFILES <path+name>
  983.   
  984.        Defines the subdirectory where you want File Wizard to create and
  985.        store your allfiles list.
  986.   
  987.        Example:
  988.   
  989.        ALLFILES E:\BP\BIN\WIZARD\ALLFILES.TXT
  990.   
  991.   - NEWFILES <path+name>
  992.   
  993.        Defines the subdirectory where you want File Wizard to create and
  994.        store your newfiles list.
  995.   
  996.        Example:
  997.   
  998.        NEWFILES E:\BP\BIN\WIZARD\NEWFILES.TXT
  999.   
  1000.   
  1001.   - DESCFILE <filename>
  1002.   
  1003.        Whenever File Wizard encounters a file with the name defined above
  1004.        in one of your file areas, the contents of this file (which must be
  1005.        a simple text file!) will be inserted in front of this file area in
  1006.        your allfiles list, before the file descriptions.
  1007.        E.g. this option can be useful when you have file areas where only
  1008.        password protected file requests are possible: in such a case the
  1009.        text inside this FILES.INF (see example below) should be:
  1010.                 "Only password protected file requests"
  1011.   
  1012.        Example:
  1013.   
  1014.        DESCFILE FILES.INF
  1015.   
  1016.   
  1017.   - NewFiles_Age <value>
  1018.   
  1019.        Defines how old (or better: new) a file must be to appear in your
  1020.  
  1021.   ────────────────────────────────────────────────────────────────────────────
  1022.                           (c) 1993,94 by Oliver Weindl                        
  1023.  
  1024.  
  1025.      File Wizard 1.3                                                   Page 17
  1026.   ════════════════════════════════════════════════════════════════════════════
  1027.  
  1028.        newfiles list.
  1029.        A common value would be 30 (days).
  1030.   
  1031.        Example:
  1032.   
  1033.        NewFiles_Age 30
  1034.   
  1035.   - List_Leading_Space <value>
  1036.   
  1037.        If your ALL/NEWFILES contain a downloadcounter, you can wrap the
  1038.        long descriptions (multiline descriptions) to the right, in order
  1039.        to make your filelist more attractiv.
  1040.   
  1041.        i.e. if your downloadcounter looks like this [00], then set the
  1042.             value to 5, so all long descriptions will be wraped 5 chars to
  1043.             the left.
  1044.   
  1045.        output:  FILENAME.EXT  34753  01.01.1993 [00] Very useless program
  1046.                                                      which does really nothing
  1047.   
  1048.   
  1049.   - FileListHeader <path+filename>
  1050.   
  1051.        Path and name of a text file that will be inserted at the beginning
  1052.        of your allfiles list (in most cases your logo or something similar
  1053.        to that).
  1054.   
  1055.   
  1056.   - Skip_Area_Header
  1057.   
  1058.        If you add an area header (you'll find examples in the file HEADERS.ZIP)
  1059.        you can force File Wizard to skip that header in the file lists.
  1060.        So, if you set MAKE_AREA_HEADER aktive, this switch should be aktive 
  1061.        too.
  1062.   
  1063.   
  1064.   - Minimum_Security <value>
  1065.   
  1066.        If you want certain file areas to be excluded from your file lists,
  1067.        you should use these parameters. Only those file areas will appear
  1068.        in your lists, which have a security level between the Minimum_Security
  1069.        and the Maximum_Security level.
  1070.   
  1071.   
  1072.   - Maximum_Security <value>
  1073.   
  1074.        Please refer to Minimum_Security
  1075.   
  1076.        Example:
  1077.   
  1078.        Minimum_Security 0
  1079.        Maximum_Security 100
  1080.   
  1081.        File areas with a security level of 101 or above will not appear in
  1082.        your file lists.
  1083.   
  1084.  
  1085.   ────────────────────────────────────────────────────────────────────────────
  1086.                           (c) 1993,94 by Oliver Weindl                        
  1087.  
  1088.  
  1089.      File Wizard 1.3                                                   Page 18
  1090.   ════════════════════════════════════════════════════════════════════════════
  1091.  
  1092.   
  1093.   - List_Group <Groups>
  1094.   
  1095.        Here you define, which areas should be shown in the filelists.
  1096.   
  1097.   
  1098.   - Make_Top_Downloaded_Files
  1099.   
  1100.        When this switch is active, a list of your most frequently downloaded
  1101.        files will be added to the end of your allfiles list.
  1102.        This - of course! - will only work if you have and use download
  1103.        counters in your file areas ....
  1104.   
  1105.   
  1106.   - Top_List <path + name>
  1107.   
  1108.        If you set this switch active, File Wizard an ANSI/ASCII file with
  1109.        the most downloaded files. IMPORTANT : This only works, if you set
  1110.        Make_Top_Downloaded_Files aktive too. Dont't add any extenstions!!
  1111.   
  1112.   
  1113.   - Area_Statistic <path + name>
  1114.   
  1115.        Same as above but creates an area statistic file, which will be add
  1116.        at the end of your lists.
  1117.   
  1118.   
  1119.   And now we reach a brandnew part of File Wizard. This is the possibility
  1120.   with mailer, request- and announce functions. You need following para-
  1121.   meter to work with.
  1122.   
  1123.   - MailerType <Mailer>
  1124.   
  1125.        This one defines the mailer type, you're using. At the moment 
  1126.        following mailer are supported.
  1127.   
  1128.        MailerType D'Bridge
  1129.        MailerType Frontdoor
  1130.        MailerType InterMail
  1131.        MailerType Binkley
  1132.   
  1133.   
  1134.   - Requestpath <Password> <Path>
  1135.   
  1136.        This switch defines the pathes you want to secure with a password.
  1137.        If you're using Binkley, the first parameter is always the pass-
  1138.        word. If you're using Frontdoor, this could be SECLIST so the path
  1139.        will be added in your SECLIST.CTL
  1140.   
  1141.        This parameter is also used by File Wizard to add the request 
  1142.        information in the top of each area. The texts which are used are
  1143.        REQUEST.TXT and NOREQ.TXT and are freely definable.
  1144.   
  1145.        Examples:
  1146.   
  1147.        RequestPath GEHEIM D:\DATA\FIDO_NOD
  1148.  
  1149.   ────────────────────────────────────────────────────────────────────────────
  1150.                           (c) 1993,94 by Oliver Weindl                        
  1151.  
  1152.  
  1153.      File Wizard 1.3                                                   Page 19
  1154.   ════════════════════════════════════════════════════════════════════════════
  1155.  
  1156.        RequestPath GEHEIM D:\DATA\VIR_NODE
  1157.        RequestPath <NONE> J:\FREEFILES
  1158.   
  1159.   
  1160.   - Magic <Magic name> <path + name> <optional password>
  1161.   
  1162.        Here you define the Magics for the file requests. You may also use
  1163.        wildcards. If you start the path definition with a !, File Wizard
  1164.        will change the path to the newest filedate.
  1165.   
  1166.        Examples:
  1167.   
  1168.        Magic WIZARD J:\MAIL\WIZARD\WIZ*.*
  1169.        Magic VPIC   J:\MAIL\GRAFIK\VPIC*.* Grafik
  1170.   
  1171.        If you're usinig the ! :
  1172.   
  1173.        Magic NODEDIFF !K:\NODEDIFF\NODEDIFF.*
  1174.   
  1175.        This will cause File Wizard to search the newest file, which fits
  1176.        to the search string K:\NODEDIFF\NODEDIFF.* and also changes the
  1177.        magic path.
  1178.   
  1179.   
  1180.   - FDOKFILE  C:\FD\FDOKLIST.LST <Groups> for unsecured sessions
  1181.   - SECLIST   C:\FD\SECLIST.LST <Groups> for secured sessions
  1182.   - ALIASFILE C:\FD\ALIASFIL.LST  for the magics file
  1183.   
  1184.        These files are needed for Frontdoor. They are pure ASCII files,
  1185.        which contains the request paths. With groups you can define
  1186.        which groups should be listed.
  1187.   
  1188.   
  1189.   - OKFile  E:\BINKLEY\OKFILE.TXT <Groups>
  1190.   
  1191.        If you're using Binkley you define with this paramter the file
  1192.        which contains the request paths and the magics. The second
  1193.        parameter defines the groups which should be added.
  1194.   
  1195.   
  1196.   - OKFile_Header E:\BINKLEY\OKHEADER.TXT
  1197.   
  1198.        The contents of this file will be put at the beginning of the
  1199.        Binkley OK file. This is normally used to insert static request
  1200.        paths and magics in the OK file.
  1201.   
  1202.   
  1203.   - RequestGroup <Password> <Groups>
  1204.   
  1205.        You can add a password to a whole group, i.e. :
  1206.   
  1207.        RequestGroup Geheim 137F
  1208.   
  1209.        All files which belongs to one of the the groups 1,3,7 and F, will
  1210.        recive the request password GEHEIM.
  1211.   
  1212.  
  1213.   ────────────────────────────────────────────────────────────────────────────
  1214.                           (c) 1993,94 by Oliver Weindl                        
  1215.  
  1216.  
  1217.      File Wizard 1.3                                                   Page 20
  1218.   ════════════════════════════════════════════════════════════════════════════
  1219.  
  1220.   
  1221.   - TrueNewFile <path + filename>
  1222.   
  1223.        Using this switch, you'll be able to create a newfile list which
  1224.        do not count with the date, you can add a name. Please do not add
  1225.        any extension. This file be created with the command line parameter
  1226.        /FBUPDATE.
  1227.   
  1228.   
  1229.   - True_List_Group
  1230.   
  1231.        Here you define the groups which should belog to the above definition.
  1232.   
  1233.   
  1234.   Now here are the definitions you to announce new files via echo mail.
  1235.   
  1236.   
  1237.   - FromName <Your name>
  1238.   
  1239.        The name which will be written in the announce message.
  1240.   
  1241.   
  1242.   - ToName <name>
  1243.   
  1244.        To whom the message will be written.
  1245.   
  1246.   
  1247.   - Subject <text>
  1248.   
  1249.        The header of the message i.e. New Files available!!
  1250.   
  1251.   
  1252.   - PKT_Path <path>
  1253.   
  1254.        Where you want the .PKT files to be written in. Normally the
  1255.        mailer inbound path.
  1256.   
  1257.   
  1258.   -Toss_Semaphore <path + name>
  1259.   
  1260.        Here you name the file, which causes a rescan of your tosser.
  1261.        This semaphore will be set after an announcement.
  1262.   
  1263.   
  1264.   - EchoTag <echo name> <AKA adress> <origin>
  1265.   
  1266.        At this point you're allowed to name up to 100 echo areas, to
  1267.        which the mail will be written.
  1268.   
  1269.        Examples :
  1270.   
  1271.        EchoTag REQUEST.GER 2:246/45 New files at PI
  1272.        EchoTag PI.POINT    2:246/45 New files via File Wizard
  1273.   
  1274.   
  1275.   - Announce <Echo name> <AKA adress> <origin>
  1276.  
  1277.   ────────────────────────────────────────────────────────────────────────────
  1278.                           (c) 1993,94 by Oliver Weindl                        
  1279.  
  1280.  
  1281.      File Wizard 1.3                                                   Page 21
  1282.   ════════════════════════════════════════════════════════════════════════════
  1283.  
  1284.   
  1285.        If you like to announce new files (see also /FBUPDATE) in a mail
  1286.        echo, you have to define here the echos.
  1287.   
  1288.        Examples :
  1289.   
  1290.        Announce BAD-ECHO 2:246/45    New files at PI
  1291.        Announce PI.POINT 2:246/45    New files at PI via File Wizard
  1292.   
  1293.   
  1294.   
  1295.   - Always_Reformat_Description
  1296.   
  1297.        This statement aktivates a switch in File Wizard, which
  1298.        reformats the descriptions of your fileareas to column 14.
  1299.        Please do not use the command, if you have ASCII-logos
  1300.        in your filedescriptions.
  1301.   
  1302.   - Add_Download_Counter
  1303.   
  1304.        When you are running AreaSort, File Wizard can add and/or
  1305.        reformat existing Donwloadcounters in your filedescription files.
  1306.   
  1307.   
  1308.   - Counter_Style <number> <Y or N>
  1309.   
  1310.        Here you define the design of your download counter.
  1311.        <number> specifies the number of numeric letters a counter can have
  1312.        <Y or N> should File Wizard add leading zeros to the number above
  1313.   
  1314.   - MaxDupeDifference <size in kB>
  1315.   
  1316.        File Wizard can search your fileareas for dupe files. Dupechecking
  1317.        will be done for filenames , excluding the extension. You can define
  1318.        a maxmimum dupe difference size to exclude files from the dupelist,
  1319.        greater then the specified value.
  1320.   
  1321.        e.g. MaxDupeDifference 16
  1322.   
  1323.        DATEI1.ARJ  200kB
  1324.        DATEI1.ZIP  187kB  found as dupe
  1325.   
  1326.        DATEI2.ARJ  150kB
  1327.        DATEI2.LZH  133kB  no dupes
  1328.   
  1329.   
  1330.   - MaxPKTSize <Größe in kB>
  1331.   
  1332.        The maximum .PKT size your tosser can process.
  1333.   
  1334.   
  1335.   - DuperReportTo <aka> <Ziel> <Name>
  1336.   
  1337.        To whom you would like to send a dupereport via netmail.
  1338.   
  1339.        e.g.
  1340.  
  1341.   ────────────────────────────────────────────────────────────────────────────
  1342.                           (c) 1993,94 by Oliver Weindl                        
  1343.  
  1344.  
  1345.      File Wizard 1.3                                                   Page 22
  1346.   ════════════════════════════════════════════════════════════════════════════
  1347.  
  1348.        DupeReportTo 2:2494/17 2:2494/17   Oliver Weindl
  1349.        DupeReportTo 2:2494/17 2:2494/17.1 Johann Weinzierl
  1350.   
  1351.   - NoDupePattern <Dateiangabe>
  1352.   
  1353.        Exclude which files/paths/trees from dupechecking. You can use
  1354.        wildcards, with/without paths. If you place a /S at the end of the
  1355.        line, all subdirectories will also ignored for dupecheck.
  1356.   
  1357.        NoDupePattern e:\area\area1\*.*
  1358.        NoDupePattern wiz*.*
  1359.   
  1360.   
  1361.   - Adopt_Missing_Files
  1362.   
  1363.        File Wizard can add missing files to your fileareas when running
  1364.        Areasort. This option is quite powerfull. Wizard will add the
  1365.        files, and will serach for descritpions inside the archives
  1366.        (valid filenames for description files are described above).
  1367.        If no description file is found, the Default_Description line
  1368.        will be used.
  1369.   
  1370.   - Default_Description <description>
  1371.   
  1372.        (see above)
  1373.   
  1374.   - AdoptReportTo <aka> <destination> <name>
  1375.   
  1376.        This command is used post a report of all adopted files to
  1377.        the specified person. This report will be sent via netmail
  1378.        (a .PKT file will be created in your inbound directory).
  1379.   
  1380.        e.g.
  1381.        AdoptReportTo 2:2494/17 2:2494/17   Oliver Weindl
  1382.        AdoptReportTo 2:2494/17 2:2494/17.1 Johann Weinzierl
  1383.   
  1384.   - NoAdoptPattern <spec> </S>
  1385.   
  1386.        In order to exclude certain files or directories or trees
  1387.        out of the AdoptMissingFile function, you can specify a filename
  1388.        (with wildcards) or a complete path (don't forget the wildcard *.*)
  1389.        to exclude this files. If you add a /S at the end of the line
  1390.        ALL SUBDIRECTORIES will be excluded by AdoptMissingFile !
  1391.   
  1392.        e.g.
  1393.        NoAdoptPattern E:\AREAS\AREA1\*.*
  1394.        NoAdoptPattern DESCRIPT.ION
  1395.        NoAdoptPattern J:\CDROM\*.* /S
  1396.   
  1397.   - Wrap_Space <number>
  1398.   
  1399.        Specifiy the column to which a WrapLine will be executed.
  1400.   
  1401.        e.g.
  1402.        Wrap_Space 56
  1403.   
  1404.  
  1405.   ────────────────────────────────────────────────────────────────────────────
  1406.                           (c) 1993,94 by Oliver Weindl                        
  1407.  
  1408.  
  1409.      File Wizard 1.3                                                   Page 23
  1410.   ════════════════════════════════════════════════════════════════════════════
  1411.  
  1412.        All words, which will overlap column 56 will be pushed
  1413.        to the next line.
  1414.   
  1415.   
  1416.   - FileList_NoKeyInfo
  1417.   
  1418.        Registered Users are capable of hiding the KEY-info at
  1419.        the bottom of filelists.
  1420.   
  1421.   
  1422.   - UpDate4DOS
  1423.   
  1424.        If you activate this switch, File Wizard will always
  1425.        save a DESCRIPT.ION file to the actual filearea, when
  1426.        saving a filearea.
  1427.   
  1428.   - CDROMStylePaths <Path> [/S]
  1429.   
  1430.        This parameter defines the paths, where special cdrom style
  1431.        files.bbs files reside. This special form of files.bbs files
  1432.        is only supported by ProBoard (May '94). The format is following:
  1433.   
  1434.   
  1435.        FILENAME.EXT <Bytes> <Date>  Description
  1436.         +description
  1437.         +description
  1438.   
  1439.        File Wizard deletes this additional informations when reading
  1440.        the files.bbs file, and will add this values when saving it
  1441.        back to disk. So you always have aktual values in your area
  1442.        files !
  1443.   
  1444.        With the command /S a complete directory tree will be selected.
  1445.   
  1446.        Important: You have to define the path, where the files.bbs
  1447.                   files reside, not the archives themselves !
  1448.   
  1449.   - GenerateTimeSlices
  1450.   
  1451.        If you are running File Wizard in multitasking environment,
  1452.        you can activate timeslicing with this switch. Only multitasker
  1453.        which support INT 2F timeslicing are supported !
  1454.   
  1455.        Windows (NT), OS/2, DesqView etc...
  1456.   
  1457.   
  1458.   - Temporary_Filebase <path>
  1459.   
  1460.        When creating filelists with the /@FLIST.CMD option, File Wizard
  1461.        creates a temporary filebase in order to achieve higher performance.
  1462.        If you are working in a LAN environment you can point the directory
  1463.        to a faster medium e.g. local harddisk or (if it is big enough)
  1464.        a ram-disk.
  1465.   
  1466.   
  1467.   - Translate <drive [+path]> <drive [+path]>
  1468.  
  1469.   ────────────────────────────────────────────────────────────────────────────
  1470.                           (c) 1993,94 by Oliver Weindl                        
  1471.  
  1472.  
  1473.      File Wizard 1.3                                                   Page 24
  1474.   ════════════════════════════════════════════════════════════════════════════
  1475.  
  1476.   
  1477.        If you are running in a LAN environment, it could happen
  1478.        that some drives are changed. With the translate commando
  1479.        you can change this drive letters (and paths!) to other
  1480.        drive letters (or paths).
  1481.   
  1482.   
  1483.        e.g. the area-paths of you bbs are configured as :
  1484.   
  1485.        J:\MAIL\AREA1
  1486.        J:\MAIL\AREA2    etc...
  1487.   
  1488.        and File Wizard only can access this areas under
  1489.   
  1490.        K:\MAILBOX\MAIL\AREA1
  1491.        K:\MAILBOX\MAIL\AREA2
  1492.   
  1493.        With "Translate J: K:\MAILBOX" you can tell File Wizard to
  1494.        change all area-paths beginning with "J:..." to "K:\MAILBOX...".
  1495.        File Wizard can handle up to 20 different translation commands.
  1496.   
  1497.   - ???UnPacker <Pfad+Name> [switches] [macros]
  1498.   
  1499.        To use the built in archive conversion routines, you have to specify
  1500.        a valid extractcommand for each packer. Please notice to add
  1501.        all switches, so that directories in an archive will be extracted too !
  1502.   
  1503.        Macros:
  1504.   
  1505.        ~@   path and file name where all the tagged files are to be found
  1506.        ~D   path and filename of the file at cursor position
  1507.        ~V   path to current file area
  1508.        ~F   path and name of current FILES.BBS (GENERIC & SBBS only)
  1509.        ~B   description of current file
  1510.        ~E   target directory
  1511.        ~A   files to be extracted from archive
  1512.        ~X   path and name of archive
  1513.   
  1514.        Example:
  1515.   
  1516.        ARJUnPacker K:\DB\PACKER\ARJ.EXE x -y ~X ~E ~A
  1517.   
  1518.        will be expanded to the following commandline:
  1519.   
  1520.                                                   ~X            ~E     ~A
  1521.                                              /---------------\ /-----\ /-----\
  1522.        ARJUnPacker K:\DB\PACKER\ARJ.EXE x -y C:\AREA1\TEST.ARJ C:\TEMP READ.ME
  1523.   
  1524.   - VirusScan <path+name> [switches,macros]
  1525.   
  1526.        The extratec files of an archive can be checked with up to 10
  1527.        different virus-scanner.
  1528.   
  1529.        Macro ~P stands for the path, where the files are placed.
  1530.   
  1531.        e.g.
  1532.  
  1533.   ────────────────────────────────────────────────────────────────────────────
  1534.                           (c) 1993,94 by Oliver Weindl                        
  1535.  
  1536.  
  1537.      File Wizard 1.3                                                   Page 25
  1538.   ════════════════════════════════════════════════════════════════════════════
  1539.  
  1540.   
  1541.        VirusScan J:\MTA\SCAN.EXE ~P /NOMEM /NOPAUSE /E
  1542.   
  1543.   - UnwantedFile <filespec>
  1544.   
  1545.        If you don't want to have advertisments of other BBS's in
  1546.        your archives, you can tell File Wizard to delete this
  1547.        files before creating the new archive.
  1548.   
  1549.        e.g.
  1550.        UnwantedFile WORKSHOP.*
  1551.        UnwantedFile JonDoe.*
  1552.        etc...
  1553.   
  1554.   - AddFile <filename>
  1555.   
  1556.     Specify a filename which should be added to the new archive.
  1557.   
  1558.     e.g.
  1559.     AddFile       J:\WIZARD\LOOKME.COM
  1560.   
  1561.   - FAttachMsgDir <path>
  1562.   
  1563.     It often happens, that a file is combined with a netmail, a so called
  1564.     fileattach. In order to keep this fileattach up2date, File Wizard will
  1565.     look for such netmails and change them to the new archive-type.
  1566.     TIC files which are produced by severel TIC echo managers will also
  1567.     be updated automatically, when they are placed in the same directory
  1568.     as the archive.
  1569.   
  1570.     e.g.
  1571.     FAttachMsgDir K:\FD\NETMAIL
  1572.   
  1573.   - ConvertToPacker <path+name, switches, macros>
  1574.   
  1575.     This defines the commandline, which is used by File Wizard to add
  1576.     the extracted and scanned files to the new archive. DOS-pipes etc.
  1577.     are also supported, so if you want to have an archive header in
  1578.     the new archive, you have to do this in this commandline.
  1579.   
  1580.     e.g.
  1581.     ConvertToPacker     K:\DB\PACKER\PKZIP.EXE -a -ex -z
  1582.                              ~X ~A < J:\WIZARD\ZIPHDR.TXT
  1583.   
  1584.                         (please write this in _one_ line,
  1585.                          i just haven't the place for it ;-)
  1586.   
  1587.   
  1588.   - PackerExtension <Extension>
  1589.   
  1590.     Which extension will the used packer produce. For the above example
  1591.     it would be ZIP:
  1592.   
  1593.     PackerExtension ZIP
  1594.   
  1595.   - AddFileID <filename>
  1596.  
  1597.   ────────────────────────────────────────────────────────────────────────────
  1598.                           (c) 1993,94 by Oliver Weindl                        
  1599.  
  1600.  
  1601.      File Wizard 1.3                                                   Page 26
  1602.   ════════════════════════════════════════════════════════════════════════════
  1603.  
  1604.   
  1605.     If there is no descriptionfile in the archive (see "FileDesc"), then
  1606.     you can tell File Wizard to create such a file in the new archive.
  1607.     The description is taken out of the actual filearea description file.
  1608.   
  1609.     Please notice: File Wizard doesn't know, wether there is a valid
  1610.                    description of this archive in your filearea. It could
  1611.                    happen, that he adds a "New file added ..." as
  1612.                    descriptionfile !
  1613.   
  1614.     e.g.
  1615.   
  1616.     AddFileID FILE_ID.DIZ
  1617.   
  1618.   
  1619.   - ScreenSaver <time in seconds>
  1620.   
  1621.     This is the time File Wizard willw ait before activating the screen-
  1622.     saver in edit-mode. If you specify 0 seconds, the screensave will be
  1623.     disabled.
  1624.   
  1625.     e.g.
  1626.     ScreenSaver 300
  1627.   
  1628.     Attention: The screensave is a VGA-mode routine, so if you are
  1629.                running e.g. a multitasking environment, don't
  1630.                activate the screensaver, it could produce trouble.
  1631.   
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.   ────────────────────────────────────────────────────────────────────────────
  1662.                           (c) 1993,94 by Oliver Weindl                        
  1663.  
  1664.  
  1665.      File Wizard 1.3                                                   Page 27
  1666.   ════════════════════════════════════════════════════════════════════════════
  1667.  
  1668.   
  1669.   4. Menue choices
  1670.   
  1671.   4.1. Main menue
  1672.   
  1673.   4 different menues are available from the main menue:
  1674.   
  1675.   - File Area Maintenance
  1676.   
  1677.        self explaining, at least I hope so!
  1678.   
  1679.   - Make Filelists
  1680.   
  1681.        Your allfiles and newfiles list will be created. This option can
  1682.        also be triggered via command line switches, which means that these
  1683.        files can be created when you call File Wizard from a batch file.
  1684.   
  1685.        Example: WIZARD /FLIST
  1686.   
  1687.        optional parameters :
  1688.   
  1689.           /C<filename>   switch to another areadefinition in
  1690.                          FLSEARCH.CTL style
  1691.           /A<filename>   path and name of your ALLFILES-list
  1692.           /N<filename>   path and name of your NEWFILES-list
  1693.           /MINSEC<value> minimum security level
  1694.           /MAXSEC<value> maximum security level
  1695.   
  1696.        if you miss one of the above switches, the defaults from the
  1697.        WIZARD.CTL file will be used.
  1698.   
  1699.        You also can use a command file for this operation:
  1700.   
  1701.        WIZARD /FLIST /@<filename>
  1702.   
  1703.        the structure of this command file :
  1704.   
  1705.   
  1706.        <name of .CTL file> <switches> <switches> <switches> ...
  1707.   
  1708.        The name of a .CTL file is the path and filename for a FLSEARCH.CTL
  1709.        style area control file (see BBSTYPE GENERIC in WIZARD.CTL)
  1710.        You also can use <DEFAULT> for the bbs configuration defined
  1711.        in WIZARD.CTL. This first statement in the line MUST exist !
  1712.   
  1713.        Following switches
  1714.        are supported:     /A<filename>  name of the allfiles-list
  1715.                           /N<filename>  name of the newfileslist
  1716.                                         (use /N alone for no newfiles-list!)
  1717.                           /MINSEC<sec>  minimum security
  1718.                           /MAXSEC<sec>  maximum security
  1719.                           /G<groups>    groups which should appear in the list
  1720.                           /H<filename>  name of an alternate headerfile
  1721.                           /CHECKDUPE    run the dupechecker for the specified
  1722.                                         list
  1723.   
  1724.  
  1725.   ────────────────────────────────────────────────────────────────────────────
  1726.                           (c) 1993,94 by Oliver Weindl                        
  1727.  
  1728.  
  1729.      File Wizard 1.3                                                   Page 28
  1730.   ════════════════════════════════════════════════════════════════════════════
  1731.  
  1732.        Example :
  1733.   
  1734.        <DEFAULT> /Ac:\allfiles.fls /N /MINSEC200 /G04AB /Hc:\header.txt
  1735.   
  1736.   
  1737.   - Sort Fileareas
  1738.   
  1739.        Your file areas will be sorted (available from batch files, too).
  1740.   
  1741.        Example: WIZARD /ASORT
  1742.   
  1743.        Multi-line descriptions and sub areas are taken care of, as decribed
  1744.        previously.
  1745.   
  1746.   - FileBase Init
  1747.   
  1748.        Same function as /FBINIT
  1749.   
  1750.   - FileBase Update
  1751.   
  1752.        Same function as /FBUPDATE
  1753.   
  1754.   - Create OldStuff
  1755.   
  1756.        Same function as /OLDLIST
  1757.   
  1758.   - Delete OldStuff
  1759.   
  1760.        Same function as /DELETEOLDSTUFF
  1761.   
  1762.   - Perform KeepLatest
  1763.   
  1764.        Same function as /KEEPLATEST
  1765.   
  1766.   - Write FILES.BBS
  1767.   
  1768.        This function is only accessable for RA 2.0x user. Here
  1769.        you can create a FILES.BBS file for each filearea in the
  1770.        RA filebase. The FILES.BBS file will be placed in the
  1771.        archive directory of each filearea.
  1772.   
  1773.   
  1774.   4.1.2 The area selection
  1775.   
  1776.        Here you find the file areas of your BBS configuartion. Use your
  1777.        cursor keys to move around. By using ENTER, you'll jump into
  1778.        edit mode and you're able to edit the current FILES.BBS.
  1779.        File Wizard has implemented a quich search function. So if you
  1780.        know the file area number, you an just type it and Wizard jumps
  1781.        to the selected area or you can enter a singel character. The number
  1782.        or the characters you typed, will be diplayed at the bottom of the
  1783.        screen. If you specified a DEFAULTPATH, you can can jump with F9
  1784.        directly to that area. That's normally your new files path. You
  1785.        find help with F1.
  1786.   
  1787.   
  1788.  
  1789.   ────────────────────────────────────────────────────────────────────────────
  1790.                           (c) 1993,94 by Oliver Weindl                        
  1791.  
  1792.  
  1793.      File Wizard 1.3                                                   Page 29
  1794.   ════════════════════════════════════════════════════════════════════════════
  1795.  
  1796.   4.2  Command line parameters
  1797.   
  1798.        In normal cases you will run File Wizard in batch mode too. To do
  1799.        that, there are different paramaters available.
  1800.   
  1801.   
  1802.   4.2.1  Alternate Area-Config  /C <filename>
  1803.   
  1804.        Using this parameter you can change from your normally used WIZARD.CTL
  1805.        to another, which should be GENERIC alike. This one has the same
  1806.        structure of a FLSEARCH.CTL
  1807.   
  1808.        <path> <security> <description_with_underscores>
  1809.   
  1810.        C:\DOS    5   This_is_my_DOS_area
  1811.        J:\GAMES 10   This_is_my_games_area
  1812.   
  1813.   
  1814.   4.2.2 Groups   /G<groups>
  1815.   
  1816.        There is at least one group for each file area. Possible groups are
  1817.        0 1 2 3 4 5 6 7 8 9 A B C D E F. If you like to do special things
  1818.        you're able to use a selection via groups. With this parameter you
  1819.        can override the defined groups in WIZARD.CTL.
  1820.   
  1821.        Groups in File Wizard are treated like the Flags in common
  1822.        BBS softwares. If you define e.g. group 8 to all areas which
  1823.        are related to "Gaming etc.", you can activate all functions
  1824.        of File Wizard especially for all "Gaming Areas" by assigning
  1825.        the function to group 8.
  1826.   
  1827.        Examples
  1828.   
  1829.        WIZARD /ASORT /G13A (only groups of 1, 3 and A will be sorted)
  1830.        WIZARD /FLIST /G1 (creates a list of all areas which belong to the
  1831.                           group 1)
  1832.   
  1833.   
  1834.   4.2.3 Creating file lists   /FLIST
  1835.   
  1836.        The parameter find in the main menue is also available in command
  1837.        line mode. There are some additional switches, to override the
  1838.        WIZARD.CTL.
  1839.   
  1840.        Optional switches:
  1841.   
  1842.        /C<file name>  use another area description (see 4.2.1)
  1843.        /A<file name>  name of the Allfile list
  1844.        /N<file name>  name of the Newfile list
  1845.        /MINSEC<value> Minimum security level
  1846.        /MAXSEC<value> Maximum security level
  1847.        /H<file name>  name of an alternate filelist header
  1848.        /DAY<number>   how olld may a file be (in days) to appear
  1849.                       in the newfileslist
  1850.   
  1851.        If you do not enter one of the above switches, File Wizard will use
  1852.  
  1853.   ────────────────────────────────────────────────────────────────────────────
  1854.                           (c) 1993,94 by Oliver Weindl                        
  1855.  
  1856.  
  1857.      File Wizard 1.3                                                   Page 30
  1858.   ════════════════════════════════════════════════════════════════════════════
  1859.  
  1860.        those you entered in your WIZARD.CTL.
  1861.   
  1862.        But there's another switch available:
  1863.   
  1864.        /FLIST /@<file name>
  1865.   
  1866.        Here you can name a file, which has following structure:
  1867.   
  1868.        <path and name of a FLSEARCH.CTL file> <Allfiles-name> <Newfiles-name>
  1869.        <Minimum security level> <Maximum security level> <Filelist header>
  1870.   
  1871.        Example:
  1872.   
  1873.        C:\BBS\FL1.CTL C:\BBS\ALLFILE1.TXT C:\BBS\NEWFILE1.TXT 0  200  C:\H1.TXT
  1874.        C:\BBS\FL2.CTL C:\BBS\ALLFILE2.TXT C:\BBS\NEWFILE2.TXT 50 100
  1875.        <DEFAULT>      C:\BBS\ALLFILE3.TXT C:\BBS\NEWFILE3.TXT 0  700  C:\H2.TXT
  1876.        C:\BBS\FL4.CTL C:\BBS\ALLFILE4.TXT <NONE> 100  300
  1877.   
  1878.        Alle filelists which you define here, will be created by File Wizard.
  1879.        You may use <NONE> as NEWFILES. This way there will be no newfile list.
  1880.        If you do not name the last parameter (header), File Wizard uses the
  1881.        header you defined in WIZARD.CTL
  1882.   
  1883.        If you want to use the default area configuration, you can specify
  1884.        the macro <DEFAULT> instead the path+name of the .CTL file (first
  1885.        parameter in the line).
  1886.   
  1887.        Since version 1.3 registered users can define an own design for
  1888.        the filelists.
  1889.   
  1890.        There are two new control files, in which this design is defined:
  1891.   
  1892.        AFLSTYLE.CTL and NFLSTYLE.CTL
  1893.   
  1894.        AFLSTYLE.CTL defines the lookout of a normal file, wheras NFLSTYLE.CTL
  1895.        defines the design for a new file (was marked in the old way by a "*")
  1896.   
  1897.        Following macros are allowed:
  1898.   
  1899.        %N filename
  1900.        %D date
  1901.        %T timestamp of the file
  1902.        %B size in bytes
  1903.        %K size in kB (including a trailing "k" !)
  1904.        %1 transfertime at 300   baud (im Format Min:Sec)
  1905.        %2 transfertime at 1200  baud
  1906.        %3 transfertime at 2400  baud
  1907.        %4 transfertime at 9600  baud
  1908.        %5 transfertime at 14400 baud
  1909.        %6 transfertime at 16800 baud
  1910.        %7 transfertime at 19200 baud
  1911.        %8 transfertime at 28800 baud
  1912.        %9 transfertime at 64000 baud
  1913.   
  1914.        %# filedescription
  1915.   
  1916.  
  1917.   ────────────────────────────────────────────────────────────────────────────
  1918.                           (c) 1993,94 by Oliver Weindl                        
  1919.  
  1920.  
  1921.      File Wizard 1.3                                                   Page 31
  1922.   ════════════════════════════════════════════════════════════════════════════
  1923.  
  1924.        All parameters (without %# !) can be followed by a "@" in order
  1925.        to hold some place, if the string isn't as long as expected.
  1926.        (see example below)
  1927.   
  1928.        There can be up to 20 lines in each of the controlfile, but the last
  1929.        line only should contain a %###... statement, because this line
  1930.        will be used more than one times (if the filedescription is longer
  1931.        than the defined lines !).
  1932.   
  1933.        If there is a missing file, the string OFFLINE will be used instead
  1934.        of the date when using %D. All other macros (except %N) will be
  1935.        replaced by empty strings.
  1936.   
  1937.        Example:
  1938.   
  1939.        --= AFLSTYLE.CTL =----------------------------------------------------
  1940.   
  1941.        %N@@@@@@@@@@ %K@@@ %D@@@@@@   %#######################################
  1942.                                       %######################################
  1943.   
  1944.        ----------------------------------------------------------------------
  1945.   
  1946.        --= NFLSTYLE.CTL =----------------------------------------------------
  1947.   
  1948.        %N@@@@@@@@@@ %K@@@ %D@@@@@@ █ %#######################################
  1949.        ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█  %######################################
  1950.   
  1951.        ----------------------------------------------------------------------
  1952.   
  1953.   
  1954.   4.2.4 Change your keyboard definitions   /K
  1955.   
  1956.        Most of the keys used in File Wizard are freely configurable. So you
  1957.        can change everthing to fit your needs.
  1958.   
  1959.           **** IMPORTANT ****
  1960.   
  1961.        There could be problems if you're usen a keyboard driver like KDRIVE.
  1962.        They use some other scancodes. So if you find that there occures
  1963.        problems, you may change the keys via the /K parameter.
  1964.   
  1965.   
  1966.   4.2.5 Exporting your area configuartion   /X<filename>
  1967.   
  1968.        By using this switch you can export a list of your areas in a
  1969.        FLSEARCH.CTL like style (see 4.2.1). Additionally there will be
  1970.        some files which you definded in WIZARD.CTL with the parameter
  1971.        "GROUP".
  1972.   
  1973.   
  1974.   4.2.6 Updating your mailer request paths
  1975.   
  1976.        File Wizard is able to update your the requestpaths of your mailer.
  1977.        This works with Binkley, FrontDoor, InterMail and D'Bridge.
  1978.        To use this switch, there should be available some addiontional
  1979.        informations.
  1980.  
  1981.   ────────────────────────────────────────────────────────────────────────────
  1982.                           (c) 1993,94 by Oliver Weindl                        
  1983.  
  1984.  
  1985.      File Wizard 1.3                                                   Page 32
  1986.   ════════════════════════════════════════════════════════════════════════════
  1987.  
  1988.   
  1989.        D'Bridge : WIZARD /RPATH /E<path and name of the exporting configuartion>
  1990.   
  1991.          To work with D'Bridge you first need to export the configuartion
  1992.          with DB EXPORT DB.CFG. After the run with /RPath you have to im-
  1993.          port the configuartion again with DB IMPORT DB.CFG.
  1994.   
  1995.        FD, InterMail: WIZARD /RPATH /E<path to your FD/IM directory>
  1996.   
  1997.        Binkley: WIZARD /RPath  (no additional parameters needed)
  1998.   
  1999.   
  2000.   4.2.7 File Wizard FileBase initialization  /FBINIT
  2001.   
  2002.        With File Wizard, you're able to have a newfiles list without
  2003.        using the date. Do do that, File Wizard needs an own file base to
  2004.        compare with your file areas. You create that list normally only
  2005.        once by using the paramater /FBINIT.
  2006.   
  2007.   
  2008.   4.2.8 Updating the FileBase   /FBUPDATE
  2009.   
  2010.        This parameter causes Wizard to compare the Wizard-FileBase with
  2011.        your real filebase. This run could be up to 30 minutes, if you
  2012.        have a big filebase.
  2013.        The result of the run will be a list of all new files since the
  2014.        last run. Additionally File Wizard may announce your new files
  2015.        in one or more mail echos.
  2016.   
  2017.   
  2018.   4.2.9 Creating an OLDSTUFF list    /OLDLIST
  2019.   
  2020.        This switch allows you to create a list with old files. Which
  2021.        files count to "old", you already defined in WIZARD.CTL
  2022.        All "old" files will be written in file called WIZARD.DEL.
  2023.        This is pure ASCII file and can be edit, before really deleting
  2024.        the files.
  2025.   
  2026.   
  2027.   4.2.9 Deleting OLDSTUFF  /DELETEOLDSTUFF
  2028.   
  2029.        If you're ready editing the WIZARD.DEL, you are going to delete
  2030.        the files via this switch. Alle files left in WIZARD.DEL will be
  2031.        deleted and cleared also in your FILES.BBS.
  2032.   
  2033.   
  2034.   4.2.10 Deleting program series  /KEEPLATEST
  2035.   
  2036.        This switch allows you to delete older version of programs which
  2037.        are the same files, but have different version numbers. A real
  2038.        good example is the Fido NODEDIFF, which comes up every week.
  2039.        You may now inform Wizard only hold <value> in the area and deleting
  2040.        the rest.
  2041.   
  2042.        Let's make an example. You defined in WIZARD.CTL:
  2043.   
  2044.  
  2045.   ────────────────────────────────────────────────────────────────────────────
  2046.                           (c) 1993,94 by Oliver Weindl                        
  2047.  
  2048.  
  2049.      File Wizard 1.3                                                   Page 33
  2050.   ════════════════════════════════════════════════════════════════════════════
  2051.  
  2052.        KeepLatest K:\SPEC\NODEDIFF.* 10
  2053.        KeepLatest J:\GRAPHIC\VPIC*.* 5
  2054.   
  2055.        Running File Wizard with the switch /KEEPLATEST will result as follows.
  2056.        All files in the directory K:\SPEC which fits to the above specification
  2057.        will be deleted, only the ten with the newest date will be hold.
  2058.        In the directory J:\GRAPHIC there will be left only the newest 5 files,
  2059.        which fits to VPIC*.*
  2060.   
  2061.   
  2062.   
  2063.   5. File area editor
  2064.   
  2065.        Explaining how to use a simple editor would be too much for this
  2066.        manual, so let me just give you an overview of the standard
  2067.        functions and keys:
  2068.   
  2069.        Standard functions
  2070.   
  2071.    - Cursor up/down               Cursor up/down one line
  2072.    - Cursor right/left            Cursor right/left
  2073.    - Pos1/End                     Cursor to first/last character of this line
  2074.    - Page up/down                 Goto previous/next page
  2075.   
  2076.    - CTRL-Pos1 / -End             Cursor to first/last line of current page
  2077.    - CTRL-Page up/-down           Cursor to first/last line of entire text
  2078.    - CTRL-Cursor-right/-left      Cursor one word to the right/left
  2079.   
  2080.   
  2081.    - F1                           Bring up interactive online help
  2082.    - F2                           Save changes
  2083.    - F9                           Jump to default area (s. WIZARD.CTL)
  2084.    - F10                          Save, jump to choose area function
  2085.   
  2086.   Macros and external programmes
  2087.   
  2088.    - F5                           Start/end macro recorder
  2089.    - F6                           Display loaded macro
  2090.    - F7                           Save current macro
  2091.    - F8                           Load previously saved macro
  2092.   
  2093.    - ALT-F1                       Load user-defined macro
  2094.    - ALT-F2                       Load user-defined macro
  2095.    - ALT-F3                       Load user-defined macro
  2096.    - ALT-F4                       Load user-defined macro
  2097.    - ALT-F5                       Load user-defined macro
  2098.    - ALT-F6                       Load user-defined macro
  2099.    - ALT-F7                       Load user-defined macro
  2100.    - ALT-F8                       Load user-defined macro
  2101.   
  2102.                ( These macros are defined in WIZARD.CTL! )
  2103.   
  2104.    - CTRL-F1                      Execute external programme
  2105.    - CTRL-F2                      Execute external programme
  2106.    - CTRL-F3                      Execute external programme
  2107.    - CTRL-F4                      Execute external programme
  2108.  
  2109.   ────────────────────────────────────────────────────────────────────────────
  2110.                           (c) 1993,94 by Oliver Weindl                        
  2111.  
  2112.  
  2113.      File Wizard 1.3                                                   Page 34
  2114.   ════════════════════════════════════════════════════════════════════════════
  2115.  
  2116.    - CTRL-F5                      Execute external programme
  2117.    - CTRL-F6                      Execute external programme
  2118.    - CTRL-F7                      Execute external programme
  2119.    - CTRL-F8                      Execute external programme
  2120.   
  2121.            ( These external programmes are defined in WIZARD.CTL! )
  2122.   
  2123.   
  2124.   All the functions mentioned above cannot be changed!
  2125.   The following commands, however, are user-definable, so only the function
  2126.   is mentioned and not the corresponding keystrokes, as these are the user's
  2127.   choice!
  2128.   
  2129.   
  2130.   - Delete line
  2131.   
  2132.     Deletes current line, all following lines go up one line
  2133.   
  2134.   - Delete to end of line
  2135.   
  2136.     Delete line from cursor position to end of line.
  2137.   
  2138.   - Delete word left from Cursor
  2139.   
  2140.   - Delete word right from cursor
  2141.   
  2142.   - Mark/Tag a file
  2143.   
  2144.     Tags current line. If this current line contains a file name, and if
  2145.     additional description lines are found in the lines below, these lines
  2146.     will also be tagged (if this option was enabled in WIZARD.CTL)
  2147.   
  2148.   - Jump to next file beginning with "?"
  2149.   
  2150.   - Tag all missing files
  2151.   
  2152.     Compares files in this area with files in file list. All files which are
  2153.     contained in the file list of this area, but which are not found in this
  2154.     directory, will be tagged.
  2155.   
  2156.   - Move tagged files
  2157.   
  2158.     All tagged files will be moved to another file area. The resulting
  2159.     changes will automatically be saved to the file list of this area.
  2160.     If no files have been tagged, the file at cursor position will be moved.
  2161.   
  2162.   - Copy tagged files
  2163.   
  2164.     Similar to "Move tagged files", except that the tagged files are not
  2165.     deleted in the "source" directory after they have been copied.
  2166.   
  2167.   - Delete File
  2168.   
  2169.     The file at cursor position _and_ its description in the file list will
  2170.     be deleted!
  2171.   
  2172.  
  2173.   ────────────────────────────────────────────────────────────────────────────
  2174.                           (c) 1993,94 by Oliver Weindl                        
  2175.  
  2176.  
  2177.      File Wizard 1.3                                                   Page 35
  2178.   ════════════════════════════════════════════════════════════════════════════
  2179.  
  2180.   - Delete all tagged Files
  2181.   
  2182.     Be careful when using this.... All tagged files will be deleted in the
  2183.     editor _and_ on your hard disk!
  2184.   
  2185.   - Search Description
  2186.   
  2187.     Searches a directory (as defined in WIZARD.CTL) for file lists and tries
  2188.     to find a description for the current file there. Multi-line
  2189.     decriptions are supported!
  2190.   
  2191.   - Search Description for tagged files
  2192.   
  2193.     The same as above, only that File Wizard will now try to find descriptions
  2194.     for all tagged files.
  2195.   
  2196.   - Tag all dupe files
  2197.   
  2198.     All files that are containied twice in your file list will be tagged.
  2199.   
  2200.   - Adopt all missing files
  2201.   
  2202.     All files which are not contained in your file list, but which are found
  2203.     on your hard disk, will be adopted to the file list.
  2204.   
  2205.   - Untag all tagged files
  2206.   
  2207.     Any questions about that???
  2208.   
  2209.   - Sort a block
  2210.   
  2211.     A whole block can be tagged choosing this function. After pressing
  2212.     <ENTER>, this block will automatically be sorted (multi-line
  2213.     descriptions are supported).
  2214.   
  2215.     Attention: sub areas are _NOT_ taken into account here!!!
  2216.   
  2217.     <ESC> will abort sorting.
  2218.   
  2219.   - Copy tagged lines inside Editor
  2220.   
  2221.   - Move tagged lines inside Editor
  2222.   
  2223.   - Rename file at cursor position
  2224.   
  2225.     The current file will be renamed in the editor and on your hard disk!
  2226.     If you specify an invalid file name or the name of a file that already
  2227.     exists, the file will not be renamed!
  2228.   
  2229.   - View contents of an archive
  2230.   
  2231.     Opens a list box and shows contents of an archive. You can select files
  2232.     inside this archive and view them using the external list programme (as
  2233.     defined in WIZARD.CTL).
  2234.     This option will also execute the External_View programmes as defined in
  2235.     WIZARD.CTL.
  2236.  
  2237.   ────────────────────────────────────────────────────────────────────────────
  2238.                           (c) 1993,94 by Oliver Weindl                        
  2239.  
  2240.  
  2241.      File Wizard 1.3                                                   Page 36
  2242.   ════════════════════════════════════════════════════════════════════════════
  2243.  
  2244.   
  2245.   - Run a DOS-SHELL
  2246.   
  2247.     Depending on your configuration of WIZARD.CTL, you will either find
  2248.     yourself in the current directory or in the directory where File Wizard
  2249.     resides.
  2250.   
  2251.   - Extract Files to test-Directory
  2252.   
  2253.     The archive is decompressed into the defined FREEDIR directory
  2254.     (WIZARD.CTL), and a DOS shell will come up there to enable viewing
  2255.     and/or testing of this archive. Typing "EXIT" will bring up File
  2256.     Wizard again, and all files in this directory will automatically be
  2257.     deleted.
  2258.   
  2259.   - Extract Descriptions from File
  2260.   
  2261.     Many archives contain text files with additional information about the
  2262.     contents of this text file (e.g. FILE_ID.DIZ, DESCRIPT.ION, etc.).
  2263.     File Wizard can look for these files (as defined in WIZARD.CTL) and
  2264.     insert the descriptions into your file list.
  2265.   
  2266.   - Extract Descriptions from tagged files
  2267.   
  2268.     Same as above, but only for tagged files.
  2269.   
  2270.   - Search for a text-string
  2271.   
  2272.     Searches file list for a specified string
  2273.   
  2274.   - Search again
  2275.   
  2276.     Guess what....
  2277.   
  2278.   - Copy Description to line below
  2279.   
  2280.     This command can be useful, when a programme consists of several archives.
  2281.     In such a case you can copy the description of one archive for all the
  2282.     other archives.
  2283.   
  2284.   - Insert GIF-resolution at cursor position
  2285.   
  2286.   - Insert MOD-Descritpion at cursor position
  2287.   
  2288.   - Touch current file
  2289.   
  2290.   - Touch all tagged files
  2291.   
  2292.   - Toggle Tag-Flag
  2293.   
  2294.     All tagged files will be untagged and vice versa.
  2295.   
  2296.   - Display MOVE-Buffer
  2297.   
  2298.     Displays names of tagged files that are to be moved to another file
  2299.     area. Maximum number of files that can be shown is 20.
  2300.  
  2301.   ────────────────────────────────────────────────────────────────────────────
  2302.                           (c) 1993,94 by Oliver Weindl                        
  2303.  
  2304.  
  2305.      File Wizard 1.3                                                   Page 37
  2306.   ════════════════════════════════════════════════════════════════════════════
  2307.  
  2308.   
  2309.   - Delete tagged lines
  2310.   
  2311.   - Exit File Wizard at once
  2312.   
  2313.   - Import files
  2314.   
  2315.     With this option you can import archives from any path. Just type in
  2316.     the import-path, and tag the files you want to import in this area.
  2317.     If there exists a FILES.BBS file in the import-path, the description
  2318.     will be added to your filearea automatically.
  2319.   
  2320.   - Export files
  2321.   
  2322.     See Import files.
  2323.   
  2324.   - Tag and Pack files
  2325.   
  2326.     A very powerfull option, which allowes you to tag certain files from
  2327.     your harddisk, and pack them into a new archive. Please refer to the
  2328.     PACKCOMMAND definition in the WIZARD.CTL file.
  2329.   
  2330.   - Tag files according to their filedate
  2331.   
  2332.     It happens often, that you want to tag all files, which are older than
  2333.     a certain age. This function allowes you to do this job very quick.
  2334.     Just type in the date, and all files which are older/newer will be tagged.
  2335.   
  2336.   - Edit fileattributes (RA 2.0x only !)
  2337.   
  2338.     Here you can edit the special file attributes for RA 2.0x
  2339.     So File Wizard becomes a complete alternative for the FILEMGR
  2340.     program included in the RA 2.0x package.
  2341.   
  2342.   
  2343.   6. Built-in macro recorder
  2344.   
  2345.     This macro recorder can save and reproduce certain keystrokes or
  2346.     combinations which are frequently needed.
  2347.   
  2348.     Pressing <F5> starts recording a macro. All the keys that are pressed
  2349.     now will be recorded. If you press <F5> again, the recording is finished
  2350.     and you can now use this macro.
  2351.   
  2352.     Pressing <F6> will then "play back" this macro.
  2353.   
  2354.     !! Attention !!
  2355.   
  2356.     Recording macros is only possible inside the editor, it is not possible
  2357.     to change areas using macros!
  2358.   
  2359.     Pressing <F7> will save the current macro to your hard disk. You will
  2360.     be asked for a description of this macro and to specify a valid file
  2361.     name. By pressing <F8> you can load any previously saved macro.
  2362.   
  2363.     In addition to that you also have the possibility to define up to 8
  2364.  
  2365.   ────────────────────────────────────────────────────────────────────────────
  2366.                           (c) 1993,94 by Oliver Weindl                        
  2367.  
  2368.  
  2369.      File Wizard 1.3                                                   Page 38
  2370.   ════════════════════════════════════════════════════════════════════════════
  2371.  
  2372.     macros for key combinations <ALT-F1> to <ALT-F8> in WIZARD.CTL.
  2373.   
  2374.     Example (deleting download counters)
  2375.   
  2376.     <F5> to start macro recorder
  2377.   
  2378.     Search text: [
  2379.         (Cursor now on left bracket)
  2380.   
  2381.     <Cursor left>
  2382.   
  2383.     <Delete word to the right>
  2384.   
  2385.     <F5> End of macro recording
  2386.   
  2387.     Now you can look for the next download counter by pressing <F6> and
  2388.     delete it at once.
  2389.   
  2390.   7. The header definition
  2391.   
  2392.   The header above each filearea and each section in the filelist is
  2393.   free definable. The headers are defined in two ASCII files, which
  2394.   are placed in the File Wizard home directory.
  2395.   
  2396.   Fileareaheader   :  WIZARD.HDR (here you define the header, which will
  2397.                                  be placed above each filearea when you
  2398.                                  start SortFileAreas.
  2399.   
  2400.   Filelistheader   : LWIZARD.HDR (Dthis header is placed above the filearea
  2401.                                  in the FileLists. To avoid dupe headers
  2402.                                  in your list, you have to place the
  2403.                                  SKIP_AREA_HEADER statement in WIZARD.CTL 
  2404.   
  2405.   In order to keep the informations in the header variable, you have to
  2406.   assign several macros in the headerfile. This macros will be replaced
  2407.   by usefull values at runtime. A macro initates with a percent (%) sign.
  2408.   
  2409.   Macrosummary:
  2410.   
  2411.     %A     Areanumber of the aktual area
  2412.     %N     Name/description of the actual area
  2413.     %B     Kilobytes of all listet files in area
  2414.     %F     Number of files in the actual area
  2415.     %D     Actual system date
  2416.     %T     Actual system time
  2417.     %H     Name of the newest file
  2418.   
  2419.    In the LWIZARD.HDR file tehre exists an additional macro, which
  2420.    represents large-font numbers. The syntax for this large-font
  2421.    numbers is a bit more complicated than the simple macro set.
  2422.    First you have to distinguish, wether the actual number stands
  2423.    for a thousandth, hundredth, tenth or single position of the
  2424.    actual area number. Secondly the large font set consists of
  2425.    4 lines for each number. With the large font set you can display
  2426.    the actual areanumber like the %A macro.
  2427.   
  2428.  
  2429.   ────────────────────────────────────────────────────────────────────────────
  2430.                           (c) 1993,94 by Oliver Weindl                        
  2431.  
  2432.  
  2433.      File Wizard 1.3                                                   Page 39
  2434.   ════════════════════════════════════════════════════════════════════════════
  2435.  
  2436.   
  2437.     %C<position>-<line>##     - position stands
  2438.                                 for     :          * 1 = Thousandth
  2439.                                                    * 2 = Hundreth                                                 * 2 = Hunderter
  2440.                                                    * 3 = Tenth
  2441.                                                    * 4 = Single number
  2442.   
  2443.                               - Line:              Each large font number
  2444.                                                    consists of 4 lines,
  2445.                                                    which have to be placed
  2446.                                                    in the header file.
  2447.   
  2448.     Beispiel: %C1-1## stands for the first line of the "thousands-number"
  2449.                       of the actual areanumber at runtime.
  2450.     Beispiel: %C4-2## stands for the second line of the "single-number"
  2451.                       of the actual areanumber at runtime.
  2452.     Beispiel: %C2-3## stands for the third line of the "tenth-number"
  2453.                       of the actual areanumber at runtime.
  2454.   
  2455.    If you have less than e.g. 100 areas, you can skip the thousandth and
  2456.    hundredth numbers. So you can save much more place in the header.
  2457.   
  2458.    In the LWIZARD.HDR file, the %N macro has some more features. You can
  2459.    use this macro more then once in the headerfile. The contence of the
  2460.    areadescription will be continued in the second %N-part, if the whole
  2461.    description doesn't match in the first %N-part.
  2462.   
  2463.   
  2464.   In order to format the macros at the right position in the header, you have
  2465.   some additional signs to indicate a left, right, or centered display.
  2466.   For this purpose, you have the signs *, #, and & available. This signs
  2467.   have to be placed right after the inital macro, and represent the place
  2468.   which will be used by the macro.
  2469.   
  2470.   examples:
  2471.   
  2472.       "Areaname : %N###################################" changes to
  2473.       "Areaname : This is the UploadArea               "
  2474.   
  2475.   the format signs have the following meaning:
  2476.   
  2477.    "#" : Text will be formated to the left
  2478.    "&" : Text will be formated to the right
  2479.    "*" : Text will be centered
  2480.   
  2481.   
  2482.   examples:
  2483.   
  2484.       "Areaname : %N&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&" changes to
  2485.       "Areaname :               This is the Upload Area"
  2486.   
  2487.       "Areaname : %N***********************************" changes to
  2488.       "Areaname :         This is the Upload Area      "
  2489.   
  2490.       "Areaname : %N&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&" changes to
  2491.       "Areaname :               This is the Upload Area"
  2492.  
  2493.   ────────────────────────────────────────────────────────────────────────────
  2494.                           (c) 1993,94 by Oliver Weindl                        
  2495.  
  2496.  
  2497.      File Wizard 1.3                                                   Page 40
  2498.   ════════════════════════════════════════════════════════════════════════════
  2499.  
  2500.   
  2501.   
  2502.       "Areaname : %N####################"
  2503.       "           %N####################" changes to
  2504.   
  2505.       "Areaname : This is the Upload    "
  2506.       "           Area                  "
  2507.   
  2508.   
  2509.   
  2510.   Attention ! In order to redefine the headers, you have to be a
  2511.   registered user of File Wizard. Otherwise, the header will be
  2512.   overwritten by the default values.
  2513.   
  2514.   
  2515.   
  2516.   
  2517.   8. Closing remarks
  2518.   
  2519.   
  2520.   Finally I'd like to thank all my Beta testers very much for their more or
  2521.   less annoying <grin...> remarks and bug reports.
  2522.   
  2523.   Im especially grateful to Wolfgang Hanke, whose ideas are responsible for
  2524.   an enormous part of File Wizard's functions.
  2525.   
  2526.   And a "Thankx-a-lot" to Felix Mueller, who helped with the documentations.
  2527.   
  2528.   9. Copyrights, trademarks etc. (i.e. the legal stuff)
  2529.   
  2530.   
  2531.       PKZIP and
  2532.       PKUNZIP            are trademarks of PKWare Inc.
  2533.       PAK                is a trademark of NoGate Consulting.
  2534.       ARC                is a trademark of SEA inc.
  2535.       LZH and LHarc      is a trademark of Yoshi.
  2536.       ARJ                is a trademark of Robert K. Jung
  2537.       MTA                is a trademark of Rob Van Hoeven
  2538.       GIF                is a trademark of CompuServe Inc.
  2539.       SuperBBS           is a trademark of Risto Virkala and
  2540.                                            Aki Antman
  2541.       WME                is a trademark of Jason Fesler
  2542.       LoaraBBS           is a trademark of ....
  2543.       RemoteAccess       is a trademark of Andrew Millner
  2544.       ProBoard           is a trademark of Philippe Leybaert
  2545.       FrontDoor          is a trademark of Jochim Homgrighausen
  2546.       InterMail          is a trademark of InterMail Sales Inc.
  2547.       Binkley            is a trademark of Bit Bucket Software
  2548.       D'Bridge           is a trademark of Chris Irwin
  2549.   
  2550.   
  2551.   
  2552.   File Wizard was programmed in Borland Pascal 7.0. Additionally the
  2553.   Turbo Professional Units, as well as the unit ZIPDIR (by Martin
  2554.   Austermeier) were used..
  2555.   
  2556.  
  2557.   ────────────────────────────────────────────────────────────────────────────
  2558.                           (c) 1993,94 by Oliver Weindl                        
  2559.  
  2560.  
  2561.      File Wizard 1.3                                                   Page 41
  2562.   ════════════════════════════════════════════════════════════════════════════
  2563.  
  2564.   
  2565.       Turbo Pascal         is a trademark of Borland International
  2566.       Turbo Professional   is a trademark of TurboPower Inc.
  2567.   
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.   ────────────────────────────────────────────────────────────────────────────
  2622.                           (c) 1993,94 by Oliver Weindl                        
  2623.  
  2624.  
  2625.