home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Black Box 4
/
BlackBox.cdr
/
bbs_opus
/
util170.arj
/
CONFILE.DOC
next >
Wrap
Text File
|
1991-07-11
|
5KB
|
124 lines
CONFILE
Opus 1.70 files.bbs to files database converter.
When invoked, the following dialog is presented:
> This utility will convert the old style one files.bbs file
> per area to the new single filesbbs database
> Do you wish to continue? [Y,n]
Answer Y to continue, N to abort.
> Do you wish to include orphan files (files that are in an area,
> that don't have an entry in the files.bbs) [Y,n]?
Orphan files are those files which exist in an area, but they do not
have an entry in the files.bbs. Answer Y if you want them included,
N if you don't want them in the new datbase either.
> Counting the number of downloads and file requests is now supported
> Are you currently using a utility which supports this function? [Y,n]
>
> The count of downloads is usually added to the file description.
> It is usually at the beginning of the description, but it may also
> be at the end. It is usually delimited by () or []
> Is the counter at the Start or at the End of the description? [S,e]
>
> Enter the starting delimiter character - usually ( or [
>
> Enter the ending delimiter character - usually ) or ]
>
> The name of the person who uploaded the file is now also kept
> with the file. If you're currently using a utility that tracks
> uploaders, enter the exact text that is in the file descriptions
> that precedes the name of the uploader i.e. `Uploaded by'
> TEXT:
Enter the text here that CONFILE is to scan for in the file description
comments. Remember that it is case sensitive.
> You have selected the following options:
> Add orphan files to the database
> Download count is at start of description
> and is delimited by `(' and `)'
> Uploader search text is `Uploaded by'
> Are these options correct? [Y,n]
Only the option you selected will be displayed. If any of them appear
to be incorrect, and the questions will be asked again. You may also wish
to hit CTRL-C to abort the program.
CONFILE will create the new files in the directory specified by the
USES FILES statement in the BBS.CTL file. If the USES FILES was not
specified, the files will be created in the PATH SYSTEM directory.
If a BBS.PRM cannot be found to get those directory names, the new
files will be created in the current directory. See the section on
setting up an OPUS environment variable.
The new files are:
FILESBBS.DAT all the file info and descriptions
FILESBBS.NDX file name index
FILESBBS.ADX area number index
DELOLDF.BAT batch file to delete the old files.bbs files
CPYOLDF.BAT batch file to backup the old files.bbs files
For CD-ROM users, each file can have it's own directory pointer.
This allows files to show up in whatever area you wish. In order to
take advantage of this feature in the file conversion, insert the
full pathname of the file in front of the file name in the files.bbs
for the area you wish it to show up in. A normal files.bbs entry is:
AFILE.ZIP description
Edit this entry to look like:
P:\dir1\AFILE.ZIP description
and CONFILE will restore it to a normal entry, and save the directory
name, so Opus can find the file.
BTW, the same mechanism can be used when you want a file to show up
in more than one area, and you only need to store the file in one
place. This should save some disk space.
Another new feature has been added. You can now pick some point
anywhere in the files area, and all new files will be inserted there.
(So when user's want to see what's new, they don't have to go all the
way to the end of the area.)
This is the MS-DOS Utility File area:
> Latest Uploads:
(new files will be inserted here)
-------------------------------------------------
Archiving programs:
(the rest of the area files)
Confile, ofare, and opus-fam will scan the first character of comment
lines, and when the first > is found, set the HAS_GT flag, and record
the database position in insert_pos. When an @ is found,
the HAS_AT flag is set. I'm handling these flags so that
insert has a higher priority than hide. That way, when insert is
specified, the new files will be seen, and the ability to hide files
at the end of the area can still be used.
Since Opus 1.70 allows the system dat files and the user file to be
located in other than the Opus home directory, support has been added
to look up these paths in the Opus prm file.
Set up an environment variable labelled OPUS, and specify
the full pathname of the prm file, i.e.
SET OPUS=H:\OP170\BBS.PRM (if your environment space is cramped,
you may leave off the .PRM suffix, the program will add it).
BTW, Doug and I are making the OPUS environment variable
a standard for all the OPUS utilities. If you want the C source,
just ask.
If the OPUS environment variable is not set, the program will look
in the current working directory for USER.DAT and SYSMSG.DAT. If
either file is not found, it will then look for BBS.PRM and look
up the paths in there. If none of the above are found, the program
will fail.
John Valentyn 1:114/5@fidonet.org