home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util4 / caltvl14.lzh / CALTRV.DOC < prev    next >
Text File  |  1990-09-02  |  41KB  |  1,017 lines
  1.  
  2.  
  3.                                        CALTRV
  4.  
  5.  
  6.                            Version 1.04 -- September 1990
  7.  
  8.  
  9.                       SideKick + Formatted  CALendar for TRaVel
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                      Copyright (c) 1989,90 WetZoft Applications
  20.  
  21.  
  22.  
  23.                                  All Rights Reserved
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                         _______
  49.                    ____|__     |               (tm)
  50.                 --|       |    |-------------------
  51.                   |   ____|__  |  Association of
  52.                   |  |       |_|  Shareware
  53.                   |__|   o   |    Professionals
  54.                 -----|   |   |---------------------
  55.                      |___|___|    MEMBER
  56.  
  57.  
  58.  
  59.                                   Table of Contents
  60.  
  61.  
  62.           I. INTRODUCTION............................................1
  63.             A. What Is CALTRV ?......................................1
  64.             B. CALTRV's Current Limitations & Restrictions...........1
  65.             C. !!!Warning!!!.........................................1
  66.             D. Files Included on Distribution Disk...................1
  67.             E. Shareware.............................................2
  68.  
  69.           II. LEGAL STUFF............................................2
  70.             A. Acknowledgements......................................2
  71.             B. Trademarks Mentioned..................................2
  72.             C. Copyright Notice And License..........................2
  73.             D. Warranty..............................................3
  74.             E. Registration..........................................3
  75.             F. Support...............................................4
  76.             G. Bulletin Boards, Users Groups And Disk Vendors........4
  77.  
  78.           III. COMMAND LINE OPTIONS..................................4
  79.             A. Detailed Explanation Of Options.......................5
  80.               1. /B {Begin Date}.....................................5
  81.               2. /C {Calendar}.......................................5
  82.               3. /D {Days}...........................................5
  83.               4. /E {End Date}.......................................6
  84.               5. /F {File Out}.......................................6
  85.               6. /G {Graphics}.......................................6
  86.               7. /H {Help}...........................................6
  87.               8. /M {Monthly}........................................6
  88.               9. /N {Print Notes}....................................6
  89.               10. /P {Print Output}..................................7
  90.               11. /T {Task File}.....................................7
  91.               12. /V {Max Video}.....................................7
  92.               13. /W {Weeks}.........................................8
  93.               14. /? {Help}..........................................8
  94.             B. Sample Command Lines..................................8
  95.  
  96.           IV. ERROR MESSAGES.........................................8
  97.  
  98.           V. INSTALLATION PROGRAM...................................10
  99.             A. Default Appointment Path & Filename..................10
  100.             B. Default Output Disk File Name........................11
  101.             C. Default Report Type..................................11
  102.             D. Default Days/Weeks/Months to Preview.................11
  103.             E. Default Screen Colors................................11
  104.             F. Print Initialization / Termination Strings...........11
  105.             G. Default Print Page Length............................11
  106.             H. Default Daily Start Time.............................11
  107.             I. Default Time Format..................................12
  108.             J. Default Video Max....................................12
  109.             K. Print Note Option....................................12
  110.             L. Use Line Draw........................................12
  111.  
  112.  
  113.  
  114.  
  115.           CALTRV  CALendar for TRaVel Documentation                  Page: i
  116.  
  117.  
  118.             M. Default Resident Task Manager File...................12
  119.             N. Print End Times Option...............................12
  120.  
  121.           VI. ASSOCIATION OF SHAREWARE PROFESSIONALS................12
  122.             A. The primary goals of the ASP:........................13
  123.  
  124.           VII. OTHER PROGRAMS BY WETZOFT APPLICATIONS...............13
  125.             A. Resident-TaskManager - RTM...........................13
  126.             B. CALRPT...............................................14
  127.  
  128.           VIII. VERSION HISTORY.....................................14
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.           CALTRV  CALendar for TRaVel Documentation                 Page: ii
  176.  
  177.  
  178.           I. INTRODUCTION
  179.  
  180.              A. What Is CALTRV ?
  181.  
  182.                CALTRV is a program that produces a nicely formatted
  183.           calendar report (Screen, Printer, or File) from Sidekick+'s
  184.           Calendar file without invoking Sidekick+. CALTRV's three reports
  185.           (Daily, Weekly, Monthly) give you a quick and concise view of you
  186.           plans and appointment. This is especially helpful in your
  187.           AUTOEXEC file to show you what is on your Calendar for the next
  188.           few days. Also CALTRV's reports were designed to fit into a small
  189.           notebook suitable for traveling. To invoke CALTRV just type
  190.           CALTRV from the DOS command line or place the command CALTRV
  191.           somewhere in your AUTOEXEC.BAT file.
  192.  
  193.           For Help on Parameters and to find out the defaults - type:
  194.  
  195.           C:\>CALTRV /?
  196.  
  197.                Also available to CALTRV users is Resident-TaskManager.
  198.           Resident-TaskManager allows you to integrate your task list with
  199.           your calendar to get a comprehensive list of your daily
  200.           activities. See the /T option described later in this document.
  201.  
  202.              B. CALTRV's Current Limitations & Restrictions
  203.  
  204.           845 Appointments within selected time span
  205.           64K SK+ Record Sizes (Usually caused by a lot of repeating
  206.           appointments or HUGE notes.
  207.           50  Notes per day
  208.  
  209.              C. !!!Warning!!!
  210.  
  211.                There have been a few isolated reports of corrupted SK+
  212.           calendars. This condition is NOT caused by CALTRV (CALTRV IS READ
  213.           ONLY!) nor is CALTRV very happy when it runs into a corrupted
  214.           Calendar. The sequence of events that occurs is that CALTRV
  215.           reports it is reading the appointment file, it may report it is
  216.           processing the repeats, and the system hangs. This is NOT (99.9%
  217.           of the time) a problem with CALTRV! If you run into this
  218.           condition please contact me. I am trying to program around this
  219.           condition but need one or more calendars to test with.
  220.  
  221.              D. Files Included on Distribution Disk
  222.  
  223.           The CALTRV Distribution Disk contains the following files:
  224.  
  225.           CALTRV.EXE     - The CALTRV program
  226.           CALTRV.DOC     - This file
  227.           CALTINST.EXE   - An installation program for setting CALTRV
  228.                            Options
  229.           README         - Changes or important information not included in
  230.                            the printed documentation  (CALTRV.DOC).
  231.           REGISTER.BAT   - A BATch file to print out the registration form
  232.  
  233.  
  234.  
  235.           CALTRV  CALendar for TRaVel Documentation                  Page: 1
  236.  
  237.  
  238.                            to your printer (LPT1)
  239.           REGFORM.DOC    - The actual Registration Form
  240.           PRINTDOC.BAT   - A BATch file to print out this documentation
  241.                            file to your printer (LPT1)
  242.           VENDOR.DOC     - Instructions to Disk Vendors who wish to
  243.                            distribute CALTRV.
  244.  
  245.                Copy these files onto your disk into whatever directory you
  246.           wish.  Then, consider how you want to run CALTRV and set your
  247.           options (See: Installation Program later in this file).
  248.  
  249.              E. Shareware
  250.  
  251.                Shareware is a distribution method, not a type of software.
  252.           You should find software that suits your needs and pocketbook,
  253.           whether it's commercial or Shareware. The Shareware system makes
  254.           fitting your needs easier, because you can try before you buy.
  255.           And because the overhead is low, prices are low also. Shareware
  256.           has the ultimate money-back guarantee -- if you don't use the
  257.           product, you don't pay for it.
  258.  
  259.                CALTRV is distributed as Shareware -- this means WetZoft
  260.           Applications encourages users, subject to restrictions described
  261.           below, to share copies of this program with friends, associates
  262.           and bulletin boards. You may not share the registered version of
  263.           Resident Task Manager.
  264.  
  265.                If you make copies of CALTRV, you must include all files in
  266.           the original distribution file.  You are not permitted to
  267.           distribute CALTRV without this documentation.
  268.  
  269.           II. LEGAL STUFF
  270.  
  271.              A. Acknowledgements
  272.  
  273.                A special thanks to all of those who encouraged me to
  274.           continue with this project with words of praise, thanks, and many
  275.           new ideas.
  276.  
  277.                Thanks to TurboPower Software for furnishing an excellent
  278.           set of utilities (Turbo Professional 5.0) that made this program
  279.           possible in 25% of the time it would have taken me otherwise.
  280.  
  281.              B. Trademarks Mentioned
  282.  
  283.           Sidekick Plus is a trademark of Borland International.
  284.           Turbo Professional is a trademark of TurboPower Software
  285.  
  286.              C. Copyright Notice And License
  287.  
  288.                This document; other accompanying written and disk-based
  289.           notes and specifications; and all referenced and related program
  290.           files, demonstration code and object modules accompanying this
  291.           document are copyrighted by WetZoft Applications.  The copyright
  292.  
  293.  
  294.  
  295.           CALTRV  CALendar for TRaVel Documentation                  Page: 2
  296.  
  297.  
  298.           owner hereby licenses you to: initial use of the software; make
  299.           as many copies of the software and documentation as you wish;
  300.           give exact copies of the original to anyone; and distribute the
  301.           software and documentation in its unmodified form via electronic
  302.           means.  There is no charge for any of the above.
  303.  
  304.                This is not free software.  This license allows you to use
  305.           this software without charge for a period of 30 days. In order to
  306.           continue using this software, include this software as part of
  307.           any product, either commercial, shareware, freeware, or public
  308.           domain, REGISTRATION IS REQUIRED.  Any other use of CALTRV is in
  309.           violation of federal copyright laws.
  310.  
  311.                No copy of the software may be distributed or given away
  312.           without this accompanying documentation; this notice must not be
  313.           removed.  ONLY COPIES OF THE SHAREWARE VERSION MAY BE DISTRIBUTED
  314.           IN ANY FORM.  Contact WetZoft Applications if you receive a copy
  315.           that does not comply with these requirements.
  316.  
  317.              D. Warranty
  318.  
  319.                There is no warranty of any kind associated with this
  320.           software, and the copyright owner is not liable for damages of
  321.           any kind.  By using this software, you agree to this. Every
  322.           effort has been made by WetZoft Applications to make this product
  323.           bug-free.  However, the nature of software development is that it
  324.           is impossible to guarantee bug-free software. Every attempt will
  325.           be made to correct any verifiable bug reported. Upgrades will be
  326.           made available to all registered users.
  327.  
  328.              E. Registration
  329.  
  330.           To register CALTRV fill out the registration form at the end of
  331.           this documentation, and send a check or money order (in US funds
  332.           only) for the appropriate amount to:
  333.  
  334.                     WetZoft Applications
  335.                     788 Martin Ct West
  336.                     Severn MD 21144
  337.  
  338.                Upon receipt of the appropriate registration fee, WetZoft
  339.           Applications will acknowledge the registration and
  340.  
  341.           .    Provide the user with the codes necessary to remove the
  342.                shareware registration screen.
  343.  
  344.           .    Provide the user with a registration number entitling the
  345.                user to upgrades and telephone support.
  346.  
  347.           .    Provide the user with a printed copy of the documentation
  348.                and the latest copy of the software. Please specify disk
  349.                size on the registration form. If no disk size is specified
  350.                5 1/4 inch disks will be sent.
  351.  
  352.  
  353.  
  354.  
  355.           CALTRV  CALendar for TRaVel Documentation                  Page: 3
  356.  
  357.  
  358.                The registration fee is for the use of a single copy of
  359.           CALTRV by ONE individual. CALTRV may be used on any computer
  360.           owned by the registered user so long as there is NO possibility
  361.           of CALTRV being used at more than one location at the same time.
  362.           Please contact WetZoft Applications for information on multiple
  363.           copy registration and site licenses.
  364.  
  365.                Telephone support will only be provided to registered users.
  366.           If you need technical assistance and you are NOT registered, you
  367.           may either write to WetZoft Applications the address above, or
  368.           contact the author on Compuserve:
  369.  
  370.                     Jim Wetzel [75166,3200]
  371.                     E-Mail, BORAPP, IBMSYS
  372.  
  373.              F. Support
  374.  
  375.                Registered Users of CALTRV are entitled to the following
  376.           support:
  377.  
  378.                .    CompuServe - The preferred method of support is via
  379.                     CompuServe. Technical questions and inquires can be E-
  380.                     Mailed to: Jim Wetzel [75166,3200].
  381.  
  382.                .    Mail Support - You can send all questions and inquires
  383.                     to the address listed above. WetZoft Applications will
  384.                     respond as promptly as possible to your inquiry.
  385.  
  386.                .    Telephone Support - Registered users may call WetZoft
  387.                     Applications at (301)-969-9385 for technical support.
  388.                     Voice response is generally available weekday evenings.
  389.                     Messages are checked periodically throughout the day.
  390.  
  391.                For Non-Registered users of CALTRV, we will provide you with
  392.           assistance to install a shareware copy of CALTRV and evaluate it
  393.           during the 30 day evaluation period. WetZoft Applications cannot
  394.           guarantee continued support to Non-Registered Users beyond the 30
  395.           day evaluation period.
  396.  
  397.              G. Bulletin Boards, Users Groups And Disk Vendors
  398.  
  399.           UNDER NO CIRCUMSTANCES MAY CALTRV BE DISTRIBUTED WITHOUT ALL
  400.           ACCOMPANYING DOCUMENTATION FILES (INCLUDING THIS COMPLETE FILE),
  401.           ALL PROGRAMS, AND OTHER MATERIALS PROVIDED WITH THE OFFICIAL
  402.           COPIES FROM WETZOFT APPLICATIONS.  ANY OTHER SUCH DISTRIBUTION OF
  403.           CALTRV OR ITS RELATED FILES, EXCEPT AS PROVIDED FOR IN THIS
  404.           LICENSE, SHALL BE DETERMINED TO BE IN VIOLATION OF FEDERAL
  405.           COPYRIGHT LAWS.
  406.  
  407.           III. COMMAND LINE OPTIONS
  408.  
  409.           Options: Space is required between /Option & Parameter
  410.  
  411.  
  412.  
  413.  
  414.  
  415.           CALTRV  CALendar for TRaVel Documentation                  Page: 4
  416.  
  417.  
  418.           /B MM/DD/YY    {Begin Date}             Default=Todays Date
  419.           /C filename    {Calendar}               Default=PERSONAL.APP
  420.           /D 1-365       {Days}                   Default=1
  421.           /E MM/DD/YY    {End Date}               Default=Begin+Days
  422.           /F [filename]  {File Out}               Default=No File Out
  423.           /G             {Graphics Output}        Default=No Line Draw
  424.           /H             {Help}                   This Help Screen
  425.           /M [1-12]      {Monthly Reports}        Default=Weekly
  426.           /N [nn]        {Note Limit}             Default=No Notes
  427.           /P             {Print Output}           Default=ScreenOutput
  428.           /T [taskfile]  {RTM Task File Name}     Default=RTM.DAT
  429.           /V             {Max Video}              Default=25 Lines
  430.           /W [1-52]      {Weekly Reports}         Default=1 Week
  431.           /?             {Help}                   This Help Screen
  432.  
  433.                Please note that a space IS REQUIRED between the option
  434.           switch '/o' and it's parameter. Dates MUST be in the form
  435.           MM/DD/YY (all 2-Digit Numbers). Under DOS 3.x and above CALTRV
  436.           will search for the CALENDAR file "/C" in the following places:
  437.  
  438.              Current Directory
  439.              Directory where CALTRV resides (It's a good Idea to put CALTRV
  440.              in the same directory as your SK+ Calendar
  441.              DOS Path
  442.  
  443.              A. Detailed Explanation Of Options
  444.  
  445.                 1. /B {Begin Date}
  446.  
  447.           /B MM/DD/YY {Begin Date} - CALTRV will start its report with the
  448.                date specified by the user. The Date format is: MM/DD/YY.
  449.                Month and Day must be valid 2 digit date numbers: Month (01-
  450.                12), Day (01->Days in Month). The default is today's
  451.                (system) date.
  452.  
  453.                 2. /C {Calendar}
  454.  
  455.           /C filename.ext {Calendar} - This parameter is used to tell
  456.                CALTRV what Sidekick+ APP file to use. The default is
  457.                PERSONAL.APP. If the specified file cannot be found in the
  458.                Current Directory CALTRV will search for the file (DOS 3.x
  459.                and higher) in the directory where CALTRV resides and the
  460.                DOS Path. Full Drive and Path information is accepted.  **
  461.                This is an installable option.
  462.  
  463.                 3. /D {Days}
  464.  
  465.           /D [n] {Days} - This parameter is used to tell CALTRV that you
  466.                want "Daily" reports and how many days of calendar data you
  467.                want to print. The valid range is 1 to 365. The default is
  468.                1. ** This is an installable option.
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.           CALTRV  CALendar for TRaVel Documentation                  Page: 5
  476.  
  477.  
  478.                 4. /E {End Date}
  479.  
  480.           /E MM/DD/YY {End Date} - CALTRV will end its report with the date
  481.                specified by the user. The Date format is: MM/DD/YY.  Month
  482.                and Day must be valid 2 digit date numbers: Month (01-12),
  483.                Day (01-Day in Month). The default is todays (system) date.
  484.                /E overrides the /D option. The default is the Begin
  485.                Date(/B) + Days(/D)
  486.  
  487.                 5. /F {File Out}
  488.  
  489.           /F [filename.ext] {File Out} - Optionally CALTRV can write its
  490.                report out to a disk file. The default filename used is
  491.                PERSONAL.RPT and will be written in the current directory.
  492.                No checking is done to see if the file already exists so BE
  493.                CAREFUL! If /F is specified with no other parameters the
  494.                default Report File name is used. You can also specify the
  495.                name of the file you want to use after the /F.
  496.  
  497.                Examples:
  498.  
  499.                CALTRV /F /D 20            Writes a 20 day report to
  500.                PERSONAL.RPT
  501.                CALTRV /F MYFILE.CAL /D 20 Writes a 20 day report to
  502.                MYFILE.CAL
  503.  
  504.                ** This is an installable option.
  505.  
  506.                 6. /G {Graphics}
  507.  
  508.           /G {Graphics} - This option tells CALTRV that you have a Graphics
  509.                capable (IBM Line Draw) printer. When possible CALTRV will
  510.                use the IBM line draw characters to print the calendar
  511.                reports rather than standard ASCII characters.
  512.  
  513.                 7. /H {Help}
  514.  
  515.           /H {Help} - Tells CALTRV to list a short help screen for the
  516.                user.
  517.  
  518.                 8. /M {Monthly}
  519.  
  520.           /M [n] {Monthly} - This parameter is used to tell CALTRV that you
  521.                want "Monthly" reports and how many months of calendar data
  522.                you want to print. The valid range is 1 to 12. The default
  523.                is 1. ** This is an installable option.
  524.  
  525.                 9. /N {Print Notes}
  526.  
  527.           /N {Print Notes} - CALTRV will optionally display a limited
  528.                amount (4096 bytes) of note information that is attached to
  529.                a Title or Appointment. There are a couple of restrictions:
  530.                1) Note lines are limited to 65 characters (you can have
  531.                longer lines in SK+ but the printed report will be
  532.  
  533.  
  534.  
  535.           CALTRV  CALendar for TRaVel Documentation                  Page: 6
  536.  
  537.  
  538.                truncated) 2) The printed report will show up to 15 note
  539.                lines. If /N is specified by itself CALTRV will print out as
  540.                much of the note as possible. If an optional number is
  541.                provided CALTRV will limit the number of note lines printed
  542.                to the number specified (within the limits described above).
  543.  
  544.                Examples:
  545.  
  546.                CALTRV /N      Writes a 1 week report with attached notes.
  547.  
  548.                CALTRV /N 4    Writes a 1 week report with attached notes
  549.                but only printing a maximum of 4 lines per note.
  550.  
  551.                 10. /P {Print Output}
  552.  
  553.           /P {Print Output} - Tells CALTRV to route its report to the
  554.                printer. CALTRV will issue user defined Printer
  555.                Setup/Termination Strings and will accept a User Defined
  556.                Page Size. ** This is an installable option.
  557.  
  558.                 11. /T {Task File}
  559.  
  560.           /T [filename.ext] {Task File} - Optionally CALTRV can interface
  561.                with Resident-TaskManager to integrate Tasks / ToDo Lists
  562.                with Calendar Output. The default filename used is RTM.DAT
  563.                and will be read from the current directory. If /T is
  564.                specified with no other parameters the default Task File
  565.                name is used. You can also specify the name of the file you
  566.                want to use after the /T.
  567.  
  568.                Examples:
  569.  
  570.                CALTRV /T /D 20             Produces a 20 day report with
  571.                RTM.DAT
  572.  
  573.                CALTRV /T MYTASKS.DAT /D 20 Produces the same report with
  574.                MYTASKS.DATA
  575.  
  576.                Please note that if you have a Task Due 21 Days or more from
  577.                the starting date of the report CALTRV will not include it
  578.                into the report. CALTRV looks for PAST DUE Tasks and all
  579.                TASKS up to and including the Report End Date.
  580.  
  581.                ** This is an installable option.
  582.  
  583.                 12. /V {Max Video}
  584.  
  585.           /V {Max Video} - This option instructs CALTRV to use the maximum
  586.                video mode available for the monitor type being used (44
  587.                Lines EGA/50 Lines VGA). ** This is an installable option.
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.           CALTRV  CALendar for TRaVel Documentation                  Page: 7
  596.  
  597.  
  598.                 13. /W {Weeks}
  599.  
  600.           /W [n] {Weeks} - This parameter is used to tell CALTRV that you
  601.                want "Weekly" reports and how many weeks of calendar data
  602.                you want to print. The valid range is 1 to 52. The default
  603.                is 1. ** This is an installable option.
  604.  
  605.                 14. /? {Help}
  606.  
  607.           /? {Help} - Tells CALTRV to list a short help screen for the
  608.                user.
  609.  
  610.              B. Sample Command Lines
  611.  
  612.  
  613.            List (CRT) daily appointments for the next 5 days
  614.  
  615.  
  616.              C:\>CALTRV /d 5
  617.  
  618.  
  619.            List (Printer) daily appointments for the next 5 days
  620.  
  621.  
  622.              C:\>CALTRV /d 10 /p
  623.  
  624.  
  625.            List (Printer) all appointments for June 1989
  626.  
  627.  
  628.              C:\>CALTRV /b 06/01/89 /m 1 /p
  629.  
  630.              *** Note the two digit month & day
  631.  
  632.  
  633.            List (CRT) appointments for the next week in the Common App
  634.            File
  635.  
  636.  
  637.              C:\>CALTRV /c C:\SKPLUS\COMMON.APP
  638.  
  639.              *** Note: 1 Week is default so does not need to be specified
  640.  
  641.           IV. ERROR MESSAGES
  642.  
  643.           Listed below are error messages generated by CALTRV and possible
  644.           explanations:
  645.  
  646.           *** ERROR! mm/dd/yy Invalid Begin Date Specified
  647.  
  648.              This message is generated when an invalid Begin Date /B is
  649.              specified. This could be the result of invalid month or day
  650.              values or the month or day value was specified with a single
  651.              digit.
  652.  
  653.  
  654.  
  655.           CALTRV  CALendar for TRaVel Documentation                  Page: 8
  656.  
  657.  
  658.           *** ERROR! mm/dd/yy Invalid End Date Specified
  659.  
  660.              This message is generated when an invalid End Date /E is
  661.              specified. This could be the result of invalid month or day
  662.              values or the month or day value was specified with a single
  663.              digit.
  664.  
  665.           *** Warning: End Date < Begin Date --- Begin/End Date Forced
  666.           Equal
  667.  
  668.              This message is generate when the End Date is chronologically
  669.              prior to the Begin Date.
  670.  
  671.           *** Warning: Appointment Limit Exceeded. nnn  Appointment Records
  672.           Skipped!
  673.  
  674.              CALTRV has a limit (specified earlier) on the number of
  675.              Appointments it can store. If this limit is exceeded all
  676.              remaining appointment records are skipped. This usually
  677.              results in a loss of repeating appointment records. Due to the
  678.              nature of the SK+ calendar early repeating appointments may be
  679.              lost while later "standard" appointments will be shown.
  680.  
  681.           *** Warning: Max Exceptions Exceeded
  682.  
  683.              Repeating appointments can be excluded(deleted) on specified
  684.              days using SK+. This is flagged in the calendar file as an
  685.              exception to the repeat. CALTRV can track up to 30 exceptions
  686.              per repeating appointment.
  687.  
  688.           *** Warning: Insufficient Memory to Process Notes
  689.  
  690.              CALTRV will store up to 4K bytes of note data per appointment.
  691.              Obviously every computer system has its memory limits. If you
  692.              use a lot of big notes you may run out of available memory.
  693.              You may also see this message if you run CALTRV while shelled
  694.              out of another program.
  695.  
  696.           *** Warning: Insufficient Memory to Process Repeating Notes
  697.  
  698.              Repeating notes are subject to the same memory limitations as
  699.              standard notes discussed above.
  700.  
  701.           *** ERROR! SK+ Record Size Exceeded CALTRV Limit. Processing
  702.           TERMINATED!
  703.  
  704.              SK+ supposedly can have very large records (2 Billion+ Bytes).
  705.              Well CALTRV's current limit is 60K records (NOT FILE SIZE)
  706.              within a file. Normally you shouldn't come even come close to
  707.              this unless you have a LOT of repeating appointments or some
  708.              VERY big notes. If this message occurs you might want to try
  709.              deleting some of your prior years data from your calendar - it
  710.              may help.
  711.  
  712.  
  713.  
  714.  
  715.           CALTRV  CALendar for TRaVel Documentation                  Page: 9
  716.  
  717.  
  718.           *** ERROR! Filename Not Found or Invalid Calendar File Specified.
  719.  
  720.              This message is a result of CALTRV not finding the filename
  721.              specified in the installation program or on the command line
  722.              with the /C option. Check the spelling and Drive and Path
  723.              information supplied.
  724.  
  725.           V. INSTALLATION PROGRAM
  726.  
  727.                CALTRV comes with a simple installation program. This
  728.           program allows you to set some of the DEFAULTS that CALTRV uses.
  729.           Most of these are pretty straight forward but a small explanation
  730.           is appropriate at this point.
  731.  
  732.                To use the installation program all you need to do is type
  733.           in CALTINST. CALTINST MUST be in the same directory as CALTRV and
  734.           CALTRV must not be renamed. CALTINST allows you to alter the
  735.           following:
  736.  
  737.                       Field             Defaults
  738.  
  739.           Appointment File Location     PERSONAL.APP
  740.           Default Output Disk File      PERSONAL.RPT
  741.           Report Type                   [Weekly]
  742.           Days/Weeks/Months to Preview  1
  743.           Standard Fore/Background      BrWhite/Blue
  744.           Message  Fore/Background      Black  /Lt Gray
  745.           Printer Setup String          [              ]
  746.           Printer Termination String    [              ]
  747.           Page Length:                  59
  748.           Daily Start Time              08:00a
  749.           Time Format                   Am/Pm
  750.           Video Max                     Off
  751.           Print Notes                   On
  752.           Use Line Draw                 Off
  753.           Resident Task File Location:  RTM.DAT
  754.  
  755.                The fields are self explanatory but a brief explanation is
  756.           listed below. There is pop-up help (F1) available for each field.
  757.           Please note that if you press <ESC> the installation will be
  758.           canceled and any changes will be lost.
  759.  
  760.              A. Default Appointment Path & Filename
  761.  
  762.                CALTRV's uses the default SIDEKICK PLUS Time Planner File -
  763.           PERSONAL.APP. If you have renamed your Time Planner file change
  764.           CALTRV's default here. The format is: d:\PATH\FILENAME.EXT.  If
  765.           you omit drive or path CALTRV will search for the Time Planner
  766.           file using DOS 3.x defaults : Current Directory, CALTRV's
  767.           Directory, and Path.  You can always override this option with
  768.           the /C Command Line Option.
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.           CALTRV  CALendar for TRaVel Documentation                 Page: 10
  776.  
  777.  
  778.              B. Default Output Disk File Name
  779.  
  780.                CALTRV will send it's output report to a Disk File:
  781.           PERSONAL.RPT if you specify the /F option on the command line. If
  782.           you wish to change the file name enter it here. Format is:
  783.           d:\PATH\FILENAME.EXT. Omit the drive or path if you want the
  784.           report to go to the default drive and path. You can also specify
  785.           the file name with the /F command line option to override this
  786.           default.
  787.  
  788.              C. Default Report Type
  789.  
  790.                CALTRV offers 3 Report Types - Daily, Weekly, & Monthly You
  791.           can specify /D for Daily /W for Weekly or /M for Monthly on the
  792.           command line. If no option is specified this default value will
  793.           be used.  Space/+/-Toggle Switches.
  794.  
  795.              D. Default Days/Weeks/Months to Preview
  796.  
  797.                CALTRV assumes you want to view the next "n" Days / Weeks /
  798.           Months by default. "n" is in terms of the report type to the
  799.           left. You can override this default each time you run CALTRV with
  800.           the /D,/W,/M parameter. You may change the CALTRV default here.
  801.  
  802.              E. Default Screen Colors
  803.  
  804.                CALTRV uses 2 Basic Colors Standard Fore/Background and
  805.           Message Fore/Background. Use the Space/+/- keys to toggle through
  806.           the color options.  The Color Sample Box shows what the current
  807.           color selections will look like (if saved).
  808.  
  809.              F. Print Initialization / Termination Strings
  810.  
  811.                CALTRV will send Printer Initialization and Termination
  812.           Strings when the /P parameter is specified.  Enter the control
  813.           codes appropriate for your printer. To enter a Page Eject enter
  814.           <CtrlP> <CtrlL>. Only the <CrtlL> will display. You can enter
  815.           multiple codes.
  816.  
  817.              G. Default Print Page Length
  818.  
  819.                CALTRV will issue a Page Eject (^L) at the end of each page.
  820.           CALTRV defaults to 59 lines per page. Enter the number of lines
  821.           you would like printed on each page. This option controls the
  822.           size of the Note/Task Box. The main portion of the report will
  823.           always print.
  824.  
  825.              H. Default Daily Start Time
  826.  
  827.                CALTRV normally starts "Daily" reports at 8:00. You can
  828.           change this by +/- 1 Hour in 30 minute increments. CALTRV tries
  829.           to integrate your appointments intelligently. That is, if you use
  830.           a start time of 8:00 and you have appointments before 8:00 the
  831.           appointments will be inserted at the appropriate spot. All other
  832.  
  833.  
  834.  
  835.           CALTRV  CALendar for TRaVel Documentation                 Page: 11
  836.  
  837.  
  838.           times will be adjusted to compensate for the inserted time. You
  839.           can toggle the start time with the Space/+/- keys.
  840.  
  841.              I. Default Time Format
  842.  
  843.                CALTRV normally prints out times in AM/PM format. If you set
  844.           SK+ to 24 Hr format then you should also set this flag to 24 Hr.
  845.           Toggle this field with the Space/+/- keys.
  846.  
  847.              J. Default Video Max
  848.  
  849.                CALTRV has a command line switch (/V - Max Video) to control
  850.           the default video mode. You can turn on Max Video (43/50 Lines on
  851.           EGA/VGA Screens) with the /V switch or toggle the field here with
  852.           the Space/+/- keys.
  853.  
  854.              K. Print Note Option
  855.  
  856.                CALTRV will print up to 4096 bytes of note information
  857.           associated with each appointment. This option can be toggled on
  858.           with the /N [n] command line switch or you can toggle the field
  859.           permanently on in this install program. If turned on permanently
  860.           here you can always limit the note output by specifying /N 1 (or
  861.           the limit of your choice on the command line.)  Toggle this field
  862.           with the Space/+/- keys.
  863.  
  864.              L. Use Line Draw
  865.  
  866.                CALTRV normally prints out its reports using standard ASCII
  867.           characters. If you have a printer that supports the IBM Line Draw
  868.           Character Set then you can set this option on. CALTRV will use
  869.           the Line Draw character set in its daily & weekly reports. This
  870.           option can also be turned on with the /G command line option.
  871.  
  872.              M. Default Resident Task Manager File
  873.  
  874.                CALTRV will read Task files from Resident TaskManager if you
  875.           specify the /T option on the command line. If you wish to change
  876.           the file name enter it here. Format is: d:\PATH\FILENAME.EXT.
  877.           Please make sure the Task File EXISTS!  You can always specify a
  878.           different file on the command line with/T [Filename]. Resident
  879.           TaskManager is available separately.
  880.  
  881.              N. Print End Times Option
  882.  
  883.                CALTRV, by default, will not print the ending times of
  884.           appointments on it's Weekly report. This allows for longer
  885.           appointment descriptions. If you need the end times printed
  886.           toggle this field to "ON". Space/+/- keys toggle this field.
  887.  
  888.           VI. ASSOCIATION OF SHAREWARE PROFESSIONALS
  889.  
  890.                The owner of WetZoft Applications is a member of the
  891.           Association of Shareware Professionals (ASP), an organization
  892.  
  893.  
  894.  
  895.           CALTRV  CALendar for TRaVel Documentation                 Page: 12
  896.  
  897.  
  898.           formed in April 1987 to strengthen the future of shareware (user-
  899.           supported software) as an alternative to commercial software.
  900.           Its members, all of whom are programmers who subscribe to a code
  901.           of ethics, are committed to the concept of shareware as a method
  902.           of marketing.
  903.  
  904.                ASP wants to make sure that the shareware principle works
  905.           for you.  If you are unable to resolve a shareware-related
  906.           problem with an ASP member by contacting the member directly, ASP
  907.           may be able to help.  The ASP Ombudsman can help you resolve a
  908.           dispute or problem with an ASP member, but does not provide
  909.           technical support for members' products.  Please write to the ASP
  910.           Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a
  911.           Compuserve message via easyplex to ASP Ombudsman 70007,3536
  912.  
  913.              A. The primary goals of the ASP:
  914.  
  915.                 To inform users about shareware programs and about
  916.                 shareware as a method of distributing and marketing
  917.                 software;
  918.  
  919.                 To encourage broader distribution of shareware through user
  920.                 groups and disk dealers who agree to identify and explain
  921.                 the nature of shareware;
  922.  
  923.                 To assist members in marketing their software;
  924.  
  925.                 To provide a forum through which ASP members may
  926.                 communicate, share ideas, and learn from each other; and
  927.  
  928.                 To foster a high degree of professionalism among shareware
  929.                 authors by setting programming, marketing, and support
  930.                 standards for ASP members to follow.
  931.  
  932.           VII. OTHER PROGRAMS BY WETZOFT APPLICATIONS
  933.  
  934.              A. Resident-TaskManager - RTM
  935.  
  936.                Resident-TaskManager is a memory-resident program to manages
  937.           lists of tasks, reminders or ToDo's.  Really, this can be
  938.           anything you want it to be: a general list of things to do, a
  939.           list of appointments, tasks you've delegated, etc.
  940.  
  941.                Resident-TaskManager's most important feature is it's
  942.           ability to load as a memory-resident program.  That means it's
  943.           available to you whenever you need to use it.  And, it only uses
  944.           about 6K while doing so.
  945.  
  946.           Resident-TaskManager has the following features for managing
  947.           lists:
  948.  
  949.              . Multiple lists
  950.              . Add, Modify, Delete, Repeat
  951.              . Sorting
  952.  
  953.  
  954.  
  955.           CALTRV  CALendar for TRaVel Documentation                 Page: 13
  956.  
  957.  
  958.              . Prioritization
  959.              . Easy date manipulation
  960.              . A user-definable field
  961.              . Audit Files
  962.              . Simple Printing
  963.  
  964.                Resident-TaskManager provides the best combination of memory
  965.           usage, simplicity, and features for managing small lists of
  966.           tasks.
  967.  
  968.              B. CALRPT
  969.  
  970.                CALRPT is a program that produces a nicely formatted
  971.           calendar report (Screen, Printer, or File) from Sidekick+'s
  972.           Calendar file without invoking Sidekick+. This is especially
  973.           helpful in your AUTOEXEC file to show you what is on your
  974.           Calendar for the next few days. To invoke CALRPT just type CALRPT
  975.           from the DOS command line or place the command CALRPT somewhere
  976.           in your AUTOEXEC.BAT file.
  977.  
  978.           RTM and CALRPT are available separately on Compuserve in the
  979.           BORAPP & IBMSYS Forums.
  980.  
  981.           VIII. VERSION HISTORY
  982.  
  983.           1.04 09/02/90
  984.                . Fixed bug preventing reading of large calendar files
  985.                . Fixed (Another) bug in repeating appointment routine
  986.  
  987.           1.03
  988.                . Update to help protect against corrupted calendar files.
  989.                There has been a check for, and warning message issued, when
  990.                a repeating appointment record is not found. If you get this
  991.                message check your version of SK+ if it is version 1.00
  992.                contact Borland Customer Service.
  993.  
  994.           1.02
  995.                . Fixed minor bug found in the processing of repeating
  996.                appointments. The bug occurred when appointments were
  997.                deleted with SK+'s "delete previous option". This process
  998.                caused the start date of the appointment to be incorrectly
  999.                calculated by CALTRV.
  1000.  
  1001.           1.01 Fixed Monthly Report Problem when no data on 1st day of
  1002.                Month.
  1003.  
  1004.           1.00 Initial Shareware Release
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.           CALTRV  CALendar for TRaVel Documentation                 Page: 14
  1016.  
  1017.