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 >
Wrap
Text File
|
1994-09-15
|
91KB
|
2,625 lines
File Wizard 1.3 Page 1
════════════════════════════════════════════════════════════════════════════
▄▄▄▄ ▄ ▄ ▄▄▄▄
───────▄────▄─▄────▄───────────
▀ ▀ ▀▀▀▀ ▀▀▀▀
██ ██ ██ ▐██▌ ███████ ▄█████▄ ██████▄ ██████▄
██ ██ ██ ██ ▄██▀ ██▄▄▄██ ██ ██ ██ ██
██ ██ ██ ██ ▄██▀ ██▀▀▀██ ██████ ██ ██
▀██████▀ ▐██▌ ███████ ██ ██ ██ ▀██ ██████▀
A Bulletin Board File Area Manager
(c) 1994 by Oliver Weindl
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 2
════════════════════════════════════════════════════════════════════════════
1.1. Some words before ... PLEASE READ CAREFULLY !!
Please read this part carefully. There are some important hints
for using File Wizard.
File Wizard was born with the idea to help the SysOps of a mail
box to make the daily maintenance of the files as easy as possible.
Most of the functions seem not be very visible, but after a short
period of training, this shouldn't be any problem.
You normally used different tools to manage your filebase, like
a tool to creat the daily filelist, something to sort the areas,
another one to move/copy files, .... etc.
File Wizard completes all these different functions in ONE packet.
This way you only need one configuartion file to handle all the
daily maintenance in one run.
Known bugs :
* Keyboards / special keys
This was found during the beta tests. There are some systems with
different keydrivers, that show problems in using combination of
keystrokes like CTRL-Y, CTRL-Z, and CTRL-C. If you find something
not working, you can change your keys by calling Wizard with the
parameter /K. Then you have the possibilty to change the keys to
your needs.
* Packer ARJ
Since the change to version 2.4x of this famous packer, there are
some changes in structures, which are not included with this version
of File Wizard. Special files like those packed with the security
envelope may result in an error. But we're working on it.
Since version 1.3 this problems should be solved, but nevertheless...
1.2. Licensing Information
File Wizard is distributed as "Shareware", i.e. you may copy
and distribute this archive as often as you like, as long as
you don't change its contents and as long as you don't charge
any money for it!
However, "Shareware" is definitely not the same as "Public Domain"!
After a trial period of 30 days, in which you can use File Wizard
as often as you like, you _must_ register this programme, if you
you continue to use it. For details please refer to the enclosed
text file REGFORM.DOC. There are also some other regforms enclose
e.g. one for creditcards etc. Please take a look at the distribution
package ("DIR REGFORM.*").
File Wizard is no Cripple-Ware, that means there are neither handicaped
functions, nor any delay times at the normal runtime. So you can test
the program for 30 days without any restrictions.
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 3
════════════════════════════════════════════════════════════════════════════
1.3. Disclaimer
If you use FileWizard, you do this at your own risk!!!
The only guarantee I can give is, that File Wizard will occupy a certain
amount of space on your hard disk and that File Wizard - when run - will
also need a certain amount of RAM!
I am in no case to be made responsible for any loss of data or any
other trouble, problems, damages etc. that might occcur when you run
File Wizard!
1.4. Memory Management
For optimizing memory requirements, please refer to the DPMI.DOC file
in this distribution packet.
If you're not familiar with DPMI memory management, i advise you NOT
to change the default setting !
1.5. Changes to previous versions
All changes to previous versions are documented in the file HISTORY.TXT.
1.6. What you need
File Wizard is designed to use DMPI (DOS-Protected-Mode-Interface). Due
to that fact, Wizard is able to use the whole RAM and the all above
memory, which is available as XMS. To run this mode you need a PC with
a 286/386 processor and 1,2 MB free XMS memory. A special version for
a XT or a pc with only 1 MB RAM isn't available.
2. What does File Wizard do?
File Wizard is a file area manager for several BBS programmes. In this
current version 1.0 the following programmes are supported:
* SuperBBS
* WME (Beta mit FILES.BBS)
* RemoteAccess 1.11
* RemoteAccess 2.0x (Filebase)
* RemoteAccess 2.0x (FILES.BBS)
* LoraBBS
* ProBoard
* QuickBBS
* Maximus
* FLSEARCH.CTL mit FILES.BBS
* FLSEARCH.BBS mit FILES.BBS
* FILECFG.PRO mit FILES.BBS
* FILES.RA
Features: - interactive file area editor, capable of one-step-editing
and copying, using standard editor commands
- user-definable key-combinations for all functions
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 4
════════════════════════════════════════════════════════════════════════════
- different colours to accentuate different information
(missing files, file descriptions, etc.)
- command-specific online help
- support of file descriptions longer than one line
- copy/move files from one area to another
- access upload directory by just one keystroke
- import of file descriptions using other BBS's file lists
or the decriptions contained in archives
- built-in macro recorder to load/save frequently used
commands
- evaluation of archives/pictures directly from within the
editor
- decompression and testing of archives by just one keystroke
- insert information about GIFs or MODs with just one
keystroke
- sort file list (or part of it) from within the editor
- include missing files into the file list
- mark "dupe" files
- search functions (e.g. search/search again)
- 8 user-definable external programmes can be started from
within the editor by a simple keystroke (e.g. MTA.EXE)
- up to 50 different extensions are recognized and can be
assigned to different programmes
- renaming of files
- "touching" of files
- missing files are displayed in another color and can be
deleted with a simple keystroke
- creation of file list/newfiles list
- automatic sorting of file areas (multi-line descriptions
are supported), in each area any number of sub-areas can be
established, which are given special attention when sorting
- insert file headers above each file area (optional)
- adjusting of multiline descriptions to make the download
counter more visible
- ex- and import of files from any path
- tag and pack files from your disk to an archive
- add temporary fileareas inside of File Wizard
- tag files with date
- create "old file" lists, which helps to delete old files
- create own area headers
- add request information to each area
- create newfiles list with real date
- update the request paths of your mailer. At the moment it
runs with D'Bridge, FrontDoor, InterMail and Binkley
- create TOP files and area statistics files (ANS/ASC)
- maintenance of new files independ of the file date
- announce of new files via .PKT
- formats long descriptions
- group maintenance to create easy selections
- runs with different LOG files to make different lists
- dupechecker for your fileareas
- variable filelist creation
- archive-conversion
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 5
════════════════════════════════════════════════════════════════════════════
3. Configuration file WIZARD.CTL
This config file is pure ASCII and can be edited using the editor
of your choice. Lines starting with a % (per cent) are comment lines
and will be ignored by File Wzard. There is a file called WIZ_CTL.ENG
in the distribution package,which contains a WIZARD.CTL file in the
english language.
- FileListPath <path+filename>
Name of subdirectory where you keep uncompressed file lists of other
BBS's. When looking for file descriptions only lists found in this
path will be searched.
To obtain the best results, these lists should be structured as
follows:
FILENAME.EXT <size> <date> description (first line)
description (second line)
.
.
.
Multi-line descriptions are exported correctly by File Wizard and
will later be inserted into your file list.
e.g.
FileListPath C:\LISTEN\*.*
FileListPath D:\FIDOLIST\*.LST
etc...
- German_Help_File
This option brings up the online help in German.
- Select_Description
File Wizard is capable of looking for the description of a single
file, as well as for the descriptions of a number of previously
marked files. You can - after the search has been carried out - make
your choice among the found descriptions. If you want to do this,
then this command should be enabled.
- BBSTYPE definition
As File Wizard needs to know what kind of BBS programme you use, it
is necessary to choose the correct type.
Possible choices:
BBSTYPE SBBS
BBSTYPE WME
BBSTYPE RA
BBSTYPE RA200
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 6
════════════════════════════════════════════════════════════════════════════
BBSTYPE RA200TXT
BBSTYPE MAXIMUS
BBSTYPE GENERIC
BBSTYPE PROBOARD
BBSTYPE LORABBS
BBSTYPE QBBS
To set one a BBSTYPE inactive, please just put a percent character (%)
before the type.
The new filebase of SuperBBS 1.18 is in development.
I don't know the future development of SBBS, so don't rely
on this future extension !
- BBSTYPE GENERIC <path+name>
If you chose GENERIC for your BBS programme, this parameter is
necessary to tell File Wizard where to find FLSEARCH.CTL.
This file is structured as follows:
<path> <security level> <decription_with_undercores>
Example:
C:\BBS\AREA1 5 Name_of_first_area
C:\BBS\AREA2 10 Name_of_second_area
When using this FLSEARCH.CTL file, all your file areas must contain
a FILES.BBS in the standard FILES.BBS format.
File Wizard supports additionally a filename at the pathdescription.
e.g.
C:\BBS\AREA1\FILES.BBS 5 Name_of_first_area
C:\BBS\AREA2\FILES.DES 10 Name_of_second_area
This filename (if you use one) must have an extension. If no
Filename is specified, File Wizard will assume FILES.BBS .
- BBSTYPE SBBS <path+name>
Path and name of FLSEARCH.BBS for SuperBBS.
For more information about this: RTFM, please.... (;->
- BBSTYPE WME <path+name>
File Wizard supports the new version of WME (Windowed Modem
Environment) with FILES.BBS alike description files.
At <path+name> you have to specify the first .WME cataloge
file in your BBS-config.
- BBSTYPE RA <path+name>
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 7
════════════════════════════════════════════════════════════════════════════
Specifys path and filename for RA 1.11
e.g. BBSTYPE RA J:\RA\FILES.RA
- BBSTYPE RA200 <path+name>
Specifys path and filename for RA 2.0x
e.g. BBSTYPE RA200 J:\RA\FILES.RA
There is an additional
parameter needed, which is described later on.
- BBSTYPE QBBS <path>
Defines bbstype Quickbbs.
<path> ONLY points to path of QuickBBS.
- BBSTYPE PROBOARD <path+name>
<path+name> specifys path and filename for ProBoard are configuration,
- BBSTYPE LORABBS <path>
<path> Points to the directory of LoraBBS
- LORA_PATH_PREFIX <path>
This one shows, which character will be put before the area paths
only for LoraBBS.
- RA200_FILEBASE D:\RA\FILEBASE
This command points to the filebase of RA 2.00
- BBSTYPE FREETYPE <path+filename> <BBS-name>
This option allowes you to use any BBS-software, which uses
FILES.BBS alike file descriptions.
<path+filename> specifies the BBS filearea configuration file
<BBS-name> name of the BBS package (e.g. MYBBS)
If File Wizard should read this areakonfiguration, you must tell
File Wizard the structure of this file. You need to know:
- Structure of the areaconfig file (usually included in every
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 8
════════════════════════════════════════════════════════════════════════════
BBS dirstribution package)
- How to calculate the structure for byte-positions.
Also you HAVE TO INCLUDE following commands in the WIZARD.CTL file:
FreeBlockSize <value>
size of a single structure in the file.
FreeTypePath <Pos> <Len> <P or C> // Path to the filearea
FreeTypeDesc <Pos> <Len> <P or C> // Description of the filearea
FreeTypeList <Pos> <Len> <P or C> // Name+path of the FILES.BBS file
FreeTypeSec <Pos> // Security of this filearea
<Pos> is a value between 1 and FreeBlockSize
<Len> tells File Wizard how many bytes a certain variable
uses in the structure
<P or C> tells File Wizard wether it is an so called "Pascal
String" = "P" or an zero-terminated string = "C"
I want to explain you the use of this statements with a small
example. This structure is used by SuperBBS:
=========================================================================
FLSearchRec = Record (* FLSEARCH.BBS *)
Name: String [60];
Directory: String [79];
Security: Integer;
Flags: Flagtype;
PFilesSec: Integer; { Not yet used }
PFlags: Flagtype; { Not yet used }
Attrib: Byte;
Age: Byte;
ListName: String [67];
ExtraSpace: Array [1..30] Of Byte;
End;
=========================================================================
Now you have to calculate the byte-positions for each variable:
Name:String[60] starts at position 1, and has a length of
61 bytes (60 chars + 1 length-char because
it's Pascal)
Directory:String[79] starts at position 62, and has a length of 80 bytes
Security:Integer starts at position 142 (62+80) and has a length of
2 bytes (Integer/Word = 2 Bytes)
So you can define following parameters:
FreeTypeDesc 1 60 P
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 9
════════════════════════════════════════════════════════════════════════════
FreeTypePath 62 80 P
FreeTypeSec 142
You see, it's quite difficult to define an own structuretype to include
some rare used BBS softwares. If you're not familiar with programming,
please contact some of your friends to help you with this problem.
- Real_Areas
This allowes you to display the unused areas of RA 1.11
or ProBoard.
- MULTILINESTRING " >"
MULTILINESTRING " +"
MULTILINESTRING " |"
In order to handle multi-line descriptions correctly, File Wizard
needs to know the characters such descriptions starts with. If you
use SuperBBS, these characters consist of a <space> followed by a
<bigger than>, as it is shown above. In order not to "lose" any
spaces, these characters should to be put into quotation marks.
There 10 differentdefinitions possible, but the first should be
the standard definition of your mail box.
-DEFAULT_GROUP 0
To which group a new area should be added automatically. Each area
HAS TO BE connect to one at least one group, cause it won't be
shown in any filelist.
To work with different groups, you should create different CTL-files,
for example
GROUP 1 ALLFILES.CTL
GROUP 2 SORT1.CTL
GROUP 3 SORT2.CTL
GROUP 4 WINNET.CTL
*** ATTENTION ***
Please never name a CTL file "WIZARD.CTL", cause your original
would be overwritten.
- Ask_When_Delete
To prevent from deleting marked files, you can add this parameter,
so Wizard will ask before deleting.
- Own_Cursor
In some configuartion we've found that there are problems with
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 10
════════════════════════════════════════════════════════════════════════════
the cursur. If you have one too, please set this parameter active.
We've found those espacially in systems running with DeskView.
- HIGHLIGHT_MISSING
If you want File Wizard to mark missing files by showing them in
a different colour, this switch must be used.
If you do so, however, this will result in a considerable loss of
speed as the checking of all the files will take quite a lot of time.
- Search_AB
When File Wizard searches for available drives, you can enable
the search for floppydrives with the above command. Please consider
that the search of the floppydevices takes a long time !
- Directory_Search_String <Wildcard>
Whenever File Wizard scans the structure of a drive you can
speed up this search by setting above "wildcard" to "*.".
If you have directories _with_ extension i.e. SUBDIR.DIR,
you have to set the wildcard to "*.*"
- Make_BAK_Files
Should File Wizard create BackupFiles from your arealist files?
- Min_Free 1000
How much space should be left on the target drive before moving
files.
- Explode_Delay 10
This command determines the time you will have to wait for the
"exploding" windows to complete. The smaller you set this value,
the shorter it takes to complete the screens. As this totally
depends on your personal taste, this value was kept user-definable.
- Ex-Import_Path C:\
This parameter tells Wizard on which path exports and imports are
called from.
- DEFAULTAREAPATH E:\AREA\AREA2\
This should default to a subdirectory which is often looked into,
e.g. the path where user uploads are stored.
By defining this path, you will later be able to access this
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 11
════════════════════════════════════════════════════════════════════════════
subdirectory by pressing a single key in the ditor.
- MACRO_ALT-F?
This parameter is used to define macros for key combinations
<ALT-F1> to <ALT-F4>.
These macros are saved as "filename" (without path and extension,
the extension .MAC will be added automatically by File Wizard).
File Wizard will create a subdirectory called MACROS in its own
directory, where all these macros are stored.
Examples:
Macro_ALT-F1 MACRO1
Macro_ALT-F2 MACRO2
Macro_ALT-F3 MACRO3
Macro_ALT-F4 MACRO4
Macro_ALT-F5 MACRO5
Macro_ALT-F6 MACRO6
Macro_ALT-F7 MACRO7
Macro_ALT-F8 MACRO8
- External_List C:\UTILITY\LIST.COM
Path and name of your favourite ASCCI/Binary list programme which
will be used to view texts etc., when in the editor.
- ???Packer <path+name> [switches] [macros]
In order to enable File Wizard's decompression features you have
to insert the complete path, name and extension of your packing
programme here!
The macros listed below can be used to pass certain information
to this compression programme:
Macros:
~@ path and file name where all the tagged files are to be found
~D path and filename of the file at cursor position
~V path to current file area
~F path and name of current FILES.BBS (GENERIC & SBBS only)
~B description of current file
~E target directory
~A files to be extracted from archive
~X path and name of archive
Example:
ARJPacker K:\DB\PACKER\ARJ.EXE e -y ~X ~E ~A
will be expanded to the following commandline:
~X ~E ~A
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 12
════════════════════════════════════════════════════════════════════════════
/---------------\ /-----\ /-----\
ARJPacker K:\DB\PACKER\ARJ.EXE e -y C:\AREA1\TEST.ARJ C:\TEMP READ.ME
- PackCommand <Packername> [switches] [macros]
Inside File Wizard you can tag files from your harddisks an
copy this files into a new archive. Above command defines
the syntax for your prefered packer.
Following macros are allowed:
~D Path and Filename of the destinationarchive
~E Path of the files to pack
- PackDriveA / PackDriveB <switches>
File Wizard can pack whole disks into an archive and add
this file to the actual filearea.
There is only one macro available for this function, ~N.
~N specifies the path and name of the destination archive.
e.g.
PackDriveA PKZIP.EXE ~D -ex -rp -$A a:\*.*
PackDriveB PKZIP.EXE ~D -ex -rp ~N -$B ~N B:\*.*
- PackerExtension <extension>
According to the defined PackCommand, define the extension
which your packer will produce.
- GuessArchiveName
If this switch is defined, File Wizard will try tu guess the
Name of the destination archive.
- DefaultPackPath <path>
In which directory File Wizard should start, when "Tag and Pack"
is selected ?
- CTRL-F? <path+name> [Switches] [Macros]
Up to 8 external programmes can be called from File Wizard to
help maintaining the archives in file areas.
In order to pass necessary information to these programmes, there
are also a number of macros which can be used.
Macros:
~@ path and file name where all the tagged files are to be found
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 13
════════════════════════════════════════════════════════════════════════════
~D path and filename of the file at cursor position
~V path to current file area
~F path and name of current FILES.BBS (GENERIC & SBBS only)
~B description of current file
Example:
CTRL-F1 J:\MTA\MTA.EXE /@~@ /LVL0 /ZIP
will be expanded to the following commandline:
~@
/------------------\
CTRL-F1 J:\MTA\MTA.EXE /@C:\WIZARD\WIZARD.FLS /LVL0 /ZIP
- External_View <extension> <path+name> [Switches] [Macros]
File Wizard can automatically connect up to 50 different extensions
to certain external viewing or listing programmes. These external
programmes must be defined here with there complete path, file name
and extension.
These External_View parameters do indeed have a high priority! If e.g.
you insert the extension ARJ here, an external programme (e.g.
ArcMaster) will be called instead of File Wizard's built-in archive
management functions.
Macros:
~@ path and file name where all the tagged files are to be found
~D path and filename of the file at cursor position
~V path to current file area
~F path and name of current FILES.BBS (GENERIC & SBBS only)
~B description of current file
Examples:
External_View GIF C:\UTILITY\VPIC.EXE ~D /a
External_View BMP C:\UTILITY\VPIC.EXE ~D /a
External_View PCX C:\UTILITY\VPIC.EXE ~D /a
- Tag_Whole_Description
This command is used to determine if, when tagging a file, a multi-
line description should automatically be tagged, too (i.e. if it
exists). When you have descriptions that are longer than just a
single line, this can save a lot of work.
- Dos-Shell_Area
This command tells File Wizard which subdirectory to default to, when
jumping into a DOS shell. If this command is not active, you will
find yourself in the directory where File Wizard resides when jumping
into DOS.
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 14
════════════════════════════════════════════════════════════════════════════
- FREEDIR <path>
One of File Wizard's options allows you to decompress the current
archive into a certain subdirectory in order to test it. This
subdirectory is determined using this command.
For best results this should point to a RAM disk.
Attention: _ALL_ files in this subdirectory will automatically be
deleted when you return to File Wizard!
- FileDesc <filename>
In many archives a text file can be found, that contains the
description of the programme in this archive. File Wizard can extract
this text file and insert the description into the file list of
this file area. File Wizard can manage up to 20 different names
of those file description text files.
Common names of these text files are:
FileDesc FILE_ID.DIZ
FileDesc DESCRIPT.ION
FileDesc DESC.SDI
FileDesc FILEID.DIZ
- DC_LeftBracket <character>
When using download counters, this switch tells File Wizard the
character that is used for the beginning of the download counter.
In most cases this will be a "[".
- DC_RightBracket <character>
Character used at the end of download counters.
In most cases this will be a "]".
Following parameters are needed if you want to create a filelist of
your "old" files.
- OldStuffDate <Date>
Here you define the date for old stuff. If you define i.e 01.01.90,
all files older than that date will be added to the list.
- OldStuffGroups <Group>
Here you define the groups which should be searched for old files.
- OldStuffCount <Counter>
With this parameter you define the highest count of a file. Only
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 15
════════════════════════════════════════════════════════════════════════════
files below that count are added to the list. This only works, if
you work with download counters.
- SubAreaString "<string>"
File Wizard can manage file areas containing multiple sub areas.
The beginning of a new sub area is determined by one of lines in
the text that starts with the <string> defined above.
You can have as many sub areas as you like. When sorting the file
areas (from the main menue, or via command line swith /ASORT) these
sub areas are taken into account, and the alphabetical sorting will
only be done in each sub area and will not make a mess out of the
whole file area!
An example for sub areas in a FILES.BBS, using the SubAreaString " -"
=== FILES.BBS === Area DFUE-Utilities
- Terminal programmes
TELIX.ARJ Terminal programme
TELEMATE.ARJ Terminal programme
- External protocols
DSZ.ARJ External X/Y/Z Modem protocol
GSZ.ARJ External X/Y/Z Modem protocol with graphics
- BBS programmes
SBBS.ARJ SuperBBS
WME.ARJ Windowed Modem Environment
=================
This sub area option does allow you to keep your file areas tidy,
functional and clear.
- Make_Area_Header
If you want File Wizard to insert a header above the selected file
area when sorting, this command must be used. The contents of this
header can be changed in file WIZARD.HDR (registered versions only).
More information about area headers can be found later in this manual.
- Header_Left_Margin <value>
Determines the left margin where you want the header to start.
Minimum: 1.
When using WME as a BBS programme, this value _MUST_ be set to at
least 13!
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 16
════════════════════════════════════════════════════════════════════════════
- Header_Size <value>
Determines the number of characters per line in the header.
Depending on the information in the header, this should be set to
a value from 40 to 78!
- TOUCH_FILES_BBS
In SuperBBS there is an option to limit the search in the
fileareas (in NEWFILES scan) only to this areas, which contain
a FILES.BBS with a newer date. With the above option,
File Wizard will touch the date of a FILES.BBS with the newest
file in the filearea. This works only when sorting the fileareas !
- ALLFILES <path+name>
Defines the subdirectory where you want File Wizard to create and
store your allfiles list.
Example:
ALLFILES E:\BP\BIN\WIZARD\ALLFILES.TXT
- NEWFILES <path+name>
Defines the subdirectory where you want File Wizard to create and
store your newfiles list.
Example:
NEWFILES E:\BP\BIN\WIZARD\NEWFILES.TXT
- DESCFILE <filename>
Whenever File Wizard encounters a file with the name defined above
in one of your file areas, the contents of this file (which must be
a simple text file!) will be inserted in front of this file area in
your allfiles list, before the file descriptions.
E.g. this option can be useful when you have file areas where only
password protected file requests are possible: in such a case the
text inside this FILES.INF (see example below) should be:
"Only password protected file requests"
Example:
DESCFILE FILES.INF
- NewFiles_Age <value>
Defines how old (or better: new) a file must be to appear in your
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 17
════════════════════════════════════════════════════════════════════════════
newfiles list.
A common value would be 30 (days).
Example:
NewFiles_Age 30
- List_Leading_Space <value>
If your ALL/NEWFILES contain a downloadcounter, you can wrap the
long descriptions (multiline descriptions) to the right, in order
to make your filelist more attractiv.
i.e. if your downloadcounter looks like this [00], then set the
value to 5, so all long descriptions will be wraped 5 chars to
the left.
output: FILENAME.EXT 34753 01.01.1993 [00] Very useless program
which does really nothing
- FileListHeader <path+filename>
Path and name of a text file that will be inserted at the beginning
of your allfiles list (in most cases your logo or something similar
to that).
- Skip_Area_Header
If you add an area header (you'll find examples in the file HEADERS.ZIP)
you can force File Wizard to skip that header in the file lists.
So, if you set MAKE_AREA_HEADER aktive, this switch should be aktive
too.
- Minimum_Security <value>
If you want certain file areas to be excluded from your file lists,
you should use these parameters. Only those file areas will appear
in your lists, which have a security level between the Minimum_Security
and the Maximum_Security level.
- Maximum_Security <value>
Please refer to Minimum_Security
Example:
Minimum_Security 0
Maximum_Security 100
File areas with a security level of 101 or above will not appear in
your file lists.
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 18
════════════════════════════════════════════════════════════════════════════
- List_Group <Groups>
Here you define, which areas should be shown in the filelists.
- Make_Top_Downloaded_Files
When this switch is active, a list of your most frequently downloaded
files will be added to the end of your allfiles list.
This - of course! - will only work if you have and use download
counters in your file areas ....
- Top_List <path + name>
If you set this switch active, File Wizard an ANSI/ASCII file with
the most downloaded files. IMPORTANT : This only works, if you set
Make_Top_Downloaded_Files aktive too. Dont't add any extenstions!!
- Area_Statistic <path + name>
Same as above but creates an area statistic file, which will be add
at the end of your lists.
And now we reach a brandnew part of File Wizard. This is the possibility
with mailer, request- and announce functions. You need following para-
meter to work with.
- MailerType <Mailer>
This one defines the mailer type, you're using. At the moment
following mailer are supported.
MailerType D'Bridge
MailerType Frontdoor
MailerType InterMail
MailerType Binkley
- Requestpath <Password> <Path>
This switch defines the pathes you want to secure with a password.
If you're using Binkley, the first parameter is always the pass-
word. If you're using Frontdoor, this could be SECLIST so the path
will be added in your SECLIST.CTL
This parameter is also used by File Wizard to add the request
information in the top of each area. The texts which are used are
REQUEST.TXT and NOREQ.TXT and are freely definable.
Examples:
RequestPath GEHEIM D:\DATA\FIDO_NOD
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 19
════════════════════════════════════════════════════════════════════════════
RequestPath GEHEIM D:\DATA\VIR_NODE
RequestPath <NONE> J:\FREEFILES
- Magic <Magic name> <path + name> <optional password>
Here you define the Magics for the file requests. You may also use
wildcards. If you start the path definition with a !, File Wizard
will change the path to the newest filedate.
Examples:
Magic WIZARD J:\MAIL\WIZARD\WIZ*.*
Magic VPIC J:\MAIL\GRAFIK\VPIC*.* Grafik
If you're usinig the ! :
Magic NODEDIFF !K:\NODEDIFF\NODEDIFF.*
This will cause File Wizard to search the newest file, which fits
to the search string K:\NODEDIFF\NODEDIFF.* and also changes the
magic path.
- FDOKFILE C:\FD\FDOKLIST.LST <Groups> for unsecured sessions
- SECLIST C:\FD\SECLIST.LST <Groups> for secured sessions
- ALIASFILE C:\FD\ALIASFIL.LST for the magics file
These files are needed for Frontdoor. They are pure ASCII files,
which contains the request paths. With groups you can define
which groups should be listed.
- OKFile E:\BINKLEY\OKFILE.TXT <Groups>
If you're using Binkley you define with this paramter the file
which contains the request paths and the magics. The second
parameter defines the groups which should be added.
- OKFile_Header E:\BINKLEY\OKHEADER.TXT
The contents of this file will be put at the beginning of the
Binkley OK file. This is normally used to insert static request
paths and magics in the OK file.
- RequestGroup <Password> <Groups>
You can add a password to a whole group, i.e. :
RequestGroup Geheim 137F
All files which belongs to one of the the groups 1,3,7 and F, will
recive the request password GEHEIM.
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 20
════════════════════════════════════════════════════════════════════════════
- TrueNewFile <path + filename>
Using this switch, you'll be able to create a newfile list which
do not count with the date, you can add a name. Please do not add
any extension. This file be created with the command line parameter
/FBUPDATE.
- True_List_Group
Here you define the groups which should belog to the above definition.
Now here are the definitions you to announce new files via echo mail.
- FromName <Your name>
The name which will be written in the announce message.
- ToName <name>
To whom the message will be written.
- Subject <text>
The header of the message i.e. New Files available!!
- PKT_Path <path>
Where you want the .PKT files to be written in. Normally the
mailer inbound path.
-Toss_Semaphore <path + name>
Here you name the file, which causes a rescan of your tosser.
This semaphore will be set after an announcement.
- EchoTag <echo name> <AKA adress> <origin>
At this point you're allowed to name up to 100 echo areas, to
which the mail will be written.
Examples :
EchoTag REQUEST.GER 2:246/45 New files at PI
EchoTag PI.POINT 2:246/45 New files via File Wizard
- Announce <Echo name> <AKA adress> <origin>
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 21
════════════════════════════════════════════════════════════════════════════
If you like to announce new files (see also /FBUPDATE) in a mail
echo, you have to define here the echos.
Examples :
Announce BAD-ECHO 2:246/45 New files at PI
Announce PI.POINT 2:246/45 New files at PI via File Wizard
- Always_Reformat_Description
This statement aktivates a switch in File Wizard, which
reformats the descriptions of your fileareas to column 14.
Please do not use the command, if you have ASCII-logos
in your filedescriptions.
- Add_Download_Counter
When you are running AreaSort, File Wizard can add and/or
reformat existing Donwloadcounters in your filedescription files.
- Counter_Style <number> <Y or N>
Here you define the design of your download counter.
<number> specifies the number of numeric letters a counter can have
<Y or N> should File Wizard add leading zeros to the number above
- MaxDupeDifference <size in kB>
File Wizard can search your fileareas for dupe files. Dupechecking
will be done for filenames , excluding the extension. You can define
a maxmimum dupe difference size to exclude files from the dupelist,
greater then the specified value.
e.g. MaxDupeDifference 16
DATEI1.ARJ 200kB
DATEI1.ZIP 187kB found as dupe
DATEI2.ARJ 150kB
DATEI2.LZH 133kB no dupes
- MaxPKTSize <Größe in kB>
The maximum .PKT size your tosser can process.
- DuperReportTo <aka> <Ziel> <Name>
To whom you would like to send a dupereport via netmail.
e.g.
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 22
════════════════════════════════════════════════════════════════════════════
DupeReportTo 2:2494/17 2:2494/17 Oliver Weindl
DupeReportTo 2:2494/17 2:2494/17.1 Johann Weinzierl
- NoDupePattern <Dateiangabe>
Exclude which files/paths/trees from dupechecking. You can use
wildcards, with/without paths. If you place a /S at the end of the
line, all subdirectories will also ignored for dupecheck.
NoDupePattern e:\area\area1\*.*
NoDupePattern wiz*.*
- Adopt_Missing_Files
File Wizard can add missing files to your fileareas when running
Areasort. This option is quite powerfull. Wizard will add the
files, and will serach for descritpions inside the archives
(valid filenames for description files are described above).
If no description file is found, the Default_Description line
will be used.
- Default_Description <description>
(see above)
- AdoptReportTo <aka> <destination> <name>
This command is used post a report of all adopted files to
the specified person. This report will be sent via netmail
(a .PKT file will be created in your inbound directory).
e.g.
AdoptReportTo 2:2494/17 2:2494/17 Oliver Weindl
AdoptReportTo 2:2494/17 2:2494/17.1 Johann Weinzierl
- NoAdoptPattern <spec> </S>
In order to exclude certain files or directories or trees
out of the AdoptMissingFile function, you can specify a filename
(with wildcards) or a complete path (don't forget the wildcard *.*)
to exclude this files. If you add a /S at the end of the line
ALL SUBDIRECTORIES will be excluded by AdoptMissingFile !
e.g.
NoAdoptPattern E:\AREAS\AREA1\*.*
NoAdoptPattern DESCRIPT.ION
NoAdoptPattern J:\CDROM\*.* /S
- Wrap_Space <number>
Specifiy the column to which a WrapLine will be executed.
e.g.
Wrap_Space 56
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 23
════════════════════════════════════════════════════════════════════════════
All words, which will overlap column 56 will be pushed
to the next line.
- FileList_NoKeyInfo
Registered Users are capable of hiding the KEY-info at
the bottom of filelists.
- UpDate4DOS
If you activate this switch, File Wizard will always
save a DESCRIPT.ION file to the actual filearea, when
saving a filearea.
- CDROMStylePaths <Path> [/S]
This parameter defines the paths, where special cdrom style
files.bbs files reside. This special form of files.bbs files
is only supported by ProBoard (May '94). The format is following:
FILENAME.EXT <Bytes> <Date> Description
+description
+description
File Wizard deletes this additional informations when reading
the files.bbs file, and will add this values when saving it
back to disk. So you always have aktual values in your area
files !
With the command /S a complete directory tree will be selected.
Important: You have to define the path, where the files.bbs
files reside, not the archives themselves !
- GenerateTimeSlices
If you are running File Wizard in multitasking environment,
you can activate timeslicing with this switch. Only multitasker
which support INT 2F timeslicing are supported !
Windows (NT), OS/2, DesqView etc...
- Temporary_Filebase <path>
When creating filelists with the /@FLIST.CMD option, File Wizard
creates a temporary filebase in order to achieve higher performance.
If you are working in a LAN environment you can point the directory
to a faster medium e.g. local harddisk or (if it is big enough)
a ram-disk.
- Translate <drive [+path]> <drive [+path]>
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 24
════════════════════════════════════════════════════════════════════════════
If you are running in a LAN environment, it could happen
that some drives are changed. With the translate commando
you can change this drive letters (and paths!) to other
drive letters (or paths).
e.g. the area-paths of you bbs are configured as :
J:\MAIL\AREA1
J:\MAIL\AREA2 etc...
and File Wizard only can access this areas under
K:\MAILBOX\MAIL\AREA1
K:\MAILBOX\MAIL\AREA2
With "Translate J: K:\MAILBOX" you can tell File Wizard to
change all area-paths beginning with "J:..." to "K:\MAILBOX...".
File Wizard can handle up to 20 different translation commands.
- ???UnPacker <Pfad+Name> [switches] [macros]
To use the built in archive conversion routines, you have to specify
a valid extractcommand for each packer. Please notice to add
all switches, so that directories in an archive will be extracted too !
Macros:
~@ path and file name where all the tagged files are to be found
~D path and filename of the file at cursor position
~V path to current file area
~F path and name of current FILES.BBS (GENERIC & SBBS only)
~B description of current file
~E target directory
~A files to be extracted from archive
~X path and name of archive
Example:
ARJUnPacker K:\DB\PACKER\ARJ.EXE x -y ~X ~E ~A
will be expanded to the following commandline:
~X ~E ~A
/---------------\ /-----\ /-----\
ARJUnPacker K:\DB\PACKER\ARJ.EXE x -y C:\AREA1\TEST.ARJ C:\TEMP READ.ME
- VirusScan <path+name> [switches,macros]
The extratec files of an archive can be checked with up to 10
different virus-scanner.
Macro ~P stands for the path, where the files are placed.
e.g.
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 25
════════════════════════════════════════════════════════════════════════════
VirusScan J:\MTA\SCAN.EXE ~P /NOMEM /NOPAUSE /E
- UnwantedFile <filespec>
If you don't want to have advertisments of other BBS's in
your archives, you can tell File Wizard to delete this
files before creating the new archive.
e.g.
UnwantedFile WORKSHOP.*
UnwantedFile JonDoe.*
etc...
- AddFile <filename>
Specify a filename which should be added to the new archive.
e.g.
AddFile J:\WIZARD\LOOKME.COM
- FAttachMsgDir <path>
It often happens, that a file is combined with a netmail, a so called
fileattach. In order to keep this fileattach up2date, File Wizard will
look for such netmails and change them to the new archive-type.
TIC files which are produced by severel TIC echo managers will also
be updated automatically, when they are placed in the same directory
as the archive.
e.g.
FAttachMsgDir K:\FD\NETMAIL
- ConvertToPacker <path+name, switches, macros>
This defines the commandline, which is used by File Wizard to add
the extracted and scanned files to the new archive. DOS-pipes etc.
are also supported, so if you want to have an archive header in
the new archive, you have to do this in this commandline.
e.g.
ConvertToPacker K:\DB\PACKER\PKZIP.EXE -a -ex -z
~X ~A < J:\WIZARD\ZIPHDR.TXT
(please write this in _one_ line,
i just haven't the place for it ;-)
- PackerExtension <Extension>
Which extension will the used packer produce. For the above example
it would be ZIP:
PackerExtension ZIP
- AddFileID <filename>
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 26
════════════════════════════════════════════════════════════════════════════
If there is no descriptionfile in the archive (see "FileDesc"), then
you can tell File Wizard to create such a file in the new archive.
The description is taken out of the actual filearea description file.
Please notice: File Wizard doesn't know, wether there is a valid
description of this archive in your filearea. It could
happen, that he adds a "New file added ..." as
descriptionfile !
e.g.
AddFileID FILE_ID.DIZ
- ScreenSaver <time in seconds>
This is the time File Wizard willw ait before activating the screen-
saver in edit-mode. If you specify 0 seconds, the screensave will be
disabled.
e.g.
ScreenSaver 300
Attention: The screensave is a VGA-mode routine, so if you are
running e.g. a multitasking environment, don't
activate the screensaver, it could produce trouble.
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 27
════════════════════════════════════════════════════════════════════════════
4. Menue choices
4.1. Main menue
4 different menues are available from the main menue:
- File Area Maintenance
self explaining, at least I hope so!
- Make Filelists
Your allfiles and newfiles list will be created. This option can
also be triggered via command line switches, which means that these
files can be created when you call File Wizard from a batch file.
Example: WIZARD /FLIST
optional parameters :
/C<filename> switch to another areadefinition in
FLSEARCH.CTL style
/A<filename> path and name of your ALLFILES-list
/N<filename> path and name of your NEWFILES-list
/MINSEC<value> minimum security level
/MAXSEC<value> maximum security level
if you miss one of the above switches, the defaults from the
WIZARD.CTL file will be used.
You also can use a command file for this operation:
WIZARD /FLIST /@<filename>
the structure of this command file :
<name of .CTL file> <switches> <switches> <switches> ...
The name of a .CTL file is the path and filename for a FLSEARCH.CTL
style area control file (see BBSTYPE GENERIC in WIZARD.CTL)
You also can use <DEFAULT> for the bbs configuration defined
in WIZARD.CTL. This first statement in the line MUST exist !
Following switches
are supported: /A<filename> name of the allfiles-list
/N<filename> name of the newfileslist
(use /N alone for no newfiles-list!)
/MINSEC<sec> minimum security
/MAXSEC<sec> maximum security
/G<groups> groups which should appear in the list
/H<filename> name of an alternate headerfile
/CHECKDUPE run the dupechecker for the specified
list
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 28
════════════════════════════════════════════════════════════════════════════
Example :
<DEFAULT> /Ac:\allfiles.fls /N /MINSEC200 /G04AB /Hc:\header.txt
- Sort Fileareas
Your file areas will be sorted (available from batch files, too).
Example: WIZARD /ASORT
Multi-line descriptions and sub areas are taken care of, as decribed
previously.
- FileBase Init
Same function as /FBINIT
- FileBase Update
Same function as /FBUPDATE
- Create OldStuff
Same function as /OLDLIST
- Delete OldStuff
Same function as /DELETEOLDSTUFF
- Perform KeepLatest
Same function as /KEEPLATEST
- Write FILES.BBS
This function is only accessable for RA 2.0x user. Here
you can create a FILES.BBS file for each filearea in the
RA filebase. The FILES.BBS file will be placed in the
archive directory of each filearea.
4.1.2 The area selection
Here you find the file areas of your BBS configuartion. Use your
cursor keys to move around. By using ENTER, you'll jump into
edit mode and you're able to edit the current FILES.BBS.
File Wizard has implemented a quich search function. So if you
know the file area number, you an just type it and Wizard jumps
to the selected area or you can enter a singel character. The number
or the characters you typed, will be diplayed at the bottom of the
screen. If you specified a DEFAULTPATH, you can can jump with F9
directly to that area. That's normally your new files path. You
find help with F1.
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 29
════════════════════════════════════════════════════════════════════════════
4.2 Command line parameters
In normal cases you will run File Wizard in batch mode too. To do
that, there are different paramaters available.
4.2.1 Alternate Area-Config /C <filename>
Using this parameter you can change from your normally used WIZARD.CTL
to another, which should be GENERIC alike. This one has the same
structure of a FLSEARCH.CTL
<path> <security> <description_with_underscores>
C:\DOS 5 This_is_my_DOS_area
J:\GAMES 10 This_is_my_games_area
4.2.2 Groups /G<groups>
There is at least one group for each file area. Possible groups are
0 1 2 3 4 5 6 7 8 9 A B C D E F. If you like to do special things
you're able to use a selection via groups. With this parameter you
can override the defined groups in WIZARD.CTL.
Groups in File Wizard are treated like the Flags in common
BBS softwares. If you define e.g. group 8 to all areas which
are related to "Gaming etc.", you can activate all functions
of File Wizard especially for all "Gaming Areas" by assigning
the function to group 8.
Examples
WIZARD /ASORT /G13A (only groups of 1, 3 and A will be sorted)
WIZARD /FLIST /G1 (creates a list of all areas which belong to the
group 1)
4.2.3 Creating file lists /FLIST
The parameter find in the main menue is also available in command
line mode. There are some additional switches, to override the
WIZARD.CTL.
Optional switches:
/C<file name> use another area description (see 4.2.1)
/A<file name> name of the Allfile list
/N<file name> name of the Newfile list
/MINSEC<value> Minimum security level
/MAXSEC<value> Maximum security level
/H<file name> name of an alternate filelist header
/DAY<number> how olld may a file be (in days) to appear
in the newfileslist
If you do not enter one of the above switches, File Wizard will use
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 30
════════════════════════════════════════════════════════════════════════════
those you entered in your WIZARD.CTL.
But there's another switch available:
/FLIST /@<file name>
Here you can name a file, which has following structure:
<path and name of a FLSEARCH.CTL file> <Allfiles-name> <Newfiles-name>
<Minimum security level> <Maximum security level> <Filelist header>
Example:
C:\BBS\FL1.CTL C:\BBS\ALLFILE1.TXT C:\BBS\NEWFILE1.TXT 0 200 C:\H1.TXT
C:\BBS\FL2.CTL C:\BBS\ALLFILE2.TXT C:\BBS\NEWFILE2.TXT 50 100
<DEFAULT> C:\BBS\ALLFILE3.TXT C:\BBS\NEWFILE3.TXT 0 700 C:\H2.TXT
C:\BBS\FL4.CTL C:\BBS\ALLFILE4.TXT <NONE> 100 300
Alle filelists which you define here, will be created by File Wizard.
You may use <NONE> as NEWFILES. This way there will be no newfile list.
If you do not name the last parameter (header), File Wizard uses the
header you defined in WIZARD.CTL
If you want to use the default area configuration, you can specify
the macro <DEFAULT> instead the path+name of the .CTL file (first
parameter in the line).
Since version 1.3 registered users can define an own design for
the filelists.
There are two new control files, in which this design is defined:
AFLSTYLE.CTL and NFLSTYLE.CTL
AFLSTYLE.CTL defines the lookout of a normal file, wheras NFLSTYLE.CTL
defines the design for a new file (was marked in the old way by a "*")
Following macros are allowed:
%N filename
%D date
%T timestamp of the file
%B size in bytes
%K size in kB (including a trailing "k" !)
%1 transfertime at 300 baud (im Format Min:Sec)
%2 transfertime at 1200 baud
%3 transfertime at 2400 baud
%4 transfertime at 9600 baud
%5 transfertime at 14400 baud
%6 transfertime at 16800 baud
%7 transfertime at 19200 baud
%8 transfertime at 28800 baud
%9 transfertime at 64000 baud
%# filedescription
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 31
════════════════════════════════════════════════════════════════════════════
All parameters (without %# !) can be followed by a "@" in order
to hold some place, if the string isn't as long as expected.
(see example below)
There can be up to 20 lines in each of the controlfile, but the last
line only should contain a %###... statement, because this line
will be used more than one times (if the filedescription is longer
than the defined lines !).
If there is a missing file, the string OFFLINE will be used instead
of the date when using %D. All other macros (except %N) will be
replaced by empty strings.
Example:
--= AFLSTYLE.CTL =----------------------------------------------------
%N@@@@@@@@@@ %K@@@ %D@@@@@@ %#######################################
%######################################
----------------------------------------------------------------------
--= NFLSTYLE.CTL =----------------------------------------------------
%N@@@@@@@@@@ %K@@@ %D@@@@@@ █ %#######################################
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█ %######################################
----------------------------------------------------------------------
4.2.4 Change your keyboard definitions /K
Most of the keys used in File Wizard are freely configurable. So you
can change everthing to fit your needs.
**** IMPORTANT ****
There could be problems if you're usen a keyboard driver like KDRIVE.
They use some other scancodes. So if you find that there occures
problems, you may change the keys via the /K parameter.
4.2.5 Exporting your area configuartion /X<filename>
By using this switch you can export a list of your areas in a
FLSEARCH.CTL like style (see 4.2.1). Additionally there will be
some files which you definded in WIZARD.CTL with the parameter
"GROUP".
4.2.6 Updating your mailer request paths
File Wizard is able to update your the requestpaths of your mailer.
This works with Binkley, FrontDoor, InterMail and D'Bridge.
To use this switch, there should be available some addiontional
informations.
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 32
════════════════════════════════════════════════════════════════════════════
D'Bridge : WIZARD /RPATH /E<path and name of the exporting configuartion>
To work with D'Bridge you first need to export the configuartion
with DB EXPORT DB.CFG. After the run with /RPath you have to im-
port the configuartion again with DB IMPORT DB.CFG.
FD, InterMail: WIZARD /RPATH /E<path to your FD/IM directory>
Binkley: WIZARD /RPath (no additional parameters needed)
4.2.7 File Wizard FileBase initialization /FBINIT
With File Wizard, you're able to have a newfiles list without
using the date. Do do that, File Wizard needs an own file base to
compare with your file areas. You create that list normally only
once by using the paramater /FBINIT.
4.2.8 Updating the FileBase /FBUPDATE
This parameter causes Wizard to compare the Wizard-FileBase with
your real filebase. This run could be up to 30 minutes, if you
have a big filebase.
The result of the run will be a list of all new files since the
last run. Additionally File Wizard may announce your new files
in one or more mail echos.
4.2.9 Creating an OLDSTUFF list /OLDLIST
This switch allows you to create a list with old files. Which
files count to "old", you already defined in WIZARD.CTL
All "old" files will be written in file called WIZARD.DEL.
This is pure ASCII file and can be edit, before really deleting
the files.
4.2.9 Deleting OLDSTUFF /DELETEOLDSTUFF
If you're ready editing the WIZARD.DEL, you are going to delete
the files via this switch. Alle files left in WIZARD.DEL will be
deleted and cleared also in your FILES.BBS.
4.2.10 Deleting program series /KEEPLATEST
This switch allows you to delete older version of programs which
are the same files, but have different version numbers. A real
good example is the Fido NODEDIFF, which comes up every week.
You may now inform Wizard only hold <value> in the area and deleting
the rest.
Let's make an example. You defined in WIZARD.CTL:
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 33
════════════════════════════════════════════════════════════════════════════
KeepLatest K:\SPEC\NODEDIFF.* 10
KeepLatest J:\GRAPHIC\VPIC*.* 5
Running File Wizard with the switch /KEEPLATEST will result as follows.
All files in the directory K:\SPEC which fits to the above specification
will be deleted, only the ten with the newest date will be hold.
In the directory J:\GRAPHIC there will be left only the newest 5 files,
which fits to VPIC*.*
5. File area editor
Explaining how to use a simple editor would be too much for this
manual, so let me just give you an overview of the standard
functions and keys:
Standard functions
- Cursor up/down Cursor up/down one line
- Cursor right/left Cursor right/left
- Pos1/End Cursor to first/last character of this line
- Page up/down Goto previous/next page
- CTRL-Pos1 / -End Cursor to first/last line of current page
- CTRL-Page up/-down Cursor to first/last line of entire text
- CTRL-Cursor-right/-left Cursor one word to the right/left
- F1 Bring up interactive online help
- F2 Save changes
- F9 Jump to default area (s. WIZARD.CTL)
- F10 Save, jump to choose area function
Macros and external programmes
- F5 Start/end macro recorder
- F6 Display loaded macro
- F7 Save current macro
- F8 Load previously saved macro
- ALT-F1 Load user-defined macro
- ALT-F2 Load user-defined macro
- ALT-F3 Load user-defined macro
- ALT-F4 Load user-defined macro
- ALT-F5 Load user-defined macro
- ALT-F6 Load user-defined macro
- ALT-F7 Load user-defined macro
- ALT-F8 Load user-defined macro
( These macros are defined in WIZARD.CTL! )
- CTRL-F1 Execute external programme
- CTRL-F2 Execute external programme
- CTRL-F3 Execute external programme
- CTRL-F4 Execute external programme
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 34
════════════════════════════════════════════════════════════════════════════
- CTRL-F5 Execute external programme
- CTRL-F6 Execute external programme
- CTRL-F7 Execute external programme
- CTRL-F8 Execute external programme
( These external programmes are defined in WIZARD.CTL! )
All the functions mentioned above cannot be changed!
The following commands, however, are user-definable, so only the function
is mentioned and not the corresponding keystrokes, as these are the user's
choice!
- Delete line
Deletes current line, all following lines go up one line
- Delete to end of line
Delete line from cursor position to end of line.
- Delete word left from Cursor
- Delete word right from cursor
- Mark/Tag a file
Tags current line. If this current line contains a file name, and if
additional description lines are found in the lines below, these lines
will also be tagged (if this option was enabled in WIZARD.CTL)
- Jump to next file beginning with "?"
- Tag all missing files
Compares files in this area with files in file list. All files which are
contained in the file list of this area, but which are not found in this
directory, will be tagged.
- Move tagged files
All tagged files will be moved to another file area. The resulting
changes will automatically be saved to the file list of this area.
If no files have been tagged, the file at cursor position will be moved.
- Copy tagged files
Similar to "Move tagged files", except that the tagged files are not
deleted in the "source" directory after they have been copied.
- Delete File
The file at cursor position _and_ its description in the file list will
be deleted!
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 35
════════════════════════════════════════════════════════════════════════════
- Delete all tagged Files
Be careful when using this.... All tagged files will be deleted in the
editor _and_ on your hard disk!
- Search Description
Searches a directory (as defined in WIZARD.CTL) for file lists and tries
to find a description for the current file there. Multi-line
decriptions are supported!
- Search Description for tagged files
The same as above, only that File Wizard will now try to find descriptions
for all tagged files.
- Tag all dupe files
All files that are containied twice in your file list will be tagged.
- Adopt all missing files
All files which are not contained in your file list, but which are found
on your hard disk, will be adopted to the file list.
- Untag all tagged files
Any questions about that???
- Sort a block
A whole block can be tagged choosing this function. After pressing
<ENTER>, this block will automatically be sorted (multi-line
descriptions are supported).
Attention: sub areas are _NOT_ taken into account here!!!
<ESC> will abort sorting.
- Copy tagged lines inside Editor
- Move tagged lines inside Editor
- Rename file at cursor position
The current file will be renamed in the editor and on your hard disk!
If you specify an invalid file name or the name of a file that already
exists, the file will not be renamed!
- View contents of an archive
Opens a list box and shows contents of an archive. You can select files
inside this archive and view them using the external list programme (as
defined in WIZARD.CTL).
This option will also execute the External_View programmes as defined in
WIZARD.CTL.
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 36
════════════════════════════════════════════════════════════════════════════
- Run a DOS-SHELL
Depending on your configuration of WIZARD.CTL, you will either find
yourself in the current directory or in the directory where File Wizard
resides.
- Extract Files to test-Directory
The archive is decompressed into the defined FREEDIR directory
(WIZARD.CTL), and a DOS shell will come up there to enable viewing
and/or testing of this archive. Typing "EXIT" will bring up File
Wizard again, and all files in this directory will automatically be
deleted.
- Extract Descriptions from File
Many archives contain text files with additional information about the
contents of this text file (e.g. FILE_ID.DIZ, DESCRIPT.ION, etc.).
File Wizard can look for these files (as defined in WIZARD.CTL) and
insert the descriptions into your file list.
- Extract Descriptions from tagged files
Same as above, but only for tagged files.
- Search for a text-string
Searches file list for a specified string
- Search again
Guess what....
- Copy Description to line below
This command can be useful, when a programme consists of several archives.
In such a case you can copy the description of one archive for all the
other archives.
- Insert GIF-resolution at cursor position
- Insert MOD-Descritpion at cursor position
- Touch current file
- Touch all tagged files
- Toggle Tag-Flag
All tagged files will be untagged and vice versa.
- Display MOVE-Buffer
Displays names of tagged files that are to be moved to another file
area. Maximum number of files that can be shown is 20.
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 37
════════════════════════════════════════════════════════════════════════════
- Delete tagged lines
- Exit File Wizard at once
- Import files
With this option you can import archives from any path. Just type in
the import-path, and tag the files you want to import in this area.
If there exists a FILES.BBS file in the import-path, the description
will be added to your filearea automatically.
- Export files
See Import files.
- Tag and Pack files
A very powerfull option, which allowes you to tag certain files from
your harddisk, and pack them into a new archive. Please refer to the
PACKCOMMAND definition in the WIZARD.CTL file.
- Tag files according to their filedate
It happens often, that you want to tag all files, which are older than
a certain age. This function allowes you to do this job very quick.
Just type in the date, and all files which are older/newer will be tagged.
- Edit fileattributes (RA 2.0x only !)
Here you can edit the special file attributes for RA 2.0x
So File Wizard becomes a complete alternative for the FILEMGR
program included in the RA 2.0x package.
6. Built-in macro recorder
This macro recorder can save and reproduce certain keystrokes or
combinations which are frequently needed.
Pressing <F5> starts recording a macro. All the keys that are pressed
now will be recorded. If you press <F5> again, the recording is finished
and you can now use this macro.
Pressing <F6> will then "play back" this macro.
!! Attention !!
Recording macros is only possible inside the editor, it is not possible
to change areas using macros!
Pressing <F7> will save the current macro to your hard disk. You will
be asked for a description of this macro and to specify a valid file
name. By pressing <F8> you can load any previously saved macro.
In addition to that you also have the possibility to define up to 8
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 38
════════════════════════════════════════════════════════════════════════════
macros for key combinations <ALT-F1> to <ALT-F8> in WIZARD.CTL.
Example (deleting download counters)
<F5> to start macro recorder
Search text: [
(Cursor now on left bracket)
<Cursor left>
<Delete word to the right>
<F5> End of macro recording
Now you can look for the next download counter by pressing <F6> and
delete it at once.
7. The header definition
The header above each filearea and each section in the filelist is
free definable. The headers are defined in two ASCII files, which
are placed in the File Wizard home directory.
Fileareaheader : WIZARD.HDR (here you define the header, which will
be placed above each filearea when you
start SortFileAreas.
Filelistheader : LWIZARD.HDR (Dthis header is placed above the filearea
in the FileLists. To avoid dupe headers
in your list, you have to place the
SKIP_AREA_HEADER statement in WIZARD.CTL
In order to keep the informations in the header variable, you have to
assign several macros in the headerfile. This macros will be replaced
by usefull values at runtime. A macro initates with a percent (%) sign.
Macrosummary:
%A Areanumber of the aktual area
%N Name/description of the actual area
%B Kilobytes of all listet files in area
%F Number of files in the actual area
%D Actual system date
%T Actual system time
%H Name of the newest file
In the LWIZARD.HDR file tehre exists an additional macro, which
represents large-font numbers. The syntax for this large-font
numbers is a bit more complicated than the simple macro set.
First you have to distinguish, wether the actual number stands
for a thousandth, hundredth, tenth or single position of the
actual area number. Secondly the large font set consists of
4 lines for each number. With the large font set you can display
the actual areanumber like the %A macro.
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 39
════════════════════════════════════════════════════════════════════════════
%C<position>-<line>## - position stands
for : * 1 = Thousandth
* 2 = Hundreth * 2 = Hunderter
* 3 = Tenth
* 4 = Single number
- Line: Each large font number
consists of 4 lines,
which have to be placed
in the header file.
Beispiel: %C1-1## stands for the first line of the "thousands-number"
of the actual areanumber at runtime.
Beispiel: %C4-2## stands for the second line of the "single-number"
of the actual areanumber at runtime.
Beispiel: %C2-3## stands for the third line of the "tenth-number"
of the actual areanumber at runtime.
If you have less than e.g. 100 areas, you can skip the thousandth and
hundredth numbers. So you can save much more place in the header.
In the LWIZARD.HDR file, the %N macro has some more features. You can
use this macro more then once in the headerfile. The contence of the
areadescription will be continued in the second %N-part, if the whole
description doesn't match in the first %N-part.
In order to format the macros at the right position in the header, you have
some additional signs to indicate a left, right, or centered display.
For this purpose, you have the signs *, #, and & available. This signs
have to be placed right after the inital macro, and represent the place
which will be used by the macro.
examples:
"Areaname : %N###################################" changes to
"Areaname : This is the UploadArea "
the format signs have the following meaning:
"#" : Text will be formated to the left
"&" : Text will be formated to the right
"*" : Text will be centered
examples:
"Areaname : %N&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&" changes to
"Areaname : This is the Upload Area"
"Areaname : %N***********************************" changes to
"Areaname : This is the Upload Area "
"Areaname : %N&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&" changes to
"Areaname : This is the Upload Area"
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 40
════════════════════════════════════════════════════════════════════════════
"Areaname : %N####################"
" %N####################" changes to
"Areaname : This is the Upload "
" Area "
Attention ! In order to redefine the headers, you have to be a
registered user of File Wizard. Otherwise, the header will be
overwritten by the default values.
8. Closing remarks
Finally I'd like to thank all my Beta testers very much for their more or
less annoying <grin...> remarks and bug reports.
Im especially grateful to Wolfgang Hanke, whose ideas are responsible for
an enormous part of File Wizard's functions.
And a "Thankx-a-lot" to Felix Mueller, who helped with the documentations.
9. Copyrights, trademarks etc. (i.e. the legal stuff)
PKZIP and
PKUNZIP are trademarks of PKWare Inc.
PAK is a trademark of NoGate Consulting.
ARC is a trademark of SEA inc.
LZH and LHarc is a trademark of Yoshi.
ARJ is a trademark of Robert K. Jung
MTA is a trademark of Rob Van Hoeven
GIF is a trademark of CompuServe Inc.
SuperBBS is a trademark of Risto Virkala and
Aki Antman
WME is a trademark of Jason Fesler
LoaraBBS is a trademark of ....
RemoteAccess is a trademark of Andrew Millner
ProBoard is a trademark of Philippe Leybaert
FrontDoor is a trademark of Jochim Homgrighausen
InterMail is a trademark of InterMail Sales Inc.
Binkley is a trademark of Bit Bucket Software
D'Bridge is a trademark of Chris Irwin
File Wizard was programmed in Borland Pascal 7.0. Additionally the
Turbo Professional Units, as well as the unit ZIPDIR (by Martin
Austermeier) were used..
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl
File Wizard 1.3 Page 41
════════════════════════════════════════════════════════════════════════════
Turbo Pascal is a trademark of Borland International
Turbo Professional is a trademark of TurboPower Inc.
────────────────────────────────────────────────────────────────────────────
(c) 1993,94 by Oliver Weindl