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