home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / DT / DT028.ZIP / APMANUAL.DOC < prev    next >
Text File  |  1992-01-07  |  92KB  |  2,204 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                             ────────────────────
  11.  
  12.                                     APCAL
  13.  
  14.  
  15.  
  16.  
  17.                             █▀█
  18.                             █     Gamma Software
  19.  
  20.  
  21.                             ────────────────────
  22.  
  23.  
  24.                               COPYRIGHT
  25. _____________________________________________________________________
  26.  
  27.  
  28.    COPYRIGHT
  29.    ---------
  30.    Copyright 1991 by Gamma Software.  All rights reserved.
  31.  
  32.    TRADEMARKS
  33.    ----------
  34.    IBM PC, PC/XT,PC/AT and PS/2 are registered trademarks of
  35.    International Business Machines, Inc.
  36.  
  37.    Proprinter is a trademark of International Business Machines.
  38.  
  39.    Epson FX80 and RX80 are registered trademarks of Epson America, Inc.
  40.  
  41.    DISCLAIMER
  42.    ----------
  43.    Users of APCAL must accept this disclaimer of warranty:
  44.    APCAL is supplied as is.  The author disclaims all
  45.    warranties, expressed or implied, including, without limitation,
  46.    the warranties of merchantability and of fitness for any purpose.
  47.    The author assumes no liability for damages, direct or conse-
  48.    quential, which may result from the use of APCAL.
  49.  
  50.    DEFINITION OF SHAREWARE
  51.    -----------------------
  52.    Shareware distribution gives users a chance to try software
  53.    before buying it. If you try a Shareware program and continue
  54.    using it, you are expected to register. Individual programs
  55.    differ on details -- some request registration while others
  56.    require it, some specify a maximum trial period. With
  57.    registration, you get anything from the simple right to continue
  58.    using the software to an updated program with printed manual.
  59.  
  60.    Copyright laws apply to both Shareware and commercial software,
  61.    and the copyright holder retains all rights, with a few specific
  62.    exceptions as stated below. Shareware authors are accomplished
  63.    programmers, just like commercial authors, and the programs are
  64.    of comparable quality. (In both cases, there are good programs
  65.    and bad ones!) The main difference is in the method of
  66.    distribution. The author specifically grants the right to copy
  67.    and distribute the software, either to all and sundry or to a
  68.    specific group. For example, some authors require written
  69.    permission before a commercial disk vendor may copy their
  70.    Shareware.
  71.  
  72.    Shareware is a distribution method, not a type of software. You
  73.    should find software that suits your needs and pocketbook,
  74.    whether it's commercial or Shareware. The Shareware system makes
  75.    fitting your needs easier, because you can try before you buy.
  76.    And because the overhead is low, prices are low also. Shareware
  77.    has the ultimate money-back guarantee -- if you don't use the
  78.    product, you don't pay for it.
  79.  
  80. _____________________________________________________________________
  81.                                   i
  82.  
  83.                             REGISTRATION 
  84. _____________________________________________________________________
  85.  
  86.  
  87.    REGISTRATION AGREEMENT
  88.    ----------------------
  89.    APCAL is a "shareware program" and is provided at no charge to the 
  90.    user for evaluation.  Feel free to share it with your friends, but 
  91.    please do not give it away altered or as part of another system.  
  92.    The essence of "user-supported" software is to provide personal 
  93.    computer users with quality software without high prices, and yet 
  94.    to provide incentive for programmers to continue to develop new 
  95.    products.  This is not free software, if you continue to use APCAL 
  96.    after a reasonable trial period, you MUST make a registration 
  97.    payment of $35.00 to Gamma Software or discontinue use.  In order
  98.    for Gamma Software to be able to continue developing this product
  99.    we must receive support from those people who use it.  We receive 
  100.    no portion of any fees paid to shareware distributors.  See the 
  101.    next section, "How To Register", for details on how to register.
  102.  
  103.    If you do not continue to use the program, but would like to offer
  104.    suggestions for future changes/enhancements to the program that
  105.    would make it useful to you then send them to the address below.
  106.    If any of your suggestions are implemented and you would like to
  107.    be notified when they are made then indicate such and also include
  108.    your address or Compuserve ID.
  109.  
  110.    The $35.00 registration fee will license one copy for use on any one
  111.    computer at any one time.  You must treat this software just like a
  112.    book.  An example is that this software may be used by any number of
  113.    people and may be freely moved from one computer location to another,
  114.    so long as there is no possibility of it being used at one location
  115.    while it's being used at another.  Just as a book cannot be read by
  116.    two different persons at the same time.
  117.  
  118.    Commercial users of APCAL must register and pay for their copies of 
  119.    APCAL within 30 days of first use or their license is withdrawn.  
  120.    Site-Licenses available.  See the "How To Register" section, below.
  121.                                               
  122.    APCAL cannot be distributed for any kind of remuneration.  It is 
  123.    permissible for distributors to charge a nominal fee (usually not
  124.    more than $5) for the disk that APCAL is shipped on plus shipping
  125.    and handling.  No fee can be charged for the APCAL software itself.
  126.    Gamma Software must be advised by any distributor charging any fee
  127.    for its distribution and the amount of such fees.  This will
  128.    insure that the distributor is kept up-to-date with the latest
  129.    version of APCAL.  Gamma Software reserves the right to withdraw
  130.    distribution rights from any and all distributors.
  131.  
  132.    You are encouraged to pass a copy of APCAL along to your
  133.    friends for evaluation.  Please encourage them to register their
  134.    copy if they find that they can use it.  All registered users
  135.    will receive a copy of the latest version of the APCAL shareware
  136.    system and a printed manual.
  137.  
  138.  
  139. _____________________________________________________________________
  140.                                  ii
  141.  
  142.                             REGISTRATION 
  143. _____________________________________________________________________
  144.  
  145.  
  146.    HOW TO REGISTER
  147.    ---------------
  148.    When you execute the shareware version of the APCAL program a
  149.    shareware registration screen is displayed at the beginning of
  150.    the program.  This screen describes the registration policy and
  151.    at the bottom of the screen is a pop up menu with 3 options.
  152.    To register APCAL press the down arrow key to highlight the 
  153.    second option "Print Registration Invoice".  Then press Enter
  154.    and the invoice will be printed to your printer (make sure your
  155.    printer is on and on-line).  If for some reason the invoice does
  156.    not print then type the following command: "PRINT APINVOIC.DOC"
  157.    at a DOS prompt (while in the APCAL directory).
  158.  
  159.    The next step is to fill in the invoice and mail it to:
  160.  
  161.                         Gamma Software
  162.                         P.O. Box 8191
  163.                         Fort Collins, CO 80526
  164.  
  165.    along with a check or money order for $35 or fill in the required 
  166.    credit card information.
  167.  
  168.    A quicker way to register APCAL is to call:
  169.  
  170.                         (800) 747-9960
  171.  
  172.    and we will take your credit card information over the phone and
  173.    ship your order.
  174.  
  175.    Purchase orders and COD orders are not accepted.
  176.  
  177.    If you wish to purchase a site license then you will also need to
  178.    print and fill in the form contained in the file "APSITE.DOC".
  179.    Mail that form along with the invoice to the address above.  We
  180.    will ship 10 copies of the software with each site license.  You
  181.    may, of course, install the software on all computers at the given
  182.    site when you purchase a site license.
  183.  
  184.    ASP STATEMENT
  185.    -------------
  186.     This program is produced by a member of the Association of Shareware
  187.     Professionals (ASP).  ASP wants to make sure that the shareware
  188.     principle works for you. If you are unable to resolve a
  189.     shareware-related problem with an ASP member by contacting the member
  190.     directly, ASP may be able to help. The ASP Ombudsman can help you
  191.     resolve a dispute or problem with an ASP member, but does not provide
  192.     technical support for members' products.  Please write to the ASP
  193.     Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a CompuServe
  194.     message via CompuServe Mail to ASP Ombudsman 70007,3536.
  195.  
  196.  
  197.  
  198. _____________________________________________________________________
  199.                                  iii
  200.  
  201.                                 INDEX
  202. _____________________________________________________________________
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.    Contents
  210.    --------                                             Page
  211.    Introduction ........................................   1
  212.      Getting Help ......................................   2
  213.      System Requirements ...............................   2
  214.      Manual Conventions ................................   2
  215.    Setup ...............................................   3
  216.    Loading The Alarm Handler ...........................   5
  217.    Upgrading From Version Prior To 3.10 ................   6
  218.    New Features In 3.10 ................................   7
  219.    Getting Started .....................................   8
  220.    Month/Appointment Screen ............................  11
  221.    Appointment Editing .................................  13
  222.    Alarms ..............................................  16
  223.    Monthly Calendar ....................................  18
  224.    Yearly Calendar .....................................  19
  225.    Configuration .......................................  20
  226.    Key Reference .......................................  28
  227.    File Descriptions ...................................  31
  228.    Problem Resolution ..................................  32
  229.    Technical Information ...............................  33
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257. _____________________________________________________________________
  258.                                  iv 
  259.  
  260.                             INTRODUCTION 
  261. _____________________________________________________________________
  262.  
  263.  
  264.    The APCAL program is a time management tool for use on PC compu-
  265.    ters.  It is extremely easy to use.  It contains flexible, customi-
  266.    zable screens with on-line help.
  267.  
  268.    APCAL displays full screen monthly calendars with day blocks in
  269.    which you can type notes just like a wall calendar and print to
  270.    any printer.  The program has a customizable holiday file for
  271.    setting holidays, birthdays, anniversaries, etc. which are automa-
  272.    tically included in the proper calendars.
  273.  
  274.    APCAL allows you to set a default appointment screen to match your
  275.    schedule.  It does not limit you to a certain time interval between
  276.    appointments.  Appointment features include: quick scan, search,
  277.    move, copy, print and more.  An alarm can be set to remind you of
  278.    an appointment a given number of minutes before the appointment 
  279.    even if you are in another program.  
  280.  
  281.    APCAL also contains a unique feature called "boot alarms" which are
  282.    displayed when you boot up your computer.  Great for reminding
  283.    yourself of a particular event that occurs on a certain day but not
  284.    at any particular time.
  285.  
  286.    All alarms can be set to occur over a given time period and will 
  287.    keep resounding if you "snooze" them when they are displayed.
  288.  
  289.    About This Manual
  290.    -----------------
  291.    The APCAL program is intended to be as easy to use as possible, but 
  292.    you should take a few minutes to go through the "Getting Started"
  293.    section of this manual.  The sections following "Getting Started" 
  294.    describe the different features available in the program.  They can 
  295.    be read in any order.
  296.  
  297.    The "Key Reference" section is designed to be used as a reference
  298.    once you become familiar with the program.
  299.  
  300.    The "Technical Information" section gives you more detailed infor-
  301.    mation on some aspects of the program.
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316. _____________________________________________________________________
  317.                                   1 
  318.  
  319.                             INTRODUCTION 
  320. _____________________________________________________________________
  321.  
  322.  
  323.    Getting Help
  324.    ------------
  325.    If you have a problem with the APCAL software first look to the
  326.    "Problem Resolution" section which contains solutions for the most
  327.    commonly encountered problems.  If you are still having difficulty
  328.    then support may be obtained by writing to:
  329.       Gamma Software
  330.       P.O. Box 8191
  331.       Fort Collins, CO 80526
  332.    Please describe the problem in sufficient detail so that it can be
  333.    reproduced by us.
  334.  
  335.    Support may also be obtained by calling (303) 667-9960, 8am-5pm
  336.    Mountain time (Mon-Fri).  It can also be obtained by sending mail
  337.    to [73737,1721] on Compuserve.
  338.  
  339.    Support is currently free and unlimited.  We do reserve the right
  340.    to change these policies in the future.
  341.  
  342.  
  343.    System Requirements
  344.    -------------------
  345.    - IBM PC, XT, AT, PS/2 or compatible.
  346.    - 256k ram
  347.    - DOS 2.0 or later.
  348.    - Screen mode is assumed to be 80 columns and 25 lines (greater line
  349.      modes can be set but only the first 25 lines will be used).
  350.    - Hard disk recommended.
  351.  
  352.    Manual Conventions
  353.    ------------------
  354.    When two keys need to be pressed simultaneously to perform a given
  355.    operation they are separated by a plus (+).  For example Shift+Tab
  356.    means to press the Shift key and hold it down while the Tab key is
  357.    pressed.  The arrow keys are denoted as Right, Left, Up and Down.
  358.    File names are in all capital letters.  There is an implied Enter
  359.    at the end of most commands (i.e. you must press the Enter key
  360.    after typing in the command).
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375. _____________________________________________________________________
  376.                                   2 
  377.  
  378.                                 SETUP
  379. _____________________________________________________________________
  380.  
  381.  
  382.    SYSTEMS WITH NO HARD DISK
  383.    -------------------------
  384.    This program can be run on systems with no hard disk.  After
  385.    booting your computer put in the APCAL program disk and change
  386.    to the drive and directory containing the APCAL software.  Then
  387.    type:
  388.  
  389.       alarm a:
  390.  
  391.    Replace the text "a:" with the path of the APCAL directory.  Do
  392.    not end the path with a backslash (\) one is automatically appended
  393.    to the end.  This will load the alarm handler.  
  394.    
  395.    The alarm handler searches the path given as a command line 
  396.    argument for alarm files and sets any that it finds for the current 
  397.    date.  Whenever you save an alarm for the current day in the main 
  398.    APCAL program the alarm tsr will attempt to reread the alarm file 
  399.    in the directory you specified on the command line when you loaded 
  400.    it.  This means you should always put the APCAL disk into the same 
  401.    drive.  For example if you put the APCAL disk in drive a: and 
  402.    loaded the alarm handler and then at some time in the future you put 
  403.    the APCAL disk in drive b: and saved an alarm the tsr will look for 
  404.    the alarm file in the a: drive and not the b: drive.
  405.  
  406.    If you have a two drive system then you could put the following
  407.    lines in your AUTOEXEC.BAT to automatically load the alarm handler.
  408.  
  409.       pause Insert APCAL disk in drive b:
  410.       b:\alarm b:
  411.  
  412.    This will load the alarm handler from the root directory of drive
  413.    b: and you should always run APCAL from b:\.
  414.  
  415.    HARD DISK SETUP
  416.    ---------------
  417.    The setup program will modify your AUTOEXEC.BAT to contain the
  418.    proper line to load the alarm handler.  If you have already run
  419.    the setup program then you can skip this section.  This setup is
  420.    for hard disk systems ONLY.  See the section above for information
  421.    on systems with no hard disk.
  422.  
  423.    To run the setup program change to the drive and directory where
  424.    APCAL has been loaded.  For example type the following commands.
  425.  
  426.       C:
  427.       CD \APCAL
  428.  
  429.    Modify the two lines above to reflect where you loaded APCAL. 
  430.    Then type:
  431.  
  432.       APSETUP
  433.  
  434. _____________________________________________________________________
  435.                                   3 
  436.  
  437.                                 SETUP
  438. _____________________________________________________________________
  439.  
  440.  
  441.    The setup program first prompts you for the drive that you boot
  442.    from.  The default of "c" is normally correct.  If you use another
  443.    drive then type in the drive letter and press Enter.  The program
  444.    will look in the root directory of the drive specified for the
  445.    file AUTOEXEC.BAT.
  446.  
  447.    If the program does not find the file you entered then it will ask
  448.    you if you want to create it.  Answering no (pressing the n key
  449.    and then Enter) will cause the program to prompt you for the name
  450.    again.  Answering yes (y Enter) will create it with the line to 
  451.    load the alarm handler in it.  If the file could not be created 
  452.    then the program will prompt you for the drive again.  You can 
  453.    abort the setup process by pressing Esc at the drive prompt.
  454.  
  455.    If the file exists the program will search for any existing lines
  456.    that need to be replaced.  If it finds any then it displays them,
  457.    otherwise it displays only the new line to be added.  The setup 
  458.    program then prompts you whether to make the indicated changes or 
  459.    not.  Answering yes will replace the given line(s) (if any) with 
  460.    the new line.  A backup of your AUTOEXEC.BAT is created with the 
  461.    displayed file name.  Answering no will leave your AUTOEXEC.BAT 
  462.    unchanged and you must make the modifications yourself.
  463.  
  464.    If the AUTOEXEC.BAT file was successfully updated the setup
  465.    program will prompt you to press Ctrl+Alt+Delete to reboot your
  466.    machine and load the alarm handler.  You must always boot your
  467.    computer from the disk containing the AUTOEXEC.BAT that contains
  468.    the line to load the alarm handler in order for the alarms to work.
  469.    The setup program will also display the command you must type once 
  470.    the computer has rebooted to execute the main APCAL program.
  471.  
  472.    DOS 2.x NOTE
  473.    ------------
  474.    The APCAL program cannot detect what directory it was run from if
  475.    you are running under a version of DOS less than 3.0.  This means
  476.    you must set the APCAL environment variable if you are using DOS
  477.    2.x.  A command similar to the following should be placed in your
  478.    AUTOEXEC.BAT file.
  479.  
  480.       set apcal=c:\apcal
  481.  
  482.    Replace the text "c:\apcal" with the directory you loaded APCAL
  483.    into.
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493. _____________________________________________________________________
  494.                                   4 
  495.  
  496.                                 ALARM
  497. _____________________________________________________________________
  498.  
  499.  
  500.    ALARM
  501.    -----
  502.    The alarm feature of this software requires that a memory resident
  503.    alarm handler be loaded.  If you do not wish to use the alarm
  504.    feature in APCAL then you can skip this section.  The setup program
  505.    will modify your AUTOEXEC.BAT to automatically load the alarm
  506.    handler.  If you have completed running the setup program then you
  507.    can skip this section.  This section describes the details of
  508.    loading the alarm handler.
  509.  
  510.    To load the alarm handler type a command similar to the following.
  511.  
  512.       C:\APCAL\ALARM C:\APCAL
  513.  
  514.    and press Enter.  The "C:\APCAL" must be replaced with the path of
  515.    the directory that you loaded APCAL into.
  516.  
  517.    If the program loads correctly then the following will be dis-
  518.    played.
  519.  
  520.       Alarm file path: C:\APCAL\ALR11-05.91
  521.       Alarm 2.00
  522.       Copyright (c) 1991 Gamma Software
  523.  
  524.    The "C:\APCAL" will contain the path you specified on the command
  525.    line.  The "ALR11-05.91" is the name of the alarm file that will be
  526.    used for the current day.  The format of the file name is
  527.    ALRmm-dd.yy where mm, dd and yy are replaced by the month, day
  528.    and year.  The APCAL program creates the alarm files.
  529.  
  530.    If the syntax of the command to load the alarm handler is not
  531.    correct then the program will display the following and not load.
  532.  
  533.       Syntax:   alarm d:\path
  534.  
  535.    If the alarm handler has already been loaded then the following
  536.    will be displayed.
  537.  
  538.       ALARM already installed
  539.  
  540.    The alarm handler can only be loaded once.  The only way to remove
  541.    it from memory is to reboot the computer.
  542.  
  543.    Alarms will only sound if the alarm handler is loaded.
  544.  
  545.  
  546.    
  547.  
  548.  
  549.  
  550.  
  551.  
  552. _____________________________________________________________________
  553.                                   5 
  554.  
  555.                    UPGRADING FROM PREVIOUS VERSION
  556. _____________________________________________________________________
  557.  
  558.  
  559.    Upgrading From Previous Versions Of APCAL
  560.    -----------------------------------------
  561.    Version 3.10 of APCAL no longer requires the APCAL environment
  562.    variable to be set as long as you are using DOS 3.0 or higher.  If 
  563.    no environment variable is set then APCAL will use the directory 
  564.    that it was run from as the working directory.  For compatibility 
  565.    with previous versions the program first checks for an environment 
  566.    variable and then uses the directory it was run from if none exists.
  567.  
  568.    Version 3.10 will not recognize reminder files at all and will not
  569.    recognize appointment files prior to 3.10 format.  If you have 
  570.    appointment/reminder files that you want to use in 3.10 then you
  571.    must update them using the following procedure.
  572.  
  573.    The 3.0x versions of APCAL contained appointment and reminder
  574.    files.  The reminder screen has been removed in version 3.10 and
  575.    replaced with the arbitrary alarm screen.  The appointment files
  576.    in version 3.10 also contain an alarm field and version 3.0x
  577.    appointment files do not.
  578.  
  579.    The versions of APCAL prior to 3.0x used an appointment file
  580.    similar to the 3.10 format but they do not contain the extra alarm
  581.    information that 3.10 appointment files contain.
  582.  
  583.    The file APUPDATE.EXE will convert files from all versions of
  584.    APCAL prior to 3.10 to 3.10 format.  The first step in this process 
  585.    should be to copy the existing reminder and appointment files to a 
  586.    floppy as a backup so they can be restored should anything go wrong.  
  587.    For example type 2 commands similar to the following:
  588.       COPY REM*.* A:\
  589.       COPY APP*.* A:\
  590.    The next step is to place the file APUPDATE.EXE in the APCAL 
  591.    directory and type the following command.
  592.       APUPDATE
  593.    It will then list the appointment and reminder files it has found
  594.    and convert them.
  595.  
  596.    The APUPDATE program converts 3.0x appointment files to 3.10 
  597.    appointment files with no alarms set.  The appointment text is 
  598.    shifted right by 2 characters to make room for the alarm column.  
  599.    This means that the appointment text may be truncated by 2 char-
  600.    acters at the end.  The 3.0x reminder files are converted to arbi-
  601.    trary alarms which are stored in an alarm file (ALR*.*).
  602.  
  603.    If appointment files are found for versions prior to 3.0 then the
  604.    additional alarm information required for version 3.10 is generated
  605.    and the files are written in 3.10 format.  The "y" or "Y" character
  606.    is converted to a check mark and the minutes before and duration
  607.    parameters are set to 0.
  608.  
  609.  
  610.  
  611. _____________________________________________________________________
  612.                                   6 
  613.  
  614.                          NEW FEATURES IN 3.10
  615. _____________________________________________________________________
  616.  
  617.  
  618.    New Features In 3.10
  619.    --------------------
  620.    - Several new configuration options have been added including:
  621.         Printer Configuration
  622.         Holiday Configuration
  623.         Start Screen Configuration
  624.         Alarm Configuration 
  625.    - The program now uses a pull down menu system.
  626.    - Alarms can be set to go off a specified number of minutes before
  627.      an appointment and will keep coming back for a specified number
  628.      of minutes if snoozed.
  629.    - Alarms can be set that do not correspond to an appointment and
  630.      can be set to go off when the computer is booted.
  631.    - The alarm handler has been significantly updated it now:  
  632.         Works on any PC
  633.         Does not require a hard disk
  634.         Can display more than one alarm at a time
  635.         Has a snooze mode
  636.         Can display an alarm over a time interval            
  637.    - Time and date clock is built into the program.
  638.    - The program now has the ability to temporarily shell to DOS.
  639.    - The on-line help has been expanded.
  640.    - The program no longer requires an environment variable.      
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670. _____________________________________________________________________
  671.                                   7 
  672.  
  673.                            GETTING STARTED
  674. _____________________________________________________________________
  675.  
  676.  
  677.    EXECUTING APCAL
  678.    ---------------
  679.    To start up the APCAL program type a command similar to the
  680.    following.
  681.  
  682.       C:\APCAL\APCAL
  683.  
  684.    and press Enter.  The "C:\APCAL" must be replaced with the path of
  685.    the directory that you loaded APCAL into.  After typing in the
  686.    above command the copyright screen will display for a brief period.
  687.    In unregistered versions this is followed by the shareware infor-
  688.    mation screen, press Enter to continue to the next APCAL screen.  
  689.    Unless the program has been reconfigured the split screen month/
  690.    appointment display will appear next.
  691.  
  692.    PULL DOWN MENU
  693.    --------------
  694.    The pull down menu at the top of the screen has several options
  695.    which can be used throughout the program.  To activate this menu
  696.    press the Alt key.  This will highlight the "File" field.  The
  697.    right and left arrow keys can be used to move from one field to
  698.    another.  To pull down the sub-menu for a field press the Enter
  699.    key.  Pressing one of the bold characters on the top line of
  700.    the pull down will move to that field and pull down its sub-menu.
  701.    If a sub-menu is already pulled down then the bold characters on
  702.    the top line are no longer active.  The up and down arrow keys 
  703.    can be used to move from one sub-menu field to another.  Pressing
  704.    Enter selects the currently highlighted sub-menu field.  Pressing
  705.    the bold character of one of the sub-menu fields automatically
  706.    selects it.  Pressing Esc exits the pull down without making a 
  707.    selection.  Once a selection is made or Esc pressed the appropriate 
  708.    action is taken and control is returned to the main menu below.
  709.  
  710.    When a field in the pull down menu is not currently active it is dis-
  711.    played in a different color (usually dark grey on most color monitors
  712.    and totally blacked out on monochrome monitors).  Selecting one of
  713.    these fields does nothing.
  714.  
  715.    The following sections describe the main menu fields of the pull down
  716.    menu.  The "Edit" section is different depending on what section of
  717.    the program you are in.  It is described in the help for each section.
  718.    Some of the pull down options can be executed directly without going
  719.    through the pull down, these options list the appropriate key(s) (to
  720.    the right in parenthesis) to type to execute the command directly.
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728. _____________________________________________________________________
  729.                                   8 
  730.  
  731.                            GETTING STARTED
  732. _____________________________________________________________________
  733.  
  734.  
  735.    Files
  736.    -----
  737.    The files section of the main pull down has the following options:
  738.    Save, Delete, Print, Dos Shell and Exit.
  739.  
  740.    Save - Saves the currently displayed appointment, monthly calendar or
  741.       alarm file.  The file is saved to the directory set by the
  742.       APCAL environment variable or, if none was set, from the
  743.       directory APCAL was run from.
  744.    Delete - Deletes the currently displayed appointment, monthly calendar
  745.       or alarm file.
  746.    Print - Prints the currently displayed appointment or monthly calendar
  747.       file.
  748.    Dos Shell - Temporarily brings up the DOS command line.  It is import-
  749.       ant to remember to type "exit" when you are done to return to the
  750.       program since it is still taking up memory.  If you wish to perma-
  751.       nently leave the program use the "Exit" selection below.
  752.    Exit - Ends the program and unloads it from memory.
  753.  
  754.    Options
  755.    -------
  756.    The options section of the main pull down has the following options:
  757.    Appointments (F2), Alarm (F3), Month Calendar (F4), Year Calendar
  758.    (F5) and Month/Appt. (F6).
  759.  
  760.    Appointments - switches to the appointment edit screen.  The appoint-
  761.       ment file for the currently selected date is displayed.
  762.    Alarm - switches to the arbitrary alarm edit screen.  The arbitrary
  763.       alarms for the currently selected date (if any) are displayed.
  764.    Month Calendar - switches to the monthly calendar edit screen.  The
  765.       monthly calendar for the currently selected date is displayed.
  766.    Year Calendar - switches to the yearly calendar display.
  767.    Month/Appt. - switches to the split screen month/appointment display.
  768.  
  769.    Search
  770.    ------
  771.    The search section of the main pull down has the following options:
  772.    Forward (F7) and Backward (Shift+F7).  This pull down sub-menu is 
  773.    only active when the split month/appointment display is active.
  774.  
  775.    Forward - search for the given text in appointment files after the
  776.       current date.
  777.    Backward - search for the given text in appointment files before the
  778.       current date.
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787. _____________________________________________________________________
  788.                                   9 
  789.  
  790.                            GETTING STARTED
  791. _____________________________________________________________________
  792.  
  793.  
  794.    Program Config.
  795.    ---------------
  796.    The configuration section of the main pull down has the following
  797.    options: Color, Appointment Template, Printer, Holidays, Start Screen
  798.    and Alarm.
  799.  
  800.    Color - configures the program colors.
  801.    Appointment Template - configures the default appointment screen.
  802.    Printer - configures printer parameters.
  803.    Holidays - configures the holidays that are automatically built into
  804.       the monthly calendars when the are first created.
  805.    Start Screen - configures the first screen that appears when the pro-
  806.       gram is loaded.
  807.    Alarm - configures the alarm parameters.
  808.  
  809.    See each of these sections form more information.
  810.  
  811.    Help
  812.    ----
  813.    The help section of the main pull down has the following options:
  814.    General, Appointment, Alarm, Month Calendar, Year Calendar, Month/
  815.    Appt. and Configuration.  Each brings up the help information for
  816.    the indicated topic.
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845. _____________________________________________________________________
  846.                                  10 
  847.  
  848.                        MONTH/APPOINTMENT SCREEN
  849. _____________________________________________________________________
  850.  
  851.  
  852.    The split screen month/appointment display is used to quickly scan
  853.    your appointments for the current and coming days.  It is also
  854.    used to search for a particular appointment.
  855.  
  856.    ┌─────────────────────────────────────────────────────────────────┐
  857.    │ File  Edit  Options  Search  Program Config.  Help(F1)          │
  858.    │ OCTOBER        1991  TIME │am│A│                               ││
  859.    │  S  M  T  W  T  F  S│HR:MN│pm│L│  Appointments                 ││
  860.    │        1  2  3  4  5│─────┴──┼─┼───────────────────────────────││
  861.    │  6  7  8  9 10 11 12│ 7:30 am│ │                               ││
  862.    │ 13 14 15 16 17 18 19│ 8:00 am│ │                               ││
  863.    │ 20 21 22 23 24 25 26│ 8:30 am│ │                               ││
  864.    │ 27 28 29 30 31      │ 9:00 am│ │                               ││
  865.    │                     │ 9:30 am│ │                               ││
  866.    │ NOVEMBER       1991 │10:00 am│ │                               ││
  867.    │  S  M  T  W  T  F  S│10:30 am│ │                               ││
  868.    │                 1  2│11:00 am│ │                               ││
  869.    │  3  4  5  6  7  8  9│11:30 am│ │                               ││
  870.    │ 10 11 12 13 14 15 16│12:00 pm│ │                               ││
  871.    │ 17 18 19 20 21 22 23│12:30 pm│ │                               ││
  872.    │ 24 25 26 27 28 29 30│ 1:00 pm│ │                               ││
  873.    │                     │ 1:30 pm│ │                               ││
  874.    │ DECEMBER       1991 │ 2:00 pm│ │                               ││
  875.    │  S  M  T  W  T  F  S│ 2:30 pm│ │                               ││
  876.    │  1  2  3  4  5  6  7│ 3:00 pm│ │                               ││
  877.    │  8  9 10 11 12 13 14│ 3:30 pm│ │                               ││
  878.    │ 15 16 17 18 19 20 21│ 4:00 pm│ │                               ││
  879.    │ 22 23 24 25 26 27 28│ 4:30 pm│ │                               ││
  880.    │ 29 30 31            │ 5:00 pm│ │                               ││
  881.    │                     │ 5:30 pm│ │                               ││
  882.    └─────────────────────┴────────┴─┴───────────────────────────────┴┘
  883.           FIGURE  1 - Split Screen Month/Appointment Display
  884.  
  885.    This screen displays 3 months on the left with the current month
  886.    in the middle.  The current day is highlighted and the appointment
  887.    file for that day is displayed on the right.  The arrow keys are
  888.    used to highlight different days in the month.  The appointment
  889.    file for the currently highlighted day is displayed on the right.
  890.  
  891.    To scroll the monthly calendars ahead one month press Ctrl+Right
  892.    or select the "Next Month" option from the "Edit" pull down.  To
  893.    scroll the monthly calendars back one month press Ctrl+Left or
  894.    select "Previous Month" from the "Edit" pull down.  To return the
  895.    actual month to the middle and the highlighted day to the actual
  896.    day press Ctrl+Home.
  897.  
  898.    Pressing F1 brings up the help information on the month/appt.
  899.    display.
  900.  
  901.    To search for a given text string in the appointment files after
  902.    the current date press F7.  Pressing Shift+F7 causes the program
  903.    to search backward from the current date.  Both will bring up a
  904. _____________________________________________________________________
  905.                                  11 
  906.  
  907.                        MONTH/APPOINTMENT SCREEN
  908. _____________________________________________________________________
  909.  
  910.  
  911.    menu on the top line of the display where you can enter the text
  912.    you want to search for.  Press Enter when you have entered the
  913.    desired text or press Esc to cancel the search operation.  If the
  914.    specified text is found in an appointment file then that date is
  915.    made current and the appointment file is displayed to the right.
  916.    The search string defaults to the last value so you can search for
  917.    more than one occurrence of the given text.
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963. _____________________________________________________________________
  964.                                  12 
  965.  
  966.                           APPOINTMENT SCREEN
  967. _____________________________________________________________________
  968.  
  969.  
  970.    The appointment screen is used to create and edit your appointments
  971.    for the currently selected date.
  972.  
  973.    ┌─────────────────────────────────────────────────────────────────┐
  974.    │  File  Edit  Options  Search  Program Config.  Help(F1)         │
  975.    │TIME │am│A│                                                     ││
  976.    │HR:MN│pm│L│  Appointments               MONDAY 11- 4-91         ││
  977.    ├─────┴──┼─┼─────────────────────────────────────────────────────││
  978.    │ 7:30 am│ │                                                     ││
  979.    │ 8:00 am│ │                                                     ││
  980.    │ 8:30 am│ │                                                     ││
  981.    │ 9:00 am│ │                                                     ││
  982.    │ 9:30 am│ │                                                     ││
  983.    │10:00 am│ │                                                     ││
  984.    │10:30 am│ │                                                     ││
  985.    │11:00 am│ │                                                     ││
  986.    │11:30 am│ │                                                     ││
  987.    │12:00 pm│ │                                                     ││
  988.    │12:30 pm│ │                                                     ││
  989.    │ 1:00 pm│ │                                                     ││
  990.    │ 1:30 pm│ │                                                     ││
  991.    │ 2:00 pm│ │                                                     ││
  992.    │ 2:30 pm│ │                                                     ││
  993.    │ 3:00 pm│ │                                                     ││
  994.    │ 3:30 pm│ │                                                     ││
  995.    │ 4:00 pm│ │                                                     ││
  996.    │ 4:30 pm│ │                                                     ││
  997.    │ 5:00 pm│ │                                                     ││
  998.    │ 5:30 pm│ │                                                     ││
  999.    └────────┴─┴─────────────────────────────────────────────────────┴┘
  1000.                    FIGURE  2 - Appointment Edit Screen
  1001.  
  1002.    If an appointment file has been previously saved for this date
  1003.    then it is displayed.  Otherwise the default appointment template
  1004.    is displayed (see Appointment Template Configuration).
  1005.  
  1006.    Many of the operations described below can be selected from the
  1007.    "Edit" pull down or by using the key(s) mentioned.  Use whatever
  1008.    method you prefer.
  1009.  
  1010.    Use the up,down,right and left arrow keys to position the cursor to
  1011.    the desired time.  If no time exactly matches the time of your
  1012.    appointment then the time fields can be edited.  Press the F9 key
  1013.    to toggle editing of the time fields.  Type in any text you desire
  1014.    to describe the appointment.  Repeat this procedure until all
  1015.    appointments have been entered.  Press ALT+f to bring up the "File"
  1016.    pull down and select "Save" to save the appointments to a file.
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022. _____________________________________________________________________
  1023.                                  13 
  1024.  
  1025.                           APPOINTMENT SCREEN
  1026. _____________________________________________________________________
  1027.  
  1028.  
  1029.    *** NOTE ***
  1030.    Trying to exit this screen without saving changes made to the 
  1031.    appointments will bring up the following prompt:
  1032.                  "File has not been saved. Exit? Y/N "
  1033.    Press the "Y" key and then Enter if you do not wish to save the 
  1034.    changes you have made.  Press "N" and Enter if you do wish to save 
  1035.    the changes.  Then select "Save" from the "File" pull down.
  1036.  
  1037.    To move an appointment to another time position the cursor on the
  1038.    line containing the appointment and press ALT+m.  This will copy
  1039.    the line to a scratch buffer and erase it.  Then position the
  1040.    cursor to the new time for the appointment and press Alt+i.  This
  1041.    will overwrite the current line with the text in the scratch
  1042.    buffer.
  1043.  
  1044.    To move an appointment to another time and day position the cursor
  1045.    on the line containing the appointment and press Alt+m.  Select 
  1046.    "Save" from the "File" pull down.  Press F6 to bring up the month/
  1047.    appt. display and highlight the new date for the appointment.  Then 
  1048.    press F2 to edit that appointment file.  Position the cursor to the 
  1049.    desired time and press Alt+i.
  1050.  
  1051.    The scratch buffer always contains the text from the last Alt+c or
  1052.    Alt+m operation.  It may be inserted with Alt+i as many times as
  1053.    desired.  The only difference between Alt+c and Alt+m is that Alt+c
  1054.    (copy) does not erase the current line and Alt+m (move) does.
  1055.  
  1056.    To delete all the characters from the current cursor position to the
  1057.    end of the line press Alt+d.  To delete an entire line press Alt+l.
  1058.  
  1059.    To set/remove an alarm for the appointment at the current cursor posi-
  1060.    tion press Alt+a.  This brings up the appointment alarm menu.
  1061.  
  1062.              ┌─────────────────────────────┐
  1063.              │Alarm: OFF                   │
  1064.              │Number Of Minutes Before:  10│
  1065.              │Duration (minutes):  10      │
  1066.              │                             │
  1067.              │         OK   CANCEL         │
  1068.              │                             │
  1069.              │ 0 Appointment Alarms        │
  1070.              │ 0 Arbitrary Alarms          │
  1071.              │10 Alarms Available          │
  1072.              └─────────────────────────────┘
  1073.             FIGURE  3 - Appointment Alarm Menu
  1074.  
  1075.    The first field in the alarm menu toggles the alarm ON and OFF.
  1076.    Press the space bar to toggle between the 2 values.  Tab moves to
  1077.    the next field and Shift+Tab moves to the previous.  The next field
  1078.    sets the number of minutes before the appointment the alarm will
  1079.    sound.  Entering anything other than an integer number of minutes
  1080.  
  1081. _____________________________________________________________________
  1082.                                  14 
  1083.  
  1084.                           APPOINTMENT SCREEN
  1085. _____________________________________________________________________
  1086.  
  1087.  
  1088.    causes a beep and the field cannot be exited until an integer is
  1089.    entered.  The duration field sets the number of minutes the alarm
  1090.    will continue to sound if it is snoozed.  It must also be an integer.
  1091.  
  1092.    For example if the current appointment time is 2:00 pm and the number
  1093.    of minutes before value is set to 15 and the duration is set to 15
  1094.    then the alarm will sound at 1:45 pm.  If Alt+s is pressed when the
  1095.    alarm sounds then the alarm will snooze for the time period set in the
  1096.    alarm configuration.  If this value is 5 then the alarm will sound
  1097.    again 5 minutes from the time at which Alt+s was pressed.  This con-
  1098.    tinues until Alt+e is pressed or the time is later than 2:00 pm (1:45
  1099.    plus the 15 minute duration).
  1100.  
  1101.    Pressing Enter on the OK field sets the alarm using the entered para-
  1102.    meters and ends the alarm menu.  Pressing Enter on the CANCEL field
  1103.    ends the alarm menu and discards any changes made to the parameters.
  1104.    Pressing Esc on any field has the same effect.
  1105.  
  1106.    Appointments with alarms have a check in the alarm column.  Up to 10
  1107.    alarms can be set for any day.  This includes any alarms set in the
  1108.    arbitrary alarm menu.
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140. _____________________________________________________________________
  1141.                                  15 
  1142.  
  1143.                                 ALARMS
  1144. _____________________________________________________________________
  1145.  
  1146.  
  1147.    Alarms
  1148.    ------
  1149.    There are 2 types of alarms that can be set in this program: Appoint-
  1150.    ment alarms and Arbitrary alarms.  The appointment alarms are assoc-
  1151.    iated with an appointment and are set in the appointment edit screen
  1152.    (described above).  Arbitrary alarms are arbitrary in the sense that
  1153.    they can be set for any time range and are not associated with an
  1154.    appointment.
  1155.  
  1156.    The "Alarm" selection on the "Options" pull down allows the setting
  1157.    of arbitrary alarms.
  1158.  
  1159.    ┌─────────────────────────────────────────────────────────────────┐
  1160.    │  File  Edit  Options  Search  Program Config.  Help(F1)         │
  1161.    │                                                                 │
  1162.    │->ALARM 1 Message                                                │
  1163.    │  ALARM 2 Message                                                │
  1164.    │  ALARM 3 Message                                                │
  1165.    │  ALARM 4 Message                                                │
  1166.    │  ALARM 5 Message                                                │
  1167.    │                                                                 │
  1168.    │                                                                 │
  1169.    │                                                                 │
  1170.    │                                                                 │
  1171.    │┌───────────────────────────────────────────────────────────────┐│
  1172.    ││Alarm: REG                              0 Appointment Alarms   ││
  1173.    ││Start Time: 11:00 am                    5 Arbitrary Alarms     ││
  1174.    ││End Time:   11:30 am                    5 Alarms Available     ││
  1175.    ││Message:                                MONDAY 11- 4-91        ││
  1176.    ││ALARM 1 Message                                                ││
  1177.    ││                                                               ││
  1178.    ││                                                               ││
  1179.    │└───────────────────────────────────────────────────────────────┘│
  1180.    └─────────────────────────────────────────────────────────────────┘
  1181.                   FIGURE  4 - Arbitrary Alarm Screen
  1182.  
  1183.    The top portion of the arbitrary alarm screen consists of the message
  1184.    text for each alarm set for the current date.  The arrow (->) at the
  1185.    left points to the selected alarm.  The parameters associated with
  1186.    this alarm are displayed in the box in the bottom portion of the
  1187.    screen.  The up and down arrow keys can be used to select other alarms
  1188.    in the list.  The "File" options on the pull down menu can be used to
  1189.    save and delete the alarm file for the currently selected date.
  1190.  
  1191.    When Alt+a or Alt+m is pressed the parameter menu at the bottom of
  1192.    the screen is activated.  These parameters can then be edited.  Alt+a
  1193.    adds a new alarm and Alt+m allows the modification of the parameters
  1194.    for the currently selected alarm.  Tab moves to the next field and
  1195.    Shift+Tab moves to the previous field in this menu.
  1196.  
  1197.  
  1198.  
  1199. _____________________________________________________________________
  1200.                                  16 
  1201.  
  1202.                                 ALARMS
  1203. _____________________________________________________________________
  1204.  
  1205.  
  1206.    The first field in the alarm parameter menu determines whether the
  1207.    alarm is a REGULAR or BOOT alarm.  The space bar toggles between the
  1208.    2 values.  Regular alarms occur for the time interval given in the
  1209.    start and end time fields.  Boot alarms occur when the computer is
  1210.    first booted and continue until midnight unless terminated.
  1211.  
  1212.    The start time fields set the time when the alarm will first sound
  1213.    if it is a REGULAR alarm.  The hours field must be an integer between
  1214.    1 and 12 and the minutes field must be an integer between 0 and 59.
  1215.    Entering anything else causes a beep and the field cannot be exited
  1216.    until a valid integer is entered.  The last field on the start time
  1217.    line indicates whether the time is am or pm.  Use the space bar to
  1218.    toggle between the 2 values.
  1219.  
  1220.    The end time sets the end of a REGULAR alarm.  The fields have the
  1221.    same restrictions as the start time fields.
  1222.  
  1223.    The start and end time are not set for BOOT alarms.
  1224.  
  1225.    For example if a regular alarm is set to start at 1:45 pm and end at
  1226.    2:00 pm then the alarm will first sound at 1:45 pm.  If Alt+s is
  1227.    pressed when the alarm sounds then the alarm will snooze for the time
  1228.    period set in the alarm configuration.  If this value is 5 then the
  1229.    alarm will sound again 5 minutes from the time at which Alt+s was
  1230.    pressed.  This continues until Alt+e is pressed or the time is later
  1231.    than 2:00 pm.
  1232.  
  1233.    The message field sets the text that will be displayed when the alarm
  1234.    sounds.
  1235.  
  1236.    Pressing Enter on the OK field accepts the entered parameters and 
  1237.    ends the alarm parameter menu.  Pressing Enter on the CANCEL field 
  1238.    ends the alarm parameter menu and discards any changes made to the 
  1239.    parameters.  Pressing Esc on any field has the same effect.
  1240.  
  1241.    Up to 10 alarms can be set for any day.  This includes any alarms set
  1242.    in the appointment menu.
  1243.  
  1244.    *** NOTE ***
  1245.    The alarms are not set until "Save" is selected from the "File" 
  1246.    pull down.
  1247.  
  1248.    *** NOTE ***
  1249.    Trying to exit this screen without saving changes made to the 
  1250.    alarms will bring up the following prompt:
  1251.                  "File has not been saved. Exit? Y/N "
  1252.    Press the "Y" key and then Enter if you do not wish to save the 
  1253.    changes you have made.  Press "N" and Enter if you do wish to save 
  1254.    the changes.  Then select "Save" from the "File" pull down.
  1255.  
  1256.  
  1257.  
  1258. _____________________________________________________________________
  1259.                                  17 
  1260.  
  1261.                            MONTHLY CALENDAR
  1262. _____________________________________________________________________
  1263.  
  1264.  
  1265.    The monthly calendar screen is used to edit the monthly calendar
  1266.    for the currently selected date.
  1267.  
  1268.    ┌──────────────────────────────────────────────────────────────┐
  1269.    │  File  Edit  Options  Search  Program Config.  Help(F1)      │
  1270.    ├───SUN──┬───MON──┬───TUE──┬───WED──┬───THU──┬───FRI──┬───SAT──┤
  1271.    │        │        │        │        │        │1       │2       │
  1272.    │        │        │        │        │        │        │        │
  1273.    │        │        │        │        │        │        │        │
  1274.    ├────────┼────────┼────────┼────────┼────────┼────────┼────────┤
  1275.    │3       │4       │5       │6       │7       │8       │9       │
  1276.    │        │        │        │        │        │        │        │
  1277.    │        │        │        │        │        │        │        │
  1278.    ├────────┼────────┼────────┼────────┼────────┼────────┼────────┤
  1279.    │10      │11      │12      │13      │14      │15      │16      │
  1280.    │        │        │        │        │        │        │        │
  1281.    │        │        │        │        │        │        │        │
  1282.    ├────────┼────────┼────────┼────────┼────────┼────────┼────────┤
  1283.    │17      │18      │19      │20      │21      │22      │23      │
  1284.    │        │        │        │        │        │        │        │
  1285.    │        │        │        │        │        │        │        │
  1286.    ├────────┼────────┼────────┼────────┼────────┼────────┼────────┤
  1287.    │24      │25      │26      │27      │28      │29      │30      │
  1288.    │        │        │        │        │Thnksgvn│        │        │
  1289.    │        │        │        │        │        │        │        │
  1290.    ├────────┼────────┼────────┼────────┼────────┼────────┼────────┤
  1291.    │        │        │        │        │        │        │        │
  1292.    │        │        │        │        │        │        │NOVEMBER│
  1293.    │        │        │        │        │        │        │1991    │
  1294.    └────────┴────────┴────────┴────────┴────────┴────────┴────────┘
  1295.                   FIGURE  5 - Monthly Calendar Screen
  1296.  
  1297.    If a monthly calendar file has been previously saved for this date
  1298.    then it is displayed.  Otherwise one is built for the currently
  1299.    selected month including any holidays configured for the month.
  1300.  
  1301.    Any text you desire can be typed into the day boxes of the calendar.
  1302.    Use the TAB and Shift+Tab keys to move from on day to another.
  1303.  
  1304.    Press Ctrl+Right to move to the next monthly calendar or Ctrl+Left
  1305.    to move to the previous.  Ctrl+Home returns to the actual date.
  1306.    These options can also be selected from the "Edit" pull down.
  1307.  
  1308.    *** NOTE ***
  1309.    Trying to exit this screen without saving changes made to the 
  1310.    calendar will bring up the following prompt:
  1311.                  "Calendar has not been saved. Exit? Y/N "
  1312.    Press the "Y" key and then Enter if you do not wish to save the 
  1313.    changes you have made.  Press "N" and Enter if you do wish to save 
  1314.    the changes.  Then select "Save" from the "File" pull down.
  1315.  
  1316.  
  1317. _____________________________________________________________________
  1318.                                  18 
  1319.  
  1320.                            YEARLY CALENDAR
  1321. _____________________________________________________________________
  1322.  
  1323.  
  1324.    The yearly calendar screen is used to select the current month and
  1325.    year.
  1326.  
  1327.    ┌────────────────────────────────────────────────────────────────┐
  1328.    │ File  Edit  Options  Search  Program Config.  Help(F1)         │
  1329.    │ JULY           1991   AUGUST         1991   SEPTEMBER      1991│
  1330.    │ S  M  T  W  T  F  S   S  M  T  W  T  F  S   S  M  T  W  T  F  S│
  1331.    │    1  2  3  4  5  6││             1  2  3││ 1  2  3  4  5  6  7│
  1332.    │ 7  8  9 10 11 12 13││ 4  5  6  7  8  9 10││ 8  9 10 11 12 13 14│
  1333.    │14 15 16 17 18 19 20││11 12 13 14 15 16 17││15 16 17 18 19 20 21│
  1334.    │21 22 23 24 25 26 27││18 19 20 21 22 23 24││22 23 24 25 26 27 28│
  1335.    │28 29 30 31         ││25 26 27 28 29 30 31││29 30               │
  1336.    │                    ││                    ││                    │
  1337.    │OCTOBER        1991   NOVEMBER       1991   DECEMBER       1991 │
  1338.    │ S  M  T  W  T  F  S   S  M  T  W  T  F  S   S  M  T  W  T  F  S│
  1339.    │       1  2  3  4  5││                1  2││ 1  2  3  4  5  6  7│
  1340.    │ 6  7  8  9 10 11 12││ 3  4  5  6  7  8  9││ 8  9 10 11 12 13 14│
  1341.    │13 14 15 16 17 18 19││10 11 12 13 14 15 16││15 16 17 18 19 20 21│
  1342.    │20 21 22 23 24 25 26││17 18 19 20 21 22 23││22 23 24 25 26 27 28│
  1343.    │27 28 29 30 31      ││24 25 26 27 28 29 30││29 30 31            │
  1344.    │                    ││                    ││                    │
  1345.    │JANUARY        1992   FEBRUARY       1992   MARCH          1992 │
  1346.    │ S  M  T  W  T  F  S   S  M  T  W  T  F  S   S  M  T  W  T  F  S│
  1347.    │          1  2  3  4││                   1││ 1  2  3  4  5  6  7│
  1348.    │ 5  6  7  8  9 10 11││ 2  3  4  5  6  7  8││ 8  9 10 11 12 13 14│
  1349.    │12 13 14 15 16 17 18││ 9 10 11 12 13 14 15││15 16 17 18 19 20 21│
  1350.    │19 20 21 22 23 24 25││16 17 18 19 20 21 22││22 23 24 25 26 27 28│
  1351.    │26 27 28 29 30 31   ││23 24 25 26 27 28 29││29 30 31            │
  1352.    └────────────────────┴┴────────────────────┴┴────────────────────┘
  1353.                     FIGURE  6 - Yearly Calendar Screen
  1354.  
  1355.    The yearly calendar screen displays 9 months on the screen at once
  1356.    and allows you to scroll through them using the arrow keys or Tab
  1357.    and Shift+Tab.  This screen sets the month and year that is used
  1358.    when other options are selected.  For example highlighting May 1995
  1359.    and pressing F4 will bring up the monthly calendar for May 1995.
  1360.    Ctrl+Home returns to the actual date.
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376. _____________________________________________________________________
  1377.                                  19 
  1378.  
  1379.                             CONFIGURATION
  1380. _____________________________________________________________________
  1381.  
  1382.  
  1383.    Color Configuration
  1384.    -------------------
  1385.    This screen allows the configuration of the colors used by the pro-
  1386.    gram.
  1387.  
  1388.                        ┌──── Color Config. ────┐
  1389.                        │Normal Text            │
  1390.                        │Highlighted Text       │
  1391.                        │Lowlight Text          │
  1392.                        │Pop-up Normal          │
  1393.                        │Pop-up Highlighted     │
  1394.                        │Save                   │
  1395.                        │Restore Defaults       │
  1396.                        │Help                   │
  1397.                        │Quit                   │
  1398.                        └───────────────────────┘
  1399.                    FIGURE  7 - Color Configuration Menu
  1400.  
  1401.    To make a selection from the pop-up menu highlight it using the up
  1402.    and down arrow keys and press Enter or just type the field's bold
  1403.    character.  Selecting any of the options above "Save" will bring
  1404.    up the color selection bar.
  1405.  
  1406.    ┌────────────────────────────────────────────────────────────────┐
  1407.    │Normal Text                                                     │
  1408.    │                           v                    Foreground Color│
  1409.    │████████████████████████████████████████████████                │
  1410.    │   *                                            Background Color│
  1411.    └────────────────────────────────────────────────────────────────┘
  1412.                   FIGURE  8 - Color Selection Bar
  1413.  
  1414.    The down arrow on the "Foreground Color" line points to the
  1415.    currently selected foreground color.  Use the left and right arrow
  1416.    keys to change the selection.  The diamond on the "Background
  1417.    Color" line marks the currently selected background color.  To
  1418.    switch from selecting the foreground to the background color use
  1419.    the up and down arrow keys.  The text in the upper left displays
  1420.    what the current selection looks like.  Press Enter to accept it.
  1421.  
  1422.    The following options are available on the pop-up menu.
  1423.  
  1424.    Normal Text - Sets the normal text color.  The color of the majori-
  1425.       ty of the text in the program.
  1426.    Highlighted Text - Sets the color of highlighted normal text.  For ex-
  1427.       ample the color of the current day selected in the split screen
  1428.       month/appt display and the color of the current month selected in
  1429.       the yearly calendar display.
  1430.    Lowlight Text - Sets the color of lowlight text.  For example the
  1431.       color of the appointment section of the split screen month/appt
  1432.       display.
  1433.    Pop-up Normal - Sets the color of the pop-up menu.
  1434.  
  1435. _____________________________________________________________________
  1436.                                  20 
  1437.  
  1438.                             CONFIGURATION
  1439. _____________________________________________________________________
  1440.  
  1441.  
  1442.    Pop-up Highlighted - Sets the color of the selected field in the
  1443.       pop-up menu.
  1444.    Save - Saves the current color selection to the configuration file.
  1445.       If this is not done then any changes made to the color selection
  1446.       will remain in effect for the current session only.
  1447.    Restore Defaults - Reads the values set in the configuration file and
  1448.       sets the colors to those values.
  1449.    Help - Brings up a help screen.
  1450.    Quit - Exits color configuration and returns to the previous menu.
  1451.  
  1452.    Appointment Template Configuration
  1453.    ----------------------------------
  1454.    This screen allows the initial appointment screen to be configured.
  1455.  
  1456.    ┌─────────────────────────────────────────────────────────────────┐
  1457.    │ Appointment Template Configuration                              │
  1458.    │TIME │am│A│                                                     ││
  1459.    │HR:MN│pm│L│  Appointments                                       ││
  1460.    ├─────┴──┼─┼─────────────────────────────────────────────────────││
  1461.    │ 7:30 am│ │                                                     ││
  1462.    │ 8:00 am│ │                                                     ││
  1463.    │ 8:30 am│ │                                                     ││
  1464.    │ 9:00 am│ │                                                     ││
  1465.    │ 9:30 am│ │                                                     ││
  1466.    │10:00 am│ │                                                     ││
  1467.    │10:30 am│ │                                                     ││
  1468.    │11:00 am│ │                                                     ││
  1469.    │11:30 am│ │                                                     ││
  1470.    │12:00 pm│ │                                                     ││
  1471.    │12:30 pm│ │                                                     ││
  1472.    │ 1:00 pm│ │                                                     ││
  1473.    │ 1:30 pm│ │                                                     ││
  1474.    │ 2:00 pm│ │                                                     ││
  1475.    │ 2:30 pm│ │                          ┌─Appt. Template Config─┐  ││
  1476.    │ 3:00 pm│ │                          │ Edit                  │  ││
  1477.    │ 3:30 pm│ │                          │ Save                  │  ││
  1478.    │ 4:00 pm│ │                          │ Help                  │  ││
  1479.    │ 4:30 pm│ │                          │ Quit                  │  ││
  1480.    │ 5:00 pm│ │                          └───────────────────────┘  ││
  1481.    │ 5:30 pm│ │                                                     ││
  1482.    └────────┴─┴─────────────────────────────────────────────────────┴┘
  1483.               FIGURE  9 - Appointment Template Configuration
  1484.  
  1485.    This is the initial screen that is displayed if no appointment file
  1486.    for the currently selected date is found.  You may configure the
  1487.    times to match your typical schedule and set any text that you al-
  1488.    ways want to appear in a particular appointment slot.  For example
  1489.    you may want to block out the 12:00 to 1:00 pm slots for lunch.
  1490.    You can change the appointment schedule times and appointment slots
  1491.    in the appointment edit menu to allow for daily variations to your
  1492.    schedule.  The appointment template is just a starting point for
  1493.    each day.
  1494. _____________________________________________________________________
  1495.                                  21 
  1496.  
  1497.                             CONFIGURATION
  1498. _____________________________________________________________________
  1499.  
  1500.  
  1501.    To make a selection from the pop-up menu highlight it using the up
  1502.    and down arrow keys and press Enter or just type the field's bold
  1503.    character.  The following options are available on the pop-up menu.
  1504.  
  1505.    Edit - Allows the editing of the appointment template.  Press Esc to
  1506.       end editing and return to the pop-up menu.  Most of the available
  1507.       keys in appointment editing are valid here.
  1508.    Save - Saves the appointment template.
  1509.    Help - Brings up a help screen.
  1510.    Quit - Exits the appointment template configuration and returns to
  1511.           the previous menu.
  1512.  
  1513.    Printer Configuration
  1514.    ---------------------
  1515.    This screen allows you to select the printer to which all print opera-
  1516.    tions will send their output.  It also allows you to configure new
  1517.    printers and modify the parameters of existing ones.
  1518.  
  1519.    ┌────────────────────────────────────────────────────────────────┐
  1520.    │  EPSON                         Printer Name: EPSON FX 80       │
  1521.    │->EPSON FX 80                                                   │
  1522.    │  EPSON RX 80                   Printer Device: PRN             │
  1523.    │  HP Laserjet                                                   │
  1524.    │  IBM PROPRINTER                Printer Mode: GRAPHIC           │
  1525.    │  Standard Graphic Printer                                      │
  1526.    │  Standard Non-graphic Prn      Escape Sequence Before Printing:│
  1527.    │  File (graphic)                FILE:apfx.dat                   │
  1528.    │  File (non-graphic)                                            │
  1529.    │                                Escape Sequence After Printing: │
  1530.    │                                                                │
  1531.    │                                                                │
  1532.    │                  ┌──────────────Key  Assignments──────────────┐│
  1533.    │                  │F1  Help              F7  Edit Esc2         ││
  1534.    │                  │F2  Select Printer    F8  Add               ││
  1535.    │                  │F3  Toggle Device     F9  Delete            ││
  1536.    │                  │F4  Toggle Mode       F10 Save Configuration││
  1537.    │                  │F5  Edit Name         ESC To Quit           ││
  1538.    │                  │F6  Edit Esc1                               ││
  1539.    │                  └────────────────────────────────────────────┘│
  1540.    └────────────────────────────────────────────────────────────────┘
  1541.                    FIGURE 10 - Printer Configuration
  1542.  
  1543.    The up and down arrow keys can be used to move the arrow (->) on the
  1544.    left through the list of printers.  The parameters for the printer to
  1545.    the right of the arrow are displayed in the right portion of the
  1546.    screen.  The currently selected printer (the one that print output
  1547.    will be sent to) is highlighted.
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553. _____________________________________________________________________
  1554.                                  22 
  1555.  
  1556.                             CONFIGURATION
  1557. _____________________________________________________________________
  1558.  
  1559.  
  1560.    The following keys can be used in this configuration menu.
  1561.  
  1562.    F1         brings up a help screen.
  1563.    F2         selects the default printer.  Move the arrow (->) on the
  1564.               left to the desired print device using the up and down
  1565.               arrow keys and press F2.  That printer will then be high-
  1566.               lighted and if the configuration is saved all print
  1567.               output will go to it.
  1568.    F3         toggles the device that the print will be sent to.  Press-
  1569.               ing F3 cycles through the list of valid options.
  1570.    F4         toggles the mode between GRAPHIC and NON-GRAPHIC.  In
  1571.               GRAPHIC mode IBM graphic line characters are output.  In
  1572.               NON-GRAPHIC mode these characters are converted to normal
  1573.               ASCII characters.
  1574.    F5         allows the editing of the name of the selection currently
  1575.               pointed to.  Control is passed to the Printer Name field on
  1576.               the right.  Change the name and press Enter to accept it or
  1577.               press Esc to cancel the changes.  Control is then returned
  1578.               to the printer list on the left.
  1579.    F6         allows the editing of the first escape sequence of the sel-
  1580.               ection currently pointed to.  Control is passed to the
  1581.               "Escape Sequence Before Printing" field on the right.  This
  1582.               sequence is output exactly as it appears in the menu to the
  1583.               printer before any other output to the printer.  To input
  1584.               values that are not ordinary ASCII characters press and hold
  1585.               down the Alt key and type the decimal value for the char-
  1586.               acter on the numeric key pad (e.g. Alt+2+7 produces the
  1587.               escape character).  Press Enter to accept or Esc to cancel
  1588.               the changes and return control to the printer list on the
  1589.               left.  If the desired sequence is too long for the input
  1590.               field then the text "FILE:" followed by the name of a file
  1591.               containing the escape sequence can be entered.
  1592.    F7         allows the editing of the second escape sequence of the
  1593.               selection currently pointed to.  This sequence is the last
  1594.               thing output to the printer for each print job.  Editing
  1595.               this field is exactly like the first escape sequence above.
  1596.    F8         adds a new printer to the list.  When F8 is pressed the
  1597.               program prompts for each of the parameters on the right and
  1598.               then returns control to the printer list.  The new printer
  1599.               is added at the end of the list.
  1600.    F9         deletes the printer currently pointed to.
  1601.    F10        saves the printer configuration.
  1602.    ESC        exits the printer configuration.
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612. _____________________________________________________________________
  1613.                                  23 
  1614.  
  1615.                             CONFIGURATION
  1616. _____________________________________________________________________
  1617.  
  1618.  
  1619.    Holiday Configuration
  1620.    ---------------------
  1621.    This screen allows you to add, modify and delete the holidays that are
  1622.    automatically placed into the monthly calendars when they are first
  1623.    generated.
  1624.  
  1625.    ┌──────────────────────────────────────────────────────────┐
  1626.    │Holiday Configuration         Page 01 of 02               │
  1627.    │                                                          │
  1628.    │->New Year's  Day                                         │
  1629.    │  Valentines  Day               Type: Month/Day Every Year│
  1630.    │  Presidents  Day               Name Line 1: New Year's   │
  1631.    │  St.         Patrick's         Name Line 2: Day          │
  1632.    │  Mother's    Day               Year: N/A                 │
  1633.    │  Memorial    Day               Month: JANUARY            │
  1634.    │  Father's    Day               Day: 01                   │
  1635.    │  Independnc  Day               Day Of Week: N/A          │
  1636.    │  Labor Day                     Number: N/A               │
  1637.    │  Halloween                                               │
  1638.    │  Thanksgivn                    ┌─────Key Assignments────┐│
  1639.    │  Christmas                     │F1         Help         ││
  1640.    │  Easter                        │F2         Edit         ││
  1641.    │  Easter                        │F3         Add          ││
  1642.    │  Easter                        │F4         Delete       ││
  1643.    │  Easter                        │F5         Save         ││
  1644.    │  Easter                        │PAGE UP    Previous Page││
  1645.    │  Easter                        │PAGE DOWN  Next Page    ││
  1646.    │  Easter                        │ESC        To Quit      ││
  1647.    │  Easter                        └────────────────────────┘│
  1648.    └──────────────────────────────────────────────────────────┘
  1649.              FIGURE 11 - Holiday Configuration Screen
  1650.  
  1651.    The up and down arrow keys can be used to move the arrow (->) on the
  1652.    left through the list of holidays.  The parameters for the one cur-
  1653.    rently pointed to are displayed to the right.
  1654.  
  1655.    The following keys can be used in this configuration menu.
  1656.  
  1657.    F1         brings up a help screen.
  1658.    F2         allows the editing of the holiday parameters.  The first
  1659.               field sets the type of holiday.  Use the space bar to cycle
  1660.               through the possible selections.  Press Enter when the
  1661.               desired one appears.  The program will then prompt you for
  1662.               the remaining parameters required for the selected holiday
  1663.               type.  Press Esc in any field to cancel the edit and dis-
  1664.               card any changes.  Pressing Enter on the last field accepts
  1665.               the changes.
  1666.    F3         adds a new holiday at the end of the list.  The procedure
  1667.               is the same as for F2, above.  The initial values for the
  1668.               fields are set to those of the holiday currently pointed to.
  1669.    F4         deletes the holiday currently pointed to.
  1670.    F5         saves the configuration to a file.
  1671. _____________________________________________________________________
  1672.                                  24
  1673.  
  1674.                             CONFIGURATION
  1675. _____________________________________________________________________
  1676.  
  1677.  
  1678.    Page Up    brings up the previous page, if any.
  1679.    Page Down  brings up the next page, if any.
  1680.    ESC        exits the holiday configuration.
  1681.  
  1682.    There are 3 types of holidays that may be set:
  1683.       Month/Day Every Year - these occur on a specific month and day
  1684.          every year (e.g. December 25 for Christmas).
  1685.       Month And Nth Day Of Week - these occur on a specific day of the
  1686.          week in a month (e.g. 4th Thursday in November for Thanks-
  1687.          giving).
  1688.       Month/Day/Year - these only occur on one specific date (e.g. April
  1689.          19, 1992 for Easter).
  1690.    The "Name Line 1:" and "Name Line 2:" parameters set the text that
  1691.    will appear in the calendar on the date for the holiday.  The year
  1692.    field gives the year minus 1900 (e.g. 92 for 1992).  The month field
  1693.    can be toggled through the months using the space bar.  The day field
  1694.    toggles from 1 through the number of days in the month.  The day of
  1695.    week field toggles through the days of the week.
  1696.  
  1697.    Changes to the holiday configuration will not be reflected in monthly
  1698.    calendars that have already been saved.  This information is only
  1699.    used when the calendar is first built.
  1700.  
  1701.    Start Screen Configuration
  1702.    --------------------------
  1703.    This screen allows you to select the first screen that is displayed
  1704.    when the program is loaded.
  1705.  
  1706.    ┌─────────────────────────────────────────────────────────────────┐
  1707.    │  Appointment                                                    │
  1708.    │  Alarm                                                          │
  1709.    │  Monthly Calendar                                               │
  1710.    │  Yearly Calendar                                                │
  1711.    │->Split Screen Month/Appt.                ┌───Key Assignments───┐│
  1712.    │                                          │F1  Help             ││
  1713.    │                                          │F2  Select Screen    ││
  1714.    │                                          │F3  Save Selection   ││
  1715.    │                                          │ESC To Quit          ││
  1716.    │                                          └─────────────────────┘│
  1717.    └─────────────────────────────────────────────────────────────────┘
  1718.                  FIGURE 12 - Start Screen Configuration
  1719.  
  1720.    The up and down arrow keys can be used to move the arrow (->) on the
  1721.    left through the list of screens.  The currently selected screen is
  1722.    highlighted.
  1723.  
  1724.    The following keys can be used in this configuration menu.
  1725.  
  1726.    F1         brings up a help screen.
  1727.    F2         selects the initial screen.  Move the arrow (->) on the
  1728.               left to the desired screen using the up and down arrow keys
  1729.               and press F2.  That screen will then be highlighted.
  1730. _____________________________________________________________________
  1731.                                  25
  1732.  
  1733.                             CONFIGURATION
  1734. _____________________________________________________________________
  1735.  
  1736.  
  1737.    F3         saves the current selection to the configuration file.
  1738.    ESC        exits the start screen configuration.
  1739.  
  1740.    Alarm Configuration
  1741.    -------------------
  1742.    This screen allows the configuration of the pop-up alarm.
  1743.  
  1744.    ┌─────────────────────────────────────────────────────────────────┐
  1745.    │Alarm Configuration                                              │
  1746.    │                                                                 │
  1747.    │General Alarm Parameters:                                        │
  1748.    │        Frequency (20 to 20,000 Hz) Duration (0 to 100 1/10 Sec) │
  1749.    │       ┌───────────────────────────┌────────────────────────────┐│
  1750.    │Tone 1:│           700             │             1              ││
  1751.    │Pause: │                           │             1              ││
  1752.    │Tone 2:│           650             │             1              ││
  1753.    │       └───────────────────────────└────────────────────────────┘│
  1754.    │Number of Tones: 10                                              │
  1755.    │Snooze Duration (1-99 minutes):  5                               │
  1756.    │Color: ┌────────────────────────────────────────────────────────┐│
  1757.    │       │                                                        ││
  1758.    │       │                                                        ││
  1759.    │       └────────────────────────────────────────────────────────┘│
  1760.    │                                                                 │
  1761.    │Appointment Alarm Parameters:               ┌── Alarm Config. ──┐│
  1762.    │Default minutes before:  10                 │Edit               ││
  1763.    │Default duration:  10                       │Play Alarm         ││
  1764.    │                                            │Save               ││
  1765.    │                                            │Help               ││
  1766.    │                                            │Quit               ││
  1767.    │                                            └───────────────────┘│
  1768.    └─────────────────────────────────────────────────────────────────┘
  1769.                 FIGURE 13 - Alarm Configuration Screen
  1770.  
  1771.    To make a selection from the pop-up menu highlight it using the up
  1772.    and down arrow keys and press Enter or just type the field's bold
  1773.    character.  The following options are available on the pop-up menu.
  1774.  
  1775.    Edit - Allows the editing of the alarm parameters.  Press Tab to
  1776.       move to the next field in the parameter menu and Shift+Tab to
  1777.       move to the previous field.  Press Esc to end editing and return
  1778.       to the pop-up menu.  If you move into a field and change it and
  1779.       then press Esc the changes will be discarded.  To process the
  1780.       changes press Tab and then press Esc.
  1781.    Play Alarm - plays the alarm as it will sound using the current alarm
  1782.       parameters.  The alarm sounds for the given duration.  It can be
  1783.       terminated before the end by pressing any key.
  1784.    Save - Saves the alarm parameters.
  1785.    Help - Brings up a help screen.
  1786.    Quit - Exits alarm configuration.
  1787.  
  1788.  
  1789. _____________________________________________________________________
  1790.                                  26
  1791.  
  1792.                             CONFIGURATION
  1793. _____________________________________________________________________
  1794.  
  1795.  
  1796.    The alarm consists of 2 tones with an intervening pause.  The frequen-
  1797.    cy values (1st and 4th fields in the parameter menu) can have values
  1798.    from 20 to 20000 Hertz.  Lower numbers produce a lower pitched sound.
  1799.    The duration of the tones (2nd and 5th fields) and intervening pause
  1800.    (3rd field) are input in tenths of a second.  For example a value of
  1801.    10 represents 10 tenths of a second or 1 second.  The durations can
  1802.    vary from 0 to 100 (0 to 10 seconds).  A value of zero for a tone
  1803.    means that tone will not play.  A zero pause produces no pause.
  1804.  
  1805.    From 0 to 99 of the tone 1/pause/tone 2 sequences can be sounded for
  1806.    the alarm.  A zero value produces no sound.
  1807.  
  1808.    The snooze duration field sets the number of minutes between when
  1809.    Alt+s is pressed to snooze an alarm and when the alarm will resound.
  1810.    This value can range from 1 to 99 minutes.
  1811.  
  1812.    The color bar sets the color of the pop-up alarm message.  Use the
  1813.    left/right arrow keys to change the color selection and the up/down
  1814.    keys to switch between configuring the foreground and background
  1815.    color.
  1816.  
  1817.    The appointment alarm parameters set the initial values that are dis-
  1818.    played in the "Number of minutes before:" and "Duration (minutes):"
  1819.    fields when an appointment alarm is set.
  1820.  
  1821.    *** NOTE ***
  1822.    Changes to these parameters (except the appointment alarm parameters)
  1823.    do not take effect until the alarm tsr is reloaded.
  1824.  
  1825.    Entering an invalid value in a field produces a beep and the field
  1826.    cannot be exited until a valid value is entered.
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848. _____________________________________________________________________
  1849.                                  27
  1850.  
  1851.                             KEY REFERENCE
  1852. _____________________________________________________________________
  1853.  
  1854.  
  1855.    Appointment Editing
  1856.    -------------------
  1857.    The following keys can be used in the appointment edit screen.  
  1858.    Some of these can also be selected from the pull down menu.
  1859.  
  1860.    Insert     toggles insert mode on and off.
  1861.    Delete     deletes the character at the current cursor position.
  1862.    Home       moves to the beginning of the appointment line.
  1863.    End        moves to the end of the appointment line.
  1864.    Backspace  moves the cursor left and deletes the character at that
  1865.               position.
  1866.    Enter      moves to the beginning of the next line.
  1867.    F1         brings up the help screen.
  1868.    F3         switches to the arbitrary alarm screen.
  1869.    F4         switches to the monthly calendar screen.
  1870.    F5         switches to the yearly calendar screen.
  1871.    F6         switches to the split screen month/appointment display.
  1872.    F9         is used to toggle editing of the time fields.
  1873.    Alt        activates the pull down menu.  Pressing Alt plus one of 
  1874.               the bold characters in the top pull down line activates
  1875.               that pull down menu.
  1876.    Alt+c      copies the current line to a scratch buffer.
  1877.    Alt+m      copies the current line to scratch and then erases it.
  1878.    Alt+i      overwrites the current line with the contents of the
  1879.               scratch buffer created by the last Alt+c or Alt+m.
  1880.    Alt+d      deletes the characters from the cursor position to the end
  1881.               of the line.
  1882.    Alt+l      deletes the current line.
  1883.    Alt+a      brings up the alarm parameter menu for the appointment at
  1884.               the current cursor position.
  1885.  
  1886.    Arbitrary Alarm Screen
  1887.    ----------------------
  1888.    The following keys can be used in the arbitrary alarm screen.  Some
  1889.    of these can also be selected from the pull down menu.
  1890.  
  1891.    F1         brings up the help screen.
  1892.    F2         switches to the appointment screen.
  1893.    F4         switches to the monthly calendar screen.
  1894.    F5         switches to the yearly calendar screen.
  1895.    F6         switches to the split screen month/appointment display.
  1896.    Alt        activates the pull down menu.  Pressing Alt plus one of 
  1897.               the bold characters in the top pull down line activates
  1898.               that pull down menu.
  1899.    Alt+a      adds another alarm.
  1900.    Alt+d      deletes the currently selected alarm.
  1901.    Alt+m      modifies the currently selected alarm.
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907. _____________________________________________________________________
  1908.                                  28
  1909.  
  1910.                             KEY REFERENCE
  1911. _____________________________________________________________________
  1912.  
  1913.  
  1914.    Monthly Calendar
  1915.    ----------------
  1916.    The following keys can be used in the calendar edit screen.  Some of
  1917.    these can also be selected from the pull down menu.
  1918.  
  1919.    Insert     toggles insert mode on and off.
  1920.    Delete     deletes the character at the current cursor position.
  1921.    Home       moves to the beginning of the current day block line.
  1922.    End        moves to the end of the current day block line.
  1923.    Backspace  moves the cursor left and deletes the character at that
  1924.               position.
  1925.    Enter      moves to the beginning of the next line in the day block.
  1926.    Tab        to highlight the next day in the calendar.
  1927.    Shift+Tab  to highlight the previous day in the calendar.
  1928.    F1         brings up the help screen.
  1929.    F2         switches to the appointment screen.
  1930.    F3         switches to the arbitrary alarm screen.
  1931.    F5         switches to the yearly calendar screen.
  1932.    F6         switches to the split screen month/appointment display.
  1933.    Alt        activates the pull down menu.  Pressing Alt plus one of 
  1934.               the bold characters in the top pull down line activates
  1935.               that pull down menu.
  1936.    Ctrl+Right is used to pull up the next monthly calendar.
  1937.    Ctrl+Left  is used to pull up the previous monthly calendar.
  1938.    Ctrl+Home  returns to the actual date.
  1939.  
  1940.    Yearly Calendar
  1941.    ---------------
  1942.    The following keys can be used in the yearly calendar screen.  Some of
  1943.    these can also be selected from the pull down menu.
  1944.  
  1945.    Tab        to highlight the next monthly calendar.
  1946.    Shift+Tab  to highlight the previous monthly calendar.
  1947.    F1         brings up the help screen.
  1948.    F2         switches to the appointment screen.
  1949.    F3         switches to the arbitrary alarm screen.
  1950.    F4         switches to the monthly calendar screen.
  1951.    F6         switches to the split screen month/appointment display.
  1952.    Alt        activates the pull down menu.  Pressing Alt plus one of 
  1953.               the bold characters in the top pull down line activates
  1954.               that pull down menu.
  1955.    Ctrl+Home  to return to the actual date.
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966. _____________________________________________________________________
  1967.                                  29
  1968.  
  1969.                             KEY REFERENCE
  1970. _____________________________________________________________________
  1971.  
  1972.  
  1973.    Month/Appointment Screen
  1974.    ------------------------
  1975.    The following keys can be used in the month/appt screen.  Some of
  1976.    these can also be selected from the pull down menu.
  1977.  
  1978.    Tab        to highlight the next day.
  1979.    Shift+Tab  to highlight the previous day.
  1980.    F1         brings up the help screen.
  1981.    F2         switches to the appointment screen.
  1982.    F3         switches to the arbitrary alarm screen.
  1983.    F4         switches to the monthly calendar screen.
  1984.    F5         switches to the yearly calendar screen.
  1985.    F7         search for the given text in the appointment files for
  1986.               future dates.
  1987.    Shift+F7   search for the given text in the appointment files for
  1988.               past dates.
  1989.    Alt        activates the pull down menu.  Pressing Alt plus one of 
  1990.               the bold characters in the top pull down line activates
  1991.               that pull down menu.
  1992.    Ctrl+Right scrolls the month display one month ahead.
  1993.    Ctrl+Left  scrolls the month display one month back.
  1994.    Ctrl+Home  return to current date.
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025. _____________________________________________________________________
  2026.                                  30
  2027.  
  2028.                           FILE DESCRIPTIONS
  2029. _____________________________________________________________________
  2030.  
  2031.  
  2032.    File Maintenance / Description
  2033.    ------------------------------
  2034.    The following files are created by the program.
  2035.  
  2036.       APCAL.CFG     APCAL configuration parameters.  This file is
  2037.                     created when a new configuration is saved.
  2038.       CALmm.yy      is used to save a calendar for display.
  2039.       CALmm-yy.prn  is used to store a calendar for printing.
  2040.       APPmm-dd.yy   is used to store an appointment schedule for display.
  2041.       APPmm-dd.prn  is used to store an appointment schedule for
  2042.                     printing.
  2043.       ALRmm-dd.yy   is used to store appointment and arbitrary alarms.
  2044.  
  2045.    Where mm is the month, dd the day and yy the year.
  2046.  
  2047.    This system should contain the following files.
  2048.  
  2049.       APCAL.EXE     main program.
  2050.       ALARM.COM     memory resident alarm handler.
  2051.       APAPPT.TPL    appointment template.  Used if no APPmm-dd.yy file
  2052.                     for the currently selected day is found.
  2053.       APFX.DAT      EPSON FX 80 printer configuration.
  2054.       APRX.DAT      EPSON RX 80 printer configuration.
  2055.       APSPEC.DAY    stores the holidays configured in the holiday
  2056.                     configuration section.
  2057.       APPRN.CFG     printer configuration parameters.
  2058.       APCAL.HLP     help file.
  2059.       APUPDATE.EXE  updates older files to 3.10 format.
  2060.       APSETUP.EXE   Makes the necessary modifications to your
  2061.                     AUTOEXEC.BAT file to load the alarm handler.
  2062.                     
  2063.                     
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084. _____________________________________________________________________
  2085.                                  31
  2086.  
  2087.                           PROBLEM RESOLUTION
  2088. _____________________________________________________________________
  2089.  
  2090.  
  2091.    ALARMS DO NOT DISPLAY OR SOUND
  2092.       1. Make sure the ALARM program is being loaded and the correct
  2093.          path is passed to it on the command line.  See the
  2094.          "Alarm" section.
  2095.       2. Alarm was entered but not saved.
  2096.       3. The DOS time and date must be set properly for the alarm to
  2097.          work.  See the TIME and DATE commands in your DOS manual.
  2098.  
  2099.    ALARM SOUNDS BUT NO MESSAGE IS DISPLAYED
  2100.       1. The computer is currently in graphics mode.  The message
  2101.          will not be displayed if the computer is in graphics mode
  2102.          when the alarm sounds.  The alarm is automatically snoozed.
  2103.  
  2104.    SAVED APPOINTMENT/CALENDAR FILES DISPLAYED INCORRECTLY
  2105.    COLOR CONFIGURATION INCORRECT
  2106.    HOLIDAYS DISPLAYED INCORRECTLY
  2107.    APPOINTMENT DISPLAY IS INCORRECT
  2108.       1. Make sure you are executing APCAL from the same directory every
  2109.          time or setting the APCAL environment variable.
  2110.       2. Make sure the associated files have not been deleted or corrupted
  2111.          (APPmm-dd.yy, CALmm.yy, APCAL.CFG, APSPEC.DAY, APAPPT.TPL, etc.).
  2112.  
  2113.    GRAPHICS LINE CHARACTERS PRINT INCORRECTLY
  2114.       1. Make sure you have the proper printer configuration set.
  2115.  
  2116.    TSR CONFLICTS
  2117.       The alarm handler is a memory resident program or TSR (terminate
  2118.       and stay resident).  It is designed to co-exist with other TSR's
  2119.       but problems can still arise.  If your machine "hangs" or "locks
  2120.       up" at certain times then it may be due to such a conflict.  Re-
  2121.       arranging the order the TSR's are loaded in your AUTOEXEC.BAT
  2122.       can sometimes eliminate the problem.
  2123.  
  2124.    DOS 5 WARNING
  2125.       It is possible to load multiple copies of the alarm handler if
  2126.       you use the loadhigh command.  Only one copy of the alarm handler
  2127.       should be loaded.
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143. _____________________________________________________________________
  2144.                                  32
  2145.  
  2146.                         TECHNICAL INFORMATION
  2147. _____________________________________________________________________
  2148.  
  2149.  
  2150.    How The Alarm Works
  2151.    -------------------
  2152.    When the alarm handler (ALARM.COM) is first loaded it reads the
  2153.    alarm file that it displays during loading if it exists.  Any
  2154.    alarms contained in that file are then saved in memory within the
  2155.    alarm handler.  The alarm handler should be loaded in your
  2156.    AUTOEXEC.BAT file so that it is always loaded.  If the alarm hand-
  2157.    ler is not loaded then no alarms will sound.
  2158.  
  2159.    The alarm handler hooks into the timer tic (INT 8) produced by the
  2160.    PC about every 18.2 seconds.  Each time the computer generates a
  2161.    timer tic the handler checks to see if any of the alarms need to be
  2162.    sounded.  When it finds one or more that need to be sounded it
  2163.    sets a flag and waits for an opportunity to pop up.  Since DOS is
  2164.    not a multitasking operating system the handler must check
  2165.    certain parameters to determine when it is safe to take control.
  2166.    It is conceivable that a program could effectively lock out the
  2167.    handler by not ever giving it a chance to take control.
  2168.  
  2169.    When the handler determines it is possible to take control it first
  2170.    sounds the alarm.  If the computer is currently in graphics mode
  2171.    it then snoozes the alarm and exits.  In text mode the alarm(s)
  2172.    are displayed.  The handler then waits for the user to press Alt+e
  2173.    or ALT+s.  Alt+e marks the alarm as ended.  Alt+s adds the snooze
  2174.    duration to the current time and sets the start time of the alarm
  2175.    to that value.  If the new start time is past the end time of the
  2176.    alarm then the alarm will not sound again, otherwise the alarm will
  2177.    resound at the new time.
  2178.  
  2179.    The alarm file for the current date (ALRmm-dd.yy) contains the
  2180.    appointment alarms and arbitrary alarms set for that date.  When
  2181.    an appointment file is saved the appointment alarms in the alarm
  2182.    file are updated (any arbitrary alarms in the file are left
  2183.    unchanged).  When an arbitrary alarm is set the arbitrary alarms
  2184.    are updated (leaving the appointment alarms unchanged).  In
  2185.    either case APCAL signals the alarm handler that it needs to
  2186.    reread the alarm file.  Which it then does and resets the alarm
  2187.    data it has stored in memory.
  2188.  
  2189.    The alarm handler will not automatically read the alarm file for
  2190.    a new day if the date changes while it is loaded (i.e. it was
  2191.    loaded before midnight and the current time is after midnight).  In
  2192.    other words the alarm handler must be reloaded (by rebooting or
  2193.    some other utility) if the date has changed since it was loaded.
  2194.    Or the alarm file for the new date could be saved in APCAL to cause
  2195.    the alarm handler to reread the alarm file.
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202. _____________________________________________________________________
  2203.                                  33
  2204.