Black Box 4/BlackBox.cdr/batch/wtt_v201.arj/WTTDOCEN.DOC

Text File | 1991-12-08 | 18KB | 391 lines

╔══════════════════════════════            ┌─────────────────┐
║ WTT       Wait Till Time                 │    D.I.S.P.     │────┐
║                                          │                 │░░░░│
╟──────────────────────────────            │                 │░░░░│
║ (c) 1991  Robert W.van Hoeven            │ Dutch           │░░░░│
╟──────────────────────────────            │   Independent   │░░░░│
║ Release : 2.01                           │     ShareWare   │░░░░│
║ Rel.Date: 8th December 1991              │       Programmer│░░░░│
╠══════════════════════════════            └─────────────────┘░░░░│
║                                          |    │░░░░░░░░░░░░░░░░░│
║ │ WTT.EXE                                |    └─────────────────┘
║ │ WTT.CTL                                |       ┌─────┐        |
║ │                                        |       │░░░░░│        |
║ │                                        |       └──┬──┘        |
║ │ Lines starting with '│' are            |     ┌────┴────┐      |
║ │ changes to release 1.02 !!             ------││││││ ═══│-------
║                                                └─────────┘
╠═══════════════════════════════
║ Address: Robert W. van Hoeven
║          PO. Box 131
║          1170 AC  Badhoevedorp
║          Nederland / Holland
╚═══════════════════════════════

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   0   │ Table of contents                                           │
 └───────┴─────────────────────────────────────────────────────────────┘

 1 ----    General information
  1.1      Copyrights and License Agreement
  1.2      Newer versions and contacting the author

 2 ----    Package description and requirements
  2.1      Preface

 3 ----    Installation description
  3.1      Installation
  3.2      WTT.CTL
  3.2      Running WTT

 4 ----    Version information and credits
  4.1      The BETA-team
  4.2      Credits
  4.3      Version history
  4.4      Copyright, Trademarks

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   1   │ General information                                         │
 └───────┴─────────────────────────────────────────────────────────────┘

 1.1 Copyrights and License Agreement
 ────────────────────────────────────

 - Users of the WTT-package must accept this disclaimer of warranty:

 - The WTT-package is supplied as is.  The author disclaims all
   warranties, expressed or implied, including, without limitation,
   the warranties of merchantability and of fitness for any purpose.
   The author assumes no liability for damages, direct or consequential,
   which may result from the use of the WTT-package;

 - The WTT-package is a "shareware program" and is provided at no charge
   to the user for evaluation.  Feel free to share it with your friends,
   but please do not give it away altered or as part of another system.
   The essence of "user-supported" software is to provide personal
   computer users with quality software without high prices, and yet to
   provide incentive for programmers to continue to develop new products.

 - If you find this program useful and find that you are using and
   continue the use of the WTT-package after a 30 days trial period,
   you must register the WTT-package as described below;

 - Non-commercial can get a license for the usage up to this release
   of the WTT-package for free. Look into the details in REGISTER.WTT
   For Non-commercial users there is a POSSIBILITY to submit to one
   of the special contracts as explained in the file REGISTER.WTT;

 - Commercial usage of WTT will cost money. Also, a so called 'closed'
   Bulletin Board System (a system where the user must pay direct to
   the SysOp to get full access) is has to pay.
   Both types of users should look into the details in REGISTER.WTT;

 - The registration of the WTT-package will license ONE copy for use on
   any computer at any one time, as long as the usage confirms to the
   type of registration you have done (so NON-commercial usage when you
   have a non-commercial license);

 - Anyone distributing the WTT-package for any kind of remuneration must
   first contact the Author at the address above for authorization;

 - You are encouraged to pass a copy of the WTT-package along to your
   friends for evaluation.  Please encourage them to register their
   copy if they find that they can use it;

 - Support on WTT, when used in a non-commercial environment, is
   available by means of written letters or by entering the inter-
   national echomail area DISP;

 - Problems and suggestions can be entered in the FidoNet <tm> Echomail
   conference <tm> called DISP (international). Entering this echo does
   not exclude you of the duty to register the WTT-package, though users
   who evaluate the product can enter the echo for questions;

 - The WTT-package, all programs, the documentation and support-files is
   copyrighted 1990,91 by Robert W. van Hoeven, PO. Box 131, Badhoevedorp
   1170AC, Holland. All rights are reserved. You may copy this package
   for backup purposes. Also you may copy and share unmodified copies of
   the whole package, providing that the copyright notice is reproduced
   and included on all copies.
   Excluded from this statement are the support-files written by other
   authors. Please refer to the documentation of these programs for
   copyrights and license agreements;

 - It is forbidden to modify, adapt, translate, reverse engineer, de-
   compile and/or disassemble the software in the WTT-package. Patching
   the medium at places that carry the software is seen as a program
   change and is also forbidden. It is forbidden to create a so called
   'bypass' to skip the original introduction screens and delay. Also
   it is forbidden to use such a 'bypass' unless supplied by the author
   (Robert W. van Hoeven) himself;

 - Performing any of the illegal actions as stated in the previous
   lines, is a theft and no fair play to the author and, more important,
   to the registered users;

 - Bulletin Board Systems that distribute the WTT package can convert
   the WHOLE package to any archive-system they like but all original
   files must be included in the new archive. The WTT-package on the
   Bulletin Board can contain at the most 2 extra files. These files
   can only be a commercial for that Bulletin Board and/or validation
   data that is presented as a service to all users and shall have no
   other functions;

 - After the normal trial period of 30 days, you must register the soft-
   ware (see REGISTER.WTT) or you must remove it from your PC;

 - Comments, suggestions and bug reports are welcome and will be answered
   as soon I have the time to do so. You can send me a letter of leave a
   NetMail <tm> message named to Rob Van.hoeven (mind the point) on node
   2:512/100 (RA Support, Monster, Holland, SysOp is Reinier de Groot).
   When you want to send me normal mail, address it to:
   Robert W. van Hoeven, PO. Box 131, 1171 AC Badhoevedorp, Holland;
   Also you can enter messages in the FidoNet <tm> DISP Echomail <tm>
   area;


 1.2 Newer versions and contacting the author
 ────────────────────────────────────────────────────────────────────────
 The newest version of WTT is always available at the DISP-HQ on node
 2:512/100. WTT is also distributed thru a number of DISP support nodes.
 There are three ways of obtaining newer versions of WTT:


 - Logging on at DISP-HQ or a support node
   Look into the file SUPPORT.WTT for a full list of support nodes;

 - Logging on to a SDS node
   WTT is distributed thru SDS/SDN, but only big minors (x.10, x.20 and
   so on) and majors (14.01, 15.01 and so on) are submitted to the SDS
   distribution point in Holland;

 - Logging on to your own BBS;
   Chances are, that you will find an older version (international
   users) because it will take some time for the new version to
   'bleed' thru the net;

 - Update service;
   You can enter a special update service (read REGISTER.WTT).


 If you think you have found problems in WTT, or in any other case,
 you wish to contact the author, you can send me:

 - A letter to the address you can find in the header of this file;
 - A NetMail <tm> message to Rob Van.hoeven (please mind the point
   between Van and Hoeven) at 2:512/100 or (better) 2:512/100.5;
 - A Message in the FidoNet <tm> DISP echomail <tm> area;

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   2   │ Package description and requirements                        │
 └───────┴─────────────────────────────────────────────────────────────┘

 2.1 Preface
 ────────────────────────────────────────────────────────────────────────
 This program is another batch-file enhancer. Its primary use is to
 create a timer-loop until a specific time or in specific periods
 of time. It was written as a program for a specific task, but because
 I already had to create a flexible environment, I decided to enhance
 the layout and to donate it to Public Domain/Shareware.

 The environment for which I wrote the program is not so uncommon. In
 this case it had to be written for a special BBS. This BBS must only
 answer the phone from 09:00-09:59 am, from 17:00-23:59 pm, but must
 always answer the phone on saturdays, sundays and on some specific
 holidays like easter, christmas and so on. In the remaining periods
 the machine must stay power-on (unattended) but answering the phone
 is a 'no-no'.

 WTT will do this tasks for you and, can be run in a multi-tasking
 environment (it is DesqView aware).

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   3   │ Installation                                                │
 └───────┴─────────────────────────────────────────────────────────────┘

 3.1 Installation
 ────────────────────────────────────────────────────────────────────────
 The installation is simple. Put WTT.EXE somewhere in a DOS path.
 Create (edit) a file called WTT.CTL (a straight ASCII file) and
 put is:

 - Along with WTT.EXE in the same directory (only DOS 3.x and up
   if this directory is not in the DOS path);
 - Somewhere in the DOS-path;
 - In the current directory.


 3.2 WTT.CTL
 ────────────────────────────────────────────────────────────────────────
 WTT.CTL must contain some options (at least 1 DownTime option) and
 can contain several. These options are described below.

 The general syntax of an option is:

 Option Parameters

 [Option]     can start in any position if the previous positions contain
              blanks or must start in position 1. Case is not important;

 [Parameters] Must follow the option and [option] and [parameters] must
              be separated with at least 1 blank.

 Comment lines can be included. These must start with the ';' character
 in position 1 of each line.


 You can include the following options in WTT.CTL:

 ╒══════════════════════════════════════════════════════════════════════════════╕
 │DownTime hhmm-hhmm                                                            │
 ╘══════════════════════════════════════════════════════════════════════════════╛
 Function: You must include at least 1 downtime option in WTT.CTL.
           Each DownTime option covers an IDLE period (e.g. a period
           when WTT must loop internaly until the period ends).
           There can an unlimited number of DownTime options. When
           you must include a dayswitch in the down-period, you must
           use at least two DownTime options, the first from somewhere
           to 2400 and the second from 0000 until somewhere.

           An example. Your task (BBS) can only run in the periods
           from 11:00 am to 19:00 pm and 21:00 pm to 22:30 pm. The
           remaining periods must be covered by WTT's IDLE loop:

           DownTime 0000-1059
           DownTime 1901-2059
           DownTime 2231-2400


 ╒══════════════════════════════════════════════════════════════════════════════╕
 │PassWord pppppppppp                                                           │
 ╘══════════════════════════════════════════════════════════════════════════════╛
 Function: When WTT is running an IDLE loop, you can NOT break in, un-
           less you reboot the computer and are able to stop the batch
           file before WTT comes active. You can interrupt an IDLE loop
           from the local keyboard only when you enter a password. This
           password must match the password you supply on the Password
           option. If you do not supply a password, breaking in is not
           possible at all.
           The password you supply can contain 1 to 10 characters. If
           you use a 1 character password you create a 'hot-key' to
           terminate WTT.
           When WTT is running in an IDLE loop, you can enter characters
           at the keyboard (you can only hear them with a beep, you can
           not see them). WTT will terminate if you enter the correct
           password as one continuous stream of keys.

           Two examples: Password a       : WTT will terminate when the
                                            'a' key is hit;
                         Password abba    : WTT will terminate if you
                                            enter a 'a', a 'b' another
                                            'b' and a 'a' without any
                                            other keys between these
                                            four letters.

           When WTT terminates because of local password input, it will
           terminate with an errorlevel of 4 (otherwise 0).


 ╒══════════════════════════════════════════════════════════════════════════════╕
 │ExcludeDay n                                                                  │
 ╘══════════════════════════════════════════════════════════════════════════════╛
 Function: WTT can ignore the DownTime periods on specific days of the
           week. In this case you must supply one or more (up to 7)
           different ExcludeDay statements. The [n] reflects the day-
           number where 1 is Sunday, 2 is Monday, 3 is Tuesday up to
           7 for Saturday.

           An example. The specified DownTime periods are only valid
           for Mondays and Fridays. All other days WTT must ignore
           the DownTime and terminate at once (so the next task can
           be started):

           ExcludeDay 1     (exclude Sun)
           ExcludeDay 3         ,,   Tue
           ExcludeDay 4         ,,   Wed
           ExcludeDay 5         ,,   Thu
           ExcludeDay 7         ,,   Sat


 ╒══════════════════════════════════════════════════════════════════════════════╕
 │ExcludeDate MMDDYY                                                            │
 ╘══════════════════════════════════════════════════════════════════════════════╛
 Function: WTT can ignore the DownTime periods on specific calender
           dates. In this case you must supply one or more (up to 50)
           different ExcludeDate statements. The format of the date
           to be excluded is MMDDYY (MM=month, DD=Day, YY=Year).

           An example. The specified DownTime periods are not valid
           on 11th of April, 23th and 24th December 1990;

           ExcludeDate 041090
           ExcludeDate 122390
           ExcludeDate 122490


 3.3 Running WTT
 ────────────────────────────────────────────────────────────────────────
 WTT (under normal conditions) is called from a batch-file. WTT will
 terminate with a errorlevel of 16 when an error was detected. WTT
 terminates with errorlevel 0 if current date/time is not a downtime
 period or if any of the exclusions are active. Errorlevel 4 means
 that WTT is terminated with a password on the local keyboard.

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   4   │ Version information and credits                             │
 └───────┴─────────────────────────────────────────────────────────────┘

 4.1 The BETA-team
 ────────────────────────────────────────────────────────────────────────
 Look into the file SUPPORT.WTT for a full list of all beta-testers.


 4.2 Credits
 ────────────────────────────────────────────────────────────────────────
 Thanks to the beta-team.


 5.3 Version history
 ────────────────────────────────────────────────────────────────────────

 ┌───────┬────────────────────────────┐
 │ 1.01  │ First release              │
 └───────┴────────────────────────────┘
  ■ The first public release

 ┌───────┬────────────────────────────┐
 │ 1.02  │ Minor release              │
 └───────┴────────────────────────────┘
  ■ Added ExcludeDay and ExcludeDate options;

  ■ Changed password support;

 ┌───────┬────────────────────────────┐
 │ 2.01  │ Minor release              │
 └───────┴────────────────────────────┘
  ■ Fixed some cosmetic bugs;

  ■ Fixed desqview <tm> awareness, WTT was taking to many ticks from
    the DesqView complex;



 5.4 Copyright, Trademarks
 ────────────────────────────────────────────────────────────────────────
 DesqView      is a trademark of QuarterDeck Office Systems.

 WTT is written in Turbo Pascal 6.0, with help of the Turbo Debugger 2.0
 and makes extensive use of Object Professional 1.12.
 Both STRG and SYS (6.1 and 6.0a) are included because I recently
 registered for (and got) a commercial license for both products. Give
 them a try ! Very nice !

 Turbo Pascal        is a trademark  of Borland International
 Turbo Debugger      is a trademark  of Borland International
 Object Professional is a trademark  of TurboPower Inc.
 Asynch Professional is a trademark  of TurboPower Inc.
 PowerTools Plus     is a trademark  of Blaise Computing Inc.
 STRG and SYS        are  trademarks of Eagle Performance Software

 ==================== END OF DOCUMENT ==================================