home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Carsten's PPE Collection
/
Carstens_PPE_Collection_2007.zip
/
T
/
TTP25A.ZIP
/
TIC2PCB.DOC
< prev
next >
Wrap
Text File
|
1993-10-31
|
26KB
|
593 lines
▀▀▀▀█▀▀▀▀ ▄▀▀▄ ▀█▀▀▀▀█ █▀▀▀▀█ ▀█▀▀▀▀█
█ ▀ █ █ █ █ █ █
█ ▀ █▀▀▀▀ ▄▀ █▄▄▄▄█ █ █▄▄▄▄▀
█ █ █ ▀▀▀ ▄▀ ▀▀▀ █ █ █ █
█ █ █▄▄▄▄ █▄▄▄▄▄ ▄█▄ █▄▄▄▄█ ▄█▄▄▄▄█
Version 2.5a
Copyright (C) 1992,93
by
Tom Carroll
All rights reserved
The Data Shop BBS
┌──────────┐
│ CLOSED │
└──────────┘
FIDO address (1:206/2607)
MAGIC FILE NAME: TIC2PCB
┌──────────────┐
│ INTRODUCTION │
└──────────────┘
Tic-2-PCB was written because I wanted a program that would be very easy to
configure, and that would move the new files I get from time to time off the
FIDO SDN networks to my uploads directory. I looked at the program called
TICK, but again, it was a program that required an extensive configuration
file, and it was very hard to understand the formatting of the directory
entries, hence, Tic-2-PCB was developed.
┌──────────────┐
│ DISCLAIMER │
└──────────────┘
This software is provided without any guarantee or warranty either expressed
or implied. I will not be held responsible for ANY damages that may result
in the use of this program. "ANY" means if you install it, run it, and it
eats your programs that you've been working on for 2 years without a backup,
IT'S NOT MY FAULT!!!
Tic-2-PCB software and this document are Copyright (C) 1992-93 by Tom
Carroll, All rights reserved.
┌──────────────┐
│ LICENSE │
└──────────────┘
This program is being released as FREEWARE. The source code will remain
the property of the author unless otherwise released by him.
You are free to use this version of the program without any cost of
registration. This however, may change at any time with a new version
release. (If this should happen, a one time registration fee will be asked)
No one may alter, modify, or reverse engineer Tic-2-PCB for any reason,
including but not limited to decompiling-compiling, patching, or
disassembling.
You may freely distribute & copy this program for others subject to the
above restrictions and the following:
■ Tic-2-PCB is copied in unmodified form including this file.
■ There is no charge for copying except for the cost of disks.
■ Tic-2-PCB is not included in another software package without
the express written permission of Tom Carroll.
┌──────────────┐
│ SUPPORT │
└──────────────┘
If you should find any problems with this program, or you have any requests
or recommendations, you may reach me on the support BBS, or at the FIDO
address listed on the front cover. I may also be reached in the PCBNET
FIDO echo or on SaltAir.
Tic-2-PCB Supports .TIC files from most file echo systems.
Tic-2-PCB v2.5a Page 2
You may log on to the support BBS by using the following info:
First Name: DATAWARE
Last Name: SOFTWARE
Password: SUPPORT
The support BBS information may be found in the PROGRAMS.DWS file found
within the TTPnn.ZIP archive.
┌──────────────┐
│ THE AUTHOR │
└──────────────┘
This was my first public program.
I have been writing in BASIC for about 7 years, and I really like it, but
I've been planning on taking a course in "C", but still haven't and am
working on converting the program to Turbo Pascal 7.0.
I am active duty in the U.S. Coast Guard, and have been a "Sysop" for
their computer systems at my duty stations for about 7 years.
I would like to thank my wife, who always says "Are you coming to bed, or
are you going to keep PLAYING on that computer?"
┌──────────────┐
│ FILES │
└──────────────┘
Files included in this archive:
CONVERT.EXE - Converts v2.2 config file to v2.3 binary format
FILE_ID.DIZ - Description file for Tic-2-PCB
PROGRAMS.DWS - List of Dataware Software products
READ.ME - Last minute info (not always included)
SAMPLE.ERR - Sample error file
SAMPLE.LOG - Sample log file
TIC2PCB.DOC - This manual
TIC2PCB.HIS - Tic-2-PCB's metamorphosis
TIC2PCB.EXE - The heart of the game...
TTPCFG.EXE - Tic-2-PCB Configuration editor
I originally compressed this program as TTPnnn.ZIP, but it may be
compressed with any other archive program you wish to use as long as all
the above listed files are included within the new archive. For your
protection I've compressed this archive with the -AV stamp. The -AV
stamp should look like this:
Authentic files Verified! # NAP248
Tom Carroll-The Data Shop
The latest version will always be available on the support BBS using the
magic filename of TIC2PCB or in the Dataware Support conference.
Tic-2-PCB v2.5a Page 3
Sometimes, there may be a need for debug code to be released. This code is
used to track down specific problems which aren't normally encountered on
my system. I have a 386/40-dx w/5megs of RAM, a 386/25-sx w/1meg of RAM,
and DOS 5.0, which should be pretty standard and generic, but sometimes this
doesn't present an optimal testing environment, so please, if you're having
problems, and debug code is available, feel free to FREQ TICDEBUG from the
support BBS, or if you're registered on the support BBS call and download
TIC2PCB.ZIP from the Dataware Support conference. If it's not available,
then you're the first person that has reported a problem, so please leave me
your specifics, and also your config file so I may be able to trouble shoot
the problem.
Now, on with the installation...
┌──────────────┐
│ SETUP │
└──────────────┘
First, if you're presently using version 2.2, you may use the included
CONVERT.EXE program to convert your old config file to the new binary
configuration file format. The command line syntax is:
CONVERT /TOLDCFG.FILE /BNEWCFG.FIL
Now execute the included configuration program. When the program
begins, if the specified configuration file doesn't exist, it will ask
you if it should create it.
There will be five options from the main menu. Here is an example of
what you should see:
╔═════ Main Menu ═════╗
║ ║
║ Default Information ║
║ Switches ║
║ Area definitions ║
║ Quit - No save ║
║ Quit & Save ║
║ ║
╚═════════════════════╝
You can use the arrow keys to select the option you want, and then press
<enter> to bring up the next menu.
The defaults menu should look like this:
Tic-2-PCB v2.5a Page 4
╔═ Defaults ═══════════════════════════════════════╗
║ NodeNumber: ║
║ PCB.DAT: ║
║ Inbound DIR: ║
║ Default DOS: ║
║ Default PCB: ║
║ Default Msgs: ║
║ Download.Txt: ║
║ Test file: ║
╚══════════════════════════════════════════════════╝
Press F1 for help
The NodeNumber is the FIDO compliant node number that you will be
using. This number will also be displayed in the message body if
you announce file arrivals.
The PCB.DAT field is the location of your PCBOARD.DAT. This is only
the path location of it, and not the file name. PCBOARD.DAT is assumed.
The Inbound DIR is where your incomming archives & .TIC files are stored
upon receipt.
The Default DOS field is the location where you want UNKNOWN area files
imported (if you allow them).
The Default PCB field is basically the same, but it will need to have
the full path and file name of the PCBoard(tm) directory listing.
The Default Msgs field is where the file arrival announcement messages
will be placed for all UNKNOWN area files (if you allow UNKNOWN's).
The Download.Txt entry requires the full path/name of your DOWNLOAD.TXT
file. If this is left blank, the file will not be updated.
Test file is the name of a batch file to be called after processing any
inbound files. If you preceed this file name with an at '@' symbol
Tic-2-PCB will create a list file and pass it as parameter %1.
To exit from this menu back to the main menu press <esc>.
╔════════ Switches ════════╗
║ DIR File date: Current ║
║ Import type: Move ║
║ Duplicates: Overwrite ║
║ .TIC files: Kill ║
║ Logging: On ║
║ Rcvd by line: On ║
║ Diz Checking: On ║
║ CRC Checking: On ║
║ Unknown Areas: On ║
╚══════════════════════════╝
These switches are setup as a default. You may change them by pressing
<enter>.
Tic-2-PCB v2.5a Page 5
DIR File date - Current or Archive. If set to Current the system date
will be used for the PCBoard(tm) directory listing, otherwise it will
use the archives file date stamp.
Import type - Move or Copy. If move is selected the archive will be
renamed to the destination directory. If Copy is selected, then the
file will be copied which in turn would leave a copy in the inbound
directory too.
Duplicates - Overwrite, Kill, or Hold. This determines how duplicate
archives are handled. If Overwrite is selected the older archive will
be overwritten using the newly arrived file. If Kill is selected, then
the newly arrived archive will be deleted and not imported. If hold is
chosen, then the .TIC file will be renamed to TKnnnnnn.DUP and the
archive will remain in the inbound directory.
.TIC files - Keep or Kill. Kill is recommended, but if you are
forwarding files to other systems, you may wish to use the Keep option.
If you use the Keep option, make sure the .TIC files are moved to another
directory before the next call to Tic-2-PCB. (The files will be renamed
to TKnnnnnn.xxx, depending on the errors encountered)
Logging - Boolean. Either ON or OFF. TIC2PCB.ERR will still be created
should an error occur.
Rcvd by line - Boolean. Either ON or OFF. Do you want the file
description appended with "Received by: Tic-2-PCB MM/DD/YY From:AREANAME
DIZ checking - Boolean. Either ON or OFF. If this is turned on, all new
archives will be checked for FILE_ID.DIZ & DESC.SDI files.
CRC checking - Boolean. Either ON or OFF. If on, it will compare the
CRC-32 included in the .TIC file to the archives total CRC-32 value. This
ensures no tampering has occured while in transit.
Unknown Areas - Boolean. Either ON or OFF. If you turn this on, any files
received from an UNKNOWN (undeclared) area will be imported into the
default DOS & PCB directories, otherwise the accompanying .TIC file will be
renamed to TKnnnnnn.UNK and the archive will not be imported.
╔═ Areas ═════════════════════════════════════════════════════════════════╗
║ 1) 11) 21) 31) ║
║ 2) 12) 22) 32) ║
║ 3) 13) 23) 33) ║
║ 4) 14) 24) 34) ║
║ 5) 15) 25) 35) ║
║ 6) 16) 26) 36) ║
║ 7) 17) 27) 37) ║
║ 8) 18) 28) 38) ║
║ 9) 19) 29) 39) ║
║ 10) 20) 30) 40) ║
╚═════════════════════════════════════════════════════════════════════════╝
Press F1 for help
Tic-2-PCB v2.5a Page 6
Just select the area number to edit, and press <enter> to bring up the
area definitions menu, or press escape to return to the main menu. If
you enter an area out of numerical order, the program will renumber it
to the next available number after the highest defined conference #.
╔═ Area definitions ═══════════════════════════════╗
║ Area Name: ║
║ DOS Directory: ║
║ PCB DIR Name: ║
║ Area Password: ║
║ Message Base: ║
║ Send Msgs To: ║
║ Msg Security: N ║
║ Echo Msgs: N ║
╚══════════════════════════════════════════════════╝
The area definitions menu will appear, and all you need to do is fill in
the information requsted.
Area Name - This is the actual FIDO assigned area name for the file echo.
DOS Directory - This is the location the area files are tossed to.
PCB DIR Name - Is the name of the PCBoard directory to be updated with
description and file information.
Area Password - This is your assigned Raid password used on your hub.
Message Base - Location & name of the message base to send announcement
messages to.
Send Msgs To - The name of the individual that the messages will be
addressed to.
Msg Security - This is either set to "P" for private or "N" for none.
Echo Msgs - Boolean. Either YES or NO.
After filling out the form, you can press <esc> to exit back to the
Areas menu.
┌──────────────┐
│ OPERATION │
└──────────────┘
Now, all you need to do is execute TIC2PCB.EXE and give it the config file
name. (i.e. TIC2PCB MYCONFIG.CFG)
There are 5 command line switches that may be used by Tic-2-PCB.
/BELL - will turn off the bell when an error is encountered.
/DEBUG - Should Tic-2-PCB begin operating incorrectly, you may use this
switch to create a very extensive log file showing exactly where
the code is. This file needs to be copied to another location or
renamed before the program is executed again. The file name will
be TIC2PCB.DBG, and you will need to send me that, your config file,
the offending .TIC file(s), and the archive or any other files that
it should mess up (including message bases and DIR files).
/M - will force Tic-2-PCB's output routines into Monochrome mode.
/NDX - will turn on the old pre v15.0 message base index files.
Tic-2-PCB v2.5a Page 7
/PO - is for version 15.0 or later indexed message bases. This is the
Packout switch that will add an extended header to the message
which will tell PCBoard when to packout the message. The format
of this switch is /PO#. (i.e /PO27 will pack out in 27 days)
/VER - If you want to know what the latest code is that you're running,
you can specify a command line of TIC2PCB /VER which will show
the program name, version number, and compile date.
If a file is specified for the DOWNLOAD.TXT file, Tic-2-PCB will update it
with the following entry:
(U),TIC-2-PCB AREANAME,MM-DD-YYYY,HH:MM,FILENAME.EXT,L,0,9600
This entry just tells your File Profilers that an upload by Tic-2-PCB of
a file from AREANAME on that date & time consisted of FILENAME.EXT, using
the L protocol (I used the L protocol to signify a local upload) with no
errors, with an average speed of 9600 CPS.
There will be one log file created if it doesn't exist (should you not
disable that option) called TIC2PCB.LOG. It will be in the following
format:
--------[ Processing {INBOUND} - MM-DD-YYYY - HH:MM:SS
--------[ Process complete - MM-DD-YYYY - HH:MM:SS
--------[ Process Aborted! - MM-DD-YYYY - HH:MM:SS
A - Area unknown for file specified
Renamed .TIC to .UNK
C - CRC check sum error on archive
Renamed .TIC to .CRC
D - FILE_ID.DIZ is longer than 450 bytes - Not used
E - Error encountered in .TIC file
Renamed .TIC to .ERR
F - File doesn't exist
Renamed .TIC to .FIL
P - Incorrect password for AREA
Renamed .TIC to .PWD
S - DESC.SDI longer than 85 bytes - Not used
X - A duplicate file was encountered
<action taken> (either renamed .TIC to .DUP, killed, or
overwrote)
√ - Process successful. File imported properly
I recommend deleting this file, or not using it at all if you move or
receive a lot of files through FIDO. In any case, should you use it, be
sure to check the size of it every now and then. If you don't want the
logging, just select Logging Off in the config file Switches menu.
When Tic-2-PCB has executed successfully, it will exit with an errorlevel
set to 0. If an error is encountered during execution, it will exit with
an errorlevel of 1, and create a file called TIC2PCB.ERR. If it should
encounter an unexpected error, it will exit with an errorlevel set to 2.
Tic-2-PCB v2.5a Page 8
When a file is received that isn't in any of your AREA declarations, and
you have turned UNKNOWN areas on in the config file it will be imported
into the default directory and DIR file listed in lines Default DOS &
Default PCB within the Defaults section of the config program. The
"Received by: Tic-2-PCB xx-xx-xx from AREANAME" in the default DIR
listing will show the area it was actually received from.
Here is an excerpt of my RUN.BAT file which shows how I process my tick
files:
CD \FD
REM --------- CHECK FOR NEW FILES ---------
IF TIC2PCB TIC2PCB.CFG <options>
That's it, you shouldn't have to do anything else, but fire it up and see
how easy and quick it actually is.
┌──────────────┐
│ NOTES │
└──────────────┘
Please remember that the speed factor will be reduced if you have logging,
check for DIZ, check CRC-32 or all of these turned on, otherwise
Tic-2-PCB will import approximately 1.5 files per second if it is only
moving the archives from one directory to another on the same drive.
You may find several TICK files within your inbound directory with the
following extensions:
TKnnnnnn.DUP - A duplicate file was encountered in the destination
import directory. You have the Duplicates switch
set to hold, so the .TIC file was renamed to .DUP
and the archive was not imported. This is an
oportunity to check the .TIC files path & seen-by
lines to determine where the break down is that is
causing duplicates to loop back through the system.
TKnnnnnn.ERR - An error was encountered within the .TIC file.
This will be caused by trashed files, or a non-
standard format for the .TIC file. The archive
is NOT processed into the system. Please notify
me if you have these appear on your system.
TKnnnnnn.FIL - The listed archive within the .TIC file doesn't exist.
This could be the cause of another file processor
moving/deleting the archive before Tic-2-PCB processed
it into the system, or you have the KEEPTIC option
turned on in your config file and Tic-2-PCB is re-
processing the .TIC files.
TKnnnnnn.PWD - An incorrect password was encountered within the .TIC
file. The archive was not processed into the system.
This could be caused by an incorrect password listed
within the config file for the AREA name, or you have
changed your RAID password on your host node.
Tic-2-PCB v2.5a Page 9
TKnnnnnn.CRC - An invalid check sum was found in the .TIC file for
the listed archive. The archive was not processed
into the system. This will be caused by someone
changing the archive format, or tampering with the
original archive release.
TKnnnnnn.UNK - An unknown AREA was found in the .TIC file for the
listed archive. The archive was not processed into
the system. This will be caused by receiving a new
file echo and not having an AREA definition for it,
or not having the UNKNOWN option turned on in the
config file.
If you don't want to download the entire distribution archive, you may
look for the archive TTPnnnU.ZIP on the same BBS that you downloaded this
file from. The upgrade archive will have the same number as this one,
except it'll have a U after the version number.
┌──────────────┐
│ DONATIONS │
└──────────────┘
This version of software is free for the taking, but if you feel compelled
to make a donation, you may send whatever contribution that you feel is
reasonable to the following address:
Dataware Software
405 Dunes Street
Morro Bay, CA 93442
┌────────────────┐
│ACKNOWLEDGEMENTS│
└────────────────┘
Thanks go out to:
Clark Development for creating such fine software.
Gary Meeker for his great documentation on the new v15.0 message indexes.
I would like to thank the Tic-2-PCB users and the Beta team. Without
their help, this program would not be what it is today.version would not
have made it out the door with the quality of work that is expected of
Dataware Software.
If you see these guys around take a moment to thank them for assisting
me in the production of a nice utility that ALL PCBoard(tm) sysops may
use and enjoy!
Fred "Buz" Busteed - The Arcs and Sparks BBS (1:372/46)
Fran To - Orient Express (1:372/6969)
Klaus Lamort - The French Connection (1:343/45)
Tim Fierro - The Racer's Edge (1:138/165)
John Schreiber - The Thunderbolt BBS (1:274/13)
Tic-2-PCB v2.5a Page 10