This is an old revision of the document!
Table of Contents
Importing FILES.BBS
MUTIL can import various formats of FILES.BBS into Mystic BBS using options configured in the supplied .INI file. If can also synchronize the file size/descriptions of existing files often useful when using a 3rd party TIC processor.
For more information on the general usage of MUTIL see the How to Use Mystic Utilities (MUTIL) section.
IMPORT_FILES.BBS Stanza Options
| OPTION NAME | EXAMPLE | DESCRIPTION |
|---|---|---|
| filesbbs | filesbbs=files.bbs | This option defines the filename of the files.bbs that the importer will look for. If this option is not defined, “files.bbs” will be used automatically. |
| uploader_name | uploader_name=Mystic BBS | This option defines the name used in the Uploader field in the database. If this option is not defined, “Mystic BBS” will be used. |
| update_files | update_files=false | If set to TRUE, the importer will compare the size of the file on disk with what is in the database. If the filesize is different, it will be updated along with the description in the file database. Enabling this option can add a significant amount of processing time to the import process. |
| delete_after | delete_after=false | If set to TRUE, the importer will delete the files.bbs file after processing. |
| desc_first | desc_first=0 | This option defines how the first line of the description is parsed. If set to -1 then the importer will not look for the first line of the description on the line that has the filename. If it is set to 0 then the importer will assume the description starts directly after the filename. If set to anything else, the importer will go to the column and copy any text on and after it as use that as the first description line. |
| desc_char | desc_char=| | This option defines the character that signifies an extended description line. A blank value means a space character. |
| desc_start | desc_start=3 | This option defines the column where the DESC_CHAR is found. If the DESC_CHAR is found in this column, then all text afterwards will be imported as an extended description line. |
Example Configurations
The following section shows various FILES.BBS formats and their .INI configuration that was used to successfully import each format. Only the “DESC_FIRST” “DESC_START” and “DESC_CHAR” options are significant to defining the format of the file, so other options are intentionally removed from the examples.
Format #1 (PCBoard, Others)
This FILES.BBS format has a fixed description on the first line at column 34, and each description line is determined by a pipe character at column 32. An example entry looks like this:
2DOV12.ZIP 511579 01-17-96 2Do Personal Task Manager v1.2d <ASP>
| Personal Task and Contact Manager for
| Microsoft Windows. Award winning Shareware.
The INI [Import_FILES.BBS] stanza for MUTIL would be configured like so:
desc_first = 34 desc_char = | desc_start = 32
Format #3 (GT Power, Others)
This FILES.BBS format has no description on the first line and each description line is determined by a pipe character at column 3. An example entry looks like this:
TEST1.ZIP 511579 01-17-96 | This is a test file description | And this is the second line
The INI [Import_FILES.BBS] stanza for MUTIL would be configured like so:
desc_first = -1 desc_char = | desc_start = 3