home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_mail / tp280.arj / TICKPACK.DOC < prev    next >
Text File  |  1991-09-04  |  13KB  |  362 lines
  1.                                                             TICKPACK Ver. 2.8
  2.                                                             (c) 1991 K. Braun
  3.  
  4.     0. What's new
  5.  
  6.     TickPack now recognizes incomplete archives by storing the total size of
  7.     the archive in the header. Starting from version 2.5ß the format of the
  8.     archives has slightly changed, but TickPack will still recognize and
  9.     process archives generated by pre 2.5 versions. Suggested by Chris Lueders.
  10.  
  11.     As more and more problems arised with sysops running Binkley, i included a
  12.     MailerType statement in the configuration file. Depending on this type,
  13.     TickPack will handle sent archives in a different way:
  14.  
  15.         FrontDoor: TickPack adds a FLAGS: KFS line to the attachmessage
  16.         Binkley  : TickPack directly creates .?LO files in the appropriate 
  17.                    outbound directory.
  18.         D'Bridge/
  19.         Generic  : TickPack deletes archives when the attachmessage is 
  20.                    gone.
  21.  
  22.     This was suggested by Guido Gybels.
  23.  
  24.     For FrontDoor users only: TickPack will touch the semaphore files
  25.     FDRESCAN.NOW and FMRESCAN.NOW if you specify the path to these files in the
  26.     configuration file. Hopefully this will enable TickPack to run smoothly in
  27.     a multiline environment. Suggested by Justin Mann.
  28.  
  29.     A little bug has been found: TickPack didn't set the filedate correctly
  30.     when unpacking archives. This has been fixed. Reported by Lars Eriksson.
  31.  
  32.  
  33.     1. What is TICKPACK
  34.  
  35.     TICKPACK is the follow-up to my famous :-) TICKECHO program. I
  36.     created this program, because I hated the look of my netmail-folder
  37.     after TICK(tm) had created hundreds of fileattach-messages.
  38.  
  39.     TICKPACK simply collects all files for one system and throws them
  40.     into one large file.
  41.  
  42.     This has numerous advantages and one disadvantage:
  43.  
  44.     - your netmail-folder looks much neater
  45.     - if you hatch your filelist regularly, HATCH will create a TIC-file
  46.       and attach this list. But if the receiver doesn't poll the list at
  47.       the same day, your nightly event will create a new filelist. From
  48.       this moment, the CRC in the TIC-file doesn't match anymore.
  49.       TICKPACK circumvents this problem by explicitly copying all files
  50.       into one archive, so every file will be sent exactly as it was when
  51.       you archived it.
  52.     - This approach will of course use more room on your harddisk than
  53.       the normal TICK-approach. Especially when you distribute files to
  54.       many systems, a TICKPACK archive for every receiver will be
  55.       created.  If you receive 3 MB and distribute those files to 10
  56.       systems, you will need 30 MB room on your harddisk to store all
  57.       those archives.  TICKPACK notices when you are out of diskspace and
  58.       leaves all TICK messages alone if it couldn't store them completely
  59.       in the archive.
  60.  
  61.  
  62.     2. Legal stuff
  63.  
  64.     TICKPACK is distributed as GUILTWARE (in contrast to TICKECHO, which
  65.     was public domain). If you intend to use TICKPACK on a regular basis,
  66.     you should pay for it. TICKPACK isn't crippled in any way and if you
  67.     pay, it doesn't miraculously develop new features, but anyway, it was a
  68.     lot of work writing it, so you shouldn't mind paying for it :-)
  69.  
  70.     To avoid any misunderstandings! You are NOT definitely required to
  71.     register TICKPACK. Especially systems who are forced to use TICKPACK
  72.     to unpack archives from their uplink shouldn't feel pressured to
  73.     register. If you do, I'll be glad, if you don't, what the heck...
  74.     BTW: YOU ARE REQUIRED TO SEND ME A NETMAIL IN WHICH YOU SHOULD STATE
  75.     HOW MUCH YOU LOVE USING TICKPACK :-))) honestly, send me a netmail so
  76.     that I know who is using this program, ok?
  77.  
  78.     If you want to register TICKPACK, see the end of this document.
  79.  
  80.     I DO NOT guarantee that TICKPACK will do anything! If it doesn't work
  81.     as you expect it to or if it crashes your harddisk, bad luck. You can't
  82.     hold me reliable for any damages my software does on your system. If
  83.     you can't agree with this, delete the software and get on with your
  84.     life...
  85.  
  86.  
  87.     3. Features
  88.  
  89.     Aside all those beautiful things mentioned above, TICKPACK is fully
  90.     zone- and pointaware. Many people pestered me with this one, apparently
  91.     there is a lot of zone-crossing traffic going on :-)
  92.  
  93.     Additionally TICKPACK will only pack message from TICK with totally
  94.     identical attributes, i.e. if you distribute two areas to system X, one
  95.     with HOLD attribute and the other one with CRASH attribute, TICKPACK
  96.     will create two archives, the first one containing all files marked as
  97.     HOLD, the second one containing all files marked as CRASH. The same
  98.     goes for the AKA you use for different areas. If you distribute some
  99.     files to system X from your main address and some other files from your
  100.     first AKA, TICKPACK will produce one archive for the first set of
  101.     files and another one for the second set.
  102.  
  103.     Last but not least a special goody: if you tell TICKPACK so, it won't
  104.     create attach messages for new archives at once but only on a special
  105.     day of the week. I myself poll for many areas only once or twice a
  106.     week, but if I sent the sysop a crashmail during the day, I received
  107.     all archived files so far. Very clever during the most expensive time
  108.     of the day... with TICKPACK the sysop can leave the archive growing
  109.     without attaching it, until on the specified day the complete archive
  110.     will be attached to the receiver...
  111.  
  112.     This weekday-feature will not be used for crash-archives, those files
  113.     will be attached immediately.
  114.  
  115.     You can also tell TICKPACK to NEVER archive any attaches to a special
  116.     system. May be helpful if you receive TICKPACK archives from a system
  117.     but don't want to archive all TICK attaches to this system.
  118.  
  119.  
  120.     4. Starting TICKPACK
  121.  
  122.     The full syntax for starting TICKPACK looks like this:
  123.  
  124.         TICKPACK {-Ccfgfile} PACK|UNPACK [Ta|Fa]|DIR [Ta|Fa]
  125.  
  126.     It's rather simple:
  127.  
  128.         -Ccfgfile       If you specify this, TICKPACK will use this file to
  129.                         find it's configuration info, otherwise it will use
  130.                                       TICKPACK.CFG in the same directory as TICKPACK.EXE
  131.  
  132.         PACK            This options scans your netmail directory for mail
  133.                         from TICK to one of the systems listed in your
  134.                                       configuration file. The attached files are
  135.                                       archived, attach messages for the archives are
  136.                                       generated.
  137.  
  138.         UNPACK [Ta|Fa]  If specified without arguments, unpacks all
  139.                         archives from one of the systems listed in your
  140.                                         configuration file to you. If you specify
  141.                                         'Tzone:net/node[.point]' TICKPACK will unpack all
  142.                                         archives to this address. If you specify 'Fzone:
  143.                                         net/node[.point]' TICKPACK will unpack all archives
  144.                                         from this address.
  145.  
  146.         DIR [Ta|Fa]     If specified without arguments, shows some info on
  147.                                         all TICKPACK archives currently on your system. If
  148.                                         specified with 'Ta' or 'Fa' (format see UNPACK
  149.                                         above) shows detailed info on all selected
  150.                                         archives.
  151.  
  152.  
  153.     5. TICKPACK.CFG
  154.  
  155.  
  156.     5.1. ADDRESS
  157.  
  158.     You have to specify at least one address of your system. This first
  159.     address will be interpreted as your main address and will be used to
  160.     determine when an INTL-kludge is necessary (such a kludge will only be
  161.     generated, when either the origin or the destination address has a
  162.     different zone than your main address).
  163.  
  164.     The syntax is easy:
  165.  
  166.     ADDRESS zone:net/node[.point]
  167.  
  168.     If you don't specify .POINT, .0 will be assumed.
  169.  
  170.  
  171.     5.2. TO
  172.  
  173.     There may be some weird sysops who refuse to use this wonderful program
  174.     :-) So TICKPACK doesn't pack all files TICK has attached, but only
  175.     files to a system specified with a TO line. The same holds for the
  176.     UNPACK function: TICKPACK will only unpack files addressed to one of
  177.     your addresses (see ADDRESS statement above) and from a system
  178.     specified with a TO line.
  179.  
  180.     Syntax:
  181.  
  182.     TO zone:net/node[.point] {MO|TU|WE|TH|FR|SA|SU | NEVER}
  183.  
  184.     If you omit the pointnumber, .0 will be assumed. If don't specify any
  185.     weekdays, attaches will be created immediately, otherwise new archives
  186.     will only be attached on one of the specified days. If you only
  187.     specify NEVER instead of any weekdays, no archives to this system
  188.     will ever be generated but TICKPACK will still unpack archives from
  189.     this system.
  190.  
  191.  
  192.     5.3. TPPATH
  193.  
  194.     The path where all TICKPACK archives will be created. This must be a
  195.     full path (drive:\path), but you can use a '?' as a drivedesignator,
  196.     this will be replaced with your current drive.
  197.  
  198.     Syntax:
  199.  
  200.     TPPATH path
  201.  
  202.  
  203.     5.4. MAILPATH
  204.  
  205.     The path to your netmail folder. Must be the same format as TPPATH
  206.     above.
  207.  
  208.     Syntax:
  209.  
  210.     MAILPATH path
  211.  
  212.  
  213.     5.5. INBOUND
  214.  
  215.     The path where all your inbound files are stored. Must be the same
  216.     format as TPPATH above.
  217.  
  218.     Syntax:
  219.  
  220.     INBOUND path
  221.  
  222.  
  223.     5.6. LOGFILE
  224.  
  225.     If you want TICKPACK to log what it is doing, specify where to write the
  226.     log info.
  227.  
  228.     Syntax:
  229.  
  230.     LOGFILE complete_filename
  231.  
  232.  
  233.     5.7. MAILERTYPE
  234.  
  235.     To specify what mechanism for file deletion should be used. If you are
  236.     using FrontDoor, you can configure TickPack to touch FDRESCAN.NOW and
  237.     FMRESCAN.NOW if any messages are created.
  238.  
  239.     If you use Binkley, you MUST specify the path to your outbound-directories. 
  240.     In order to cope with Binkleys multiple outbounds, you have to use a #N in 
  241.     the path specifier. TICKPACK will replace this #N with the target 
  242.     zonenumber for the attach message. The N specifies the number of digits to 
  243.     use. I guess some examples will make this clear (the zonenumber in the 
  244.     examples is 2):
  245.  
  246.         C:\OUTBOUND.#3\   ---> C:\OUTBOUND.002\
  247.         C:\OUT#2\         ---> C:\OUT02\
  248.  
  249.     BE CAREFUL: As TICKPACK can't check if the pathname pattern you supplied is 
  250.     correct (it wouldn't be nice to require all directories C:\OUT00 up to 
  251.     C:\OUT99 in the above example to exist...) it doesn't try to do so. If you 
  252.     specify an illegal path, you won't be happy...
  253.  
  254.     Syntax:
  255.  
  256.     MAILERTYPE BINKLEY outbound-path
  257.     MAILERTYPE DBRIDGE
  258.     MAILERTYPE GENERIC
  259.     MAILERTYPE FRONTDOOR [path to semaphore files]
  260.  
  261.  
  262.     6. Registration
  263.  
  264.     To register TICKPACK, you have to pay 20,- DM (or $15) in one of the
  265.     following ways:
  266.  
  267.     a) Send cash (DM or dollar bills)
  268.     b) Send an eurocheque
  269.     c) Transfer the money to the following account:
  270.     Postgiroamt Koeln
  271.     Bankleitzahl: 370 100 50
  272.     Konto       : 4402 27 507
  273.  
  274.     Fill out the following form and send it (with cash if you want to pay
  275.     this way) to the following address:
  276.  
  277.     Kalle Braun
  278.     In der Kumme 69
  279.     D-5300 Bonn 2
  280.     GERMANY
  281.  
  282.     If you transfer the money to my bankaccount, you can also send the form
  283.     via netmail.
  284.  
  285.     I will mail back your key as soon as I have received your money.
  286.  
  287.  
  288.     --------------------------- (cut here) --------------------------------
  289.  
  290.  
  291.                 ORDER FORM
  292.                 ==========
  293.  
  294.     Your name (max. 30 chars): ______________________________
  295.  
  296.     Your address (if you want to receive the key by mail):
  297.     _________________________________________________________
  298.     _________________________________________________________
  299.  
  300.     Your FIDO address: ______________________________________
  301.  
  302.     How do you want to pay for TICKPACK:
  303.     [ ] enclosed cash
  304.     [ ] enclosed eurocheque
  305.     [ ] transfered money to above bank account
  306.  
  307.     Where did you hear about TICKPACK:
  308.     _________________________________________________________
  309.     _________________________________________________________
  310.  
  311.  
  312.     --------------------------- (cut here) --------------------------------
  313.  
  314.  
  315.     7. Bugreports, constructive criticism etc.
  316.  
  317.     Please send love letters, money, thank-you notes etc. to
  318.  
  319.     Kalle Braun
  320.     In der Kumme 69
  321.     D-5300 Bonn 2
  322.     GERMANY
  323.     2:241/5302@fidonet
  324.  
  325.     If you really need to, you can send bug-reports, criticism and
  326.     everything else to the same address...
  327.  
  328.  
  329.     8. History
  330.  
  331.     Version 2.0: First release of TickPack. Made it version 2.0 to avoid
  332.             mixup with TickEcho
  333.  
  334.     Version 2.1: Temporary release. TickPack didn't accept a CTRL-Z at the
  335.             end of the CFG-file, corrected. TickPack replaced
  336.             underscore characters in pathnames with blanks, corrected.
  337.  
  338.     Version 2.2: Restructured program to use some new libraries I wrote.
  339.             TickPack created PID lines with wrong version numbers,
  340.             corrected.
  341.  
  342.     Version 2.3: Implemented the NEVER option, allowed override of CFG file
  343.                     from the command line.
  344.  
  345.     Version 2.4: Implemented log file option. Clarified the paragraph on
  346.                     registration in the doc file.
  347.  
  348.     Version 2.5ß: TickPack now checks if the archive is complete by
  349.                     storing the total size of the archive in the header. Added
  350.                     the MailerType statement for all those Binkley and D'Bridge
  351.                     users out there. TickPack didn't set the filedate when unpacking
  352.                     archives. Fixed.
  353.  
  354.     Version 2.6ß: Added support to touch the FrontDoor semaphore files if new
  355.                     messages are created.
  356.  
  357.     Version 2.7ß: As pre 1.70 versions of OMMM aren't capable of creating 
  358.             kill-after-send attach messages, TICKPACK now creates .?LO-files on 
  359.                     its own.
  360.  
  361.   Version 2.8: Finally a non-beta release :-) Binkley support now works.
  362.