home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / DESKTOP / PAL21.ZIP / PAL.DOC < prev    next >
Text File  |  1990-07-09  |  269KB  |  6,844 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.           [Note:  If your printer does not print IBM graphics characters,
  7.           you can use the supplied NOIBMPRN.EXE program]
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                          PAL
  14.  
  15.                               Documentation, Version 2.1
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                   Copyright (c) 1990
  30.                                  All Rights Reserved
  31.  
  32.  
  33.  
  34.                                    PAL Software NY
  35.                                     51 Cedar Lane
  36.                                  Ossining, NY  10562
  37.                                  BBS:  (914) 762-8055
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                         ┌─────────┐
  45.                   ┌─────┴───┐     │               (R)
  46.                 ──│         │o    │──────────────────
  47.                   │         │     │
  48.                   │   ┌─────┴╨──┐ │  Association of
  49.                   │   │         ├─┘  Shareware
  50.                   └───┤    o    │    Professionals
  51.                       │         │
  52.                 ──────│    ║    │────────────────────
  53.                       └────╨────┘    MEMBER
  54.  
  55.  
  56.                    PAL and PALARM are trademarks of PAL Software NY
  57.  
  58.  
  59.  
  60.  
  61.           ═════════════════════════════════════════════════════════════════
  62.           ═════════════════════════════════════════════════════════════════
  63.  
  64.                                   TABLE OF CONTENTS
  65.  
  66.           ═════════════════════════════════════════════════════════════════
  67.           ═════════════════════════════════════════════════════════════════
  68.  
  69.  
  70.           INTRODUCTION AND QUICK START  . . . . . . . . . . . . . . . .   1
  71.  
  72.           CHAPTER 1:  BASIC OPERATION . . . . . . . . . . . . . . . . .   4
  73.                1.1     Menu Operation of PAL  . . . . . . . . . . . . .   4
  74.                1.2     Entering a Command Line From the Menu  . . . . .   5
  75.                1.3     Command Line and Batch Operation of PAL  . . . .   6
  76.                1.4     Menu or Command Line?  . . . . . . . . . . . . .   8
  77.  
  78.           CHAPTER 2:  REQUIREMENTS  . . . . . . . . . . . . . . . . . .   9
  79.                2.1     Hardware Requirements  . . . . . . . . . . . . .   9
  80.                2.2     Required Pal Files . . . . . . . . . . . . . .    10
  81.  
  82.           CHAPTER 3:  INSTALLATION  . . . . . . . . . . . . . . . . .    12
  83.                3.1     Basic Installation . . . . . . . . . . . . . .    12
  84.                3.1.1     Copy Required Files  . . . . . . . . . . . .    12
  85.                3.1.2     Automate With Your AUTOEXEC.BAT File . . . .    12
  86.                3.1.3     Required Customization . . . . . . . . . . .    13
  87.                3.1.3.1      Appointment File  . . . . . . . . . . . .    13
  88.                3.1.3.2      Alarm Data File . . . . . . . . . . . . .    14
  89.                3.2     Advanced Installation  . . . . . . . . . . . .    14
  90.                3.3     Screen Display . . . . . . . . . . . . . . . .    14
  91.  
  92.           CHAPTER 4:  ONLINE HELP . . . . . . . . . . . . . . . . . .    16
  93.  
  94.           CHAPTER 5:  REPORT MODE . . . . . . . . . . . . . . . . . .    17
  95.                5.1     What Does a Report Show? . . . . . . . . . . .    17
  96.                5.2     REPORT MODE Syntax . . . . . . . . . . . . . .    18
  97.                5.3     Date Control . . . . . . . . . . . . . . . . .    19
  98.                5.4     Toggle Switches  . . . . . . . . . . . . . . .    19
  99.                5.5     File Handling  . . . . . . . . . . . . . . . .    21
  100.                5.5.1     File Assumptions . . . . . . . . . . . . . .    21
  101.                5.5.2     PAL's Appointment Scratchpad . . . . . . . .    22
  102.                5.5.3     Overriding PAL's Assumptions . . . . . . . .    22
  103.                5.6     Examples . . . . . . . . . . . . . . . . . . .    23
  104.                5.7     Special Memos  . . . . . . . . . . . . . . . .    24
  105.  
  106.           CHAPTER 6:  SEARCH MODE . . . . . . . . . . . . . . . . . .    25
  107.                6.1     SEARCH MODE Syntax . . . . . . . . . . . . . .    25
  108.                6.2     SEARCH MODE Optional Parameters  . . . . . . .    25
  109.                6.3     What SEARCH MODE does  . . . . . . . . . . . .    25
  110.  
  111.           CHAPTER 7:  THE APPOINTMENT SCRATCHPAD  . . . . . . . . . .    29
  112.                7.1     Getting There  . . . . . . . . . . . . . . . .    29
  113.                7.2     The Appointment Scratchpad Menu  . . . . . . .    29
  114.                7.3     The Appointment Scratchpad Screen  . . . . . .    30
  115.  
  116.  
  117.  
  118.  
  119.                7.4     "A"dding Appointments  . . . . . . . . . . . .    31
  120.                7.4.1     Frequency  . . . . . . . . . . . . . . . . .    32
  121.                7.4.2     Setting Restrictions . . . . . . . . . . . .    32
  122.                7.4.2.1      Once  . . . . . . . . . . . . . . . . . .    32
  123.                7.4.2.2      Daily, Weekdays and Weekends  . . . . . .    32
  124.                7.4.2.3      Weekly, First, Second, Third, Fourth, Last   33
  125.                7.4.2.4      Biweekly  . . . . . . . . . . . . . . . .    34
  126.                7.4.2.5      Monthly, Bimonthly, Quarterly . . . . . .    34
  127.                7.4.2.6      Annual  . . . . . . . . . . . . . . . . .    34
  128.                7.4.3     Entering the Memo  . . . . . . . . . . . . .    35
  129.                7.4.4     Choosing the Time Slot . . . . . . . . . . .    35
  130.                7.4.5     Saving (or Erasing) Your Choices . . . . . .    35
  131.                7.5     "D"eleting an Appointment  . . . . . . . . . .    36
  132.                7.6     "E"diting an Appointment . . . . . . . . . . .    36
  133.                7.7     "F"inding an Appointment   . . . . . . . . . .    37
  134.                7.8     "N"ext Screen  . . . . . . . . . . . . . . . .    37
  135.                7.9     Removing "O"ld Appointments  . . . . . . . . .    38
  136.                7.10    "P"revious Screen  . . . . . . . . . . . . . .    38
  137.                7.11    "S"orting Appointments . . . . . . . . . . . .    39
  138.                7.12    "ESC"ape . . . . . . . . . . . . . . . . . . .    40
  139.  
  140.           CHAPTER 8:  REMINDERS . . . . . . . . . . . . . . . . . . .    41
  141.  
  142.           CHAPTER 9:  SK AUTO-REPEAT APPOINTMENTS . . . . . . . . . .    42
  143.                9.1     Single Character Auto-Repeat . . . . . . . . .    42
  144.                9.2     Special Auto-Repeat Sequences  . . . . . . . .    43
  145.                9.2.1     Daily types  . . . . . . . . . . . . . . . .    44
  146.                9.2.2     Weekly types . . . . . . . . . . . . . . . .    44
  147.                9.2.3     Monthly types  . . . . . . . . . . . . . . .    44
  148.                9.2.4     Annual type  . . . . . . . . . . . . . . . .    44
  149.                9.3     Special Month Restrictions . . . . . . . . . .    45
  150.                9.4     Limiting the Number of Times to Repeat . . . .    46
  151.                9.5     Auto-Repeats Not Shown Within SideKick . . . .    46
  152.                9.6     Auto-Repeats in Appointment Scratchpad . . . .    47
  153.  
  154.           CHAPTER 10:  SK DELETE AND PURGE  . . . . . . . . . . . . .    48
  155.                10.1    Out of Date Appointments . . . . . . . . . . .    48
  156.                10.2    Deleting Auto-Repeat Appointments  . . . . . .    49
  157.                10.3    Putting Out the Garbage  . . . . . . . . . . .    49
  158.                10.4    Avoiding a Conflict With SideKick  . . . . . .    50
  159.                10.5    How to Safely Update When SK is Loaded . . . .    51
  160.                10.6    Multi-Tasking and Task-Switching Systems . . .    52
  161.                10.7    Knowing When to Use PURGE or DELETE  . . . . .    53
  162.  
  163.           CHAPTER 11:  MULTIPLE SK APPOINTMENT FILES  . . . . . . . .    54
  164.                11.1    SideKick's Deficiency  . . . . . . . . . . . .    54
  165.                11.2    PAL's Solution . . . . . . . . . . . . . . . .    54
  166.                11.3    An Example . . . . . . . . . . . . . . . . . .    55
  167.  
  168.           CHAPTER 12:  ALARMS . . . . . . . . . . . . . . . . . . . .    56
  169.                12.1    Auto-Repeat Alarms . . . . . . . . . . . . . .    56
  170.                12.2    PALARM . . . . . . . . . . . . . . . . . . . .    56
  171.  
  172.                                           3
  173.  
  174.  
  175.  
  176.  
  177.                12.3    Two Ways to Set Alarms . . . . . . . . . . . .    57
  178.                12.4    Capacity for 10 Alarms . . . . . . . . . . . .    57
  179.                12.5    How to Kill or Snooze a Sounding Alarm . . . .    57
  180.                12.6    How to Pop Up a Snoozing Alarm . . . . . . . .    58
  181.                12.7    Controlling the Sound  . . . . . . . . . . . .    58
  182.                12.8    How to Write a Memo to Become an Alarm . . . .    58
  183.                12.9    Advance Alarms . . . . . . . . . . . . . . . .    59
  184.                12.10   Run PAL to Automatically Update Alarms . . . .    61
  185.                12.11   Editing Alarms Manually with PAL SET . . . . .    61
  186.                12.12   Removing PALARM  . . . . . . . . . . . . . . .    63
  187.  
  188.           CHAPTER 13:  TIMED EVENTS . . . . . . . . . . . . . . . . .    65
  189.                13.1    Creating and Editing Macros  . . . . . . . . .    67
  190.                13.1.2    Macro Editor Commands  . . . . . . . . . . .    69
  191.                13.1.3    Editing Existing Macros  . . . . . . . . . .    70
  192.                13.1.4    Deleting Existing Macros . . . . . . . . . .    70
  193.                13.2    Setting a Timed Event  . . . . . . . . . . . .    71
  194.                13.3    Conditional Application Macros . . . . . . . .    72
  195.                13.4    Finding your X,Y coordinates with PALOCATE . .    73
  196.                13.5    Refreshing the Alarm Queue . . . . . . . . . .    74
  197.                13.6    When the Time for an Alarm Arrives . . . . . .    75
  198.                13.7    Possible Messages From PALARM  . . . . . . . .    77
  199.                13.8    A Practical Illustration . . . . . . . . . . .    78
  200.                13.8.1    Creating a Batch File to Do the Mail Run . .    79
  201.                13.8.2    Determining Launch Conditions  . . . . . . .    80
  202.                13.8.3    Determining Keystrokes for the Macro . . . .    80
  203.                13.8.4    Creating the Macro . . . . . . . . . . . . .    80
  204.                13.8.5    Testing and Debugging the Alarm  . . . . . .    81
  205.                13.8.6    The Finishing Touches  . . . . . . . . . . .    84
  206.                13.8.7    Postscript . . . . . . . . . . . . . . . . .    85
  207.  
  208.           CHAPTER 14:  CUSTOMIZING PAL  . . . . . . . . . . . . . . .    86
  209.                14.1    The Clone Procedure  . . . . . . . . . . . . .    86
  210.                14.1.1    Appointment Scratchpad . . . . . . . . . . .    88
  211.                14.1.2    File Location Defaults     . . . . . . . . .    88
  212.                14.1.2.1     The Second Directory  . . . . . . . . . .    88
  213.                14.1.2.2     The Third Directory . . . . . . . . . . .    88
  214.                14.1.2.3     Appointment Calendar Name . . . . . . . .    89
  215.                14.1.2.4     Appointment Calendar Type . . . . . . . .    89
  216.                14.1.2.5     Report File Name  . . . . . . . . . . . .    90
  217.                14.1.3    Holidays . . . . . . . . . . . . . . . . . .    90
  218.                14.1.4    Miscellaneous Defaults . . . . . . . . . . .    92
  219.                14.1.4.1     Default Command Line  . . . . . . . . . .    92
  220.                14.1.4.2     Color Display . . . . . . . . . . . . . .    92
  221.                14.1.4.3     Reverse Video . . . . . . . . . . . . . .    93
  222.                14.1.4.4     Single Character Auto-Repeat  . . . . . .    93
  223.                14.1.4.5     Effect of PURGE and DELETE  . . . . . . .    94
  224.                14.1.4.6     Noise . . . . . . . . . . . . . . . . . .    94
  225.                14.1.4.7     Extended Alarm Report . . . . . . . . . .    94
  226.                14.1.5    Printer Defaults . . . . . . . . . . . . . .    95
  227.                14.1.5.1     Initialization String . . . . . . . . . .    95
  228.                14.1.5.2     Exit String . . . . . . . . . . . . . . .    95
  229.  
  230.                                           4
  231.  
  232.  
  233.  
  234.  
  235.                14.1.5.3     Lines Per Page  . . . . . . . . . . . . .    95
  236.                14.1.6    Clone  . . . . . . . . . . . . . . . . . . .    96
  237.                14.1.7    <ESC> to quit without change . . . . . . . .    96
  238.                14.1.8    The RESTORE Procedure  . . . . . . . . . . .    97
  239.                14.1.9    Saving and Reading CLONE Images  . . . . . .    97
  240.                14.2    The PAL SET INSTALL Procedure  . . . . . . . .    99
  241.                14.2.1    Data File  . . . . . . . . . . . . . . . . .    99
  242.                14.2.2    Macro File . . . . . . . . . . . . . . . . .   100
  243.                14.2.3    Sound Level  . . . . . . . . . . . . . . . .   100
  244.                14.2.4    Snooze Feature . . . . . . . . . . . . . . .   101
  245.                14.2.5    Clock and Date . . . . . . . . . . . . . . .   101
  246.                14.2.5.1     Clock Visibility on Start-Up  . . . . . .   102
  247.                14.2.5.2     Date Visibility on Start-Up . . . . . . .   102
  248.                14.2.5.3     Colors for Clock and Date . . . . . . . .   102
  249.                14.2.6    Cloning Your PALARM Changes  . . . . . . . .   102
  250.  
  251.           CHAPTER 15:  TSR WARS, RAM CRAM AND MULTITASKING  . . . . .   103
  252.                15.1    TSR Wars . . . . . . . . . . . . . . . . . . .   103
  253.                15.2    Ram Cram and Multitasking  . . . . . . . . . .   104
  254.                15.3    Hints on PALARM with Multitasking  . . . . . .   104
  255.                15.4    PALARM and Task-switching Programs   . . . . .   106
  256.  
  257.           CHAPTER 16:  REGISTRATION . . . . . . . . . . . . . . . . .   107
  258.  
  259.           CHAPTER 17:  LICENSE  . . . . . . . . . . . . . . . . . . .   108
  260.  
  261.           CHAPTER 18:  USER SUPPORT . . . . . . . . . . . . . . . . .   110
  262.  
  263.           CHAPTER 19:  ASP OMBUDSMAN PROCEDURE  . . . . . . . . . . .   111
  264.  
  265.           INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . .   112
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.                                           5
  289.  
  290.  
  291.  
  292.  
  293.           ═════════════════════════════════════════════════════════════════
  294.           ═════════════════════════════════════════════════════════════════
  295.  
  296.                              INTRODUCTION AND QUICK START
  297.  
  298.           ═════════════════════════════════════════════════════════════════
  299.           ═════════════════════════════════════════════════════════════════
  300.  
  301.  
  302.  
  303.           FEATURES:
  304.  
  305.  
  306.                In addition to the ability to show a sorted report of your
  307.           upcoming appointments, PAL can, among other things:
  308.  
  309.                *  search for a particular appointment,
  310.  
  311.                *  maintain a to-do list which will tickle you if you fail
  312.                   to do something after a specified date,
  313.  
  314.                *  set a virtually infinite number of alarms,
  315.  
  316.                *  use an alarm to initiate an event on your computer, even
  317.                   if you are not present at that moment,
  318.  
  319.                *  run reports on multiple appointment files,
  320.  
  321.                *  automatically repeat appointments,
  322.  
  323.                *  delete old appointments,
  324.  
  325.                *  run with or without SideKick,
  326.  
  327.                *  provide online help,
  328.  
  329.                *  show common secular and religious holidays automatically,
  330.  
  331.                *  allow you to customize the program for your own needs and
  332.                   style of use,
  333.  
  334.                *  show you a calendar for any month in the 20th or 21st
  335.                   century, and
  336.  
  337.                *  do much, much more....
  338.  
  339.  
  340.  
  341.           FOR A QUICK DEMONSTRATION:
  342.  
  343.                If you would like a quick demonstration of some of PAL's
  344.           features, first copy all the files in this distribution to a
  345.  
  346.                                           1
  347.  
  348.  
  349.  
  350.  
  351.                                 Pal 2.1 Documentation
  352.  
  353.           ─────────────────────────────────────────────────────────────────
  354.  
  355.           single subdirectory which lies within your DOS path.  Then run
  356.           the batch file PALDEMO.BAT.
  357.  
  358.  
  359.  
  360.           SUMMARY OF DOCUMENTATION:
  361.  
  362.                Here's a synopsis of the contents of this documentation.
  363.  
  364.                Chapter 1 (page 4) describes the basic syntax for using Pal
  365.           and some of the common terms used throughout this documentation.
  366.  
  367.                Chapter 2 (page 9) describes the hardware and software
  368.           requirements for using Pal.
  369.  
  370.                Chapter 3 (page 12) gives you simple installation
  371.           instructions for Pal.
  372.  
  373.                Chapter 4 (page 16) describes how you can get help within
  374.           PAL.
  375.  
  376.                Chapter 5 (page 17) tells you how to get a report of your
  377.           upcoming appointments and your old reminders.
  378.  
  379.                Chapter 6 (page 25) shows you how to find a particular
  380.           appointment.
  381.  
  382.                Chapter 7 (page 29) describes PAL's own internal Appointment
  383.           Scratchpad.  It is this facility which allows PAL to stand alone,
  384.           even if you do not have SideKick.
  385.  
  386.                Chapter 8 (page 41) tells you how to get PAL to remind you
  387.           to do something.
  388.  
  389.                Chapters 9, 10 and 11 are exclusively for SideKick users.
  390.           Chapter 9 (page 42) shows how you can create auto-repeat ap-
  391.           pointments within SideKick.  Chapter 10 (page 48) describes how
  392.           to get rid of old appointments in your SideKick file.  Chapter
  393.           11 (page 54) tells you how to combine multiple SideKick
  394.           appointment files so that PAL can do a side by side search.
  395.  
  396.                Chapter 12 (page 56) describes how to create alarms.
  397.  
  398.                Chapter 13 (page 65) tells you how to use an alarm to
  399.           initiate an action on your computer even when nobody is present.
  400.  
  401.                Chapter 14 (page 86) tells you how to customize PAL and
  402.           PALARM to your own liking.  In particular, section 14.1 focuses
  403.  
  404.                                           2
  405.  
  406.  
  407.  
  408.  
  409.                                 Pal 2.1 Documentation
  410.  
  411.           ─────────────────────────────────────────────────────────────────
  412.  
  413.           on changes to PAL's operation, while section 14.2 focuses on
  414.           changes to PALARM's operation.
  415.  
  416.                Chapter 15 (page 103) contains a discussion of multitasking
  417.           and possible conflicts with other resident programs.
  418.  
  419.                Chapter 16 (page 107) describes how to register, and the
  420.           benefits thereof.
  421.  
  422.                Chapter 17 (page 108) indicates the complete terms of your
  423.           license to use Pal.
  424.  
  425.                Chapter 18 (page 110) tells you how to obtain user support.
  426.  
  427.                Chapter 19 (page 111) describes the Ombudsman procedures of
  428.           the Association of Shareware Professionals.
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.                                           3
  463.  
  464.  
  465.  
  466.  
  467.           ═════════════════════════════════════════════════════════════════
  468.           ═════════════════════════════════════════════════════════════════
  469.  
  470.                              CHAPTER 1:  BASIC OPERATION
  471.  
  472.           ═════════════════════════════════════════════════════════════════
  473.           ═════════════════════════════════════════════════════════════════
  474.  
  475.  
  476.                PAL may be run either through menus or directly from the DOS
  477.           system prompt.
  478.  
  479.                Any time that PAL is paused awaiting your input, you may
  480.           temporarily drop out of the program to DOS by striking the <AltD>
  481.           key combination.  The <AltD> combination is obtained by pressing
  482.           and holding down the <Alt> key and then, while still holding down
  483.           the <Alt> key, simultaneously pressing the <D> key.  When you
  484.           have completed your task in DOS, you must type "Exit" and hit the
  485.           <Enter> key to return to PAL.  You will find yourself back in the
  486.           program, precisely at the spot you left.  While in DOS, do not
  487.           load any resident programs.
  488.  
  489.  
  490.  
  491.                1.1     Menu Operation of PAL
  492.  
  493.  
  494.                PAL is distributed so that if you invoke the program without
  495.           any additional command line parameters, it will present you with
  496.           a menu so that you may choose from its various operations.  PAL's
  497.           main menu appears as follows:
  498.  
  499.                    1.  Appointment Scratchpad
  500.                    2.  Clone New Defaults
  501.                    3.  Delete Old Appointments
  502.                    4.  Enter Command Line
  503.                    5.  Help
  504.                    6.  Purge Deadwood From Appointment File
  505.                    7.  Restore Original Distribution Defaults
  506.                    8.  Set Alarms
  507.  
  508.                    <ESC> to exit program
  509.  
  510.                To select an operation on any menu, hit the alphabetic key,
  511.           function key or numeric key which corresponds with the operation
  512.           you desire to activate.  No carriage return is required.
  513.  
  514.                Some of the foregoing choices on the main menu will lead you
  515.  
  516.  
  517.  
  518.  
  519.  
  520.                                           4
  521.  
  522.  
  523.  
  524.  
  525.                                 Pal 2.1 Documentation
  526.  
  527.           ─────────────────────────────────────────────────────────────────
  528.  
  529.           to other menus.  Just to give you an idea of the pathways you can
  530.           follow with PAL's menu system, here's a diagram showing the menu
  531.           structure:
  532.  
  533.                                        MAIN MENU
  534.                                           │
  535.           ┌──────────────────┬────────────┴──────┬────────────────────────┐
  536.           │                  │                   │                        │
  537.           │                  │                   │                        │
  538.           Appointment       Clone               Help                    Set
  539.           Scratchpad        Menu                Menu                   Menu
  540.           Menu                                                            │
  541.                                                                           │
  542.                                                                           │
  543.                                                                     Alarms│
  544.                                                                        Menu
  545.  
  546.  
  547.                If you require online help, just choose the help function.
  548.           You will be presented with a number of topics to choose from.
  549.  
  550.                You may use the CLONE procedure to force PAL not to show the
  551.           menu on start up, but to perform some other operation instead.
  552.  
  553.                Hint:   If you do clone PAL to perform a different operation
  554.           on start up, you can always reach the main menu by issuing either
  555.           "PAL MENU" or "PAL M" from the DOS system prompt.
  556.  
  557.  
  558.  
  559.                1.2     Entering a Command Line From the Menu
  560.  
  561.  
  562.                If you choose selection 4 ("Enter Command Line") from the
  563.           main menu, you will be able to enter the commands which instruct
  564.           PAL to perform any of its possible operations, with the same
  565.           syntax you would use if you were summoning PAL directly from the
  566.           DOS system prompt.  You will be provided with an on-screen
  567.           reminder of the syntax that PAL uses.
  568.  
  569.                When entering a command line here, do not start with the
  570.           word "PAL" as you would from the DOS system prompt.  The initial
  571.           word "PAL" is assumed; you'll see it on the screen already.
  572.  
  573.                Examples:
  574.  
  575.                If you enter "7" and hit return, PAL will give you a 7 day
  576.           report of your appointments.
  577.  
  578.                                           5
  579.  
  580.  
  581.  
  582.  
  583.                                 Pal 2.1 Documentation
  584.  
  585.           ─────────────────────────────────────────────────────────────────
  586.  
  587.                On the other hand, if you enter "PAL 7", this is incorrect
  588.           syntax since the word "PAL" is already assumed.  What you have
  589.           entered is equivalent to the entry "PAL PAL 7" at the DOS system
  590.           prompt.  You'll get an error message on the "booboo" screen.
  591.  
  592.                More often than not, you will be using the command line to
  593.           summon PAL's REPORT MODE to show your upcoming appointments,
  594.           reminders and alarms, or to summon PAL's SEARCH MODE to search
  595.           for an entry.  For more information about REPORT MODE, see
  596.           chapter 5 (page 17).  For more information about SEARCH MODE, see
  597.           chapter 6 (page 25).
  598.  
  599.  
  600.  
  601.                1.3     Command Line and Batch Operation of PAL
  602.  
  603.  
  604.                As an alternative to menu operation, you may invoke any of
  605.           PAL's operations directly from the DOS system prompt by adding
  606.           parameters after the program name.  Command line operation is
  607.           especially useful for batch files.
  608.  
  609.                There are many possible parameters which may be added after
  610.           the program name to instruct PAL to perform its operations.
  611.           These include the following (the items which are shown within
  612.           square brackets are optional):
  613.  
  614.                   PAL [@mm/dd/yyyy] n[ABCFHPRU] [FILENAME]
  615.                        for REPORT MODE
  616.                        (see chapter 5)
  617.  
  618.                   PAL [@mm/dd/yyyy] $[BCFPR] SEARCHTERM [FILENAME]
  619.                        for SEARCH MODE
  620.                        (see chapter 6)
  621.  
  622.                   PAL APPOINT or PAL A
  623.                        for invoking Appointment Scratchpad
  624.                        (see chapter 7)
  625.  
  626.                   PAL CLONE or PAL C
  627.                        for invoking Clone procedure
  628.                        (see chapter 14)
  629.  
  630.                   PAL DELETE or PAL D
  631.                        for invoking Delete procedure
  632.                        (see chapter 10)
  633.  
  634.  
  635.  
  636.                                           6
  637.  
  638.  
  639.  
  640.  
  641.                                 Pal 2.1 Documentation
  642.  
  643.           ─────────────────────────────────────────────────────────────────
  644.  
  645.                   PAL DELETEAUTO
  646.                        for non-stop Delete procedure
  647.                        (see section 10.4)
  648.  
  649.                   PAL DELETEAUTOALL
  650.                        for non-stop Delete procedure
  651.                        (see section 10.4)
  652.  
  653.                   PAL HELP or PAL H or PAL ?
  654.                        for invoking online help
  655.                        (see chapter 4)
  656.  
  657.                   PAL MENU or PAL M
  658.                        for invoking Menu operation
  659.                        (see chapter 1)
  660.  
  661.                   PAL PURGE or PAL P
  662.                        for invoking Purge procedure
  663.                        (see chapter 10)
  664.  
  665.                   PAL PURGEAUTO
  666.                        for non-stop Purge procedure
  667.                        (see section 10.4)
  668.  
  669.                   PAL READIMAGE [FILENAME]
  670.                        to read a Clone image
  671.                        (see section 14.1.9)
  672.  
  673.                   PAL RESTORE or PAL R
  674.                        for invoking Restore procedure
  675.                        (see section 14.1.8)
  676.  
  677.                   PAL SAVEIMAGE [FILENAME]
  678.                        to save a Clone image
  679.                        (see section 14.1.9)
  680.  
  681.                   PAL SET or PAL S
  682.                        for invoking the Set procedure
  683.                        (see section 12.11 and section 14.2)
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.                                           7
  695.  
  696.  
  697.  
  698.  
  699.                                 Pal 2.1 Documentation
  700.  
  701.           ─────────────────────────────────────────────────────────────────
  702.  
  703.                1.4     Menu or Command Line?
  704.  
  705.  
  706.                In general, once you get the hang of what PAL can do for
  707.           you, you will find that things go more quickly by using command
  708.           line operation directly from the DOS system prompt.
  709.  
  710.                Hint:   The one instance in which the menu will be more
  711.           efficient is if you want to perform more than one operation with
  712.           PAL; in that situation, rather than reloading the program each
  713.           time you want to do something, you can quickly initiate each
  714.           successive request directly from the menu.
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.                                           8
  753.  
  754.  
  755.  
  756.  
  757.           ═════════════════════════════════════════════════════════════════
  758.           ═════════════════════════════════════════════════════════════════
  759.  
  760.                                CHAPTER 2:  REQUIREMENTS
  761.  
  762.           ═════════════════════════════════════════════════════════════════
  763.           ═════════════════════════════════════════════════════════════════
  764.  
  765.  
  766.  
  767.                One requirement which you should observe immediately is to
  768.           look among your distribution files for one which is named
  769.           PALREAD.ME.  This file will include any changes to this
  770.           documentation that may require your attention.
  771.  
  772.  
  773.  
  774.                2.1     Hardware Requirements
  775.  
  776.  
  777.                You must be running on an IBM-PC or compatible computer.
  778.           Some machines which are not 100% compatible and which include
  779.           their own screen displays may have some difficulty showing PAL
  780.           well.
  781.  
  782.                You will find it convenient if you have a clock/calendar
  783.           within your system which sets the clock and date when you turn on
  784.           your computer.  If you are uncertain whether your machine sets
  785.           the time and date automatically, either through hardware or
  786.           software, consult your equipment manual.
  787.  
  788.                PAL requires at least 138K bytes of free memory to operate.
  789.  
  790.                If you want to use the resident alarm feature, then you'll
  791.           need an additional 36K bytes to install PALARM.EXE.  PALARM must
  792.           be loaded into memory for PAL's alarm feature to work.
  793.  
  794.                A hard disk is not required, but is strongly recommended.
  795.  
  796.                Expanded memory (memory above 640K which meets the LIM
  797.           specification) is not required.  However, if you do have
  798.           sufficient expanded memory available, then Pal's overlay file
  799.           will be loaded into that region of your computer and accessed
  800.           with lightning speed.  Similarly, EMS will be used by Pal for its
  801.           swap file whenever you swap to DOS.
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.                                           9
  811.  
  812.  
  813.  
  814.  
  815.                                 Pal 2.1 Documentation
  816.  
  817.           ─────────────────────────────────────────────────────────────────
  818.  
  819.                2.2     Required Pal Files
  820.  
  821.  
  822.                     Please check your distribution files to see if you have
  823.           received a file called "PALREAD.ME".  If so, this file contains
  824.           additional information or changes which do not appear in this
  825.           documentation.  Use the DOS type command or any other file
  826.           listing utility to read the file.
  827.  
  828.  
  829.                You should have the following files:
  830.  
  831.                   PALREAD.ME     If present, contains latest information
  832.                                  not included in this documentation.
  833.  
  834.                   PAL.EXE        PAL main program file
  835.                   PAL.OVR        PAL overlay file
  836.  
  837.                   PALARM.EXE     PALARM program file
  838.                   PALOFF.EXE     Removes PALARM from memory
  839.  
  840.                   PALDEMO.BAT    Demonstrate PAL
  841.                   PALDICK.APP    Data file for PALDEMO.BAT
  842.                   PALJANE.APP    Data file for PALDEMO.BAT
  843.  
  844.                   PAL.DOC        This documentation
  845.                   NOIBMPRN.EXE   Program to print documentation without IBM
  846.                                  graphics characters
  847.  
  848.                   PALOCATE.EXE   Resident program to help with Conditional
  849.                                  Application Macros
  850.  
  851.                   ORDER.FRM      Order form to register Pal and to order
  852.                                  Palrun (Palrun is another product of PAL
  853.                                  Software NY)
  854.  
  855.                   VENDOR.DOC     Disk vendors must read this file
  856.                   SYSOP.DOC      Special offer to BBS Sysops
  857.  
  858.                   WHATSNEW.PAL   A short file describing what's new in PAL
  859.                                  version 2.1
  860.  
  861.                   PAL21.INF      A short description of the features of PAL
  862.                                  version 2.1, which you might want to
  863.                                  upload separately to BBSes
  864.  
  865.                   PALRUN20.INF   A short description of the features of
  866.                                  PALRUN version 2.0
  867.  
  868.                                           10
  869.  
  870.  
  871.  
  872.  
  873.                                 Pal 2.1 Documentation
  874.  
  875.           ─────────────────────────────────────────────────────────────────
  876.  
  877.                Only the PAL.EXE and PAL.OVR files are needed to use all the
  878.           capabilities of Pal other than alarms.  Place them in a
  879.           subdirectory which resides in your DOS path.  PALARM.EXE is
  880.           required to use the alarms.
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.                                           11
  927.  
  928.  
  929.  
  930.  
  931.           ═════════════════════════════════════════════════════════════════
  932.           ═════════════════════════════════════════════════════════════════
  933.  
  934.                                CHAPTER 3:  INSTALLATION
  935.  
  936.           ═════════════════════════════════════════════════════════════════
  937.           ═════════════════════════════════════════════════════════════════
  938.  
  939.  
  940.  
  941.                3.1     Basic Installation
  942.  
  943.  
  944.                Installation of Pal and Palarm is a three step process.  You
  945.           need to place the needed files in your DOS path, make changes to
  946.           your AUTOEXEC.BAT file if you desire, and tell Pal and Palarm the
  947.           name and location of important data files.
  948.  
  949.                If you are upgrading from version 2.0 to 2.1 and want to
  950.           transplant all your customized settings from the older version to
  951.           the newer one, take advantage of the SAVEIMAGE and READIMAGE
  952.           procedures described in section 14.1.9 at page 97.
  953.  
  954.  
  955.  
  956.                   3.1.1     Copy Required Files
  957.  
  958.  
  959.                Copy all the files included in the distribution to a single
  960.           subdirectory which resides in your PATH (if you aren't familiar
  961.           with paths, check your DOS documentation).
  962.  
  963.  
  964.  
  965.                   3.1.2     Automate With Your AUTOEXEC.BAT File
  966.  
  967.  
  968.                The changes to your AUTOEXEC.BAT file described in this
  969.           section are not required.  You may, however, find them useful.
  970.  
  971.                If you intend to use the alarm facility, you need to load
  972.           PALARM.  This is most efficiently done by placing the command
  973.  
  974.                     PALARM
  975.  
  976.           within your AUTOEXEC.BAT file after the statement that sets your
  977.           DOS PATH.  If you also use SideKick, make sure that PALARM is
  978.           listed in your AUTOEXEC.BAT file before the command to load
  979.           SideKick.
  980.  
  981.                A common use for PAL is to show you your upcoming
  982.           appointments as soon as your computer is finished booting up in
  983.  
  984.                                           12
  985.  
  986.  
  987.  
  988.  
  989.                                 Pal 2.1 Documentation
  990.  
  991.           ─────────────────────────────────────────────────────────────────
  992.  
  993.           the morning.  To provide for this, you can add a command to your
  994.           AUTOEXEC.BAT file.  Usually this will be the very last command in
  995.           your AUTOEXEC.BAT file.  For instance, the command
  996.  
  997.                     PAL 14
  998.  
  999.           at the end of your AUTOEXEC.BAT file will show you your upcoming
  1000.           appointments for the next 2 weeks.
  1001.  
  1002.  
  1003.  
  1004.                   3.1.3     Required Customization
  1005.  
  1006.  
  1007.                There are two items that you need to tell PAL to remember
  1008.           before you can let it loose.  Once you set this information, you
  1009.           won't need to change it again.
  1010.  
  1011.  
  1012.  
  1013.                     3.1.3.1      Appointment File
  1014.  
  1015.  
  1016.                You need to tell PAL what file to examine when preparing a
  1017.           report.  To do this, you have to enter PAL's main menu, which you
  1018.           accomplish by issuing the command
  1019.  
  1020.                     PAL
  1021.  
  1022.           from the DOS prompt.
  1023.  
  1024.                From PAL's main menu, strike the <C> key to enter the CLONE
  1025.           procedure.  Then from the CLONE menu, strike the <F> key to
  1026.           change information regarding file locations.
  1027.  
  1028.                As distributed, PAL assumes that the name of your
  1029.           appointment file will be "NOFILE."  This is the proper setting
  1030.           for people who are not using SideKick, or for people using
  1031.           SideKick who do not want to use the same appointment file all the
  1032.           time.  If you do use SideKick and want PAL to use the same
  1033.           appointment file all the time, then enter the name here.
  1034.  
  1035.                If you are planning to use PAL with SideKick then change the
  1036.           name and extension of the appointment file to what SideKick
  1037.           writes its appointments.
  1038.  
  1039.  
  1040.  
  1041.  
  1042.                                           13
  1043.  
  1044.  
  1045.  
  1046.  
  1047.                                 Pal 2.1 Documentation
  1048.  
  1049.           ─────────────────────────────────────────────────────────────────
  1050.  
  1051.                     3.1.3.2      Alarm Data File
  1052.  
  1053.  
  1054.                The second item that you need to set is required only if you
  1055.           intend to use PAL's alarm capability.  If you do not intent to
  1056.           use alarms, disregard this section.
  1057.  
  1058.                On distribution, PALARM writes information to a file by the
  1059.           name of PALARM.DAT in the root directory of drive C:.  If this is
  1060.           satisfactory to you, then you do not need to make any change.
  1061.  
  1062.                If you want to change the default assumption as to the name
  1063.           and location of PALARM's data file, you first need to have loaded
  1064.           PALARM.  Then get back to PAL's main menu.  From the main menu,
  1065.           hit the <S> key to get to the "Set Alarms" menu.  From that menu,
  1066.           hit <I> to install assumptions.  Change the name and location of
  1067.           PALARM's data file to whatever suits your purposes.
  1068.  
  1069.  
  1070.  
  1071.                3.2     Advanced Installation
  1072.  
  1073.  
  1074.                The foregoing installation procedure is all that is required
  1075.           of you.  Assuming that you have copied all required files, made
  1076.           the suggested changes to your AUTOEXEC.BAT file and changed the
  1077.           assumptions that PAL and PALARM remember, you can reboot your
  1078.           computer and see just what happens.
  1079.  
  1080.                If you would like to examine the extensive customization
  1081.           that is possible with PAL and PALARM, browse through Chapter 14,
  1082.           starting at page 86.
  1083.  
  1084.  
  1085.  
  1086.                3.3     Screen Display
  1087.  
  1088.  
  1089.                Persons with 100% compatible monochrome and color monitors
  1090.           will ordinarily find PAL's screen display quite comfortable.
  1091.  
  1092.                However, persons with less than 100% compatible displays
  1093.           which try to emulate the IBM color screen may have difficulty
  1094.           reading what PAL writes.  For instance, it is known that some
  1095.           laptop computers which show colors as shades of gray interpret
  1096.           some of PAL's color combinations very poorly.
  1097.  
  1098.  
  1099.  
  1100.                                           14
  1101.  
  1102.  
  1103.  
  1104.  
  1105.                                 Pal 2.1 Documentation
  1106.  
  1107.           ─────────────────────────────────────────────────────────────────
  1108.  
  1109.                Solutions:
  1110.  
  1111.                   1.  The simplest solution is to have PAL write to your
  1112.           screen in basic black and white.
  1113.  
  1114.                   To see quickly how your screen will look in basic black
  1115.           and white, go to the directory in which the PALDICK.APP file
  1116.           resides (this is a demo SideKick appointment file which is used
  1117.           by PALDEMO.BAT) and issue the command "PAL 60C PALDICK".  If you
  1118.           find the display more readable, then you should CLONE PAL to
  1119.           always show in black and white.  See section 14.1.4.2 at page 92.
  1120.           Since the CLONE procedure itself may display poorly on the
  1121.           screen, before attempting to CLONE, issue the DOS command "MODE
  1122.           BW80" in order to turn off color generally within your system.
  1123.           After you finish cloning, you can restore color to your system
  1124.           with "MODE CO80".
  1125.  
  1126.                   2.   Another possible solution to the screen display
  1127.           problem is to use the facilities that may be provided by your own
  1128.           computer manufacturer for dealing with such problems.  Many
  1129.           computers have the ability to emulate monochrome monitors rather
  1130.           than color graphics adapters.  Others may permit you to choose
  1131.           from several palettes of color combinations to avoid a difficult
  1132.           display.  In any case, you should explore your hardware manual to
  1133.           see what options you have.
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.                                           15
  1159.  
  1160.  
  1161.  
  1162.  
  1163.           ═════════════════════════════════════════════════════════════════
  1164.           ═════════════════════════════════════════════════════════════════
  1165.  
  1166.                                CHAPTER 4:  ONLINE HELP
  1167.  
  1168.           ═════════════════════════════════════════════════════════════════
  1169.           ═════════════════════════════════════════════════════════════════
  1170.  
  1171.  
  1172.  
  1173.                You can invoke online help from the beginning menu, or
  1174.           directly from the DOS system prompt with "PAL HELP" , "PAL H" or
  1175.           "PAL ?".  To select a subject for help, hit the alphabetic key
  1176.           which corresponds with the subject which you wish to review.  No
  1177.           carriage return is required.
  1178.  
  1179.                Additional help regarding alarms is available from the PAL
  1180.           SET menu.  You reach the PAL SET menu by issuing "PAL SET" or
  1181.           "PAL S" from the DOS system prompt or by choosing "S", "8" or
  1182.           "F8" from PAL's main menu.  Once at the PAL SET menu, you can
  1183.           summon the additional help by striking "H", "4" or "F4".
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.                                           16
  1217.  
  1218.  
  1219.  
  1220.  
  1221.           ═════════════════════════════════════════════════════════════════
  1222.           ═════════════════════════════════════════════════════════════════
  1223.  
  1224.                                CHAPTER 5:  REPORT MODE
  1225.  
  1226.           ═════════════════════════════════════════════════════════════════
  1227.           ═════════════════════════════════════════════════════════════════
  1228.  
  1229.  
  1230.  
  1231.                5.1     What Does a Report Show?
  1232.  
  1233.  
  1234.                When you request a report from PAL, you will first see PAL's
  1235.           title screen.  In the upper left hand corner, PAL will provide a
  1236.           message telling you the name of the file it is analyzing.  In the
  1237.           center of the top line, as PAL inserts your memos in a sorted
  1238.           manner into your computer's memory, PAL may display the number of
  1239.           bytes of free memory which remain as it does its work.  Here's a
  1240.           sample screen display:
  1241.  
  1242.  
  1243.  
  1244.    Personal Appointment Locator
  1245.    Ver. 2.1 Copyright 1990 PAL Software NY                ╔════════════════════╗
  1246.                                                           ║April     20    1994║
  1247.    Searching \SK\PAL.APP                                  ╠════════════════════╣
  1248.    Today is Wednesday, April 20, 1994                     ║      10:38:13am    ║
  1249.    14 entries listed for next 14 days:                    ╠══╤══╤══╤══╤══╤══╤══╣
  1250.                                                           ║SU│MO│TU│WE│TH│FR│SA║
  1251.    Wed, Apr 20 1994,  9:00 am   :Mr. Kurlin               ╟──┼──┼──┼──┼──┼──┼──╢
  1252.    Wed, Apr 20 1994, 10:30 am   :Word processing demo     ║27│28│29│30│31│ 1│ 2║
  1253.    Wed, Apr 20 1994,  5:00 pm   :Run for the train@       ╟──┼──┼──┼──┼──┼──┼──╢
  1254.                                                           ║ 3│ 4│ 5│ 6│ 7│ 8│ 9║
  1255.    Thu, Apr 21 1994,  5:00 pm   :Run for the train@       ╟──┼──┼──┼──┼──┼──┼──╢
  1256.                                                           ║10│11│12│13│14│15│16║
  1257.    Fri, Apr 22 1994,  5:00 pm   :Run for the train@       ╟──┼──┼──┼──┼──┼──┼──╢
  1258.                                                           ║17│18│19│20│21│22│23║
  1259.    Mon, Apr 25 1994,  8:00 am   :Partner's Meeting        ╟──┼──┼──┼──┼──┼──┼──╢
  1260.    Mon, Apr 25 1994, 12:00 pm   :Lunch with Gracie @10    ║24│25│26│27│28│29│30║
  1261.    Mon, Apr 25 1994,  5:00 pm   :Run for the train@       ╚══╧══╧══╧══╧══╧══╧══╝
  1262.  
  1263.    Tue, Apr 26 1994,  5:00 pm   :Run for the train@
  1264.  
  1265.  
  1266.  
  1267.                When the file is completely read and sorted, PAL will flash
  1268.           the first screen of the report.
  1269.  
  1270.                On the right side of the screen, you will see a calendar for
  1271.           the current month, with today's date highlighted.  There will be
  1272.  
  1273.  
  1274.                                           17
  1275.  
  1276.  
  1277.  
  1278.  
  1279.                                 Pal 2.1 Documentation
  1280.  
  1281.           ─────────────────────────────────────────────────────────────────
  1282.  
  1283.           a digital clock above the calendar, ticking away with the present
  1284.           time.  The clock will continue as you page through the report.
  1285.  
  1286.                PAL will highlight your most pressing appointments.  Today's
  1287.           appointments will show in intense yellow on color monitors, and
  1288.           all appointments after today through the next business day will
  1289.           be highlighted in intense green.  Monochrome and black and white
  1290.           monitors will show all these appointments in reverse video.
  1291.  
  1292.                The memo "Run for the train @" is an auto-repeating weekday
  1293.           alarm which was produced by a single memo entry.
  1294.  
  1295.                When PAL has finished showing you your coming appointments,
  1296.           it will then tell you if you have any future alarms to load into
  1297.           PALARM.  For information on alarms, see chapter 12 at page 56.
  1298.  
  1299.                Then PAL will show you your old reminders, if any.  See
  1300.           chapter 8 starting at page 41 for information on reminders.
  1301.  
  1302.                There are a few modifications to the report which you can
  1303.           make with the CLONE procedure.  First, you may have PAL tell you
  1304.           at the beginning of the report how many bytes could be saved from
  1305.           your file if you use the DELETE or PURGE procedures.  Second, you
  1306.           may have PAL give you an extended report describing each of the
  1307.           alarms which will be loaded into memory.  Third, you may turn off
  1308.           the sound which PAL makes as it displays each page.  For informa-
  1309.           tion on the CLONE procedure, see chapter 14 at page 86.
  1310.  
  1311.  
  1312.  
  1313.                5.2     REPORT MODE Syntax
  1314.  
  1315.  
  1316.                Syntax for the REPORT MODE is:
  1317.  
  1318.                   PAL [@mm/dd/yyyy] n[ABCFHPRU] [FILENAME]
  1319.  
  1320.                The only required entries at the DOS system prompt are the
  1321.           program name and "n", where "n" is the number of days you would
  1322.           like the report to encompass.  The maximum number for "n" is
  1323.           32,767.  PAL can show memos and holidays through the year 2099.
  1324.  
  1325.                For instance, "PAL 7" would give you a report of your next
  1326.           week's appointments.
  1327.  
  1328.                The remaining parameters are optional.  Do not type in the
  1329.           brackets; they are set forth above only to indicate that the
  1330.           items are optional.
  1331.  
  1332.                                           18
  1333.  
  1334.  
  1335.  
  1336.  
  1337.                                 Pal 2.1 Documentation
  1338.  
  1339.           ─────────────────────────────────────────────────────────────────
  1340.  
  1341.                Note that all operations which can be invoked from the DOS
  1342.           system prompt can also be entered at PAL's main menu.
  1343.  
  1344.  
  1345.  
  1346.                5.3     Date Control
  1347.  
  1348.  
  1349.                The first optional parameter is to set the start date of the
  1350.           report at other than your present system date.  For instance,
  1351.           "PAL @1/1/88 7" will give you appointments for the first week in
  1352.           1990.
  1353.  
  1354.                Hint:   If you use the "@" by itself without a following
  1355.           date, then PAL will assume you mean "@1/1/85"; this is useful if
  1356.           you want a shorthand method to begin a Report or Search from a
  1357.           very early date.  For instance, "PAL @ 730" will show all
  1358.           appointments for 1985 and 1986.
  1359.  
  1360.  
  1361.  
  1362.                5.4     Toggle Switches
  1363.  
  1364.  
  1365.                The second group of optional parameters ("ABCFHPRU")
  1366.           consists of toggle switches.  They must be specified immediately
  1367.           following "n", without intervening spaces.  They stand for:
  1368.  
  1369.                   * "A" disables the "A"larm updating function.
  1370.  
  1371.                   Any alarms which PAL finds scheduled within the ap-
  1372.           pointment file will not be loaded.  This toggle switch is useful,
  1373.           for instance, where you have combined your own SideKick appoint-
  1374.           ment file with somebody else's so that you can view them to-
  1375.           gether, but you do not want the other person's alarms to be
  1376.           loaded into your system.  See chapter 11 for information on
  1377.           combining several SideKick appointment files.
  1378.  
  1379.                   * "B" is for batch usage.  This forces reports to pause
  1380.           before exiting back to the DOS prompt, requiring the user to
  1381.           strike a key.  This switch would be useful only if you are
  1382.           invoking PAL from a batch file and PAL is not the final command
  1383.           in the batch file, thus preventing the report from scrolling off
  1384.           the screen while the remaining commands execute.  Since the
  1385.           shareware version of PAL already requires user action to exit
  1386.           from the program, the "B" switch is only necessary in batch
  1387.           operation of the registered, commercial version of PAL.
  1388.  
  1389.  
  1390.                                           19
  1391.  
  1392.  
  1393.  
  1394.  
  1395.                                 Pal 2.1 Documentation
  1396.  
  1397.           ─────────────────────────────────────────────────────────────────
  1398.  
  1399.                   * "C" toggles "C"olor.
  1400.  
  1401.                   If you have a color display, or a screen which tries to
  1402.           emulate a color display (such as many laptop computers), then PAL
  1403.           will automatically attempt to show in color.  You may prefer to
  1404.           see a simple black and white display, or your laptop may display
  1405.           the colors poorly.  If this is the case, then you should try the
  1406.           "C" toggle to see how the reports look with color turned off;
  1407.           e.g., "PAL 7C".
  1408.  
  1409.                   If you prefer to have color turned off permanently, then
  1410.           you can make the adjustment permanently within the CLONE
  1411.           procedure.  Once you make such a permanent adjustment with the
  1412.           CLONE procedure, the meaning of the "C" toggle is that you will
  1413.           temporarily be viewing the report in color.  The "C" toggle
  1414.           switch will not have any effect with monochrome displays.
  1415.  
  1416.                   * "F" sends your report to a "F"ile.
  1417.  
  1418.                   PAL uses the name PAL.TXT for the file.  You may change
  1419.           the name with the CLONE procedure.  When you specify "F", the
  1420.           screen display will not pause as it fills with appointments.
  1421.           Instead, the appointments will scroll by quickly as they are
  1422.           being written to the file.  You may force the scrolling to pause
  1423.           by hitting the key combination <CtrlS>; strike any other key to
  1424.           continue scrolling.
  1425.  
  1426.                   * "H" suppresses the reporting of "H"olidays.
  1427.  
  1428.                   This toggle switch is useful if you want to see a report
  1429.           of your appointments without the clutter of holidays.  PAL will
  1430.           ordinarily show several holidays automatically.  Within the CLONE
  1431.           procedure, you may turn off holidays individually, and you can
  1432.           make PAL show several other holidays which the distribution
  1433.           version is not set to show.  See section 14.1.3 for information
  1434.           on holidays.
  1435.  
  1436.                   * "P" sends your report to the "P"rinter.
  1437.  
  1438.                   PAL assumes that you would like only 48 lines per page
  1439.           and that you would like a form feed at the conclusion of each
  1440.           page.  With the CLONE procedure, you may change these assumptions
  1441.           and send tailor-made instructions to your printer immediately
  1442.           before and after each report.  As with the "F" parameter, when
  1443.           you specify "P", the screen will not pause as it fills with
  1444.           appointments.  Instead, the appointments will scroll by quickly
  1445.           as they are being sent to the printer.  Use <CtrlS> to pause and
  1446.           any other key to continue.
  1447.  
  1448.                                           20
  1449.  
  1450.  
  1451.  
  1452.  
  1453.                                 Pal 2.1 Documentation
  1454.  
  1455.           ─────────────────────────────────────────────────────────────────
  1456.  
  1457.                   * "R" suppresses auto-"R"epeat appointments.
  1458.  
  1459.                   This toggle switch is useful if you want to see a report
  1460.           without the clutter of repeating appointments.
  1461.  
  1462.                   * "U" runs REPORT MODE in "U"nattended mode.
  1463.  
  1464.                   With this toggle switch, PAL will run through your whole
  1465.           report without pausing for a key-press when the screen fills up
  1466.           with information.  This is useful, for instance, when you want to
  1467.           automatically update your alarm queue for timed events.
  1468.  
  1469.  
  1470.  
  1471.                5.5     File Handling
  1472.  
  1473.  
  1474.                The last optional parameter permits you to specify the
  1475.           complete name, including drive and path if needed, of the file
  1476.           you desire to examine.
  1477.  
  1478.  
  1479.  
  1480.                   5.5.1     File Assumptions
  1481.  
  1482.  
  1483.                If you do not specify the filename, then PAL will use its
  1484.           default assumptions for the name and location of the file.  These
  1485.           default assumptions can be set in the CLONE procedure.  On
  1486.           distribution, PAL assumes that the name of the file to examine is
  1487.           "APPOINT.APP" and looks for it first in the current directory and
  1488.           the DOS path.  If PAL does not find APPOINT.APP, it looks for the
  1489.           file in "C:\SK" and then in "C:\".
  1490.  
  1491.                PAL allows you to specify your filename in "shorthand". If
  1492.           you specify a directory only, then PAL will supply the filename
  1493.           and extension.  If you specify a directory plus a filename but
  1494.           leave out the extension, then PAL will automatically supply the
  1495.           assumed extension.  You can have PAL examine a file that has no
  1496.           extension by adding a period after the filename.
  1497.  
  1498.                Examples:    For instance, assume that you have a file
  1499.           called "BUSINESS.APP" for your business appointments and
  1500.           "VIDEO.APP" to schedule all the TV shows you want to video tape,
  1501.           and that both files reside in "C:\SK".  The command line "PAL 7
  1502.           VIDEO" will examine the file "C:\SK\VIDEO.APP".
  1503.  
  1504.  
  1505.  
  1506.                                           21
  1507.  
  1508.  
  1509.  
  1510.  
  1511.                                 Pal 2.1 Documentation
  1512.  
  1513.           ─────────────────────────────────────────────────────────────────
  1514.  
  1515.                Similarly, the command line "PAL 7 BUSINESS" will examine
  1516.           the file "C:\SK\BUSINESS.APP".
  1517.  
  1518.                The command line "PAL 7" will cause PAL to look for the file
  1519.           "APPOINT.APP" in the series of directories described above, while
  1520.           the command line "PAL 7 C:\SK\" will force PAL to look for the
  1521.           file "C:\SK\APPOINT.APP".
  1522.  
  1523.  
  1524.  
  1525.                   5.5.2     PAL's Appointment Scratchpad
  1526.  
  1527.  
  1528.                In addition to examining the specified SideKick appointment
  1529.           file, PAL will examine all the appointments which you have
  1530.           entered in PAL's own Appointment Scratchpad.  See chapter 7 for a
  1531.           complete description of the Appointment Scratchpad.
  1532.  
  1533.                If you specify "Nofile" as the file to examine, then PAL
  1534.           will not examine any physical file on your disk.  Instead, PAL
  1535.           will only examine the Appointment Scratchpad.  For instance:
  1536.  
  1537.                   PAL 30 NOFILE
  1538.  
  1539.           will force PAL to avoid looking in any SideKick appointment file
  1540.           and to focus its attention on the Appointment Scratchpad instead.
  1541.  
  1542.                If you are not using SideKick with PAL, then you absolutely
  1543.           must specify "Nofile" as the file to examine.  Otherwise, PAL
  1544.           will always be looking for a non-existent APPOINT.APP.  If you
  1545.           have "Nofile" as your default file name, you can always
  1546.           explicitly name a SideKick file on the command line.
  1547.  
  1548.                You can force PAL to change its internal file name assump-
  1549.           tions.  See section 14.1.2.3 for instructions on how to CLONE
  1550.           such a change into PAL.
  1551.  
  1552.  
  1553.  
  1554.                   5.5.3     Overriding PAL's Assumptions
  1555.  
  1556.  
  1557.                In general, if PAL's assumptions as to the name and location
  1558.           of your appointment file are incorrect, then you may either:
  1559.  
  1560.                (1) change PAL's assumptions with the CLONE feature, or
  1561.  
  1562.  
  1563.  
  1564.                                           22
  1565.  
  1566.  
  1567.  
  1568.  
  1569.                                 Pal 2.1 Documentation
  1570.  
  1571.           ─────────────────────────────────────────────────────────────────
  1572.  
  1573.                (2) change the name and location of your appointment
  1574.                file in order to match PAL's assumptions, or
  1575.  
  1576.                (3) fully specify the name and location each time you
  1577.                invoke PAL.
  1578.  
  1579.  
  1580.  
  1581.                5.6     Examples
  1582.  
  1583.  
  1584.                As an example of REPORT MODE, to see all your appointments
  1585.           for the next week, issue the command "PAL 7".
  1586.  
  1587.                A very common use for PAL is to insert such a command as the
  1588.           last line of your AUTOEXEC.BAT file, so that your coming appoint-
  1589.           ments greet you when your computer finishes booting in the morn-
  1590.           ing.
  1591.  
  1592.                Other examples:
  1593.  
  1594.                PAL @1/1/90 366hr
  1595.  
  1596.                   --  shows all appointments in 1990, suppresses
  1597.                   holidays and auto-repeat appointments.
  1598.  
  1599.                PAL 30 nofile
  1600.  
  1601.                   --  shows appointments for next 30 days, but only
  1602.                   those which have been entered in the Appointment
  1603.                   Scratchpad.
  1604.  
  1605.                PAL @ 32000p myapp.
  1606.  
  1607.                   --  shows appointments for 32,000 days starting at
  1608.                   1/1/1985, and sends the report to your printer.
  1609.                   Looks for file MYAPP (which does not have a
  1610.                   filename extension).
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.                                           23
  1623.  
  1624.  
  1625.  
  1626.  
  1627.                                 Pal 2.1 Documentation
  1628.  
  1629.           ─────────────────────────────────────────────────────────────────
  1630.  
  1631.                5.7     Special Memos
  1632.  
  1633.  
  1634.                In REPORT MODE, PAL will interpret some of your memos as
  1635.           having special meaning and will provide you with extra-special
  1636.           results when those memos are encountered.  They are:
  1637.  
  1638.                   * Reminders:     Memos containing "!"
  1639.  
  1640.                   * Alarms:      Memos containing "@"
  1641.  
  1642.                   * Auto-Repeat:   SideKick memos containing any of the
  1643.                     following characters:   [ ] { } ~
  1644.  
  1645.                Caution:  A caution for persons printing out this
  1646.           documentation rather than viewing it on a computer screen:  The
  1647.           special characters shown on the immediately preceding line are
  1648.           generally known as the left and right square brackets, left and
  1649.           right curly braces and the tilde (a small, wavy line).  Some
  1650.           printers may not print the correct image of these characters.
  1651.           Therefore, if you have any doubt as to the "truthfulness" of your
  1652.           printer, consult PAL's online help regarding auto-repeat
  1653.           appointments and view the characters on your screen; or you can
  1654.           view this documentation with DOS's TYPE command or any other
  1655.           program that permits you to view the documentation on your
  1656.           monitor.
  1657.  
  1658.                For details on reminders, see chapter 8.
  1659.  
  1660.                For details on alarms, see chapter 12.
  1661.  
  1662.                For details on auto-repeat, see chapters 7 (for the Appoint-
  1663.           ment Scratchpad) and 9 (for SideKick auto-repeat).
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.                                           24
  1681.  
  1682.  
  1683.  
  1684.  
  1685.           ═════════════════════════════════════════════════════════════════
  1686.           ═════════════════════════════════════════════════════════════════
  1687.  
  1688.                                CHAPTER 6:  SEARCH MODE
  1689.  
  1690.           ═════════════════════════════════════════════════════════════════
  1691.           ═════════════════════════════════════════════════════════════════
  1692.  
  1693.  
  1694.  
  1695.                6.1     SEARCH MODE Syntax
  1696.  
  1697.  
  1698.                Syntax for the SEARCH MODE is:
  1699.  
  1700.                   PAL [@mm/dd/yyyy] $[BCFPR] SEARCHTERM [FILENAME]
  1701.  
  1702.           The required parameters in SEARCH MODE are the program's name,
  1703.           followed by the "$" character (think "$earch"), followed by the
  1704.           term for which you want PAL to search.
  1705.  
  1706.  
  1707.  
  1708.                6.2     SEARCH MODE Optional Parameters
  1709.  
  1710.  
  1711.                The optional parameters are identical to those permitted in
  1712.           REPORT MODE, with minor exceptions.
  1713.  
  1714.                For information regarding date manipulation, see section
  1715.           5.3.
  1716.  
  1717.                For information regarding the toggle switches, see section
  1718.           5.4.  The only differences in the effect of the toggle switches
  1719.           within SEARCH MODE are that the "A"larm and "H"oliday switches
  1720.           have no effect, and the "R" switch prevents search of the Ap-
  1721.           pointment Scratchpad.
  1722.  
  1723.                For information regarding the FILENAME, see section
  1724.           14.1.2.3.
  1725.  
  1726.  
  1727.  
  1728.                6.3     What SEARCH MODE does
  1729.  
  1730.  
  1731.                SEARCH MODE is restricted to the single, simple function of
  1732.           conducting a search for your "Searchterm" through your file
  1733.           and/or through PAL's own Appointment Scratchpad.  A search will
  1734.           pick up appointments which fall on or after the date of the
  1735.           report.
  1736.  
  1737.  
  1738.                                           25
  1739.  
  1740.  
  1741.  
  1742.  
  1743.                                 Pal 2.1 Documentation
  1744.  
  1745.           ─────────────────────────────────────────────────────────────────
  1746.  
  1747.                The "Searchterm" is the string of characters that you are
  1748.           trying to match.  The search is insensitive to upper or lower
  1749.           case.
  1750.  
  1751.                Suppose you want to search for "Uncle Herman's Birthday".
  1752.           You can shorten the number of letters you type by just choosing a
  1753.           few.  Let's say you issue the command "PAL $ man".  You may get a
  1754.           search report that looks something like this:
  1755.  
  1756.  
  1757.    Personal Appointment Locator
  1758.    Ver. 2.1 Copyright 1990 PAL Software NY                ╔════════════════════╗
  1759.                                                           ║June      22    1990║
  1760.    Searching APPOINT.APP                                  ╟────────────────────╢
  1761.    The following matches have been found                  ║      10:49:25pm    ║
  1762.     for "MAN":                                            ╠══╤══╤══╤══╤══╤══╤══╣
  1763.                                                           ║SU│MO│TU│WE│TH│FR│SA║
  1764.    #  1│Yrly│ 7/ 8  │   Title   │Uncle Herman's Birthday  ╠══╪══╪══╪══╪══╪══╪══╣
  1765.                                                           ║27│28│29│30│31│ 1│ 2║
  1766.    Mon, Jun 25 1990, 10:00 am   :Appt. w/ Ullman @20      ╟──┼──┼──┼──┼──┼──┼──╢
  1767.                                                           ║ 3│ 4│ 5│ 6│ 7│ 8│ 9║
  1768.                                                           ╟──┼──┼──┼──┼──┼──┼──╢
  1769.                                                           ║10│11│12│13│14│15│16║
  1770.                                                           ╟──┼──┼──┼──┼──┼──┼──╢
  1771.                                                           ║17│18│19│20│21│22│23║
  1772.                                                           ╟──┼──┼──┼──┼──┼──┼──╢
  1773.                                                           ║24│25│26│27│28│29│30║
  1774.                                                           ╚══╧══╧══╧══╧══╧══╧══╝
  1775.  
  1776.  
  1777.                Notice that this search picked up another appointment as
  1778.           well.  You would have picked up only the appointment you wanted
  1779.           if you had been more exclusive in your search by, for instance,
  1780.           using "Herman" as your searchterm.
  1781.  
  1782.                In your search report, all matching appointments which are
  1783.           found in the Appointment Scratchpad which are auto-repeating
  1784.           (that is, all of them except those which you designate with a
  1785.           frequency of "once") will be clustered at the beginning of the
  1786.           report with an indication that they are located in the Scratch-
  1787.           pad, with fields of pertinent information separated by vertical
  1788.           bars.  For more detailed information, you'll have to enter the
  1789.           Appointment Scratchpad to see the restrictions imposed on the
  1790.           appointment.
  1791.  
  1792.                All "carryforward" appointments from your SideKick appoint-
  1793.           ment file will also be shown.  By "carryforward" we mean appoint-
  1794.           ments which were entered prior to today's date, but which are
  1795.  
  1796.                                           26
  1797.  
  1798.  
  1799.  
  1800.  
  1801.                                 Pal 2.1 Documentation
  1802.  
  1803.           ─────────────────────────────────────────────────────────────────
  1804.  
  1805.           intended to be shown today or after today's date, such as auto-
  1806.           repeat appointments and reminders.  These carryforward appoint-
  1807.           ments will be shown in your search screen as occurring on the day
  1808.           for which they were initially entered.  Thus, auto-repeat ap-
  1809.           pointments are shown only once in Search Mode.  It is up to you
  1810.           to look at the special character codes that you have entered in
  1811.           the memo in order to determine when they will repeat.
  1812.  
  1813.                If your searchterm spans more than a single word, then you
  1814.           must enclose the entire searchterm within quote marks; otherwise,
  1815.           PAL will interpret the second word of the searchterm as the name
  1816.           of the file you wish to search.
  1817.  
  1818.                If you wish to search for a string which itself contains
  1819.           quote marks, then you must enclose each of those quote marks
  1820.           themselves within quote marks.
  1821.  
  1822.  
  1823.                Examples:
  1824.  
  1825.  
  1826.                PAL @ $r ~
  1827.  
  1828.                   --  will pick up all appointments in your SK file (the
  1829.                   "r" disables search of the Appointment Scratchpad) after
  1830.                   1/1/85 which contain the tilde character, which signifies
  1831.                   an auto-repeat appointment within a SideKick memo.
  1832.  
  1833.  
  1834.                PAL $c max
  1835.  
  1836.                   --  will pick up "max", "maxine", "maximum", etc. in your
  1837.                   default appointment file.  Color is toggled.
  1838.  
  1839.  
  1840.                PAL $ max planck
  1841.  
  1842.                   --  will pick up same as preceding command, but will
  1843.                   search a file called "PLANCK.APP" (if it can be found).
  1844.  
  1845.  
  1846.                PAL $ "max planck"
  1847.  
  1848.                   --  will search for the words "Max Planck" in your
  1849.                   default appointment file.
  1850.  
  1851.  
  1852.  
  1853.  
  1854.                                           27
  1855.  
  1856.  
  1857.  
  1858.  
  1859.                                 Pal 2.1 Documentation
  1860.  
  1861.           ─────────────────────────────────────────────────────────────────
  1862.  
  1863.                PAL $ "Pay Joey """The Hatchet""" !"
  1864.  
  1865.                   --  will search for the words:
  1866.                     Pay Joey "The Hatchet" !
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.                                           28
  1913.  
  1914.  
  1915.  
  1916.  
  1917.           ═════════════════════════════════════════════════════════════════
  1918.           ═════════════════════════════════════════════════════════════════
  1919.  
  1920.                         CHAPTER 7:  THE APPOINTMENT SCRATCHPAD
  1921.  
  1922.           ═════════════════════════════════════════════════════════════════
  1923.           ═════════════════════════════════════════════════════════════════
  1924.  
  1925.  
  1926.  
  1927.                PAL's Appointment Scratchpad allows you to keep track of
  1928.           your appointments even if you do not have, or prefer not to use,
  1929.           SideKick.  You are provided with 60 slots to enter your memos,
  1930.           but by employing the easy to use auto-repeat editing capacity
  1931.           within the Appointment Scratchpad, the number of appointments you
  1932.           actually design could easily exceed 60,000.  Furthermore, by
  1933.           using PAL's ability to save and read images, you can have an
  1934.           infinite number of Appointment Scratchpads, restricted only by
  1935.           available disk space.  See section 14.1.9 at page 97.
  1936.  
  1937.  
  1938.  
  1939.                7.1     Getting There
  1940.  
  1941.  
  1942.                You can reach the Appointment Scratchpad any of three ways.
  1943.  
  1944.                1.   From the DOS system prompt:
  1945.  
  1946.                     PAL APPOINT, or PAL A
  1947.  
  1948.                2.   From PAL's main menu:
  1949.  
  1950.                     Hit "1", "F1" or "A"
  1951.  
  1952.                3.   From PAL's CLONE menu:
  1953.  
  1954.                     Hit "1", "F1" or "A"
  1955.  
  1956.  
  1957.  
  1958.                7.2     The Appointment Scratchpad Menu
  1959.  
  1960.  
  1961.                When you first enter the Appointment Scratchpad, you are
  1962.           presented with the following simple menu:
  1963.  
  1964.                    Add, Delete, Edit, Find, Old, Sort, ESC to quit
  1965.  
  1966.                To choose any of the operations, just hit the first letter
  1967.           of the operation you wish to perform, or strike the ESC key to
  1968.           exit the Appointment Scratchpad.
  1969.  
  1970.                                           29
  1971.  
  1972.  
  1973.  
  1974.  
  1975.                                 Pal 2.1 Documentation
  1976.  
  1977.           ─────────────────────────────────────────────────────────────────
  1978.  
  1979.                Use the cursor keys to view another screenful of appoint-
  1980.           ments.  The Home key will always take you to the top screen,
  1981.           while the End key will always take you to the bottom screen.  To
  1982.           page down through individual screens, use either the Page Down
  1983.           key, the right arrow key or the down arrow key.  To page up
  1984.           through the individual screens, use either the Page Up key, the
  1985.           left arrow key or the up arrow key.
  1986.  
  1987.                If you perform a Find operation which results in a match for
  1988.           a memo which is located on a screen not currently visible, then
  1989.           the menu will also show "Next" if the match is on a screen with
  1990.           higher numbered appointments and/or "Previous" if there is a
  1991.           match on a screen with lower numbered appointments.
  1992.  
  1993.  
  1994.  
  1995.                7.3     The Appointment Scratchpad Screen
  1996.  
  1997.  
  1998.                When you enter the Appointment Scratchpad, you will see your
  1999.           appointments in tabular form.  Here's a sample showing the first
  2000.           page:
  2001.  
  2002.  
  2003.    No Frequency Restrictions                    Memo                    Timeslot
  2004.     1│Once     │11/07/1990x  1, ...............│Finish Documentation!  │  Title
  2005.     2│Once     │11/25/1990x  1, ...............│First Jersey           │10:30 am
  2006.     3│Weekly   │10/22/1990x 40, Thu............│Mtg with D.M. @45      │ 7:30 pm
  2007.     4│Weekly   │10/27/1990x∞∞∞, Tue............│Mtg with K.T. @45      │ 7:30 pm
  2008.     5│1st Week │Always--------, Mon............│Partner's Meeting      │ 6:00 pm
  2009.     6│1st Week │10/27/1990x  9, Tue............│Marianne @45           │ 6:30 pm
  2010.     7│3rd Week │10/22/1990x  9, Thu............│Rhetta @45             │ 6:30 pm
  2011.     8│3rd Week │10/27/1990x  9, Tue............│Lynn @45               │ 6:30 pm
  2012.     9│Yearly   │Always--------, 07/06/****.....│Delia's Birthday       │  Title
  2013.    10│Yearly   │Always--------, 07/20/****.....│Aunt Ethel's Birthday  │  Title
  2014.    11│Yearly   │Always--------, 10/16/****.....│Micah's Birthday       │  Title
  2015.    12│Yearly   │Always--------, 12/21/****.....│Dad's Birthday         │  Title
  2016.    13│Yearly   │Always--------, 11/21/****.....│Laura's Birthday       │  Title
  2017.    14│Yearly   │Always--------, 02/06/****.....│Jesse's Birthday       │  Title
  2018.    15│Yearly   │Always--------, 02/20/****.....│Phyllis' Birthday      │  Title
  2019.  
  2020.  
  2021.                As you can see, each appointment is numbered (from 1 to 60).
  2022.           The columns show the frequency with which the appointment will
  2023.           appear, the restrictions which you have imposed on the appearance
  2024.           of that appointment, the memo which will be shown with REPORT
  2025.           MODE or SEARCH MODE, and the time slot for which the memo will
  2026.           appear.
  2027.  
  2028.                                           30
  2029.  
  2030.  
  2031.  
  2032.  
  2033.                                 Pal 2.1 Documentation
  2034.  
  2035.           ─────────────────────────────────────────────────────────────────
  2036.  
  2037.                To some extent, the facilities of REPORT MODE and SEARCH
  2038.           MODE are duplicated within the Appointment Scratchpad's own menu.
  2039.           For instance, you may "F"ind a sequence of characters in the
  2040.           Appointment Scratchpad instead of exiting and running a search.
  2041.           You may also order the appointments within the Appointment
  2042.           Scratchpad with the "S"ort command; however, only a complete
  2043.           report in REPORT MODE will expand the auto-repeating appoint-
  2044.           ments, show you holidays, load alarms, and provide all the
  2045.           goodies available in REPORT MODE.
  2046.  
  2047.  
  2048.  
  2049.                7.4     "A"dding Appointments
  2050.  
  2051.  
  2052.                To add an appointment to the Appointment Scratchpad, just
  2053.           hit the "A" key.  PAL will select the lowest-numbered empty slot
  2054.           for your appointment to occupy.
  2055.  
  2056.                As you construct the record for the appointment you want PAL
  2057.           to memorize, PAL will guess at the answers to the questions posed
  2058.           and will display those guesses opposite the questions.  If you
  2059.           wish to accept PAL's guess, then just hit the return key.
  2060.           Otherwise, enter your own choice and then hit the return key.
  2061.  
  2062.                As soon as you finish answering each question, PAL will
  2063.           convert your answer to start building a visual record of your
  2064.           choices.  When you complete all of your answers, the record will
  2065.           appear in identical form to all the other appointments which
  2066.           already reside in the Appointment Scratchpad.  This record will
  2067.           appear on the line immediately below the last line of the Ap-
  2068.           pointment Scratchpad.
  2069.  
  2070.                If you make a mistake while building the record, don't worry
  2071.           about it.  Just keep hitting the return key in answer to all the
  2072.           rest of the questions until you come to the last query:  "Are you
  2073.           satisfied with the record you have built?"  --  which can be
  2074.           answered only with a "Y" or an "N".  Strike the "N" key, and your
  2075.           erroneous information will disappear so you can try again.  Even
  2076.           if you select "Y" and the information in your Appointment
  2077.           Scratchpad is changed, the changes are not permanently accepted
  2078.           unless you CLONE when you exit the Appointment Scratchpad.
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.                                           31
  2087.  
  2088.  
  2089.  
  2090.  
  2091.                                 Pal 2.1 Documentation
  2092.  
  2093.           ─────────────────────────────────────────────────────────────────
  2094.  
  2095.                   7.4.1     Frequency
  2096.  
  2097.  
  2098.                The first choice you are requested to make is the frequency
  2099.           of the appointment:
  2100.  
  2101.  
  2102.           Enter desired frequency:  _____
  2103.  
  2104.      A. Once        D. Weekends    G. 2nd Week    J. Lst Week    M. Bimonthly
  2105.      B. Daily       E. Weekly      H. 3rd Week    K. Biweekly    N. Quarterly
  2106.      C. Weekdays    F. 1st Week    I. 4th Week    L. Monthly     O. Yearly
  2107.  
  2108.  
  2109.                   You will see an "A" to the right of the "Enter desired
  2110.           frequency:" prompt.  If you want to enter a non-repeating ap-
  2111.           pointment, then just hit the return key to accept the "A" selec-
  2112.           tion.  Otherwise, choose a letter that corresponds to the fre-
  2113.           quency you desire and then hit the return key.
  2114.  
  2115.  
  2116.  
  2117.                   7.4.2     Setting Restrictions
  2118.  
  2119.  
  2120.                Once you have chosen the frequency for the appointment, then
  2121.           you will be asked for the manner in which you would like the
  2122.           appearance of the appointment to be restricted.
  2123.  
  2124.  
  2125.  
  2126.                     7.4.2.1      Once
  2127.  
  2128.  
  2129.                Setting restrictions for a one-time appointment is simple.
  2130.           All you need to do is set the date on which the appointment
  2131.           falls.  Use the cursor keys to manipulate the month, day of
  2132.           month, and year.
  2133.  
  2134.  
  2135.  
  2136.                     7.4.2.2      Daily, Weekdays and Weekends
  2137.  
  2138.  
  2139.                For daily, weekday and weekend appointments you will first
  2140.           be asked whether you would like to show the appointment always.
  2141.  
  2142.  
  2143.  
  2144.                                           32
  2145.  
  2146.  
  2147.  
  2148.  
  2149.                                 Pal 2.1 Documentation
  2150.  
  2151.           ─────────────────────────────────────────────────────────────────
  2152.  
  2153.                If you answer "Y", then the appointment will be picked up by
  2154.           PAL for every appropriate day which is contained within your
  2155.           report, regardless of the beginning and ending day of your
  2156.           report.
  2157.  
  2158.                If you answer "N", then you will next be asked for the
  2159.           earliest date for which you would like the appointment to appear.
  2160.           To manipulate the date, use the cursor keys as shown at the
  2161.           bottom of the screen.  For weekday and weekend appointments, you
  2162.           will note that as you change the date with the cursor keys, the
  2163.           date will jump over inappropriate dates so that, for instance,
  2164.           you cannot select a weekend date for a weekday appointment.
  2165.  
  2166.                If you have answered "N" to the query whether you want the
  2167.           appointment to repeat always, then after you select the date, you
  2168.           are asked whether you would like to limit the number of times for
  2169.           the appointment to repeat.  If you answer "N", then the appoint-
  2170.           ment will repeat from the date you have chosen in the prior step
  2171.           until the end of your report, regardless of the ending date of
  2172.           your report (The Appointment Scratchpad will reflect your choice
  2173.           by inserting a series of three "infinity" characters in the line
  2174.           you are building).  If you answer "Y", you may then select a
  2175.           number between 1 and 255 to limit the number of repetitions.
  2176.  
  2177.  
  2178.  
  2179.                     7.4.2.3      Weekly, First, Second, Third, Fourth, Last
  2180.  
  2181.  
  2182.                The procedure for restricting weekly appointments is sub-
  2183.           stantially similar to the discussion for restricting daily,
  2184.           weekday and weekend appointments.  The only difference is that
  2185.           prior to getting into any of the other questions, you are first
  2186.           asked the day of the week on which you would like the appointment
  2187.           to be reported.  Then you answer all the same questions outlined
  2188.           above in section 7.4.2.2.
  2189.  
  2190.                Appointments which you request to be scheduled for the
  2191.           first, second, third, fourth or last occurrence of a particular
  2192.           day of the week in each month are restricted with the same steps
  2193.           as for weekly appointments.  However, you are given the addi-
  2194.           tional opportunity to further restrict the appointment to be
  2195.           shown only in a particular month each year, so that, for in-
  2196.           stance, you can set an appointment to fall on the fourth Thursday
  2197.           in November if you know of any holiday or appointment that could
  2198.           benefit from such a schedule.
  2199.  
  2200.  
  2201.  
  2202.                                           33
  2203.  
  2204.  
  2205.  
  2206.  
  2207.                                 Pal 2.1 Documentation
  2208.  
  2209.           ─────────────────────────────────────────────────────────────────
  2210.  
  2211.                     7.4.2.4      Biweekly
  2212.  
  2213.  
  2214.                The procedure for restricting a biweekly appointment is the
  2215.           same as for a weekly appointment, but with one significant
  2216.           difference.  Since it is important to know the starting date for
  2217.           a biweekly appointment (so that PAL knows which of the alternate
  2218.           weeks you want the appointment to be shown), PAL goes directly to
  2219.           the question of the starting date.  Thus, you are not given the
  2220.           opportunity to designate a biweekly appointment as repeating
  2221.           "always".  However, if you do want the appointment to appear from
  2222.           the beginning of any report through the end of any report, then
  2223.           simply pick a starting date prior to today (or prior to any
  2224.           earlier date that you might conceivably specify with the
  2225.           "@MM/DD/YYYY" parameter on the command line) and do not restrict
  2226.           the number of times for the appointment to repeat.
  2227.  
  2228.  
  2229.  
  2230.                     7.4.2.5      Monthly, Bimonthly, Quarterly
  2231.  
  2232.  
  2233.                If you select a monthly, bimonthly or quarterly appointment,
  2234.           you will first be asked to specify the day of the month on which
  2235.           the appointment must appear.  For bimonthly and quarterly ap-
  2236.           pointments, you must then specify which monthly pattern to
  2237.           follow; for instance, for bimonthly you can choose either the
  2238.           even numbered months or the odd numbered months of the year.
  2239.  
  2240.                Once you have specified the day of the month, and, where
  2241.           appropriate, the monthly pattern, you will then be given the
  2242.           opportunity to state whether the appointment should be shown
  2243.           always.  As with other types of appointments, if you answer
  2244.           "Y"es, then the appointment will be shown from the beginning to
  2245.           the end of all your reports.  If you answer "N"o, then you must
  2246.           specify a start date and then will be asked whether you wish to
  2247.           limit the number of repeats.
  2248.  
  2249.  
  2250.  
  2251.                     7.4.2.6      Annual
  2252.  
  2253.  
  2254.                First you will be asked to specify the month and day on
  2255.           which you would like the annual appointment to fall.  Then you
  2256.           will be given the opportunity to require the appointment to be
  2257.           shown always.  If you do not want it shown always, then you must
  2258.  
  2259.  
  2260.                                           34
  2261.  
  2262.  
  2263.  
  2264.  
  2265.                                 Pal 2.1 Documentation
  2266.  
  2267.           ─────────────────────────────────────────────────────────────────
  2268.  
  2269.           specify the beginning date and whether or not you want to limit
  2270.           the number of repeats.
  2271.  
  2272.  
  2273.  
  2274.                   7.4.3     Entering the Memo
  2275.  
  2276.  
  2277.                Now that you have chosen the frequency and have set the
  2278.           restrictions for your appointment, you may enter the memo as you
  2279.           would like it to appear in your report.  As with SideKick, your
  2280.           memo can be as long as 26 characters.
  2281.  
  2282.                Any of your memos in the Appointment Scratchpad may contain
  2283.           the special codes to create an alarm.  In this way you can
  2284.           readily create repeating alarms.  See chapter 12 at page 56 for
  2285.           how to create an alarm within your memo.
  2286.  
  2287.                Since the Appointment Scratchpad has already learned the
  2288.           frequency of your memo and the restrictions on how your appoint-
  2289.           ment will repeat, there is no need to use any of the valuable 26-
  2290.           character memo space for the special codes which would have been
  2291.           needed in a SideKick memo to design an auto-repeating appoint-
  2292.           ment.
  2293.  
  2294.  
  2295.  
  2296.                   7.4.4     Choosing the Time Slot
  2297.  
  2298.  
  2299.                You may choose any standard SideKick-type time slot, includ-
  2300.           ing "Title" and all half-hour intervals from 8:00 a.m. through
  2301.           and including 8:30 p.m.  Of course, with the ability to set
  2302.           advance alarms (see section 12.9 at page 59), you have a much
  2303.           wider choice of times at which you can be alerted to your
  2304.           appointments.
  2305.  
  2306.  
  2307.  
  2308.                   7.4.5     Saving (or Erasing) Your Choices
  2309.  
  2310.  
  2311.                Once you have selected the time slot, you will be asked
  2312.           whether you are satisfied with the record you built.
  2313.  
  2314.                If you answer "N"o, then the record will be erased and you
  2315.           will be returned to the Appointment Scratchpad menu.
  2316.  
  2317.  
  2318.                                           35
  2319.  
  2320.  
  2321.  
  2322.  
  2323.                                 Pal 2.1 Documentation
  2324.  
  2325.           ─────────────────────────────────────────────────────────────────
  2326.  
  2327.                If you answer "Y"es, that you are indeed satisfied with the
  2328.           record, then your new appointment will temporarily be added to
  2329.           the Appointment Scratchpad.  You will be able to see it inserted
  2330.           in the slot which was selected when you initially selected the
  2331.           "A"dd operation.  In order to make the addition permanent, you
  2332.           must CLONE when you exit the Appointment Scratchpad.  You will be
  2333.           given this opportunity when you hit ESC to leave the Scratchpad.
  2334.           If you choose not to CLONE, then you will lose the changes which
  2335.           were made to the Appointment Scratchpad during this session.
  2336.  
  2337.  
  2338.  
  2339.                7.5     "D"eleting an Appointment
  2340.  
  2341.  
  2342.                To delete an appointment from the Appointment Scratchpad,
  2343.           simply supply the number of the appointment you wish to delete.
  2344.           You will be asked to confirm that you want to delete the appoint-
  2345.           ment.
  2346.  
  2347.                As with changes made using the "A"dd operation, the changes
  2348.           which you make with the "D"elete operation take effect only
  2349.           temporarily.  To make the changes permanent, you must CLONE when
  2350.           you "ESC"ape from the Appointment Scratchpad.
  2351.  
  2352.  
  2353.  
  2354.                7.6     "E"diting an Appointment
  2355.  
  2356.  
  2357.                To edit an appointment, select any appointment slot.  You
  2358.           will then be taken through each of the choices that you would
  2359.           have to make if you were "A"dding an appointment (see section
  2360.           7.4).  The difference here is that if the slot you have selected
  2361.           to edit is already occupied, the guesses which PAL makes for the
  2362.           answers to the questions it poses will match the original infor-
  2363.           mation which you already have for the entry being edited.  If you
  2364.           would like to retain any of the original information, just hit
  2365.           the carriage return key to accept that default information.  To
  2366.           change the information, just enter the information as you would
  2367.           like it to appear, then hit the return key.
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.                                           36
  2377.  
  2378.  
  2379.  
  2380.  
  2381.                                 Pal 2.1 Documentation
  2382.  
  2383.           ─────────────────────────────────────────────────────────────────
  2384.  
  2385.                7.7     "F"inding an Appointment
  2386.  
  2387.  
  2388.                While within the Appointment Scratchpad, you may search for
  2389.           an appointment without having to exit and run PAL in its SEARCH
  2390.           MODE.  Of course, you may always run PAL in SEARCH MODE to look
  2391.           for an appointment, and PAL will turn up the matches in both your
  2392.           SideKick appointment file and PAL's Appointment Scratchpad.
  2393.  
  2394.                When you select the "F"ind operation, you will be asked what
  2395.           you want to search for.  You can enter any sequence of characters
  2396.           or words to search for.  Do not use quotation marks to surround
  2397.           groups of words as you would if you were using SEARCH MODE.  Hit
  2398.           the return key when you are finished typing the term or terms you
  2399.           want to find.
  2400.  
  2401.                PAL will then immediately examine all of the appointments in
  2402.           the Appointment Scratchpad to see if there is a match.  Lower and
  2403.           upper case characters will be treated identically.
  2404.  
  2405.                If PAL finds a match or matches, then those matches will be
  2406.           highlighted in the Appointment Scratchpad screen, and PAL will
  2407.           report in the lower left hand corner the numbers of the matched
  2408.           appointments.
  2409.  
  2410.                If there is a match located on a screen with appointments
  2411.           numbered higher than those on the visible screen, then the "N"ext
  2412.           operation will appear in the menu, and hitting the "N" key will
  2413.           take you immediately to the next screen with a match on it.
  2414.           Similarly, if there is a match located on a screen with lower-
  2415.           numbered appointments, then the "P"revious operation will appear
  2416.           in the menu, and hitting the "P" key will take you immediately to
  2417.           the prior screen with a match on it.  You may also use the cursor
  2418.           keys to page through the Appointment Scratchpad screens one by
  2419.           one.
  2420.  
  2421.                Choosing any operation other than "N"ext, "P"revious or
  2422.           paging with the cursor keys will remove the highlighting on the
  2423.           found appointments.
  2424.  
  2425.  
  2426.  
  2427.                7.8     "N"ext Screen
  2428.  
  2429.  
  2430.                Immediately following a "F"ind operation, if a match is
  2431.           found in an appointment which resides on a screen with higher-
  2432.           numbered appointments than the screen presently being shown, then
  2433.  
  2434.                                           37
  2435.  
  2436.  
  2437.  
  2438.  
  2439.                                 Pal 2.1 Documentation
  2440.  
  2441.           ─────────────────────────────────────────────────────────────────
  2442.  
  2443.           the "Next" selection will appear on the Appointment Scratchpad
  2444.           menu.  By hitting the "N" key, you will be taken directly to that
  2445.           screen.
  2446.  
  2447.  
  2448.  
  2449.                7.9     Removing "O"ld Appointments
  2450.  
  2451.  
  2452.                When you select the "O"ld operation, you are being given the
  2453.           opportunity to delete all non-repeating appointments (those which
  2454.           show in the frequency column as "Once").  You will be prompted
  2455.           whether or not you also want to delete old reminders, that is,
  2456.           appointments with the "!" character in them.
  2457.  
  2458.                It is possible that some of your auto-repeating appointments
  2459.           for which you specified a limited number of repeats are indeed
  2460.           out of date.  However, the "O"ld operation will not automatically
  2461.           delete them.  Since it is possible that when you specified the
  2462.           limited number of repeats you gave only a rough guess, it may be
  2463.           inappropriate for PAL to assume that you want to get rid of the
  2464.           limited auto-repeat appointment automatically.
  2465.  
  2466.                To cull out the auto-repeat appointments which are out of
  2467.           date by reason of the limitation on the number of repetitions,
  2468.           you must examine each of them, and if you truly no longer need
  2469.           them, use the "D"elete operation.
  2470.  
  2471.                Hint:   You may find it convenient to examine limited auto-
  2472.           repeat appointments by using the "S"ort operation to sort by
  2473.           number of repeats, thereby bring the limited appointments all
  2474.           together.  This will force the time-limited appointments to be
  2475.           sorted between those which appear only once and those which
  2476.           appear an infinite number of times.  See section 7.11 at page 39.
  2477.  
  2478.  
  2479.  
  2480.                7.10    "P"revious Screen
  2481.  
  2482.  
  2483.                Immediately following a "F"ind operation, if a match is
  2484.           found in an appointment which resides on a screen with lower-
  2485.           numbered appointments than the screen presently being shown, then
  2486.           the "Previous" selection will appear on the Appointment Scratch-
  2487.           pad menu.  By hitting the "P" key, you will be taken directly to
  2488.           that screen.
  2489.  
  2490.  
  2491.  
  2492.                                           38
  2493.  
  2494.  
  2495.  
  2496.  
  2497.                                 Pal 2.1 Documentation
  2498.  
  2499.           ─────────────────────────────────────────────────────────────────
  2500.  
  2501.                7.11    "S"orting Appointments
  2502.  
  2503.  
  2504.                To sort appointments within the Appointment Scratchpad, just
  2505.           hit the "S" key.  You will be presented with a number of choices
  2506.           as to the order in which you would like to sort the appointments:
  2507.  
  2508.           A. Complete                   F. Start Date, Descending
  2509.           B. Memo                       G. Frequency, Ascending
  2510.           C. Time Slot, Ascending       H. Frequency, Descending
  2511.           D. Time Slot, Descending      I. Repeats, Ascending
  2512.           E. Start Date, Ascending      J. Repeats, Descending
  2513.  
  2514.                To run a sort, strike the alphabetic key which corresponds
  2515.           with the type of sort you want.  To get back to the Appointment
  2516.           Scratchpad without sorting, strike the "Q" key to "Q"uit.
  2517.  
  2518.                Once you run a sort, you may then immediately re-sort on
  2519.           another category if you wish.  This will permit you to set up
  2520.           sorts within sorts, so that you can tailor the order of your
  2521.           Appointment Scratchpad display to your own needs.  For instance,
  2522.           if you would like to see your appointments sorted mainly by the
  2523.           number of repeats but would also like to see all appointments
  2524.           further sorted by increasing start date, then first use sort "E"
  2525.           (for the start date), then use sort "I" (for the number of
  2526.           repeats).
  2527.  
  2528.                Hint:   In general, when you want a sort within a sort (or a
  2529.           sort within a sort within a sort, etc.), then the least
  2530.           significant category should be sorted first, and the most
  2531.           important category should be sorted last.
  2532.  
  2533.                If you select "Complete" (choice A), which is the default
  2534.           choice, then PAL will do a multiple sort.  The sequence of the
  2535.           complete sort, in order of most to least significant, is (1)
  2536.           ascending frequency, (2) ascending start date, (3) ascending time
  2537.           slot, (4) ascending repeats, and (5) alphabetic.
  2538.  
  2539.                Selecting "Memo" (choice B), will sort alphabetically by
  2540.           your memo.
  2541.  
  2542.                "Time Slot, Ascending" (choice C) will sort by the time slot
  2543.           in increasing order of time, while "Time Slot, Descending"
  2544.           (choice D) will sort by the time slot in decreasing order of
  2545.           time.
  2546.  
  2547.  
  2548.  
  2549.  
  2550.                                           39
  2551.  
  2552.  
  2553.  
  2554.  
  2555.                                 Pal 2.1 Documentation
  2556.  
  2557.           ─────────────────────────────────────────────────────────────────
  2558.  
  2559.                "Start Date, Ascending" (choice E) will sort by increasing
  2560.           order of the commencement date of the appointment, while "Start
  2561.           Date, Descending" (choice F) will sort in reverse.
  2562.  
  2563.                When sorting by start date, appointments which are marked as
  2564.           "Always" (that is, they have no start date) will be considered to
  2565.           be earlier than appointments with a specified start date.
  2566.           "Always" appointments will also be considered to be equal to each
  2567.           other in start date, except that annual appointments situated
  2568.           next to one another will be sorted by month and date, monthly
  2569.           type appointments (monthly, bimonthly and quarterly) will be
  2570.           sorted by day of the month, and weekly type appointments (weekly,
  2571.           biweekly, first, second, third, fourth and last) will be sorted
  2572.           by the day of the week.
  2573.  
  2574.                "Frequency, Ascending" (choice G) will sort by the frequency
  2575.           order.  The order used for frequency is that which is displayed
  2576.           in the choices provided when you add or edit an appointment (see
  2577.           section 7.4.1).  "Frequency, Descending" (choice H) will sort in
  2578.           the opposite order.
  2579.  
  2580.                "Repeats, Ascending" (choice I) will sort by order of
  2581.           increasing number of repetitions, while "Repeats, Descending"
  2582.           (choice J) will sort by decreasing number of repetitions.
  2583.           Appointments which are not limited in the number of repetitions
  2584.           will be considered to repeat infinitely.
  2585.  
  2586.                If you want to quit back to the Appointment Scratchpad menu
  2587.           without sorting, then strike the "Q" key.
  2588.  
  2589.  
  2590.  
  2591.                7.12    "ESC"ape
  2592.  
  2593.  
  2594.                At the Appointment Scratchpad menu, once you hit the ESC
  2595.           key, you will either be dropped back to the DOS system prompt,
  2596.           the main menu or to the CLONE menu, depending on how you first
  2597.           entered the Appointment Scratchpad.
  2598.  
  2599.                If you have made changes to the Appointment Scratchpad, then
  2600.           you must CLONE them in order to save them.  PAL will automati-
  2601.           cally remind you of the need to CLONE unsaved changes when you
  2602.           exit back to the DOS system prompt or to the main menu; if you
  2603.           are "ESC"aping back to the CLONE menu, then you'll be reminded of
  2604.           your unsaved changes if you attempt to exit the CLONE menu
  2605.           without saving.   If you choose not to CLONE, then the changes
  2606.           you made in this session will be ignored.
  2607.  
  2608.                                           40
  2609.  
  2610.  
  2611.  
  2612.  
  2613.           ═════════════════════════════════════════════════════════════════
  2614.           ═════════════════════════════════════════════════════════════════
  2615.  
  2616.                                 CHAPTER 8:  REMINDERS
  2617.  
  2618.           ═════════════════════════════════════════════════════════════════
  2619.           ═════════════════════════════════════════════════════════════════
  2620.  
  2621.  
  2622.  
  2623.                If you want to maintain a reminder list, then enter an
  2624.           appointment either with SideKick or with PAL's internal Appoint-
  2625.           ment Scratchpad and insert an exclamation point ("!") anywhere in
  2626.           the memo.  If the day passes and the memo is still there, then
  2627.           PAL will remind you of that memo in a special section of its
  2628.           report.
  2629.  
  2630.                This feature is designed to serve as a "tickler."  Any time
  2631.           you have passed the day for which the reminder has been set, you
  2632.           will be specially alerted.  If you have run the demonstration
  2633.           batch file "PALDEMO" you will recall that Dick was supposed to
  2634.           have bought an engagement ring for Jane quite a long time ago.
  2635.  
  2636.                Hint:   Once you no longer require a memo to be
  2637.           characterized as one of these tickling reminders, all you need to
  2638.           do is enter SideKick or PAL's Scratchpad, as the case may be, and
  2639.           edit the memo to delete the "!", or else delete the memo in its
  2640.           entirety.
  2641.  
  2642.                Caution:  You cannot create automatically repeating
  2643.           reminders.  PAL will tickle you only for the actual, physical
  2644.           entry which you make, but not for any repetitions of that
  2645.           appointment which it interprets with its auto-repeat function.
  2646.           For instance, study the two following appointments:
  2647.  
  2648.                   Pay mortgage!
  2649.                   Pay car loan!]
  2650.  
  2651.           Assuming that both are entered on March 1, 1990, then on March 2,
  2652.           1990 and thereafter both will appear in the reminders section of
  2653.           your report.  If you have asked for a report which extends beyond
  2654.           March 31, 1990, then since the car loan memo is a monthly auto-
  2655.           repeat (see section 9.1 at page 42), you will see the car loan
  2656.           memo on the first day of each month which is included in the
  2657.           report.  However, in the reminders section of the report, you
  2658.           will see each of those memos only once.  To be reminded for more
  2659.           than a single date, you must enter a memo on each date for which
  2660.           you want to be tickled.
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.                                           41
  2667.  
  2668.  
  2669.  
  2670.  
  2671.           ═════════════════════════════════════════════════════════════════
  2672.           ═════════════════════════════════════════════════════════════════
  2673.  
  2674.                        CHAPTER 9:  SK AUTO-REPEAT APPOINTMENTS
  2675.  
  2676.           ═════════════════════════════════════════════════════════════════
  2677.           ═════════════════════════════════════════════════════════════════
  2678.  
  2679.  
  2680.  
  2681.                If you are not using SideKick with PAL, you can skip this
  2682.           chapter 9 in its entirety.
  2683.  
  2684.                PAL has extensive facilities to automatically repeat an
  2685.           appointment.  You may combine the auto-repeat capability with the
  2686.           alarm function to have an automatically repeating alarm.
  2687.  
  2688.                PAL's Appointment Scratchpad gives you a very simple method
  2689.           to automatically repeat appointments, but that is not the focus
  2690.           of this chapter.  Instead, this chapter focuses on creating auto-
  2691.           repeat appointments with SideKick.  For an in-depth discussion of
  2692.           the Appointment Scratchpad, see chapter 7.
  2693.  
  2694.  
  2695.  
  2696.                9.1     Single Character Auto-Repeat
  2697.  
  2698.  
  2699.                Daily, weekly, monthly and annual appointments may be
  2700.           repeated in either of two ways.  That is, you may either use a
  2701.           single character or a sequence of characters.  All auto-repeat
  2702.           patterns other than daily, weekly, monthly and annual require a
  2703.           special sequence of characters to be set.
  2704.  
  2705.                If you want to have an appointment come up periodically on a
  2706.           daily, weekly, monthly or annual basis, then you may insert
  2707.           characters as follows:
  2708.  
  2709.                Annual:
  2710.  
  2711.                   Use the left bracket ("[") or the sequence "~A"
  2712.  
  2713.  
  2714.                Monthly:
  2715.  
  2716.                   Use the right bracket ("]") or the sequence "~M"
  2717.  
  2718.  
  2719.                Weekly:
  2720.  
  2721.                   Use the left curly brace ("{") or the sequence "~W"
  2722.  
  2723.  
  2724.                                           42
  2725.  
  2726.  
  2727.  
  2728.  
  2729.                                 Pal 2.1 Documentation
  2730.  
  2731.           ─────────────────────────────────────────────────────────────────
  2732.  
  2733.                Daily:
  2734.  
  2735.                   Use the right curly brace ("}") or the sequence "~D"
  2736.  
  2737.                The four single-character codes are found on two keys on
  2738.           your keyboard.  To remember their use, it may be helpful to
  2739.           visualize them as follows:
  2740.  
  2741.  
  2742.                    weekly      daily
  2743.                       \        /
  2744.                        \      /
  2745.  
  2746.                         {    }
  2747.  
  2748.                         [    ]
  2749.  
  2750.                        /      \
  2751.                       /        \
  2752.                   annual      monthly
  2753.  
  2754.  
  2755.                Thus, for instance, if you would like PAL to remind you of
  2756.           your client's wedding anniversary so that you can remember to
  2757.           send out a greeting card and thereby be assured that the client
  2758.           will view you as a thoughtful person entitled to even more busi-
  2759.           ness, then either of the following two methods will produce an
  2760.           annual auto-repeat of that memo:
  2761.  
  2762.                   Mr. Money Anniv.  [
  2763.                   Mr. Money Anniv.  ~A
  2764.  
  2765.                The single-character codes (the square brackets and curly
  2766.           brackets) were chosen because of the likelihood that they would
  2767.           be infrequently used in your memos.  However, in the event that
  2768.           you find that it is more important to you to use the square
  2769.           brackets and the curly brackets as text instead of as auto-repeat
  2770.           characters, then you may disable them as auto-repeat characters.
  2771.           To do so, simply enter the CLONE procedure and make the change
  2772.           described in section 14.1.4.4 at page 93.
  2773.  
  2774.  
  2775.  
  2776.                9.2     Special Auto-Repeat Sequences
  2777.  
  2778.  
  2779.                More complex auto-repeat patterns can be inserted through
  2780.           the use of the tilde ("~") character.  PAL interprets the tilde
  2781.  
  2782.                                           43
  2783.  
  2784.  
  2785.  
  2786.  
  2787.                                 Pal 2.1 Documentation
  2788.  
  2789.           ─────────────────────────────────────────────────────────────────
  2790.  
  2791.           as a signal that the next character or characters represent the
  2792.           codes for a special pattern.  You may follow the tilde with any
  2793.           of the following combinations:
  2794.  
  2795.  
  2796.  
  2797.                   9.2.1     Daily types
  2798.  
  2799.  
  2800.                ~D   Daily
  2801.                ~WD  Weekdays
  2802.                ~WE  Weekends
  2803.  
  2804.  
  2805.  
  2806.                   9.2.2     Weekly types
  2807.  
  2808.  
  2809.                ~W   Weekly
  2810.                ~WO  Biweekly (think "Week Other")
  2811.                ~1   First occurrence of that day in each month
  2812.                ~2   Second occurrence of that day in each month
  2813.                ~3   Third occurrence of that day in each month
  2814.                ~4   Fourth occurrence of that day in each month
  2815.                ~L   Last occurrence of that day in each month
  2816.  
  2817.  
  2818.  
  2819.                   9.2.3     Monthly types
  2820.  
  2821.  
  2822.                ~M   Monthly
  2823.                ~MO  Bimonthly (think "Month Other")
  2824.                ~Q   Quarterly
  2825.  
  2826.  
  2827.  
  2828.                   9.2.4     Annual type
  2829.  
  2830.  
  2831.                ~A   Annually
  2832.  
  2833.  
  2834.                Each of these patterns will repeat starting with the day for
  2835.           which the appointment has been entered, with the following excep-
  2836.           tions:
  2837.  
  2838.  
  2839.  
  2840.                                           44
  2841.  
  2842.  
  2843.  
  2844.  
  2845.                                 Pal 2.1 Documentation
  2846.  
  2847.           ─────────────────────────────────────────────────────────────────
  2848.  
  2849.                *  If you enter a ~WD appointment on a Saturday or Sunday it
  2850.           will not commence repeating until the following Monday.
  2851.  
  2852.                *  If you enter a ~WE appointment on a weekday it will not
  2853.           commence repeating until the first Saturday which follows.
  2854.  
  2855.                *  If you enter patterns ~1 through ~L, and the day for
  2856.           which you have entered the appointment does not coincide with the
  2857.           occurrence that you have specified, then the appointment will not
  2858.           repeat until the first appropriate occurrence thereafter.  For
  2859.           instance, suppose that you have entered "Department meeting ~2"
  2860.           in a timeslot for Thursday, October 15, 1992.  Your specified
  2861.           pattern calls for the appointment to repeat on the second Thurs-
  2862.           day of each month, but the date on which you entered the appoint-
  2863.           ment is actually the third Thursday of October, 1992.  The auto-
  2864.           repeat will not commence until the second Thursday of the follow-
  2865.           ing month:  Thursday, November 12, 1992.
  2866.  
  2867.  
  2868.  
  2869.                9.3     Special Month Restrictions
  2870.  
  2871.  
  2872.                The patterns of ~1 through ~L may be further restricted to a
  2873.           particular month.  The way to impose this restriction is to add a
  2874.           single character at the end of the pattern to signify the desired
  2875.           month.  The characters to add are:
  2876.  
  2877.                   1  --  January
  2878.                   2 --   February
  2879.                   3 --   March
  2880.                   4 --   April
  2881.                   5 --   May
  2882.                   6 --   June
  2883.                   7 --   July
  2884.                   8 --   August
  2885.                   9 --   September
  2886.                   O --   October
  2887.                   N --   November
  2888.                   D --   December
  2889.  
  2890.                Thus, for instance, you can make Thanksgiving appear on the
  2891.           appropriate date each year by entering the following memo in any
  2892.           Thursday timeslot:
  2893.  
  2894.                     Thanksgiving ~4N
  2895.  
  2896.  
  2897.  
  2898.                                           45
  2899.  
  2900.  
  2901.  
  2902.  
  2903.                                 Pal 2.1 Documentation
  2904.  
  2905.           ─────────────────────────────────────────────────────────────────
  2906.  
  2907.           Of course, PAL itself will automatically show Thanksgiving for
  2908.           you, but you get the idea.  This month-limiting feature may be
  2909.           useful for special holidays for which PAL does not provide.
  2910.  
  2911.  
  2912.  
  2913.                9.4     Limiting the Number of Times to Repeat
  2914.  
  2915.  
  2916.                An additional useful function which PAL permits in an auto-
  2917.           repeat appointment is to specify the precise number of times that
  2918.           you would like the appointment to repeat.  This is accomplished
  2919.           simply by placing the number sign ("#") immediately following the
  2920.           pattern which you have already constructed, and then following
  2921.           the number sign with an integer between 1 and 255 to signify the
  2922.           limitation.  Placing the number sign in any position other than
  2923.           immediately following your auto-repeat pattern will be ignored by
  2924.           PAL.
  2925.  
  2926.                To help understand this ability to limit the repeats to a
  2927.           specified number, compare the following two entries:
  2928.  
  2929.                   Pan Am Flt #7~m
  2930.                   Pan Am Flt ~m#7
  2931.  
  2932.                The first memo will display as "Pan Am Flt #7" and will
  2933.           appear every single month, without restriction as to the number
  2934.           of times displayed.  The second memo will display as "Pan Am Flt"
  2935.           and will repeat monthly for 7 times beginning with the date for
  2936.           which it was originally entered.
  2937.  
  2938.                If you do not limit the number of repeats with the number
  2939.           sign, then the memo will repeat through to the last day of your
  2940.           report, regardless of the number of days in your report.
  2941.  
  2942.  
  2943.  
  2944.                9.5     Auto-Repeats Not Shown Within SideKick
  2945.  
  2946.  
  2947.                Caution:  One final caution regarding using the auto-repeat
  2948.           ability within SideKick's appointment file.  It is important to
  2949.           understand that what is happening with PAL's auto-repeat function
  2950.           is that PAL is interpreting a single memo within your SideKick
  2951.           file and showing it multiple times within PAL's own report.  That
  2952.           memo will not be reproduced physically within SideKick's own
  2953.           file.  Therefore, when you use SideKick's calendar pad to page
  2954.           through the appointment file, you will NOT see a repeating
  2955.  
  2956.                                           46
  2957.  
  2958.  
  2959.  
  2960.  
  2961.                                 Pal 2.1 Documentation
  2962.  
  2963.           ─────────────────────────────────────────────────────────────────
  2964.  
  2965.           appointment unless you are looking at the actual day on which you
  2966.           entered the appointment.
  2967.  
  2968.                For this reason, if you use auto-repeat appointments within
  2969.           SideKick and want to know whether a particular time slot is
  2970.           available to make a new appointment, you will be best off by
  2971.           using PAL first to report on what's doing for the day.  Once you
  2972.           have determined with PAL that you have the time, you can then
  2973.           invoke SideKick to actually enter the appointment.
  2974.  
  2975.  
  2976.                9.6     Auto-Repeats in Appointment Scratchpad
  2977.  
  2978.  
  2979.                Once you start playing with the character sequences to
  2980.           generate automatically-repeating appointments in a SideKick memo,
  2981.           you may rue the 26 character limitation in each time slot.  The
  2982.           auto-repeat character sequence, depending on the restrictions you
  2983.           impose, may take up much more space than you would like.
  2984.  
  2985.                The logical alternative is to make use of PAL's own internal
  2986.           Appointment Scratchpad, where auto-repeat appointments can be
  2987.           designed without using up any of the 26 character limitation for
  2988.           your memo.  See chapter 7 for complete information about the
  2989.           Appointment Scratchpad.
  2990.  
  2991.  
  2992.  
  2993.  
  2994.  
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.                                           47
  3015.  
  3016.  
  3017.  
  3018.  
  3019.           ═════════════════════════════════════════════════════════════════
  3020.           ═════════════════════════════════════════════════════════════════
  3021.  
  3022.                            CHAPTER 10:  SK DELETE AND PURGE
  3023.  
  3024.           ═════════════════════════════════════════════════════════════════
  3025.           ═════════════════════════════════════════════════════════════════
  3026.  
  3027.  
  3028.  
  3029.                If you are not using SideKick with PAL, you can skip this
  3030.           chapter  in its entirety.
  3031.  
  3032.                PAL has the ability to get rid of entries in your SideKick
  3033.           appointment file which are of no further use to you.  If you
  3034.           would like to see the amount of space that you could save in your
  3035.           SideKick appointment file by employing the DELETE or PURGE proce-
  3036.           dures, then by making the appropriate changes within the CLONE
  3037.           procedure (see section 14.1.4.5 at page 94), you can have PAL
  3038.           advise you of the benefits each time you run a report.
  3039.  
  3040.                To remove old appointments from the Appointment Scratchpad,
  3041.           use the "O"ld function from the Appointment Scratchpad menu.  See
  3042.           section 7.9.  Deleting old appointments from SideKick's file is
  3043.           the subject of the remainder of this chapter.
  3044.  
  3045.  
  3046.  
  3047.                10.1    Out of Date Appointments
  3048.  
  3049.  
  3050.                If you'd like to delete all your old appointments from the
  3051.           SideKick appointment file, then invoke the delete function with
  3052.           "PAL DELETE" or choose "Delete" from the main menu.  This will
  3053.           get rid of all your out of date appointments except for reminders
  3054.           ("!") and auto-repeat appointments.  PAL will specifically ask if
  3055.           you would like to delete old reminders as well, and will do so if
  3056.           you answer "Y"es.  PAL will not automatically delete old auto-
  3057.           repeat appointments whose usefulness has expired.
  3058.  
  3059.                The DELETE procedure has no effect on the Appointment
  3060.           Scratchpad.
  3061.  
  3062.                Caution:  Beware!  When you DELETE old appointments, the
  3063.           SideKick file is changed so that you will not be able to recover
  3064.           the old appointments unless you have previously saved a backup
  3065.           copy of the file.
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.                                           48
  3073.  
  3074.  
  3075.  
  3076.  
  3077.                                 Pal 2.1 Documentation
  3078.  
  3079.           ─────────────────────────────────────────────────────────────────
  3080.  
  3081.                10.2    Deleting Auto-Repeat Appointments
  3082.  
  3083.  
  3084.                The DELETE procedure, as stated above, is designed not to
  3085.           delete old automatically repeating appointments.  This is so even
  3086.           though it is possible that an auto-repeat appointment whose
  3087.           number of repeats has been limited may indeed be out of date (see
  3088.           section 9.4 for an explanation of how you can limit the number of
  3089.           repeats in a SideKick memo).  The reason that we have implemented
  3090.           PAL so as not to delete such appointments is that we recognize
  3091.           that you may have merely estimated the number of times that you
  3092.           want the appointment to repeat.
  3093.  
  3094.                Hint:   If you want to examine your time-limited auto-repeat
  3095.           appointments to make a conscious decision whether to delete any
  3096.           of them, then simply ask PAL to locate them for you so you can
  3097.           examine them.  To locate the time-limited auto-repeat appoint-
  3098.           ments within your SideKick file, search for the special character
  3099.           that signifies the limited number, the "#" character.  The com-
  3100.           mand to search for those appointments, starting from 1/1/85, is
  3101.           "PAL @ $ #".
  3102.  
  3103.  
  3104.  
  3105.                10.3    Putting Out the Garbage
  3106.  
  3107.  
  3108.                The DELETE procedure will also get rid of some useless
  3109.           records in your appointment file which SideKick tends to leave
  3110.           there even after you delete them with SideKick.  When you delete
  3111.           an appointment with SideKick, SideKick does not physically remove
  3112.           the bytes from its file.  Instead, all that SideKick does is
  3113.           place a special code within the file so that the appointment then
  3114.           becomes invisible.
  3115.  
  3116.                If all you want to do is collect and dispose of this garbage
  3117.           but leave your old visible appointments intact, then use the
  3118.           command "PAL PURGE" or choose "Purge" from the main menu.  The
  3119.           PURGE procedure has no effect on the Appointment Scratchpad.
  3120.  
  3121.                The DELETE procedure will automatically invoke the garbage
  3122.           collection procedure that PURGE uses, so you needn't invoke both
  3123.           procedures separately.
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.                                           49
  3131.  
  3132.  
  3133.  
  3134.  
  3135.                                 Pal 2.1 Documentation
  3136.  
  3137.           ─────────────────────────────────────────────────────────────────
  3138.  
  3139.                10.4    Avoiding a Conflict With SideKick
  3140.  
  3141.  
  3142.                If PAL detects that SideKick is not loaded, it will automa-
  3143.           tically change your appointment file and rewrite the new, clean
  3144.           version to disk.  However, PAL will refuse to upgrade your file
  3145.           automatically if it senses that SideKick is resident within your
  3146.           system.  Instead, PAL creates a new file with the name
  3147.           "CLEAN.APP" and instructs you to copy CLEAN.APP over your exist-
  3148.           ing file when SideKick is not loaded in memory or when you know
  3149.           that SideKick is not attached to the file that has just been
  3150.           cleansed.
  3151.  
  3152.                Caution:  If you have multitasking software or task-switch-
  3153.           ing software in your system, PAL may not be able to sense the
  3154.           presence of SideKick.  If you have such software in your system,
  3155.           please read chapter 15 carefully.
  3156.  
  3157.                The reason for this protection is that we have observed that
  3158.           SideKick has at times had problems writing new appointments to
  3159.           its appointment file when that file has been shrunken (by PAL)
  3160.           without its knowledge, with the potential result of scrambling
  3161.           data on your disk!  For this reason, please heed PAL's warnings!
  3162.  
  3163.                For convenience, we supply you with three additional command
  3164.           line alternatives which you may find useful to place in your
  3165.           AUTOEXEC.BAT file prior to the command which loads SideKick.
  3166.           Each of these commands will perform its operations to their
  3167.           conclusion, without pausing to provide instructions or to request
  3168.           input from the user.  If PAL senses that SideKick is loaded when
  3169.           these commands are issued, then the requested operation will not
  3170.           be completed.
  3171.  
  3172.                   PAL DELETEAUTO
  3173.                     Deletes all out-of-date appointments,
  3174.                     except for old reminders.
  3175.                     Also performs "PURGEAUTO".
  3176.  
  3177.                   PAL DELETEAUTOALL
  3178.                     Deletes all out-of-date appointments,
  3179.                     including old reminders.
  3180.                     Also performs "PURGEAUTO".
  3181.  
  3182.                   PAL PURGEAUTO
  3183.                     Deletes only the empty appointments left
  3184.                     behind when you erase an appointment within
  3185.                     SideKick's calendar.
  3186.  
  3187.  
  3188.                                           50
  3189.  
  3190.  
  3191.  
  3192.  
  3193.                                 Pal 2.1 Documentation
  3194.  
  3195.           ─────────────────────────────────────────────────────────────────
  3196.  
  3197.  
  3198.                10.5    How to Safely Update When SK is Loaded
  3199.  
  3200.  
  3201.                We strongly recommend against DELETING or PURGING while
  3202.           SideKick is loaded and encourage you to follow the procedures set
  3203.           forth earlier in this chapter.  If you do follow those proce-
  3204.           dures, then there is no need for you to read the remainder of
  3205.           this section.
  3206.  
  3207.                If, however, you have a particular need to use DELETE or
  3208.           PURGE while SideKick is loaded, then please read this section
  3209.           carefully.  If you have multi-tasking or task-switching software
  3210.           in your system, please read chapter 15 before attempting to
  3211.           employ these procedures.
  3212.  
  3213.                When PAL senses that SideKick is loaded, PAL tells you it is
  3214.           not automatically updating your appointment file but instead is
  3215.           creating the file CLEAN.APP.  There are three methods you can
  3216.           follow to copy CLEAN.APP over your APPOINT.APP:
  3217.  
  3218.                   1.   First, if and only if you have not yet used Side-
  3219.                Kick's appointment entry pad since you booted your computer,
  3220.                then SideKick will not yet be attached to your appointment
  3221.                file.  You may then perform the copy.
  3222.  
  3223.                   2.  Second, you can remove SideKick from memory before
  3224.                issuing the copy command.  Follow the instructions in your
  3225.                SideKick manual to do this.  Go ahead and copy the appoint-
  3226.                ment file.  You may then reinstall SideKick.
  3227.  
  3228.                   3.  Third, you can force SideKick (without removing it
  3229.                from memory) to recognize the new size of your cleansed ap-
  3230.                pointment file with a little bit of fancy footwork:
  3231.  
  3232.                     a)   Pop up SideKick and force it to disattach
  3233.                itself from your original appointment file by doing the
  3234.                following.  Call up the calendar, then enter the
  3235.                appointment entry pad (<AltL>, followed by Return).
  3236.                Hit "F2" to tell SideKick to attach itself to a new
  3237.                file name for the appointment file.  Give it the name
  3238.                of any file other than the original appointment file
  3239.                which PAL has just cleansed.  Press return to make sure
  3240.                that SideKick has accepted your new choice of file.
  3241.                SideKick has now disattached itself from your original
  3242.                appointment file.  Drop out of SideKick and return to
  3243.                the DOS system prompt.
  3244.  
  3245.  
  3246.                                           51
  3247.  
  3248.  
  3249.  
  3250.  
  3251.                                 Pal 2.1 Documentation
  3252.  
  3253.           ─────────────────────────────────────────────────────────────────
  3254.  
  3255.                     b)   Now:  "COPY CLEAN.APP APPOINT.APP".
  3256.  
  3257.                     c)   Pop up SideKick again, and reattach your original
  3258.                appointment file by using the "F2" selection in the ap-
  3259.                pointment entry pad and supplying the name of the original
  3260.                file.  SideKick now will be operating with correct informa-
  3261.                tion regarding the length of your cleansed file.
  3262.  
  3263.  
  3264.  
  3265.                10.6    Multi-Tasking and Task-Switching Systems
  3266.  
  3267.  
  3268.                Persons who use multi-tasking systems (e.g. Desqview, Task-
  3269.           view, Topview) or task-switching systems (e.g. Carousel) must
  3270.           exercise extra-special caution, because PAL will not be able to
  3271.           sense when SideKick is loaded in a partition of memory different
  3272.           from that from which PAL was invoked.
  3273.  
  3274.                In particular, PAL will be able to sense SideKick only if
  3275.           (a) SideKick has been made resident globally prior to installa-
  3276.           tion of the multi-tasking or task-switching software, or (b) if
  3277.           PAL is run within the separate partition in which SideKick has
  3278.           been made resident.
  3279.  
  3280.                When SideKick is made resident within one partition, and you
  3281.           ask PAL to run either the DELETE or PURGE procedures within
  3282.           another partition, PAL will merrily go about its activity obli-
  3283.           vious to SideKick's presence in a hidden partition of your system
  3284.           and will change your file without the built-in precautions de-
  3285.           scribed above.
  3286.  
  3287.                To avoid potential data loss in multi-tasking or task-
  3288.           switching systems, you may exercise any one of the following
  3289.           precautions:
  3290.  
  3291.                   1.   Refrain from using DELETE and PURGE during the
  3292.                normal course of your computer usage.  Instead, insert one
  3293.                of the automatic batch file commands (described in section
  3294.                10.4 above) within your AUTOEXEC.BAT file prior to the com-
  3295.                mand which loads SideKick.
  3296.  
  3297.                   2.   If you must use the DELETE or PURGE procedures while
  3298.                SideKick is loaded in your system, make sure that SideKick
  3299.                is not hidden from PAL in another partition.  You can assure
  3300.                yourself of this by either:
  3301.  
  3302.  
  3303.  
  3304.                                           52
  3305.  
  3306.  
  3307.  
  3308.  
  3309.                                 Pal 2.1 Documentation
  3310.  
  3311.           ─────────────────────────────────────────────────────────────────
  3312.  
  3313.                     (a)  loading SideKick globally before your
  3314.                     multi-tasker or task-switcher, or
  3315.  
  3316.                     (b)  if you load SideKick after your multi-
  3317.                     tasker or task-switcher, then use PAL only
  3318.                     within the partition in which SideKick is
  3319.                     loaded.
  3320.  
  3321.                   3.   You may run PAL DELETE or PAL PURGE with complete
  3322.                safety from a partition which differs from that in which
  3323.                SideKick resides only if the operation is performed prior to
  3324.                your first use of SideKick's calendar since you last booted
  3325.                your computer.
  3326.  
  3327.                   4.   If you mistakenly run the DELETE or PURGE procedure
  3328.                from a partition which differs from SideKick's partition,
  3329.                and if SideKick's calendar has already been invoked, then
  3330.                refrain from permitting SideKick to write any additional ap-
  3331.                pointments to your appointment file until you follow the
  3332.                "fancy footwork" instructions under option 3 described in
  3333.                section 10.5.
  3334.  
  3335.  
  3336.  
  3337.                10.7    Knowing When to Use PURGE or DELETE
  3338.  
  3339.  
  3340.                If you would like to know how many bytes you can save in
  3341.           your appointment file with these garbage collection procedures,
  3342.           then you can enter the CLONE procedure, call up the screen for
  3343.           Miscellaneous Defaults, and ask PAL to show you the effect of the
  3344.           PURGE and DELETE procedures.  The next time you run PAL in REPORT
  3345.           MODE, you will receive information at the head of the report
  3346.           showing the number of bytes you could save if you use either
  3347.           procedure.  See section 14.1.4.5.
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.                                           53
  3363.  
  3364.  
  3365.  
  3366.  
  3367.           ═════════════════════════════════════════════════════════════════
  3368.           ═════════════════════════════════════════════════════════════════
  3369.  
  3370.                       CHAPTER 11:  MULTIPLE SK APPOINTMENT FILES
  3371.  
  3372.           ═════════════════════════════════════════════════════════════════
  3373.           ═════════════════════════════════════════════════════════════════
  3374.  
  3375.  
  3376.                PAL offers the ability to merge two or more SideKick ap-
  3377.           pointment files in order to view them together.  If you are not
  3378.           using SideKick with PAL, you can skip this chapter 11 in its
  3379.           entirety.
  3380.  
  3381.  
  3382.  
  3383.                11.1    SideKick's Deficiency
  3384.  
  3385.  
  3386.                SideKick by itself has no capability for simultaneously
  3387.           viewing the appointments of two or more persons.  In particular,
  3388.           you can merge two files into a single file to be read by Side-
  3389.           Kick, but if both files contain an appointment on the same day at
  3390.           the same time, SideKick will show you only one of the appointm-
  3391.           ents in the time slot.  PAL corrects this deficiency.
  3392.  
  3393.  
  3394.  
  3395.                11.2    PAL's Solution
  3396.  
  3397.  
  3398.                If you keep more than one appointment file and would like to
  3399.           view them together to check on conflicts or common free time,
  3400.           then copy them together (using the "/b" parameter), and view the
  3401.           combined file with PAL.  For instance, if Dick uses DICK.APP and
  3402.           Jane uses JANE.APP, use the following command to combine the
  3403.           files into TOTAL.APP:
  3404.  
  3405.                   COPY DICK.APP + JANE.APP TOTAL.APP /b
  3406.  
  3407.           Then use PAL on the combined file:
  3408.  
  3409.                   PAL 7 TOTAL
  3410.  
  3411.                If you fail to use the "/b" parameter, then the combined
  3412.           file will not have the correct number of bytes, and PAL will
  3413.           refuse to recognize it as a valid appointment file.
  3414.  
  3415.                If any of the files to be combined contains alarm appoint-
  3416.           ments, then you may or may not want PAL to load all of the alarms
  3417.           from all of the files.  By default, PAL will load all alarms
  3418.           which it senses.  One of the command line toggle switches which
  3419.  
  3420.                                           54
  3421.  
  3422.  
  3423.  
  3424.  
  3425.                                 Pal 2.1 Documentation
  3426.  
  3427.           ─────────────────────────────────────────────────────────────────
  3428.  
  3429.           might be appropriate for using here is the "A" parameter, which
  3430.           turns off alarm loading.  To turn off alarm loading when report-
  3431.           ing on the combined file, use the command "PAL 7A TOTAL".
  3432.  
  3433.  
  3434.  
  3435.                11.3    An Example
  3436.  
  3437.  
  3438.                Suppose a single appointments secretary maintains appoint-
  3439.           ments for six lawyers on her own computer using SideKick.  She
  3440.           uses files named "JOHN.APP", "SUSAN.APP", "ROBERT.APP" and so
  3441.           forth, all in the "\SK" directory.  There are no other "*.APP"
  3442.           files in her system.  Here's the contents of a simple batch file
  3443.           which she could write to give her a hard-copy printout of every-
  3444.           one's appointments for the next week:
  3445.  
  3446.                   CD \SK
  3447.                   DELETE ALL.APP
  3448.                   COPY *.APP ALL /B
  3449.                   REN ALL ALL.APP
  3450.                   PAL 7PA ALL
  3451.  
  3452.                This batch file first changes to the directory on which the
  3453.           *.APP files can be found, then deletes the old merged file (if
  3454.           any), then merges everyone's appointment records, then sends a 7
  3455.           day report on the merged file to the printer.  Alarm updating has
  3456.           been suppressed.
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.  
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.                                           55
  3479.  
  3480.  
  3481.  
  3482.  
  3483.           ═════════════════════════════════════════════════════════════════
  3484.           ═════════════════════════════════════════════════════════════════
  3485.  
  3486.                                  CHAPTER 12:  ALARMS
  3487.  
  3488.           ═════════════════════════════════════════════════════════════════
  3489.           ═════════════════════════════════════════════════════════════════
  3490.  
  3491.  
  3492.  
  3493.                PAL will insert alarms into your computer memory for you so
  3494.           that you may have an audible and visual signal at the time you
  3495.           wish to be alerted to an appointment.
  3496.  
  3497.  
  3498.  
  3499.                12.1    Auto-Repeat Alarms
  3500.  
  3501.  
  3502.                By combining the alarm feature with PAL's auto-repeat fea-
  3503.           ture, you may design automatically repeating alarms.  For in-
  3504.           stance, with PAL and PALARM you can set your computer, with just
  3505.           two memos, to awaken you at 7:00 a.m. each weekday and 11:30 a.m.
  3506.           every weekend day for the rest of your life.
  3507.  
  3508.                Since you'll be visually and audibly reminded at the appro-
  3509.           priate times with an auto-repeat alarm, you may consider viewing
  3510.           these alarms in your REPORT MODE reports to be unnecessarily
  3511.           cluttering.  Do you really want to see your 7:00 a.m. wakeup call
  3512.           in your report intermixed with your other appointments?  Probably
  3513.           not.  Therefore, PAL allows you the option of making an auto-re-
  3514.           peat alarm invisible to REPORT MODE.  This is accomplished by
  3515.           inserting the inverted carat character -- ^ -- any place within
  3516.           the memo.  Although this memo will thereafter not appear in any
  3517.           report, you can still search for it in SEARCH MODE, and any
  3518.           alarms which are sent off to PALARM will be visible in the table
  3519.           of alarms accessible in the PAL SET ALARMS menu (see section
  3520.           12.11).
  3521.  
  3522.  
  3523.  
  3524.                12.2    PALARM
  3525.  
  3526.  
  3527.                In order for PAL to insert alarms into your computer memory,
  3528.           you must first load PALARM.  To do so, all you have to do is
  3529.           issue the command "PALARM", and that program will install itself
  3530.           and remain resident.  You must call PALARM prior to  installing
  3531.           SideKick, because SideKick must remain the last-installed program
  3532.           in memory.
  3533.  
  3534.  
  3535.  
  3536.                                           56
  3537.  
  3538.  
  3539.  
  3540.  
  3541.                                 Pal 2.1 Documentation
  3542.  
  3543.           ─────────────────────────────────────────────────────────────────
  3544.  
  3545.                12.3    Two Ways to Set Alarms
  3546.  
  3547.  
  3548.                There are two ways that PAL can communicate an alarm to
  3549.           PALARM:  automatically and manually.
  3550.  
  3551.                First, PAL has the capability of automatically interpreting
  3552.           a special character (the "@") in your SideKick or Appointment
  3553.           Scratchpad memo as signifying that you want the memo treated as
  3554.           an alarm.  See section 12.8.
  3555.  
  3556.                Second, in the PAL SET menu, you may manually add or edit
  3557.           alarms directly without using SideKick or the Appointment
  3558.           Scratchpad.  See section 12.11.
  3559.  
  3560.  
  3561.  
  3562.                12.4    Capacity for 10 Alarms
  3563.  
  3564.  
  3565.                PALARM allows your computer to maintain up to 10 alarms at
  3566.           any time.  When the moment comes for the alarm, PALARM will pop
  3567.           up over your current application and will present you with both a
  3568.           visual and an audible alarm (the visual alarm will not pop up
  3569.           over a graphics application).
  3570.  
  3571.  
  3572.  
  3573.                12.5    How to Kill or Snooze a Sounding Alarm
  3574.  
  3575.  
  3576.                You kill a sounding alarm by hitting the carriage return
  3577.           key.
  3578.  
  3579.                If you fail to kill the alarm within a specified period,
  3580.           then PALARM will automatically silence the alarm, snooze for a
  3581.           period, then pop up again later.  You can intentionally force
  3582.           PALARM to snooze by hitting any key other than the carriage re-
  3583.           turn when it pops up.  If PALARM is snoozing, you will hear a
  3584.           soft ticking sound approximately once per second.
  3585.  
  3586.                As distributed, the alarm will display for 10 seconds and
  3587.           will snooze for 1 minute.  You can change the time for display to
  3588.           between 1 and 60 seconds, and the snooze time to between 1 minute
  3589.           and 24 hours.  This change can be made by entering the Install
  3590.           function from the PAL SET main menu.  See section 14.2.4.
  3591.  
  3592.  
  3593.  
  3594.                                           57
  3595.  
  3596.  
  3597.  
  3598.  
  3599.                                 Pal 2.1 Documentation
  3600.  
  3601.           ─────────────────────────────────────────────────────────────────
  3602.  
  3603.                Hint:   If you want to kill an alarm before it pops up or
  3604.           while it is snoozing, then you must delete it within the PAL SET
  3605.           ALARMS menu.  See section 12.11.
  3606.  
  3607.  
  3608.  
  3609.                12.6    How to Pop Up a Snoozing Alarm
  3610.  
  3611.  
  3612.                New to version 2.1 of PAL is the ability to force a snoozing
  3613.           alarm to pop up once again before the snooze time elapses.
  3614.           You'll know if you have a snoozing alarm if you hear a soft
  3615.           ticking sound coming from your computer.  To make that alarm pop
  3616.           up immediately, just strike the <AltP> key combination.
  3617.  
  3618.                If the currently active application program also ordinarily
  3619.           responds to <AltP> (for instance, Procomm Plus uses that key
  3620.           combination to alter modem line settings), PALARM will take
  3621.           complete control over <AltP> while an alarm is snoozing, so that
  3622.           hitting that combination will always result in popping up the
  3623.           snoozing alarm.  Once PALARM detects that no alarms are snoozing,
  3624.           it relinquishes control over the <AltP> combination.
  3625.  
  3626.  
  3627.  
  3628.                12.7    Controlling the Sound
  3629.  
  3630.  
  3631.                An additional control you have over the alarm is the ability
  3632.           to specify the type of sound you hear when the alarm goes off.
  3633.           You can change the sound to OFF, LOW, NORMAL or HIGH.  The dis-
  3634.           tribution version of PALARM has the sound set to SOFT.  See sec-
  3635.           tion 14.2.3.
  3636.  
  3637.  
  3638.  
  3639.                12.8    How to Write a Memo to Become an Alarm
  3640.  
  3641.  
  3642.                To tell PAL that you want a memo to be loaded automatically
  3643.           as an alarm, simply insert the "@" character anyplace in the
  3644.           memo.  All of the following are valid examples of memos which
  3645.           will be treated as alarms:
  3646.  
  3647.                   Run for the train @30
  3648.                   @@@@@@  WAKE UP  @@@@@@
  3649.                   @  Partners Meeting
  3650.  
  3651.  
  3652.                                           58
  3653.  
  3654.  
  3655.  
  3656.  
  3657.                                 Pal 2.1 Documentation
  3658.  
  3659.           ─────────────────────────────────────────────────────────────────
  3660.  
  3661.                When you ask PAL to run a report of your coming appoint-
  3662.           ments, PAL will translate your memo into an alarm and feed the
  3663.           information to PALARM.  The alarm will then pop up at the time
  3664.           for which you wrote the memo.  The "Title" slot in SideKick and
  3665.           the Appointment Scratchpad will be interpreted as 7:30 a.m.
  3666.  
  3667.  
  3668.  
  3669.                12.9    Advance Alarms
  3670.  
  3671.  
  3672.                If you want advance notice of the appointment, you can force
  3673.           the alarm to pop up prior to the time slot of the appointment by
  3674.           writing the amount of time to advance the alarm immediately fol-
  3675.           lowing the "@" character.  The alarm will then pop up that number
  3676.           of minutes prior to the time slot for which you wrote the memo.
  3677.           For instance, the sequence "@20" means you want the alarm to pop
  3678.           up 20 minutes before the time slot of the appointment.
  3679.  
  3680.                The maximum number you can use is 1440.  This gives you the
  3681.           capability of advancing the alarm anywhere from 1 minute to 24
  3682.           hours.
  3683.  
  3684.                Furthermore, you can amplify the effect of the number to
  3685.           reflect the number of days or the number of hours for which you
  3686.           would like advance notice.  If you follow the number with a "D",
  3687.           then the alarm will be advanced that number of days;  if you
  3688.           follow the number with an "H", then the alarm will be advanced
  3689.           that number of hours; if you follow the number with any other
  3690.           letter or with nothing, then the alarm will be advanced that
  3691.           number of minutes.
  3692.  
  3693.                Hint:   By using advance alarms, you can effectively set
  3694.           appointments for after 8:30 pm (the last regular time entry slot
  3695.           in SideKick and the Appointment Scratchpad) or before 8:00 am
  3696.           (the earliest slot).  Note also that PAL will interpret the Title
  3697.           slot as calling for an alarm at 7:30 am.  For instance, suppose
  3698.           you want an alarm to sound at 11:30 pm:  you could enter an alarm
  3699.           in the next day's Title slot with the code "@8h", in the 11:30 am
  3700.           slot with the code "@12h" or in the 8:00 am slot with the code
  3701.           "@510" -- any of the foregoing combinations (and innumerable
  3702.           other possible combinations) would produce an 11:30 pm alarm.
  3703.  
  3704.  
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.                                           59
  3711.  
  3712.  
  3713.  
  3714.  
  3715.                                 Pal 2.1 Documentation
  3716.  
  3717.           ─────────────────────────────────────────────────────────────────
  3718.  
  3719.                Examples:
  3720.  
  3721.  
  3722.                Call IRS @
  3723.  
  3724.                   -- A simple alarm
  3725.  
  3726.  
  3727.                Wake up @ ~wd
  3728.  
  3729.                   -- Example of a repeating alarm, every weekday
  3730.  
  3731.  
  3732.                Run for the train @ ~wd^
  3733.  
  3734.                   -- Example of a repeating weekday alarm which will not
  3735.                   show up when you run a report, but which will pop up at
  3736.                   the appointed times regularly.
  3737.  
  3738.  
  3739.                Flight to London @240
  3740.  
  3741.                   -- Warns you 4 hours in advance
  3742.  
  3743.  
  3744.                Flight to London @4h
  3745.  
  3746.                   -- Warns you 4 hours in advance
  3747.  
  3748.  
  3749.                Wedding Anniversary @1d
  3750.  
  3751.                   -- Lets the forgetful husband/wife know a full day in
  3752.                   advance
  3753.  
  3754.  
  3755.                Catch Train @ 10
  3756.  
  3757.                   -- Beware!  This will pop up at the precise time of your
  3758.                   memo slot, not 10 minutes in advance!  The space between
  3759.                   the "@" and the number means that PAL will not interpret
  3760.                   the "10" as a command to advance the alarm.
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.                                           60
  3769.  
  3770.  
  3771.  
  3772.  
  3773.                                 Pal 2.1 Documentation
  3774.  
  3775.           ─────────────────────────────────────────────────────────────────
  3776.  
  3777.                12.10   Run PAL to Automatically Update Alarms
  3778.  
  3779.  
  3780.                In order to automatically update your alarms, you must run
  3781.           PAL in REPORT MODE from time to time.  The alarms which you de-
  3782.           sign with SideKick and the Appointment Scratchpad do nothing at
  3783.           all unless PAL reads them, interprets them, and sends them off to
  3784.           PALARM.
  3785.  
  3786.                PAL will examine each alarm for its intended date and time,
  3787.           and if the alarm is to be sounded after the moment at which PAL
  3788.           is examining it, then PAL will try to load it into the ten-slot
  3789.           queue which PALARM holds in memory.  Only the 10 most immediate
  3790.           alarms will be held in the queue.
  3791.  
  3792.                Hint:   Periodically running PAL to ask for a report will
  3793.           make sure that your alarms are updated regularly.  If you run PAL
  3794.           in your AUTOEXEC.BAT file every morning when you boot up, then
  3795.           you're likely to do just fine.  Since PALARM has only a 10 alarm
  3796.           capacity, if you set more than 10 alarms during a day, you'll
  3797.           have to run PAL more frequently than once daily.
  3798.  
  3799.  
  3800.  
  3801.                12.11   Editing Alarms Manually with PAL SET
  3802.  
  3803.  
  3804.                Editing alarms manually is accomplished by entering PAL SET,
  3805.           then entering the "Alarms Menu".
  3806.  
  3807.                You can reach the PAL SET menu by issuing the command "PAL
  3808.           SET" or "PAL S" from the command line, or just invoking "PAL" to
  3809.           get to the main menu and then selecting "SET" from the main menu.
  3810.  
  3811.                The PAL SET menu appears as follows:
  3812.  
  3813.  
  3814.                     1.  Alarms Menu
  3815.                     2.  Clock Toggle
  3816.                     3.  Date Toggle
  3817.                     4.  Help
  3818.                     5.  Install Assumptions
  3819.                     6.  Load Info From Disk
  3820.                     7.  Save Info To Disk
  3821.  
  3822.                    <ESC> to quit to main menu
  3823.  
  3824.  
  3825.  
  3826.                                           61
  3827.  
  3828.  
  3829.  
  3830.  
  3831.                                 Pal 2.1 Documentation
  3832.  
  3833.           ─────────────────────────────────────────────────────────────────
  3834.  
  3835.                From the PAL SET menu, press the "A", "1" or "F1" keys to
  3836.           enter the Alarms Menu.  The Alarms Menu appears in the lower
  3837.           right hand corner of your screen as follows:
  3838.  
  3839.  
  3840.                   1.  Add an Alarm
  3841.                   2.  Clear all Alarms
  3842.                   3.  Delete an Alarm
  3843.                   4.  Edit an Alarm
  3844.                   5.  Purge Old Alarms
  3845.  
  3846.                   <ESC> to return to main menu
  3847.  
  3848.  
  3849.                At the top of the screen when you enter the Alarms Menu is a
  3850.           listing of all the alarms which PALARM currently contains in
  3851.           memory (up to 10):
  3852.  
  3853.  
  3854.            You have the following Alarms set:
  3855.             1. Thu, Mar  3 1990,   4:30pm : Gary Fields @30 ................
  3856.             2. Thu, Mar  3 1990,   6:45pm : Aerobics  @45 ..................
  3857.             3. Mon, Mar  7 1990,   6:45pm : Art Class   @45 ................
  3858.             4. Thu, Mar 10 1990,   6:45pm : Aerobics  @45 ..................
  3859.             5. Mon, Mar 14 1990,   5:45pm : Lynn @45 .......................
  3860.             6. Mon, Mar 14 1990,   6:45pm : Art Class   @45 ................
  3861.             7. Thu, Mar 17 1990,   5:45pm : Rhetta @45 .....................
  3862.             8. Thu, Mar 17 1990,   6:45pm : Aerobics  @45 ..................
  3863.             9.
  3864.            10.
  3865.  
  3866.  
  3867.                You are shown the full memo for each alarm and the time at
  3868.           which it is scheduled to pop up.  The next scheduled alarm will
  3869.           be highlighted to set it off from the rest of the alarms.  If any
  3870.           of the alarms are currently snoozing, that fact will be noted
  3871.           together with the time at which it will pop up again.
  3872.  
  3873.                From the Alarms Menu, you can add alarms, edit them (change
  3874.           the date, time or memo), delete specific alarms, purge old alarms
  3875.           (those which are listed prior to the next scheduled alarm), or
  3876.           clear the entire alarm sequence.
  3877.  
  3878.                When you exit the Alarms menu and get back to the opening
  3879.           PAL SET menu, you should "S"ave your changes to the data file if
  3880.           you want the information remembered the next time you boot up.
  3881.           If you fail to "S"ave the information, then your changes will be
  3882.           remembered only for your current computing session.  If, prior to
  3883.  
  3884.                                           62
  3885.  
  3886.  
  3887.  
  3888.  
  3889.                                 Pal 2.1 Documentation
  3890.  
  3891.           ─────────────────────────────────────────────────────────────────
  3892.  
  3893.           saving the current changes, you would like to restore the infor-
  3894.           mation which was last saved to disk, then use the "L"oad option
  3895.           from the PAL SET main menu.
  3896.  
  3897.                Manual editing of an alarm permits you to determine expli-
  3898.           citly the date and time that a memo will pop up, without having
  3899.           to insert any special codes within the memo.
  3900.  
  3901.                Hint:   It is best to manually edit alarms which are not
  3902.           near the end of the 10-place queue that PALARM holds.  The reason
  3903.           for this caution is that the automatic interpretation by PAL of
  3904.           SideKick and Appointment Scratchpad memos may, under certain
  3905.           circumstances, delete your manually entered alarm.  Here's how
  3906.           that would happen.  Let's say you have manually entered an alarm
  3907.           for one year down the road.  PAL, however, sees from your
  3908.           SideKick or Appointment Scratchpad memos that you want 15 alarms
  3909.           sounding between now and then.  As indicated above, PALARM has
  3910.           space for only 10 alarms.  What PAL will do is insert the 10 most
  3911.           immediate alarms in those spaces.  If it finds that an alarm
  3912.           which has already been scheduled is set to occur later than the
  3913.           10 alarms it wants to insert, then the later alarm will be pushed
  3914.           out of the queue.  If that alarm which has been kicked out was
  3915.           within the SideKick or Appointment Scratchpad memos, then PAL
  3916.           will automatically add it back to the queue when there is room.
  3917.           But if the unfortunate alarm was manually added, then it won't
  3918.           get back in unless you manually add it in once again.
  3919.  
  3920.                Hint:   Whenever you kill a sounding alarm, PALARM will
  3921.           update the alarm data file on your disk, even if you are in the
  3922.           midst of an alarm editing session.  Therefore, if an alarm pops
  3923.           up in the middle of an editing session and you don't want the
  3924.           current changes to overwrite your existing data, then instead of
  3925.           killing the alarm, force it to snooze.  When you are certain that
  3926.           your editing changes are correct, you can then kill the alarm the
  3927.           next time it pops up.
  3928.  
  3929.  
  3930.  
  3931.                12.12   Removing PALARM
  3932.  
  3933.  
  3934.                To remove PALARM from memory, you must be at the DOS system
  3935.           prompt.  Simply invoke "PALOFF" at the DOS system prompt.
  3936.           "PALOFF.EXE" is one of the files supplied, and it should reside
  3937.           in a directory within your DOS path for maximum convenience.
  3938.  
  3939.                If it is safe to unload PALARM from memory, then the program
  3940.           will terminate its operations and release its occupied memory.
  3941.  
  3942.                                           63
  3943.  
  3944.  
  3945.  
  3946.  
  3947.                                 Pal 2.1 Documentation
  3948.  
  3949.           ─────────────────────────────────────────────────────────────────
  3950.  
  3951.                If another program is resident in memory after PALARM and
  3952.           that program uses some of the same interrupt vectors that PALARM
  3953.           uses, then it is not safe to remove PALARM until the other
  3954.           program is first removed from memory.  In the event such a condi-
  3955.           tion exists, PALARM will remain in memory.  You will have to
  3956.           remove the other program first before trying again to unload
  3957.           PALARM.
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.  
  3968.  
  3969.  
  3970.  
  3971.  
  3972.  
  3973.  
  3974.  
  3975.  
  3976.  
  3977.  
  3978.  
  3979.  
  3980.  
  3981.  
  3982.  
  3983.  
  3984.  
  3985.  
  3986.  
  3987.  
  3988.  
  3989.  
  3990.  
  3991.  
  3992.  
  3993.  
  3994.  
  3995.  
  3996.  
  3997.  
  3998.  
  3999.  
  4000.                                           64
  4001.  
  4002.  
  4003.  
  4004.  
  4005.           ═════════════════════════════════════════════════════════════════
  4006.           ═════════════════════════════════════════════════════════════════
  4007.  
  4008.                               CHAPTER 13:  TIMED EVENTS
  4009.  
  4010.           ═════════════════════════════════════════════════════════════════
  4011.           ═════════════════════════════════════════════════════════════════
  4012.  
  4013.                In combination with PALARM's alarms, PAL now provides you
  4014.           with the ability to initiate an "event" on your computer at a
  4015.           pre-appointed time.  With the flexibility of PALARM's alarms, you
  4016.           can set up a series of regularly occurring events.
  4017.  
  4018.                How might this facility be employed?  Here are some examples
  4019.           to stimulate your imagination:
  4020.  
  4021.                *  You want your tape drive to commence an unattended backup
  4022.                   every Wednesday night.
  4023.  
  4024.                *  You want your computer to retrieve your electronic mail
  4025.                   for you every weekday morning so that it awaits you when
  4026.                   you arrive at your office.
  4027.  
  4028.                *  You want your hard disk optimizer program to run its
  4029.                   defragmentizing option every Saturday morning, and you
  4030.                   want it to test disk integrity and lock out bad sectors
  4031.                   in the afternoon of the first Saturday of every month.
  4032.  
  4033.                *  You run a BBS which is a member of a network of BBSes
  4034.                   that exchange mail.  You want your computer to exit out
  4035.                   of your BBS software (but only when none of your users is
  4036.                   in the process of using the BBS) and then run a batch
  4037.                   file or Palrun Alias that exchanges mail with your local
  4038.                   hub (Palrun is another product of PAL Software NY).  You
  4039.                   want to do this three times a day.
  4040.  
  4041.                *  Once a day you want to run a series of programs designed
  4042.                   to tidy up your hard disk.
  4043.  
  4044.                *  Your spreadsheet program contains information derived
  4045.                   from a major online stock exchange database.  You have
  4046.                   already figured out a way to download the information
  4047.                   from the database and incorporate it into your
  4048.                   spreadsheet, but you would like to automate the process.
  4049.                   What you want is for your computer to be able to exit the
  4050.                   spreadsheet once every half hour (but only if nobody in
  4051.                   your office is examining the spreadsheet at that moment),
  4052.                   call up the database, download the information,
  4053.                   incorporate the data into the spreadsheet, and then
  4054.                   return into the spreadsheet to present the data.
  4055.  
  4056.  
  4057.  
  4058.                                           65
  4059.  
  4060.  
  4061.  
  4062.  
  4063.                                 Pal 2.1 Documentation
  4064.  
  4065.           ─────────────────────────────────────────────────────────────────
  4066.  
  4067.                In using the term "event", we refer to the ability for
  4068.           PALARM to feed keystrokes to your computer.  The actual series of
  4069.           keystrokes we refer to as a "Macro".
  4070.  
  4071.                PAL contains a sophisticated "Macro Editor" to allow you to
  4072.           pre-define the series of keystrokes that make up your Macro.  You
  4073.           give each of your Macros a name of not more than 20 characters.
  4074.  
  4075.                A Macro is executed when PALARM pops up with an alarm that
  4076.           has a special identifying character in the first position of the
  4077.           memo and has the name of the Macro following the special
  4078.           character.
  4079.  
  4080.                It wouldn't be much use to you if a Macro which is designed
  4081.           to run a batch file started executing while you were in the
  4082.           middle of your spreadsheet application.  Therefore, PAL and
  4083.           PALARM are engineered to permit you to create two different types
  4084.           of Macros:  "Prompt Macros" and "Application Macros".
  4085.  
  4086.                A "Prompt Macro" is one which you want to run only if the
  4087.           computer is resting at the DOS prompt or the Palrun Prompt.  The
  4088.           "Palrun Prompt" is the command line for Palrun, another product
  4089.           of PAL Software NY.
  4090.  
  4091.                An "Application Macro" is one which you want to run only if
  4092.           the computer is NOT at the DOS prompt or Palrun Prompt.
  4093.  
  4094.                Both types of Macros are created in the Macro Editor in
  4095.           identical fashion.  What separates the two is that the special
  4096.           identifying character (to insert as the first character of your
  4097.           alarm memo) for a Prompt Macro is ">", while the special
  4098.           identifying character for an Application Macro is the "<"
  4099.           character.
  4100.  
  4101.                If an alarm pops up with a Prompt Macro ready to be run, but
  4102.           your computer is not at the Palrun Prompt or Dos prompt, then the
  4103.           alarm will snooze and pop up at a later time.  The snooze time is
  4104.           the same length that you have set in the Clone procedure (See
  4105.           section 14.2.4).
  4106.  
  4107.                Similarly, if the alarm contains an Application Macro, but
  4108.           your cursor is sitting in DOS or at the Palrun Prompt rather than
  4109.           in an application, the alarm will snooze.
  4110.  
  4111.                An Application Macro may be further conditioned upon the
  4112.           presence of a particular word or phrase at a particular screen
  4113.           location, so that you can design a Macro that will execute only
  4114.           when the situation is precisely right for it.
  4115.  
  4116.                                           66
  4117.  
  4118.  
  4119.  
  4120.  
  4121.                                 Pal 2.1 Documentation
  4122.  
  4123.           ─────────────────────────────────────────────────────────────────
  4124.  
  4125.  
  4126.                In order for you to take advantage of this timed event
  4127.           facility, you must know how to do a few things:
  4128.  
  4129.                1.   How to create an alarm.  This is covered in detail in
  4130.           Chapter 12.
  4131.  
  4132.                2.   How to define a Macro.  This is covered below.
  4133.  
  4134.                3.   How to make an alarm initiate a Macro.  This is also
  4135.           covered below.
  4136.  
  4137.  
  4138.                13.1    Creating and Editing Macros
  4139.  
  4140.                Macros are created from the "Set Alarms" menu of PAL.  From
  4141.           the main menu of PAL, hit "S" to enter the "Set Alarms" menu.
  4142.           Please note that in order to enter the "Set Alarms" menu, PALARM
  4143.           must already have been loaded in memory
  4144.  
  4145.                You'll see the "Edit Macros for Alarms" choice.  Select that
  4146.           and you'll be presented with a self-explanatory "Macro Action"
  4147.           menu:
  4148.  
  4149.  
  4150.      ╒═════════════════════════════ Macro Action ══════════════════════════════╕
  4151.      │Edit a Macro            Delete a Macro          Exit                     │
  4152.      ╘═════════════════════════════════════════════════════════════════════════╛
  4153.  
  4154.  
  4155.                You make your selection by moving the highlight bar with the
  4156.           cursor keys and then striking <Enter>.  You can either edit or
  4157.           delete a Macro, or exit back to the "Set Alarms" menu.  Hitting
  4158.           the <Esc> key will also allow you to exit.
  4159.  
  4160.                To create a new Macro, or to edit an old one, select the
  4161.           "Edit a Macro" choice.
  4162.  
  4163.                If you do not yet have any Macros, then PAL will immediately
  4164.           ask you for the name of a Macro to create.
  4165.  
  4166.                If, on the other hand, you have already created Macros, then
  4167.           a window will pop up showing you the names of all the Macros
  4168.  
  4169.  
  4170.  
  4171.  
  4172.  
  4173.  
  4174.                                           67
  4175.  
  4176.  
  4177.  
  4178.  
  4179.                                 Pal 2.1 Documentation
  4180.  
  4181.           ─────────────────────────────────────────────────────────────────
  4182.  
  4183.           which are available for editing.  The first selection in the
  4184.           window will be "Edit a New Macro".  For instance, your pop up
  4185.           window might look something like this:
  4186.  
  4187.  
  4188.      ╒══════════════════════ Choices for Editing Macros ═══════════════════════╕
  4189.      │Edit a New Macro        DOMYWORDPROCESSING      DOWNLOADFILES            │
  4190.      │DOS                     UPLOADFILES                                      │
  4191.      ╘═════════════════════════════════════════════════════════════════════════╛
  4192.  
  4193.  
  4194.  
  4195.                   13.1.1 Creating a New Macro
  4196.  
  4197.  
  4198.                The first thing PAL asks you to do when creating a Macro is
  4199.           to select a name for the Macro.  This must not be more than 20
  4200.           characters long.  It is this name which you will use to tell
  4201.           PALARM which Macro to look for when you set an alarm.
  4202.  
  4203.                If the name you select matches the name of a Macro that you
  4204.           have previously recorded, PAL will warn you that the name you
  4205.           have selected is not unique and will ask you to enter another
  4206.           name.  If you want to edit the Macro which already has that name,
  4207.           then hit the <Esc> key when asked to enter the name so that you
  4208.           can return to the "Choices for Editing Macros" menu to select
  4209.           that Macro for editing.
  4210.  
  4211.                After you specify a Macro name, a window will pop up.  We
  4212.           refer to this window as the "Macro Editor".
  4213.  
  4214.                In the Macro Editor, you will create the actual Macro by
  4215.           typing the keys that you want PALARM to play back at a later time
  4216.           when it calls on the named Macro.  All you have to do is type in
  4217.           the keys that you want to be played back when your alarm later
  4218.           pops up.  As you type, you will see a written representation of
  4219.           each key appear in the editing window.  The maximum number of
  4220.           keys that you can include in any Macro is 50.
  4221.  
  4222.                For accuracy in recording the keys that need to be played
  4223.           back in your Macro, it will be helpful if you keep by your side
  4224.           notes that you have previously made which set forth, keystroke by
  4225.           keystroke, the entire sequence that needs to be replayed by the
  4226.           Macro.
  4227.  
  4228.                When you are finished recording the Macro, press <Enter> for
  4229.           the sequence to be memorized by PAL.  The Macro will be stored in
  4230.           a Macro File on your disk.  On distribution, PAL is designed to
  4231.  
  4232.                                           68
  4233.  
  4234.  
  4235.  
  4236.  
  4237.                                 Pal 2.1 Documentation
  4238.  
  4239.           ─────────────────────────────────────────────────────────────────
  4240.  
  4241.           create Macros in a file with the designation of "C:\MAC.MAC".
  4242.           You can change the name and location of the Macro File from the
  4243.           "Install Assumptions" selection on the "Set Alarms" menu.
  4244.  
  4245.                "Wait," you say.  "What if I need to use the <Enter> key to
  4246.           be played back in the Macro?  How do I get it to be recorded
  4247.           within the Macro without the Macro Editor thinking that I'm
  4248.           finished?"
  4249.  
  4250.                The <Enter> key is one of several keys on your keyboard that
  4251.           may be used either as keystrokes to be played back in your Macro
  4252.           or as commands within the Macro Editor.  When the Macro Editor
  4253.           initially opens, all of these keys are used as commands.  If you
  4254.           want any of these keys to be replayed by your Macro, you can tell
  4255.           PAL to treat them literally instead of as commands.  To toggle
  4256.           between literal treatment or command treatment of any of these
  4257.           keys, you must press the <ScrollLock> key.  Each successive press
  4258.           of <ScrollLock> will change the treatment of these keys back and
  4259.           forth between literal and command mode.  Near the upper right
  4260.           corner of the window, you will see the words "Literal" and
  4261.           "Command" change places each time you press <ScrollLock>.
  4262.  
  4263.  
  4264.  
  4265.                   13.1.2    Macro Editor Commands
  4266.  
  4267.  
  4268.                The following commands are available in the Macro Editor:
  4269.  
  4270.                <Enter>      Stop editing and accept changes
  4271.  
  4272.                <Esc>     Stop editing and discard changes
  4273.  
  4274.                <Left>, <Right>, <Up> and <Down>
  4275.  
  4276.                        These cursor keys may be used to move left and right
  4277.                        one key, or up and down one line.
  4278.  
  4279.                <Ins>     Toggle insert mode.  The edit window opens in
  4280.                          insert mode.  With each successive press of <Ins>,
  4281.                          the words "Insert" and "Overtype" will exchange
  4282.                          places at the upper right corner of the editing
  4283.                          window to let you know the current state.
  4284.  
  4285.                <Del>     Delete key at cursor
  4286.  
  4287.                <Bksp>    Delete previous key
  4288.  
  4289.  
  4290.                                           69
  4291.  
  4292.  
  4293.  
  4294.  
  4295.                                 Pal 2.1 Documentation
  4296.  
  4297.           ─────────────────────────────────────────────────────────────────
  4298.  
  4299.                <CtrlBksp>   Delete all keys in Macro
  4300.  
  4301.                <ScrollLock>   Toggle between command mode and literal mode.
  4302.                               In literal mode, pressing any of the keys
  4303.                               listed above will insert that key into the
  4304.                               Macro, rather than executing the command.
  4305.  
  4306.  
  4307.  
  4308.                   13.1.3    Editing Existing Macros
  4309.  
  4310.  
  4311.                To edit an existing Macro, choose the "Edit a Macro"
  4312.           selection from the first menu.  Then position the highlight bar
  4313.           over the name of the existing Macro and strike <Enter>.
  4314.  
  4315.                The first thing that PAL will do for you is permit you to
  4316.           change the name of the Macro.  If you are satisfied with the name
  4317.           of the Macro, just strike <Enter> once again.
  4318.  
  4319.                At this point, the Macro Editor will pop up.  It will show
  4320.           you the full sequence of keys in your Macro, as currently
  4321.           defined.  You have the full set of Macro editing commands at your
  4322.           disposal to make any changes that you wish.
  4323.  
  4324.                After making changes, hitting <Enter> will tell PAL to
  4325.           accept your changes, while hitting <ESC> will tell PAL to ignore
  4326.           the changes and leave the Macro as you found it.  If you delete
  4327.           all the keys in the Macro definition and then strike <Enter>, the
  4328.           Macro will be deleted, without asking for your confirmation.
  4329.  
  4330.  
  4331.  
  4332.                   13.1.4    Deleting Existing Macros
  4333.  
  4334.  
  4335.                There are two ways to delete existing Macros.
  4336.  
  4337.                First, you can choose the "Delete a Macro" selection from
  4338.           the top menu.  You will be presented with a window setting forth
  4339.           the names of all your currently defined Macros.  Place the
  4340.           highlight bar over the name of the Macro you wish to delete, then
  4341.           strike <Enter>.  PAL will then ask you whether you would like to
  4342.           confirm your intention to delete that Macro.
  4343.  
  4344.                Second, while editing any Macro, if you delete all keys
  4345.           within the definition and then hit <Enter>, PAL will interpret
  4346.  
  4347.  
  4348.                                           70
  4349.  
  4350.  
  4351.  
  4352.  
  4353.                                 Pal 2.1 Documentation
  4354.  
  4355.           ─────────────────────────────────────────────────────────────────
  4356.  
  4357.           that action as an intention to delete the Macro.  In this case,
  4358.           PAL will not request confirmation for the deletion.
  4359.  
  4360.  
  4361.  
  4362.                13.2    Setting a Timed Event
  4363.  
  4364.  
  4365.                A timed event is set by creating a memo, either with
  4366.           SideKick or with PAL's Appointment Scratchpad.  The memo must
  4367.           have as its first character either the ">" or "<" characters.
  4368.  
  4369.                Your selection of which character to use will depend on
  4370.           whether you want the Macro to be invoked while an application
  4371.           program is running or whether you want it to be invoked when you
  4372.           are at the DOS or Palrun Prompts.
  4373.  
  4374.                As you might guess, the ">" character is used to signify
  4375.           that the Macro is to be launched only if PALARM senses that your
  4376.           computer is resting at the DOS or Palrun Prompt.
  4377.  
  4378.                Conversely, the "<" character is used to tell PALARM that
  4379.           the Macro should be invoked only if the computer is NOT at the
  4380.           DOS or Palrun Prompt; i.e., only if you are then within an
  4381.           application program.  You have the ability to set additional
  4382.           conditions with the "<" signifier, so that the Macro will run
  4383.           only if those conditions are met when the alarm pops up.  The
  4384.           ability to set conditions is covered in detail below.
  4385.  
  4386.                Following the ">" or "<" signifier, you must include the
  4387.           name of the Macro that you have created and which you desire to
  4388.           be invoked at the appointed time.
  4389.  
  4390.                The last thing you need to remember to do is to include the
  4391.           "@" character in the memo to let PAL know that this is an alarm.
  4392.  
  4393.                For instance, if you want the Macro "EXITWP" to be invoked
  4394.           while you are in your application program, you might have a memo
  4395.           which reads "<EXITWP @".  This Macro will run only if your system
  4396.           is not at the Palrun or DOS prompt at the appointed time.  If
  4397.           that condition is not satisfied, then the alarm will snooze and
  4398.           pop up intermittently until the computer is not at the prompt.
  4399.  
  4400.                Similarly, if you have a Macro named "ENTERWP" which is
  4401.           designed to enter your application program from the DOS or Palrun
  4402.           Prompt, you could have a memo that reads ">ENTERWP @".
  4403.  
  4404.  
  4405.  
  4406.                                           71
  4407.  
  4408.  
  4409.  
  4410.  
  4411.                                 Pal 2.1 Documentation
  4412.  
  4413.           ─────────────────────────────────────────────────────────────────
  4414.  
  4415.                All the special characters that you can use in a memo can be
  4416.           used.  For instance a memo such as
  4417.  
  4418.                   <EXITWP @5 ^
  4419.  
  4420.           can be used to set the alarm for 5 minutes before the half hour
  4421.           of the memo slot, and the memo will not be visible when you ask
  4422.           PAL for a report.  Please study the PAL documentation for a full
  4423.           appreciation of the meanings of the special characters at your
  4424.           disposal.
  4425.  
  4426.  
  4427.                13.3    Conditional Application Macros
  4428.  
  4429.  
  4430.                Any Application Macro can be set to run only if a particular
  4431.           word or sequence of characters appears on your screen at a
  4432.           specific location.  We provide you with this facility because a
  4433.           certain set of keystrokes executed by a Macro may make perfect
  4434.           sense in one situation, but would wreak havoc in the application
  4435.           in another situation.
  4436.  
  4437.                Usually, the "right" situation can be identified by
  4438.           reference to some word or set of characters which appear on your
  4439.           screen at a particular location.
  4440.  
  4441.                The proper syntax for conditional execution of an
  4442.           Application Macro is:
  4443.  
  4444.                     <x,y,string< NameofMacro @
  4445.  
  4446.                where "X" is the column of the screen location,
  4447.  
  4448.                and "Y" is the row of the screen location,
  4449.  
  4450.                and "string" is the sequence of characters to check for
  4451.                starting at column X on row Y.
  4452.  
  4453.                "NameofMacro" is, as you might guess, the name of the Macro
  4454.                that you have already created.
  4455.  
  4456.                The "@" character is used by PAL and PALARM to signify that
  4457.                the memo must be treated as an alarm.
  4458.  
  4459.                Note that everything that follows "<x,y," and precedes the
  4460.           second "<" is significant in determining the string that must be
  4461.           present in order for the conditions to be satisfied.  This allows
  4462.           you to include spaces as part of your test string.
  4463.  
  4464.                                           72
  4465.  
  4466.  
  4467.  
  4468.  
  4469.                                 Pal 2.1 Documentation
  4470.  
  4471.           ─────────────────────────────────────────────────────────────────
  4472.  
  4473.                For instance, the following three memos will all require
  4474.           different conditions to be satisfied:
  4475.  
  4476.                   <1,2,mystring< myMacro @
  4477.  
  4478.                   <1,2,mystring < myMacro @
  4479.  
  4480.                   <1,2, mystring< myMacro @
  4481.  
  4482.                With the first example, the first 8 places starting at
  4483.           column 1 on row 2 must match "mystring".  In the second example,
  4484.           the first 9 places must match "mystring ".  In the third example,
  4485.           the first 9 places have to match " mystring".
  4486.  
  4487.                Although the positioning of characters and the number of
  4488.           characters in the string is important, it does not matter whether
  4489.           the characters are upper or lower case.  Thus, a string of
  4490.           "MyStRiNg" will match "mystring" and "MYSTRING".
  4491.  
  4492.                If your Application Macro is launched from an alarm that
  4493.           includes these conditions, then if PALARM does not find the
  4494.           string at the specified location when it pops up, it will snooze
  4495.           until a later time.
  4496.  
  4497.  
  4498.  
  4499.                13.4    Finding your X,Y coordinates with PALOCATE
  4500.  
  4501.  
  4502.                Finding the precise "X" (column) and "Y" (row) coordinates
  4503.           can be difficult without a convenient tool.  That's why we supply
  4504.           you with the program PALOCATE.EXE.
  4505.  
  4506.                PALOCATE is a resident program that will pop up at the touch
  4507.           of the appropriate keystrokes.  You need to load it before the
  4508.           application program that you want to gauge.  Once in your
  4509.           application program, press the key combination of <AltSpacebar>.
  4510.           You will then see a large block cursor which you can maneuver to
  4511.           the point at which your "string" begins.  PALOCATE will report to
  4512.           you the X and Y values as you move the cursor.  The values which
  4513.           PALOCATE shows when the block cursor rests at the beginning of
  4514.           your string are the values that you should use in designing the
  4515.           alarm memo for your Conditional Application Macro.
  4516.  
  4517.                Since PALOCATE is used for this purpose and this purpose
  4518.           only, you should not load it regularly in your AUTOEXEC.BAT file.
  4519.           Instead, use it only as needed.
  4520.  
  4521.  
  4522.                                           73
  4523.  
  4524.  
  4525.  
  4526.  
  4527.                                 Pal 2.1 Documentation
  4528.  
  4529.           ─────────────────────────────────────────────────────────────────
  4530.  
  4531.  
  4532.                13.5    Refreshing the Alarm Queue
  4533.  
  4534.  
  4535.                PALARM memorizes a queue of 10 alarms at a time.  Whenever
  4536.           PALARM causes an alarm to pop up, whether it's one that initiates
  4537.           a timed event or whether it's just a reminder for you, one of
  4538.           those alarms in the queue becomes stale.  If you were to go
  4539.           through 10 alarms without refreshing the alarm queue, then PALARM
  4540.           would no longer know whether or not you have any further alarms
  4541.           that you would like to trigger.
  4542.  
  4543.                For this reason, it is important that you periodically
  4544.           refresh the alarm queue.  The alarm queue is refreshed every time
  4545.           you ask PAL to run a report of your future appointments, assuming
  4546.           that PALARM is loaded at the time the report is rendered.  For
  4547.           instance, if you invoke PAL at the end of your AUTOEXEC.BAT file
  4548.           to give you a report of the day's coming events, then PAL will
  4549.           make sure that PALARM disposes of any old, spent alarms and
  4550.           becomes loaded with 10 future alarms.
  4551.  
  4552.                Asking PAL to give you a report in your AUTOEXEC.BAT file
  4553.           will do just fine for you so long as you are confident that fewer
  4554.           than 10 alarms will be spent between successive boots of your
  4555.           computer.  If, however, it is possible that your 10-position
  4556.           alarm queue might become exhausted before the next time your
  4557.           AUTOEXEC.BAT file runs, then you must take other steps to make
  4558.           sure that the queue gets refreshed.
  4559.  
  4560.                One method, of course, is to manually call up PAL to render
  4561.           a report.  But since the name of the game here is automation, the
  4562.           most efficient way to make sure that the queue gets refreshed is
  4563.           to include the PAL report command in one of your regularly used
  4564.           batch files.  If you're using Palrun, the command could be
  4565.           included in a regularly used Alias.
  4566.  
  4567.                For instance, if you are using PAL's timed event capacity to
  4568.           trigger a batch file or Palrun Alias, why not include the report
  4569.           command in there?
  4570.  
  4571.                The normal method of calling up a report with PAL is to use
  4572.           the command "PAL n", where "n" is the number of days you want to
  4573.           view.  If you intend to include this command in a batch file that
  4574.           you expect to be running on an unattended basis, then add the "U"
  4575.           switch, which is designed to force PAL to render its report on an
  4576.           "U"nattended basis.  Thus, your batch file or Palrun Alias might
  4577.           include as one of its commands "PAL 10U", which will examine the
  4578.           next 10 days worth of appointments and send all alarms found in
  4579.  
  4580.                                           74
  4581.  
  4582.  
  4583.  
  4584.  
  4585.                                 Pal 2.1 Documentation
  4586.  
  4587.           ─────────────────────────────────────────────────────────────────
  4588.  
  4589.           that period to the PALARM alarm queue.  What the "U" switch does
  4590.           is make sure that PAL doesn't pause for a keystroke whenever the
  4591.           screen fills up with information.
  4592.  
  4593.  
  4594.  
  4595.                13.6    When the Time for an Alarm Arrives
  4596.  
  4597.  
  4598.                Whenever PALARM receives from PAL a memo that was
  4599.           interpreted to be an alarm (it must contain the "@" character),
  4600.           PALARM places that alarm in its 10-place alarm queue.  It
  4601.           continuously checks the date and time for the moment at which it
  4602.           has been requested to pop up.
  4603.  
  4604.                At the appointed time, a small window pops up in the upper
  4605.           left corner of the screen, flashing the memo and providing an
  4606.           audible alert.
  4607.  
  4608.                If you strike the <Enter> key while the alarm is sounding,
  4609.           then the alarm will be killed.  If you hit any other key, the
  4610.           alarm will cut short its sounding time and will fall into a
  4611.           snooze period so that it can pop up again later.  This behavior
  4612.           is the same whether or not your memo contains a Macro for
  4613.           execution.
  4614.  
  4615.                If you take no action during the time span for which the
  4616.           alarm is set to sound, what PALARM does depends on whether it is
  4617.           issuing a normal alarm or whether the memo contains a Macro to be
  4618.           executed.
  4619.  
  4620.                If the memo is just an ordinary alarm, then if you do
  4621.           nothing during the time the alarm is sounding, the alarm will
  4622.           snooze for a pre-determined period, after which it will pop up
  4623.           once again.  It will continue to sound, snooze, sound, and so
  4624.           forth, until you kill it with the <Enter> key.
  4625.  
  4626.                If the memo contains a Macro to be executed, and the time
  4627.           for sounding the alarm elapses without your touching the
  4628.           keyboard, then PALARM will test for whether the conditions you
  4629.           have set are then present.  If your memo begins with ">", it will
  4630.           test whether the computer is resting at the Palrun Prompt or DOS
  4631.           prompt.  If your memo begins with "<", it will test whether the
  4632.           computer is not at the prompt.  And if your memo starts off with
  4633.           the "<x,y,string<" specification, it will test whether the
  4634.           "string" is present at column x, row y.
  4635.  
  4636.  
  4637.  
  4638.                                           75
  4639.  
  4640.  
  4641.  
  4642.  
  4643.                                 Pal 2.1 Documentation
  4644.  
  4645.           ─────────────────────────────────────────────────────────────────
  4646.  
  4647.                If the Macro conditions are satisfied, then PALARM will try
  4648.           to execute the Macro that you have designated.
  4649.  
  4650.                If the conditions are not satisfied, then PALARM will snooze
  4651.           the alarm and pop up again later.  When it does pop up later it
  4652.           will go through the same test of the conditions that you have
  4653.           set.  If the conditions finally become satisfied, the Macro will
  4654.           finally execute.  If the conditions never become satisfied, then
  4655.           the alarm will continue to sound, snooze, sound, snooze and so
  4656.           forth, until you physically return to your computer and kill it
  4657.           with the <Enter> key.
  4658.  
  4659.                Both the length of time that the alarm will sound and the
  4660.           length of time for snoozing are adjustable from PAL's "Set
  4661.           Alarms" menu by entering the "Install assumptions" portion of the
  4662.           menu.  While the alarm is snoozing, your computer will emit a
  4663.           tell-tale soft ticking sound.  If you arrive at your computer and
  4664.           detect that it is snoozing, and you would like to force the alarm
  4665.           to pop up once again before the snooze time elapses, you can do
  4666.           so by pressing the <AltP> key combination.
  4667.  
  4668.                There is one additional measure of control that you can
  4669.           exert over the time that a Macro alarm will sound before it
  4670.           decides whether to execute or snooze.  If you load PALARM with
  4671.           the single parameter of "F", then PALARM will be initialized to
  4672.           work in "F"ast mode when making its decision on executing Macros.
  4673.           The command when loading PALARM from DOS would be
  4674.  
  4675.                     PALARM F
  4676.  
  4677.           When PALARM is set up in this manner, the alarm will sound for
  4678.           just a fraction of a second before PALARM decides what to do.
  4679.  
  4680.                Fast action affects only Prompt Macros and Conditional
  4681.           Application Macros.  In these two cases, if the conditions are
  4682.           met, the alarm will not waste time sounding, but will go right
  4683.           ahead to execute the Macro.  Similarly, if the conditions are not
  4684.           met, the alarm will pop up for only a fraction of a second
  4685.           (regardless of the time that you've set in the installation
  4686.           procedures for the alarm to sound before it's supposed to snooze)
  4687.           and will then snooze immediately, without giving you a separate
  4688.           warning of why it's going to snooze.  The "F"ast action switch
  4689.           should be used only after you've tested your Macro under normal
  4690.           operating conditions and know that you have it set up properly.
  4691.  
  4692.  
  4693.  
  4694.  
  4695.  
  4696.                                           76
  4697.  
  4698.  
  4699.  
  4700.  
  4701.                                 Pal 2.1 Documentation
  4702.  
  4703.           ─────────────────────────────────────────────────────────────────
  4704.  
  4705.                13.7    Possible Messages From PALARM
  4706.  
  4707.  
  4708.                If PALARM determines that it is not appropriate or not
  4709.           possible to execute a Macro, it will snooze and will give you any
  4710.           one of the following messages:
  4711.  
  4712.  
  4713.                     Not at DOS prompt
  4714.  
  4715.                        -- You have a Prompt Macro but you're not at the DOS
  4716.                        prompt or Palrun Prompt.
  4717.  
  4718.  
  4719.                     At DOS prompt
  4720.  
  4721.                        -- You have an Application Macro but you're not
  4722.                        within an application program.
  4723.  
  4724.  
  4725.                     Screen not ready
  4726.  
  4727.                        -- You have specified a Conditional Application
  4728.                        Macro, but the screen does not contain the specified
  4729.                        string at the specified location.
  4730.  
  4731.  
  4732.                     ERROR in "<x,y,string<"
  4733.  
  4734.                        -- You have an error in the way you wrote your
  4735.                        screen specification for your Conditional
  4736.                        Application Macro.  Re-check the syntax of how you
  4737.                        wrote the conditions in your alarm memo.
  4738.  
  4739.  
  4740.                The following messages may be given once PALARM determines
  4741.           that conditions are ripe to try to execute the Macro:
  4742.  
  4743.  
  4744.                     Macro file missing
  4745.  
  4746.                        -- PALARM could not find your Macro file.  Check the
  4747.                        location that you have specified in the "Install
  4748.                        Assumptions" section of the "Set Alarms" menu.
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.                                           77
  4755.  
  4756.  
  4757.  
  4758.  
  4759.                                 Pal 2.1 Documentation
  4760.  
  4761.           ─────────────────────────────────────────────────────────────────
  4762.  
  4763.                     [NameofMacro] not in file
  4764.  
  4765.                        -- PALARM found your Macro file, but it does not
  4766.                        contain a Macro with the name that you specified in
  4767.                        the alarm.  Cross-check the name you specified in
  4768.                        your memo against the name that you selected when
  4769.                        you created or edited the Macro.
  4770.  
  4771.  
  4772.                     Macro read error
  4773.  
  4774.                        -- PALARM could not read your Macro file.  You may
  4775.                        have a problem with your disk.
  4776.  
  4777.  
  4778.                The following messages are coded, but you are unlikely to
  4779.           receive any of them.  Please let us know if you do get any of the
  4780.           following messages:
  4781.  
  4782.                   Macro is blank
  4783.                   Macro file corrupt
  4784.                   Macro heap error
  4785.                   Macro unknown error
  4786.  
  4787.  
  4788.  
  4789.                13.8    A Practical Illustration
  4790.  
  4791.  
  4792.                It's time to give you a practical illustration of timed
  4793.           events, one that employs just about all of the facilities
  4794.           described above.  This also happens to be a very real
  4795.           illustration, since it describes how we are using 6 timed events
  4796.           every day on the PAL Software BBS.
  4797.  
  4798.                The PAL Software BBS runs a widely used bulletin board
  4799.           package known as PCBoard.  We are also a member of RIME (the
  4800.           Relaynet International Message Exchange) which permits BBS users
  4801.           around the world to exchange messages with one another.  The
  4802.           technique by which mail is exchanged is that the BBS at which the
  4803.           user leaves a message (the user's BBS is known as a "node")
  4804.           collects all of its outgoing mail in a packet and sends it to a
  4805.           local "hub" BBS.  At the same time that the mail is sent to the
  4806.           hub, the node will pick up a load of mail that has been assembled
  4807.           at the hub for delivery back down to the node.  The hub BBS
  4808.           communicates a central hub for the entire network, which serves
  4809.           as a crossroads for all mail in the system.
  4810.  
  4811.  
  4812.                                           78
  4813.  
  4814.  
  4815.  
  4816.  
  4817.                                 Pal 2.1 Documentation
  4818.  
  4819.           ─────────────────────────────────────────────────────────────────
  4820.  
  4821.                PCBoard has the ability to drop out of its BBS activity once
  4822.           a day in order to run a batch file that the system operator
  4823.           ("sysop") has designed.  PCBoard, like PAL, also uses the term
  4824.           "event" to describe this.  Our PCBoard event, among other things,
  4825.           does our mail run to the local hub.
  4826.  
  4827.                Doing just one mail run per day is inefficient in terms of
  4828.           getting mail back and forth quickly.  The turnaround time for a
  4829.           conversation between users on different BBSes could be days.
  4830.           Enter PAL and PALARM to expand beyond PCBoard's limited one-
  4831.           event-per-day capability and permit messaging capabilities much
  4832.           closer to real time.
  4833.  
  4834.  
  4835.  
  4836.                   13.8.1    Creating a Batch File to Do the Mail Run
  4837.  
  4838.  
  4839.                The first thing we do is construct a batch file to be
  4840.           summoned from a Macro.  It does just three things:
  4841.  
  4842.                   PAL 10U
  4843.                   {......
  4844.                   Commands here to do the mail run
  4845.                   .......}
  4846.                   BOARD
  4847.  
  4848.                The first line of the batch file runs PAL to get a report
  4849.           for the next 10 days, making sure that the system's alarms get
  4850.           refreshed.  The "U" switch following the "10" runs PAL in
  4851.           "U"nattended mode so that it will not pause when the screen fills
  4852.           up with information.
  4853.  
  4854.                The next group of commands in the batch file take care of
  4855.           completing all that is necessary in order to send and receive
  4856.           mail.
  4857.  
  4858.                The last command in the batch file returns the computer to
  4859.           the bulletin board.
  4860.  
  4861.                This batch file is saved to a file by the name of
  4862.           "RELAYBRD.BAT".
  4863.  
  4864.  
  4865.  
  4866.  
  4867.  
  4868.  
  4869.  
  4870.                                           79
  4871.  
  4872.  
  4873.  
  4874.  
  4875.                                 Pal 2.1 Documentation
  4876.  
  4877.           ─────────────────────────────────────────────────────────────────
  4878.  
  4879.                   13.8.2    Determining Launch Conditions
  4880.  
  4881.  
  4882.                The next thing we do is to create a Conditional Applications
  4883.           Macro.  We know that the Macro will have to execute while within
  4884.           an application (while PCBoard is running), but we want it to
  4885.           execute only if there is no user currently on line on the BBS at
  4886.           the appointed time.  Therefore, we have to determine whether we
  4887.           can find a "string" that will always appear on the screen at a
  4888.           particular location whenever the board is not in use.
  4889.           Conveniently, PCBoard version 14.2 prominently notes that the
  4890.           board is idle with the string "System Available".
  4891.  
  4892.                To find the exact X,Y coordinates of that string, we load
  4893.           PALOCATE before PCBoard and then call up PCBoard.  When the
  4894.           "System Available" string became visible, we hit the
  4895.           <AltSpacebar> key combination to pop up PALOCATE and move the
  4896.           block cursor until it covers the first letter of the test string.
  4897.           We note the X,Y coordinates to be 17,21 and write them down for
  4898.           later reference.  This information will be needed when designing
  4899.           the memo that becomes an alarm.
  4900.  
  4901.  
  4902.  
  4903.                   13.8.3    Determining Keystrokes for the Macro
  4904.  
  4905.  
  4906.                Now we exit from PALOCATE and figure out, keystroke by
  4907.           keystroke, what keys must be pressed to exit PCBoard back to DOS
  4908.           and run the RELAYBRD.BAT batch file.  Again, we record each of
  4909.           those keystrokes on paper so that we can enter them in the Macro
  4910.           Editor later.  These keystrokes will be played back at a later
  4911.           time when the Macro is executed by PALARM.
  4912.  
  4913.                After hitting the few keystrokes that bring us back to the
  4914.           DOS prompt, we type in "RELAYBRD" and strike <Enter>.   We
  4915.           witness the operation of our batch file just to make sure that it
  4916.           does what it's supposed to do.
  4917.  
  4918.  
  4919.  
  4920.                   13.8.4    Creating the Macro
  4921.  
  4922.  
  4923.                The next thing we need is to create a Macro that can set the
  4924.           ball rolling when the alarm pops up at the right time.  We enter
  4925.           PAL, visiting the "Set Alarms" menu and selecting "Edit Macros
  4926.           for Alarms".  This brings up the "Macro Action" menu, from which
  4927.  
  4928.                                           80
  4929.  
  4930.  
  4931.  
  4932.  
  4933.                                 Pal 2.1 Documentation
  4934.  
  4935.           ─────────────────────────────────────────────────────────────────
  4936.  
  4937.           we choose to edit a Macro.  PAL asks us for a name for the Macro.
  4938.           We feed it the name "EXITBRD".
  4939.  
  4940.                The Macro Editor pops up, and we give it the keystrokes
  4941.           which we wrote down in step #3 above.  To run the batch file
  4942.           created in step #1, the Macro must conclude with
  4943.           "RELAYBRD<Enter>".
  4944.  
  4945.                Recall that in order to have the <Enter> key included as a
  4946.           keystroke in the Macro, you must first change from command mode
  4947.           to literal mode by striking the <ScrollLock> key.  Once the
  4948.           "<Enter>" appears as part of your Macro, you can tap the
  4949.           <ScrollLock> key so that the next touch of <Enter> will be
  4950.           interpreted as the command to register the Macro.
  4951.  
  4952.  
  4953.  
  4954.                   13.8.5    Testing and Debugging the Alarm
  4955.  
  4956.  
  4957.                Before we set up our Macro as an automatically repeating
  4958.           alarm, we want to test it to make sure that it works properly.
  4959.  
  4960.                Based on our exploration with PALOCATE, we know that the
  4961.           conditions we want to look for are "<18,21,System Avail<", and we
  4962.           know that the name of the Macro that we created for execution at
  4963.           upon those conditions is "EXITBRD".  Consequently, our memo to
  4964.           trigger the alarm must be:
  4965.  
  4966.                   <18,21,System Avail< EXITBRD @
  4967.  
  4968.                To test how our Conditional Application Macro works, we have
  4969.           to take the memo that we have designed and allow PALARM to give
  4970.           it a try.  What we want to do is manually to create a test alarm
  4971.           that will sound just a minute or two from the time we set it.
  4972.  
  4973.                We invoke PAL and enter the "Set Alarms" menu.  From there
  4974.           we enter the "A"larms menu and then strike <A> once again to add
  4975.           an alarm.  PAL guesses correctly that we want today's date, so we
  4976.           hit <Enter> to accept the date.  Then it asks for the time in
  4977.           military format.  We set the time for a few minutes from now.
  4978.           Then, we provide PAL with the memo that we have designed:
  4979.           "<18,21,System Avail< EXITBRD @".  PAL asks us whether we are
  4980.           satisfied that everything is correct, and we answer "Y"es.  Our
  4981.           memo instantly appears at the top of the screen in the alarm
  4982.           queue, highlighted to indicate that it is the next alarm to be
  4983.           triggered.
  4984.  
  4985.  
  4986.                                           81
  4987.  
  4988.  
  4989.  
  4990.  
  4991.                                 Pal 2.1 Documentation
  4992.  
  4993.           ─────────────────────────────────────────────────────────────────
  4994.  
  4995.                Now we strike the <ESC> key several times to exit PAL, then
  4996.           issue the command to get back into our bulletin board software.
  4997.           If everything goes well, when the alarm pops up while the board
  4998.           is "available" PALARM will feed the keystrokes necessary to exit
  4999.           the BBS and invoke our batch file.
  5000.  
  5001.                We wait for the BBS software to load itself, but, oops, we
  5002.           didn't give enough time for our test alarm.  There it goes up in
  5003.           the top left corner of our screen.  If we touch nothing, we can
  5004.           see whether it's smart enough to know that now is not the time to
  5005.           invoke our Conditional Applications Macro.  We are rewarded when,
  5006.           at the conclusion of the sounding period, PALARM feeds us the
  5007.           message "Screen not ready" and begins to snooze.
  5008.  
  5009.                When the alarm begins to snooze, we hear the tell-tale faint
  5010.           ticking sound.  PCBoard, now free to complete its loading, cycles
  5011.           to its wait screen and displays the expected phrase "System
  5012.           Available".  Do we have to wait for the full snooze time to see
  5013.           whether everything is working properly?  No.  We hit <AltP> to
  5014.           pop up the alarm immediately.
  5015.  
  5016.                Now for the moment of truth!  As the alarm finishes
  5017.           sounding, we watch as, sure enough, the computer seems to be
  5018.           accepting keystrokes without anybody touching the keyboard.  We
  5019.           are thrilled to see that PCBoard is in the process of exiting to
  5020.           DOS.  We hold our breath as we await the moment that the computer
  5021.           will type in the word "RELAYBRD" and send the batch file on its
  5022.           way to do our mail run.
  5023.  
  5024.                Unfortunately, we can't hold our breath long enough, because
  5025.           the word "RELAYBRD" never appears.  What has happened?  Why, that
  5026.           greedy software from which we just exited ate up all the
  5027.           keystrokes!  By the time the program had exited to DOS, none of
  5028.           the "RELAYBRD<Enter>" keystrokes were still available to be fed
  5029.           to DOS.
  5030.  
  5031.                What is the solution when the application program eats up
  5032.           all remaining keystrokes when you exit from it?  The answer is
  5033.           that you have to have two Macros.  First, you need your
  5034.           Conditional Application Macro to do nothing other than exit from
  5035.           the application.  Next, you need a Prompt Macro, which is
  5036.           designed to do nothing other than invoke a batch file when the
  5037.           computer is at the prompt.
  5038.  
  5039.                So, we go back into the Macro Editor and edit the "EXITBRD"
  5040.           Macro to delete the entire "RELAYBRD<Enter>" sequence.  We save
  5041.           that Macro and then create a new Macro called "GETMAIL" which
  5042.  
  5043.  
  5044.                                           82
  5045.  
  5046.  
  5047.  
  5048.  
  5049.                                 Pal 2.1 Documentation
  5050.  
  5051.           ─────────────────────────────────────────────────────────────────
  5052.  
  5053.           contains all the keystrokes that we just deleted from "EXITBRD".
  5054.  
  5055.                To get back to our testing, we enter go back and manually
  5056.           set two alarms to sound one after the other.  The first alarm
  5057.           contains the memo:
  5058.  
  5059.                   <18,21,System Avail< EXITBRD @
  5060.  
  5061.           The second alarm, which we schedule to occur just a minute after
  5062.           the first one, contains the memo:
  5063.  
  5064.                   >GETMAIL @
  5065.  
  5066.           Notice that the first one is a Conditional Applications Macro and
  5067.           the second one is a Prompt Macro.  The first one will not execute
  5068.           unless the BBS is idle, and the second one will not execute until
  5069.           after the first one has gotten us out of the BBS software back to
  5070.           the prompt.
  5071.  
  5072.                We now exit from PAL and reload PCBoard.  We witness the
  5073.           "System Available" notice appearing in its designated spot on the
  5074.           screen and bide our time while the time for the first alarm
  5075.           approaches.  As we wait, one of our BBS users dials in to the
  5076.           BBS, and the "System Available" notice disappears.  This doesn't
  5077.           bother us, for this will give us an opportunity to see the
  5078.           behavior of the alarms while the BBS is in use.
  5079.  
  5080.                While the user is examining some files on the board, the
  5081.           Conditional Applications Macro pops up.  At the conclusion of the
  5082.           sounding period, the window indicates "Screen Not Ready" and
  5083.           begins to snooze.
  5084.  
  5085.                One important thing that we note is that the sounding period
  5086.           is too long for BBS operation and could interfere with file
  5087.           transmission if it interrupts in the middle of an upload or a
  5088.           download.  So we make a promise to ourselves to change our
  5089.           AUTOEXEC.BAT file to use the command "PALARM F" when loading
  5090.           PALARM so that the alarm will snooze immediately if conditions
  5091.           are not satisfactory.  We won't use the "F" parameter in loading
  5092.           PALARM until we are sure that our alarm is properly debugged,
  5093.           because otherwise the alarm will flash by so quickly that we
  5094.           might not be able to see the messages that PALARM wants to show
  5095.           us.
  5096.  
  5097.                The BBS user continues in his exploration as, a minute
  5098.           later, the Prompt Macro pops up.  It, too, snoozes, as it reports
  5099.           "Not at Dos Prompt".  Another couple of minutes later, our
  5100.  
  5101.  
  5102.                                           83
  5103.  
  5104.  
  5105.  
  5106.  
  5107.                                 Pal 2.1 Documentation
  5108.  
  5109.           ─────────────────────────────────────────────────────────────────
  5110.  
  5111.           Conditional Applications Macro pops up again while the user is
  5112.           still browsing, and the alarm snoozes again.
  5113.  
  5114.                The user now logs off.  PCBoard returns to its idle state,
  5115.           displaying the "System Available" notice.  Our Prompt Macro,
  5116.           which was the next alarm in line, pops up and then snoozes
  5117.           because we are still in an application program.  Next, our
  5118.           Conditional Applications Macro pops up, detects the "System
  5119.           Available" notice in the correct location, and issues the
  5120.           keystrokes to exit PCBoard and return to the prompt.  In a short
  5121.           time, our Prompt Macro pops up and issues the command "RELAYBRD"
  5122.           at the prompt.
  5123.  
  5124.                We watch with great joy as our batch file calls up PAL to
  5125.           update the alarm queue, then does our mail run, then returns to
  5126.           PCBoard, all without human intervention.
  5127.  
  5128.  
  5129.  
  5130.                   13.8.6    The Finishing Touches
  5131.  
  5132.  
  5133.                Now that all the ingredients are perfect, the last thing
  5134.           that we need to do is create automatically repeating alarms with
  5135.           our Macros, so that the events can be triggered on a recurring
  5136.           basis.
  5137.  
  5138.                This is accomplished by creating auto-repeat alarms with
  5139.           PAL.  There are two ways to do this.  You can either enter PAL's
  5140.           Appointment Scratchpad and use its flexible facilities for
  5141.           creating auto-repeat alarms or you can create an auto-repeat
  5142.           alarm in a SideKick memo utilizing the special characters that
  5143.           PAL interprets for recurring alarms.  Details for creating auto-
  5144.           repeat alarms are set forth in section 7.4 and in chapter 9.
  5145.  
  5146.                In our BBS example, we decide that we would like our mail
  5147.           runs to "surround" the times that we know that our hub
  5148.           communicates with the network hub.  By "surround", we mean that
  5149.           we want to do a mail run to our hub immediately before and after
  5150.           its network runs so that we can be sure that we send out our
  5151.           latest mail to the entire network and that we receive the latest
  5152.           mail from the network as soon as it becomes available to us.  We
  5153.           know that our hub communicates with the network hub twice a day,
  5154.           so that means that we need four mail runs to our hub each day.
  5155.           We can use PCBoard's built-in event for one of those runs, so we
  5156.           need to design just three mail runs with PAL and PALARM.  Since
  5157.           each mail run will require a pair of Macros, as we discovered in
  5158.  
  5159.  
  5160.                                           84
  5161.  
  5162.  
  5163.  
  5164.  
  5165.                                 Pal 2.1 Documentation
  5166.  
  5167.           ─────────────────────────────────────────────────────────────────
  5168.  
  5169.           testing and debugging our alarms, this means that we need to set
  5170.           six alarms daily.
  5171.  
  5172.                Assuming that our hub relays with the network at 5:00 am and
  5173.           6:00 pm, we decide to have our PCBoard event run at 6:30 am and
  5174.           for our PAL/PALARM timed events to run at 4:30 am, 5:30 pm and
  5175.           6:30 pm.  Let's take the 5:30 pm event as an example.  The alarms
  5176.           can be set with SideKick or with the PAL Appointment Scratchpad.
  5177.           We'll use the Appointment Scratchpad.  We enter the Scratchpad
  5178.           and ask to add an appointment.  We tell PAL that the appointment
  5179.           is to be run daily and always.  We will enter the memo and then
  5180.           tell PAL that the time slot will be 5:30pm.
  5181.  
  5182.                For the first memo, we will enter
  5183.  
  5184.                   <18,21,System Avail<  @1
  5185.  
  5186.           and the second memo will be
  5187.  
  5188.                   >EXITBRD @
  5189.  
  5190.           The "@1" in the first memo indicates that the alarm to exit out
  5191.           of PCBoard is to be triggered 1 minute in advance of the time
  5192.           slot.
  5193.  
  5194.  
  5195.  
  5196.                   13.8.7    Postscript
  5197.  
  5198.  
  5199.                Your application program may be updated from time to time
  5200.           with new versions.  If you use a Conditional Application Macro
  5201.           with an updated program, you might want to double check the
  5202.           conditions that you set for launching your event still pertain to
  5203.           the updated version.  For instance, the foregoing real life
  5204.           example relating to PCBoard required a change when PCBoard went
  5205.           from version 14.2 to 14.5.  We needed to change the test string,
  5206.           its anticipated position on the screen, and the keystrokes for
  5207.           the macro to execute.
  5208.  
  5209.  
  5210.  
  5211.  
  5212.  
  5213.  
  5214.  
  5215.  
  5216.  
  5217.  
  5218.                                           85
  5219.  
  5220.  
  5221.  
  5222.  
  5223.           ═════════════════════════════════════════════════════════════════
  5224.           ═════════════════════════════════════════════════════════════════
  5225.  
  5226.                              CHAPTER 14:  CUSTOMIZING PAL
  5227.  
  5228.           ═════════════════════════════════════════════════════════════════
  5229.           ═════════════════════════════════════════════════════════════════
  5230.  
  5231.  
  5232.  
  5233.                There are many, many ways you can customize PAL to meet your
  5234.           own needs.  All you need to do is tell PAL how to change its
  5235.           assumptions, then PAL will clone a new version of itself which
  5236.           will remember what you told it.
  5237.  
  5238.                There are two places within the program in which you can
  5239.           specify assumptions:
  5240.  
  5241.                   1.   In the CLONE procedure, you have numerous options to
  5242.                change regarding the operation of PAL.  See section 14.1,
  5243.                immediately below.
  5244.  
  5245.                   2.   To change aspects of the operation of PALARM, you
  5246.                must first enter the SET procedure and then select "Install
  5247.                Assumptions".  See section 14.2 at page 99.
  5248.  
  5249.                To reach the CLONE procedure, simply invoke "PAL CLONE" or
  5250.           "PAL C" from the command line, or select it directly from PAL's
  5251.           opening menu.
  5252.  
  5253.                Similarly, to reach the SET procedure, invoke "PAL SET" or
  5254.           "PAL S" from the command line, or select it from PAL's opening
  5255.           menu.  Then select "Install Assumptions".
  5256.  
  5257.  
  5258.  
  5259.                14.1    The Clone Procedure
  5260.  
  5261.  
  5262.                After reaching the CLONE procedure, you will be presented
  5263.           with a menu of the following choices:
  5264.  
  5265.  
  5266.                       1.  Appointment Scratchpad
  5267.                       2.  File Location Defaults
  5268.                       3.  Holidays
  5269.                       4.  Miscellaneous Defaults
  5270.                       5.  Printer Defaults
  5271.  
  5272.                       6.  Clone
  5273.                       <ESC> to quit without change
  5274.  
  5275.  
  5276.                                           86
  5277.  
  5278.  
  5279.  
  5280.  
  5281.                                 Pal 2.1 Documentation
  5282.  
  5283.           ─────────────────────────────────────────────────────────────────
  5284.  
  5285.                You may select any of the six operations by hitting the
  5286.           alphabetic key corresponding to the function, the numeric key, or
  5287.           the function key (F1 - F6).
  5288.  
  5289.                Each of the first 5 operations permit you to change PAL's
  5290.           internal assumptions.  You may change all, some or none of the
  5291.           assumptions.  You may jump from operation to operation, and PAL
  5292.           will remember all of your changes until you leave the CLONE menu.
  5293.  
  5294.                There are only two ways to leave the CLONE menu:  by choos-
  5295.           ing operation #6 to CLONE the changes you have made, or by
  5296.           hitting ESC to leave the menu without making any changes.
  5297.  
  5298.                Hint:   If for some reason you have made so many changes
  5299.           from the original distribution default assumptions that you want
  5300.           an easy method of returning to PAL's original assumptions, then
  5301.           use the RESTORE procedure, discussed at section 14.1.8.
  5302.  
  5303.                Example:
  5304.  
  5305.                The benefit of being able to CLONE different copies of PAL
  5306.           is illustrated by the following scenario.  Suppose you use PAL
  5307.           sometimes to print out (on paper) a report of your coming ap-
  5308.           pointments for a month, and you need to use special printer
  5309.           control codes to squeeze the characters to the smallest possible
  5310.           size so that you have a nice neat little schedule to slip into
  5311.           your wallet.  At other times you want to use normal size print
  5312.           for a hard copy of the coming week's appointments to place on
  5313.           your desk.  For the first use, you can insert the special printer
  5314.           codes , make the default command line "30P", and, when you go
  5315.           through the CLONE operation specify "MONTHLY" as the name of your
  5316.           new ".EXE" file.  For the second use, use PAL's default printer
  5317.           codes, change the command line to "7P" and name the ".EXE" file
  5318.           "WEEKLY".  At the DOS system prompt, issuing the command "MONTH-
  5319.           LY" will cause your squeezed, monthly report to be issued, while
  5320.           issuing the command "WEEKLY" will give you your hard copy for the
  5321.           next week, at normal print size.
  5322.  
  5323.                A description of each of the operations which can be ini-
  5324.           tiated from the CLONE menu follows.
  5325.  
  5326.  
  5327.  
  5328.  
  5329.  
  5330.  
  5331.  
  5332.  
  5333.  
  5334.                                           87
  5335.  
  5336.  
  5337.  
  5338.  
  5339.                                 Pal 2.1 Documentation
  5340.  
  5341.           ─────────────────────────────────────────────────────────────────
  5342.  
  5343.                   14.1.1    Appointment Scratchpad
  5344.  
  5345.  
  5346.                This choice summons PAL's Appointment Scratchpad, which can
  5347.           be used both as an auxiliary to and/or as a replacement for
  5348.           SideKick's appointment file.  For detailed information about the
  5349.           Appointment Scratchpad, see chapter 7.
  5350.  
  5351.                The changes which you make in the Appointment Scratchpad
  5352.           will take effect only if you choose to CLONE the changes.
  5353.  
  5354.  
  5355.  
  5356.                   14.1.2    File Location Defaults
  5357.  
  5358.  
  5359.                When you summon this choice from within the CLONE menu, you
  5360.           are given the opportunity to change the following assumptions.
  5361.           Remember that the changes which you make here will not take
  5362.           effect unless you CLONE and do not ESCape from the CLONE proce-
  5363.           dure.
  5364.  
  5365.  
  5366.  
  5367.                     14.1.2.1     The Second Directory
  5368.  
  5369.  
  5370.                This is the full path name of the directory in which PAL
  5371.           should look for your SideKick appointment file if it cannot find
  5372.           the file in your DOS path.  As distributed, PAL assumes the
  5373.           Second Directory to be "C:\SK\".
  5374.  
  5375.  
  5376.  
  5377.                     14.1.2.2     The Third Directory
  5378.  
  5379.  
  5380.                This is the full path name of the directory in which PAL
  5381.           should look for your SideKick appointment file if it cannot find
  5382.           the file in your DOS path or in the Second Directory.  As dis-
  5383.           tributed, PAL assumes the Third Directory to be "C:\".
  5384.  
  5385.  
  5386.  
  5387.  
  5388.  
  5389.  
  5390.  
  5391.  
  5392.                                           88
  5393.  
  5394.  
  5395.  
  5396.  
  5397.                                 Pal 2.1 Documentation
  5398.  
  5399.           ─────────────────────────────────────────────────────────────────
  5400.  
  5401.                     14.1.2.3     Appointment Calendar Name
  5402.  
  5403.  
  5404.                This is the filename (first 8 characters only) of the
  5405.           SideKick appointment file.  As distributed, PAL assumes the name
  5406.           to be "APPOINT".
  5407.  
  5408.                If you change this name to "NOFILE", then PAL will automati-
  5409.           cally look only in its own Appointment Scratchpad, unless you
  5410.           supply a specific filename on the command line.
  5411.  
  5412.  
  5413.  
  5414.                     14.1.2.4     Appointment Calendar Type
  5415.  
  5416.  
  5417.                This is the extension for the filename (the 3 characters
  5418.           after the period in the whole file name) of the SideKick appoint-
  5419.           ment file.  As distributed, PAL assumes the type to be "APP".
  5420.           The purpose of this assumption is that PAL will automatically add
  5421.           the extension to a filename specified by you on the command line
  5422.           but for which you do not explicitly state the extension.
  5423.  
  5424.                If your filename is "NOFILE", PAL will not add the exten-
  5425.           sion.  Instead, the NOFILE filename will force PAL to look in the
  5426.           Appointment Scratchpad without looking at any SideKick appoint-
  5427.           ment file.
  5428.  
  5429.                To override the assumption for files that do not have any
  5430.           extension, simply specify the filename on the command line with a
  5431.           period immediately following it.
  5432.  
  5433.                Examples:
  5434.  
  5435.                PAL 7
  5436.                   --  will look for APPOINT.APP in the DOS path, then the
  5437.                   Second Directory, then the Third Directory.
  5438.  
  5439.                PAL 7 JANE
  5440.                   --  will look for JANE.APP in the same sequence of
  5441.                   directories.
  5442.  
  5443.                PAL 7 d:\utility\
  5444.                   --  will look for d:\utility\appoint.app
  5445.  
  5446.                PAL 7 d:\utility\jane
  5447.                   --  will look for d:\utility\jane.app
  5448.  
  5449.  
  5450.                                           89
  5451.  
  5452.  
  5453.  
  5454.  
  5455.                                 Pal 2.1 Documentation
  5456.  
  5457.           ─────────────────────────────────────────────────────────────────
  5458.  
  5459.                PAL 7 noextens.
  5460.                   --  will look for the file NOEXTENS, which does not have
  5461.                   any extension in the last three character places of the
  5462.                   file name.
  5463.  
  5464.  
  5465.  
  5466.                     14.1.2.5     Report File Name
  5467.  
  5468.  
  5469.                This is the name of the file to which PAL writes your report
  5470.           when you specify the "F" optional parameter.  On distribution,
  5471.           PAL assumes the name of the file to be PAL.TXT.  This file will
  5472.           be written in the current subdirectory from which you invoke PAL.
  5473.  
  5474.  
  5475.  
  5476.                   14.1.3    Holidays
  5477.  
  5478.  
  5479.                PAL will automatically show you several common holidays.
  5480.           You may use the CLONE procedure to change the holidays that PAL
  5481.           shows.
  5482.  
  5483.                Once you enter the CLONE procedure, hit "3", "F3" or "H" in
  5484.           order to view your holiday settings.  You will be presented with
  5485.           a list of possible holidays in two columns:  "General Holidays"
  5486.           and "Religious Holidays".  On distribution, PAL is set to show
  5487.           fewer than 50% of those holidays which it is capable of showing.
  5488.  
  5489.  
  5490.  
  5491.  
  5492.  
  5493.  
  5494.  
  5495.  
  5496.  
  5497.  
  5498.  
  5499.  
  5500.  
  5501.  
  5502.  
  5503.  
  5504.  
  5505.  
  5506.  
  5507.  
  5508.                                           90
  5509.  
  5510.  
  5511.  
  5512.  
  5513.                                 Pal 2.1 Documentation
  5514.  
  5515.           ─────────────────────────────────────────────────────────────────
  5516.  
  5517.           The holidays marked below with an asterisk are the ones which PAL
  5518.           will show you if you make no changes to its initial assumptions:
  5519.  
  5520.  
  5521.           *New Year's Day                      *Easter Sunday
  5522.            Martin Luther King Day              *Good Friday
  5523.            Lincoln's Birthday                   Ash Wednesday
  5524.            Valentine's Day                      Shrove Tuesday
  5525.           *President's Day                      Palm Sunday
  5526.            St. Patrick's Day                    Pentecost
  5527.           *Mother's Day
  5528.           *Memorial Day                        *Hanukkah
  5529.            Flag Day                            *Rosh Hashanah
  5530.           *Father's Day                        *Yom Kippur
  5531.           *Independence Day                    *Passover
  5532.           *Labor Day                            Succoth
  5533.           *Columbus Day                         Simchat Torah
  5534.            Election Day                         Tu B'Shevat
  5535.            Veteran's Day                        Sh'mini Atzeret
  5536.           *Thanksgiving Day                     Purim
  5537.           *Day After Thanksgiving               Yom Hashoah
  5538.           *Christmas Day                        Lag B'Omer
  5539.                                                 Shavuot
  5540.                                                 Tisha B'av
  5541.  
  5542.  
  5543.                When you first enter the holiday screen, those holidays
  5544.           which are set will appear highlighted.  You will be asked whether
  5545.           you want to change any of the holidays.   If you answer "Y" for
  5546.           yes, a small arrow will be pointed at "New Year's Day" and you
  5547.           will be prompted for your response for each holiday.  At each
  5548.           position, you may answer "Y" or "N", you may simply hit the
  5549.           carriage return to accept whatever state the holiday is set for,
  5550.           or you may hit "ESC" to end your editing session.
  5551.  
  5552.                The changes which you make in the holiday editing session
  5553.           will take effect only if you choose to CLONE your changes.
  5554.  
  5555.                The holidays you select will show up whenever you run a
  5556.           report in REPORT MODE.  If you prefer not to see the holidays in
  5557.           a report, you may either (a) turn off all of the holidays per-
  5558.           manently in the CLONE procedure, or (b) turn them off temporarily
  5559.           by using the "H" toggle switch (e.g. "PAL 7H").
  5560.  
  5561.  
  5562.  
  5563.  
  5564.  
  5565.  
  5566.                                           91
  5567.  
  5568.  
  5569.  
  5570.  
  5571.                                 Pal 2.1 Documentation
  5572.  
  5573.           ─────────────────────────────────────────────────────────────────
  5574.  
  5575.                   14.1.4    Miscellaneous Defaults
  5576.  
  5577.  
  5578.                The Miscellaneous Defaults operation is selected by hitting
  5579.           "4", "F4" or "M".  You will be presented with a series of
  5580.           choices, with a description of the effect of each choice, and you
  5581.           will be asked whether you want to change any of the assumptions.
  5582.           If you answer "Y" for yes, then you will be able to make the
  5583.           following decisions:
  5584.  
  5585.  
  5586.  
  5587.                     14.1.4.1     Default Command Line
  5588.  
  5589.  
  5590.                This is the command which PAL will execute if you do not
  5591.           specify any additional parameters on the command line.  In the
  5592.           distribution version of PAL, this default command line is "MENU",
  5593.           so that PAL will show you its main menu if all you do at the DOS
  5594.           system prompt is write the command "PAL".
  5595.  
  5596.                You may change the default command line to any command that
  5597.           PAL can understand.  Do not start off the command with the word
  5598.           "PAL" as you would if you were issuing a command from the DOS
  5599.           system prompt.  Instead, provide a command similar to that which
  5600.           you would use in the "Enter Command Line" choice in the main
  5601.           menu.  The beginning "PAL" is assumed.
  5602.  
  5603.                If you have substituted a new default command line with this
  5604.           option, you can always request the main menu from the DOS system
  5605.           prompt with the command "PAL MENU" or "PAL M".
  5606.  
  5607.  
  5608.  
  5609.                     14.1.4.2     Color Display
  5610.  
  5611.  
  5612.                This choice is important only for color monitors.  The
  5613.           distribution version of PAL will display in color on systems with
  5614.           color monitors.  Systems which try to emulate color monitors but
  5615.           in shades of gray will try to display PAL's colors.
  5616.  
  5617.                Some color and composite monitors may display PAL's colors
  5618.           poorly.  A "composite" monitor is one which displays only two
  5619.           colors (e.g., black and white, black and amber, black and green)
  5620.           but which tries to emulate a color graphics adapter rather than a
  5621.           monochrome display; this is common in many laptop computers.  You
  5622.           can use this selection to permanently turn off color so that PAL
  5623.  
  5624.                                           92
  5625.  
  5626.  
  5627.  
  5628.  
  5629.                                 Pal 2.1 Documentation
  5630.  
  5631.           ─────────────────────────────────────────────────────────────────
  5632.  
  5633.           will write to your screen as if it were a simple monochrome
  5634.           monitor.  If your screen display is so poor that you cannot even
  5635.           read the directions within the CLONE procedure, then please read
  5636.           the discussion in the Installation chapter under the heading
  5637.           "Screen Display" at section 3.3.  If you run PAL on a true mono-
  5638.           chrome monitor, your selection for this option is unimportant.
  5639.  
  5640.                Hint:   Whatever you choose for this selection, you can
  5641.           temporarily force PAL in REPORT MODE or in SEARCH MODE to toggle
  5642.           back to the reverse kind of display by using the "C" toggle
  5643.           switch.
  5644.  
  5645.  
  5646.  
  5647.                     14.1.4.3     Reverse Video
  5648.  
  5649.  
  5650.                This choice is significant only for monochrome and black &
  5651.           white monitors (including color monitors for which you have
  5652.           forced PAL to display in simple black and white).
  5653.  
  5654.                The distribution version of PAL will show some messages in
  5655.           reverse video on monochrome monitors and black & white monitors.
  5656.           For instance, your appointments for today through the next
  5657.           business day will show up in reverse video.  However, some
  5658.           monitors may not show reverse video in a satisfactory manner.  If
  5659.           you prefer to use intense (bright) video in lieu of reverse
  5660.           video, then answer "N" to this question.  Otherwise, answer "Y".
  5661.  
  5662.  
  5663.  
  5664.                     14.1.4.4     Single Character Auto-Repeat
  5665.  
  5666.  
  5667.                PAL will interpret certain special characters in your
  5668.           SideKick memos as signals that you want the appointment to be
  5669.           repeated in your report automatically.  The square brackets --
  5670.           '[' and ']' -- and the curly brackets -- '{' and '}' -- will
  5671.           signal annual, monthly, weekly and daily repeating appointments.
  5672.           These frequencies for repeating may also be signified by two-
  5673.           character sequences beginning with the tilde character "~".  See
  5674.           the chapter on auto-repeat appointments for more information,
  5675.           section 9.1.
  5676.  
  5677.                You may prefer to employ the bracket characters for normal
  5678.           usage within your SideKick memos without having them signify
  5679.           auto-repeat appointments.  You would then rely on the tilde
  5680.  
  5681.  
  5682.                                           93
  5683.  
  5684.  
  5685.  
  5686.  
  5687.                                 Pal 2.1 Documentation
  5688.  
  5689.           ─────────────────────────────────────────────────────────────────
  5690.  
  5691.           sequences instead.  To make PAL ignore the bracket characters,
  5692.           answer "N" to this question, otherwise answer "Y".
  5693.  
  5694.                The distribution version of PAL does use the bracket charac-
  5695.           ters to signify auto-repeat.
  5696.  
  5697.                If you do not use SideKick with PAL, then your answer to
  5698.           this choice is unimportant.
  5699.  
  5700.  
  5701.  
  5702.                     14.1.4.5     Effect of PURGE and DELETE
  5703.  
  5704.  
  5705.                If you answer "Y" to this question, then at the top of each
  5706.           Report of your appointments, PAL will let you know how many bytes
  5707.           you could save in your SideKick appointment file if you were to
  5708.           use the PURGE or DELETE procedures.
  5709.  
  5710.                The distribution version of PAL does not show this informa-
  5711.           tion.
  5712.  
  5713.                If you do not use SideKick with PAL, then your answer to
  5714.           this choice is unimportant.
  5715.  
  5716.  
  5717.  
  5718.                     14.1.4.6     Noise
  5719.  
  5720.  
  5721.                The distribution version of PAL will blip at you occasio-
  5722.           nally in certain circumstances.  You can silence PAL by answering
  5723.           "N" to this question.
  5724.  
  5725.  
  5726.  
  5727.                     14.1.4.7     Extended Alarm Report
  5728.  
  5729.  
  5730.                The last thing that PAL tells you in REPORT MODE is whether
  5731.           you have alarms to be loaded into PALARM.  If so, you can have
  5732.           PAL tell you all the alarms which it is loading.  On distribu-
  5733.           tion, PAL does not give you this extended report.  To force PAL
  5734.           to give you this information, answer "Y" to this question.
  5735.  
  5736.  
  5737.  
  5738.  
  5739.  
  5740.                                           94
  5741.  
  5742.  
  5743.  
  5744.  
  5745.                                 Pal 2.1 Documentation
  5746.  
  5747.           ─────────────────────────────────────────────────────────────────
  5748.  
  5749.                   14.1.5    Printer Defaults
  5750.  
  5751.  
  5752.                You can send a report to your printer by using the "P"
  5753.           switch.  For instance, "PAL 7P" will send a 7 day report to your
  5754.           printer.  There are three changes which you can make to PAL's
  5755.           printer defaults.
  5756.  
  5757.  
  5758.  
  5759.                     14.1.5.1     Initialization String
  5760.  
  5761.  
  5762.                PAL allows you to send up to 26 bytes to your printer to
  5763.           initialize it prior to printing a report.  You need to know the
  5764.           hex notation of the printer codes you want to send.  On distribu-
  5765.           tion, PAL's initialization string is merely a series of zeroes,
  5766.           which should not have any effect on your printer.
  5767.  
  5768.  
  5769.  
  5770.                     14.1.5.2     Exit String
  5771.  
  5772.  
  5773.                PAL also allows you to send up to 26 bytes to your printer
  5774.           after the report is concluded.  As with the initialization
  5775.           string, you need to know the hex notation of the printer codes to
  5776.           send.  On distribution, PAL's exit string is just a form feed
  5777.           character (hex code: 0C), followed by a series of zeroes.
  5778.  
  5779.  
  5780.  
  5781.                     14.1.5.3     Lines Per Page
  5782.  
  5783.  
  5784.                This is the number of lines that PAL will print to a page
  5785.           before telling your printer to advance to the next page.  On
  5786.           distribution, PAL will issue the form feed instruction after
  5787.           every 48 lines.  You may change this number to any other number.
  5788.           A simple 0 will force continuous printing without form feeds.
  5789.  
  5790.  
  5791.  
  5792.  
  5793.  
  5794.  
  5795.  
  5796.  
  5797.  
  5798.                                           95
  5799.  
  5800.  
  5801.  
  5802.  
  5803.                                 Pal 2.1 Documentation
  5804.  
  5805.           ─────────────────────────────────────────────────────────────────
  5806.  
  5807.                   14.1.6    Clone
  5808.  
  5809.  
  5810.                Once you have made all the changes that you desire within
  5811.           the CLONE procedure, the only way to make those changes permanent
  5812.           is to strike "6", "F6" or "C" to force the changes to be written
  5813.           to disk.
  5814.  
  5815.                The first screen that you reach is one which reminds you
  5816.           what happens if you proceed.  If you want to avoid writing your
  5817.           changes, then hit the ESC key.  You may proceed to CLONE by
  5818.           hitting any other key.
  5819.  
  5820.                Assuming that you proceed, you will next be asked the name
  5821.           of the file that you want to create.  You may accept the default
  5822.           name by hitting return, or you may select any other name for the
  5823.           file.  The default name will appear as "PAL" or as the last name
  5824.           you chose when you previously CLONED the program.  You can CLONE
  5825.           several copies of PAL, all with different names, each of which
  5826.           can contain different internal assumptions.
  5827.  
  5828.                The next screen informs you that PAL will seek a valid
  5829.           PAL.EXE file in your path and will CLONE a new copy into that
  5830.           directory.  Here again you will be given the opportunity to avoid
  5831.           CLONING by hitting the ESC key.  If you hit any other key, PAL
  5832.           will proceed with the CLONE operation.  If PAL cannot find a
  5833.           valid PAL.EXE file in your path, it will seek your help in
  5834.           locating one.  If you are asked to supply the name of a valid
  5835.           PAL.EXE file, you may provide the name of any renamed or CLONED
  5836.           file which is a descendant of your original PAL.EXE.
  5837.  
  5838.                If PAL finds that a file already exists with the same name
  5839.           that you are trying to create, PAL will give you the choice of
  5840.           overwriting that file, backing it up, changing the name, or
  5841.           hitting the ESC key to abort the process.
  5842.  
  5843.  
  5844.  
  5845.                   14.1.7    <ESC> to quit without change
  5846.  
  5847.  
  5848.                ....means just what it says.  If you hit the ESC key, then
  5849.           all the changes which you have made within the CLONE session will
  5850.           be lost, and the defaults which existed within PAL prior to
  5851.           entering the session will be retained.
  5852.  
  5853.  
  5854.  
  5855.  
  5856.                                           96
  5857.  
  5858.  
  5859.  
  5860.  
  5861.                                 Pal 2.1 Documentation
  5862.  
  5863.           ─────────────────────────────────────────────────────────────────
  5864.  
  5865.                   14.1.8    The RESTORE Procedure
  5866.  
  5867.  
  5868.                For a quick method of restoring PAL's original distribution
  5869.           defaults, use the RESTORE procedure.  Employing this procedure
  5870.           returns all of the selections back to PAL's virgin state.  You
  5871.           may have need of this procedure, for instance, if you have made
  5872.           many changes, have thought better of it, and would like to start
  5873.           from scratch again.
  5874.  
  5875.                The RESTORE procedure restores only the assumptions which
  5876.           were changed with the CLONE procedure, as described in all of the
  5877.           sections which fall within section ? of this manual.  The changes
  5878.           which you may have made with the PAL SET INSTALL procedure
  5879.           described in section 14.2 will not be affected.
  5880.  
  5881.                To invoke the RESTORE procedure, either choose the RESTORE
  5882.           selection from PAL's main menu, or you can call it from the DOS
  5883.           system prompt with "PAL RESTORE" or "PAL R".
  5884.  
  5885.  
  5886.  
  5887.                   14.1.9    Saving and Reading CLONE Images
  5888.  
  5889.  
  5890.                You can use virtually an infinite number of CLONE setups by
  5891.           taking advantage of PAL's ability to save its CLONE settings,
  5892.           including the entire Appointment Scratchpad, to a disk file.  You
  5893.           may then read back any one of those CLONE images to make PAL
  5894.           accept all the assumptions contained in the requested image.
  5895.  
  5896.                This feature may also come in handy for you when future
  5897.           enhancements of PAL come out.  Instead of having to re-enter all
  5898.           your Appointment Scratchpad memos and all your CLONE settings to
  5899.           a new version, each new version of PAL will be able to read your
  5900.           old image file.
  5901.  
  5902.                Saving and reading CLONE images affects only the assumptions
  5903.           which were changed with the CLONE procedure, as described in all
  5904.           of the sections which fall within section ? of this manual.  The
  5905.           changes which you may have made with the PAL SET INSTALL
  5906.           procedure described in section 14.2 will not be saved or af-
  5907.           fected.
  5908.  
  5909.                To save an image, go to PAL's main menu.  Press the "ALT"
  5910.           key, then while still holding the ALT key, press "S" (this key
  5911.           combination is commonly referred to as <AltS>).  You will be
  5912.           asked for the name of the file to which you would like the image
  5913.  
  5914.                                           97
  5915.  
  5916.  
  5917.  
  5918.  
  5919.                                 Pal 2.1 Documentation
  5920.  
  5921.           ─────────────────────────────────────────────────────────────────
  5922.  
  5923.           written.  The default name is "PAL2.1", which will be used unless
  5924.           you specify a different name.  If you accept the default name,
  5925.           the file will be written in the current directory.  If the file
  5926.           already exists, then you will be given the choice to overwrite
  5927.           the file, back it up, change the name you want to use, or else
  5928.           escape the procedure.
  5929.  
  5930.                To read an image, press <AltR> at PAL's main menu.  Since
  5931.           reading a new image into PAL will obliterate the CLONE image
  5932.           which currently exists within PAL, you will be asked to confirm
  5933.           your choice to read an image.  This will give you the opportunity
  5934.           to change your mind so that you can save the existing image
  5935.           first.  If you choose to proceed, you must select the file name
  5936.           of the image.  The default name is "PAL2.1", but you may choose
  5937.           any other existing image file.  Once you select the name, PAL
  5938.           will search for the file along your DOS path and the two alter-
  5939.           nate directories which you previously set with the CLONE proce-
  5940.           dure.  If you specify a complete file name including the direc-
  5941.           tory, then PAL will look only in that directory for that particu-
  5942.           lar file.
  5943.  
  5944.                As an alternative to using <AltS> and <AltR> at the main
  5945.           menu, PAL offers two special command line parameters:  SAVEIMAGE
  5946.           and READIMAGE.  Each of these command line alternatives is
  5947.           designed for quick action by PAL without pausing for confirmation
  5948.           or choices from the user, and therefore should be employed only
  5949.           when you know that the data which will be overwritten either has
  5950.           been previously saved or does not need to be saved.
  5951.  
  5952.                To save an image, use the command:
  5953.  
  5954.                   PAL SAVEIMAGE [FILENAME]
  5955.  
  5956.           where FILENAME is the optional name of the file to which you
  5957.           would like to write.  If you do not designate a FILENAME, then
  5958.           PAL will write to the file PAL2.1 in the current directory.  PAL
  5959.           will not query whether you want to take alternative action if the
  5960.           file already exists, it will just overwrite the file, so be cer-
  5961.           tain before using this command that you are not concerned about
  5962.           losing the data in the existing file.
  5963.  
  5964.                To read an image, use the command:
  5965.  
  5966.                   PAL READIMAGE [FILENAME]
  5967.  
  5968.           where FILENAME is again the optional name of the file which you
  5969.           want to read.  If you do not designate a FILENAME, then PAL will
  5970.           try to find PAL2.1.  PAL will seek the image file in the DOS path
  5971.  
  5972.                                           98
  5973.  
  5974.  
  5975.  
  5976.  
  5977.                                 Pal 2.1 Documentation
  5978.  
  5979.           ─────────────────────────────────────────────────────────────────
  5980.  
  5981.           and the two special directories which you have set with the CLONE
  5982.           procedure.  It will not query you to confirm whether you want to
  5983.           proceed, so satisfy yourself that the existing CLONE information
  5984.           either is not of importance to you or has first been saved.  If
  5985.           PAL cannot find the specified file in the path, then it will
  5986.           return to the DOS system prompt without further action.
  5987.  
  5988.  
  5989.  
  5990.                14.2    The PAL SET INSTALL Procedure
  5991.  
  5992.  
  5993.                This chapter has, so far, described the assumptions that can
  5994.           be changed within PAL concerning its methods of operation and how
  5995.           it presents its reports to you.  We now turn to a description of
  5996.           how you can change various assumptions that PALARM uses with
  5997.           respect to how it deals with your alarms.
  5998.  
  5999.                As with the CLONE procedure, PAL offers you the opportunity
  6000.           to change these assumptions through a series of choices, then
  6001.           writes your desired changes to your PALARM.EXE file for perma-
  6002.           nence.  These changes are reached from the PAL SET menu, at which
  6003.           you arrive by issuing "PAL SET" or "PAL S" from the command line,
  6004.           or hitting "7", "F7" or "S" from PAL's main menu.  Once in the
  6005.           PAL SET menu, choose "Install Assumptions" by hitting "5", "F5"
  6006.           or "I".
  6007.  
  6008.                When you request the INSTALL procedure, you are presented
  6009.           with a screen that shows the current assumptions with which
  6010.           PALARM is presently working, and you are asked whether you want
  6011.           to change any of them.  If you do, then respond with a "Y"; if
  6012.           not, then hit the "N" key and you will be returned to the PAL SET
  6013.           menu.
  6014.  
  6015.                When you respond with a "Y", you will be presented with a
  6016.           series of four screens offering you the opportunity to change
  6017.           assumptions.  Each screen shows a few of the assumptions which
  6018.           can be changed, describing what effect they have and what PALARM
  6019.           presently assumes.  The screens are as follows:
  6020.  
  6021.  
  6022.  
  6023.                   14.2.1    Data File
  6024.  
  6025.  
  6026.                This is the name of the file which contains a record of your
  6027.           alarms.  When PALARM is first loaded into memory, it will look
  6028.           for this file.  When PALARM pops up an alarm and you kill it by
  6029.  
  6030.                                           99
  6031.  
  6032.  
  6033.  
  6034.  
  6035.                                 Pal 2.1 Documentation
  6036.  
  6037.           ─────────────────────────────────────────────────────────────────
  6038.  
  6039.           hitting the carriage return key, then PALARM will update this
  6040.           file.  This is so that PALARM will know the next time it's loaded
  6041.           that the alarm has already been popped up.  If, when PALARM
  6042.           loads, it senses an old alarm in the data file which has not yet
  6043.           been popped up, then PALARM will pop up with that alarm imme-
  6044.           diately.  This will assure you that if you missed an alarm
  6045.           because your computer was shut off at the appropriate time then
  6046.           you will not ignore the alarm in silent bliss.
  6047.  
  6048.                On distribution, the name of the data file is assumed to be
  6049.           "C:\PALARM.DAT."  You may change this to any legal file name.
  6050.  
  6051.  
  6052.  
  6053.                   14.2.2    Macro File
  6054.  
  6055.  
  6056.                This is the name of the file which contains the macros that
  6057.           you create for timed events.
  6058.  
  6059.                On distribution, the name of the data file is assumed to be
  6060.           "C:\PAL.MAC."  You may change this to any legal file name.
  6061.  
  6062.  
  6063.  
  6064.                   14.2.3    Sound Level
  6065.  
  6066.  
  6067.                When an alarm pops up, you will be presented with a visual
  6068.           and an audible alarm (though the visual alarm will not pop up
  6069.           over a graphics screen).  You may select any of four sound levels
  6070.           for the alarm:
  6071.  
  6072.                   a)   Off  --  self-explanatory.
  6073.  
  6074.                   b)   Soft  --  the distribution default, sounds a bit
  6075.                   like the squishy sound of walking in soggy shoes.
  6076.  
  6077.                   c)   Normal  --  a more insistent beeping that sounds
  6078.                   like your nephew's toy ray-gun.
  6079.  
  6080.                   d)   Loud --  a high-pitched siren.
  6081.  
  6082.  
  6083.  
  6084.  
  6085.  
  6086.  
  6087.  
  6088.                                          100
  6089.  
  6090.  
  6091.  
  6092.  
  6093.                                 Pal 2.1 Documentation
  6094.  
  6095.           ─────────────────────────────────────────────────────────────────
  6096.  
  6097.                   14.2.4    Snooze Feature
  6098.  
  6099.  
  6100.                Once the alarm pops up, you may cancel it by hitting the
  6101.           return key.  If within a limited period of time you fail to hit
  6102.           the return key, or if you hit any key other than the carriage
  6103.           return, then the alarm will silence itself and permit your system
  6104.           to continue running while it snoozes.  You will be reminded that
  6105.           an alarm is snoozing because your system will be emitting a soft
  6106.           ticking sound in the meantime.  The alarm will pop up once more
  6107.           after a specified period of time.
  6108.  
  6109.                The two changes you can make here are:
  6110.  
  6111.                   (a)  The number of seconds for the alarm to sound:
  6112.                   between 1 and 60 seconds.
  6113.  
  6114.                   (b)  The number of minutes for the alarm to snooze:
  6115.                   between 1 and 1440 minutes (a full 24 hours).
  6116.  
  6117.                The purpose of the snooze mode is fairly obvious.  Imagine
  6118.           the following scenario with an alarm system that captures your
  6119.           system and refuses to let go until you consciously choose to
  6120.           silence the alarm.  Suppose you start a sort of your customer
  6121.           records with SlowBase VI, knowing that it ought to take an hour.
  6122.           So you go out for lunch, expecting the sort to be completed by
  6123.           the time you come back.  Lo and behold, when you return you find
  6124.           that the alarm is screeching at you for some event that you had
  6125.           forgotten about.  When you kill the alarm, SlowBase VI resumes
  6126.           its sort at the 45th of 5,784 records!  An alarm without a snooze
  6127.           feature is fairly useless, isn't it?
  6128.  
  6129.                Hint:   If, while an alarm is snoozing, you would like to
  6130.           cancel the alarm without waiting for the snooze period to finish,
  6131.           you can delete the alarm by entering the PAL SET procedure.  From
  6132.           the PAL SET menu, select "A"larms, then "D"elete the alarm that
  6133.           shows as snoozing.
  6134.  
  6135.  
  6136.  
  6137.                   14.2.5    Clock and Date
  6138.  
  6139.  
  6140.                This section describes the parameters you can change that
  6141.           involve the clock and date that PALARM can show at the top right
  6142.           corner of your screen.
  6143.  
  6144.  
  6145.  
  6146.                                          101
  6147.  
  6148.  
  6149.  
  6150.  
  6151.                                 Pal 2.1 Documentation
  6152.  
  6153.           ─────────────────────────────────────────────────────────────────
  6154.  
  6155.                     14.2.5.1     Clock Visibility on Start-Up
  6156.  
  6157.  
  6158.                As distributed, PALARM will automatically show you the time
  6159.           in the upper-right corner of your monitor.  With this choice, you
  6160.           may force PALARM not to show the clock when it loads.
  6161.  
  6162.                To turn the clock on or off quickly and temporarily, you may
  6163.           use the "Clock Toggle" selection at the PAL SET menu.
  6164.  
  6165.  
  6166.  
  6167.                     14.2.5.2     Date Visibility on Start-Up
  6168.  
  6169.  
  6170.                As distributed, PALARM will automatically show you the date
  6171.           in the upper-right corner of your monitor.  With this choice, you
  6172.           may force PALARM not to show the date when it loads.
  6173.  
  6174.                To turn the date on or off quickly and temporarily, you may
  6175.           use the "Date Toggle" selection at the PAL SET menu.
  6176.  
  6177.  
  6178.  
  6179.                     14.2.5.3     Colors for Clock and Date
  6180.  
  6181.  
  6182.                If you are not pleased with the color combination for the
  6183.           clock and date display, you may change the colors with this
  6184.           choice.  You will be presented with a table of numbers displayed
  6185.           in varying combinations of background and foreground colors.
  6186.           Simply choose the number which corresponds to the color combina-
  6187.           tion of your choice.
  6188.  
  6189.  
  6190.  
  6191.                   14.2.6    Cloning Your PALARM Changes
  6192.  
  6193.  
  6194.                Once you have made your desired changes within the PAL SET
  6195.           INSTALL procedure, you may clone these changes permanently.  Just
  6196.           follow the instructions presented on the screen.  If you choose
  6197.           to clone, then all changes will take effect immediately.
  6198.  
  6199.  
  6200.  
  6201.  
  6202.  
  6203.  
  6204.                                          102
  6205.  
  6206.  
  6207.  
  6208.  
  6209.           ═════════════════════════════════════════════════════════════════
  6210.           ═════════════════════════════════════════════════════════════════
  6211.  
  6212.                    CHAPTER 15:  TSR WARS, RAM CRAM AND MULTITASKING
  6213.  
  6214.           ═════════════════════════════════════════════════════════════════
  6215.           ═════════════════════════════════════════════════════════════════
  6216.  
  6217.                This chapter discusses some of the problems you might face
  6218.           if you use PALARM for its alarm capability.  If you do not use
  6219.           PALARM, then you don't need to read the remainder of this
  6220.           chapter.
  6221.  
  6222.  
  6223.  
  6224.                15.1    TSR Wars
  6225.  
  6226.  
  6227.                Resident programs are often referred to as TSR's, named
  6228.           after the DOS programmer's function that permits a program to
  6229.           Terminate but Stay Resident.  As more and more resident programs
  6230.           vie for memory, processor time and control, it is inevitable that
  6231.           skirmishes may result, sometimes resulting in total system lockup
  6232.           which can only be remedied by turning the system off and then
  6233.           back on again.
  6234.  
  6235.                PALARM has been tested in many system configurations and has
  6236.           been found to coexist peacefully in the vast majority of situa-
  6237.           tions.  If, for any reason, you find that the introduction of
  6238.           PALARM as a resident program in your system causes computer lock-
  6239.           ups or any other problems, then try the following:
  6240.  
  6241.                1.   In most cases, you will find that loading PALARM early
  6242.           on in the sequence should solve your problem.
  6243.  
  6244.                2.   You should also make sure that SideKick is your last-
  6245.           loaded resident program.
  6246.  
  6247.                Caution:  Running "CHKDSK" with the "/F" parameter is a
  6248.           potential problem under certain limited circumstances.  This is
  6249.           the case with ANY program that alters your disk's FAT table.
  6250.           Although this is not the result of a war between two resident
  6251.           programs, it is a concern which can arise because two things are
  6252.           happening in your computer at the same time without the two
  6253.           processes being aware of each other.  If you kill an alarm while
  6254.           CHKDSK is running, PALARM updates its data file, and it is pos-
  6255.           sible that CHKDSK may be fooled into thinking that you have a
  6256.           disk error when in fact there is none.  Answering "YES" to
  6257.           CHKDSK's query whether it should fix the "problem" could result
  6258.           in scrambling PALARM's data file and other unknown results.  For
  6259.           this reason, you should do either of the following when running
  6260.           "CHKDSK /F":  (1)  Snooze the alarm instead of killing it if the
  6261.  
  6262.                                          103
  6263.  
  6264.  
  6265.  
  6266.  
  6267.                                 Pal 2.1 Documentation
  6268.  
  6269.           ─────────────────────────────────────────────────────────────────
  6270.  
  6271.           alarm pops up before CHKDSK makes its report, or (2) Answer "NO"
  6272.           to CHKDSK's fix-up query if the alarm has popped up before CHKDSK
  6273.           has finished its processing and CHKDSK then reports an error on
  6274.           your disk.
  6275.  
  6276.  
  6277.  
  6278.                15.2    Ram Cram and Multitasking
  6279.  
  6280.  
  6281.                Another problem which is presented by the proliferation of
  6282.           resident programs is "ram cram," a malady that results when you
  6283.           have so many programs residing permanently in your computer's
  6284.           memory that you don't have sufficient memory left to run your
  6285.           normal applications programs.  A few years ago, CP/M based
  6286.           computers with a 64K limit were the cutting edge of technology,
  6287.           and when IBM came forward with a 640K capacity, many people
  6288.           wondered why anybody could possibly want so much memory.  Now,
  6289.           the 640K "horizon" is more frequently viewed as a "barrier" to
  6290.           efficient computing.  PALARM only uses about 30K of your RAM, but
  6291.           that little bit may, to some people, be too precious to part
  6292.           with.
  6293.  
  6294.                In order to go beyond the 640K barrier, you'll need to get
  6295.           operating software that supports breaking down that wall.  Future
  6296.           versions of OS/2 promise to permit this, and some presently
  6297.           available software, such as Desqview operating on 80386 machines,
  6298.           offer this possibility now.
  6299.  
  6300.  
  6301.  
  6302.                15.3    Hints on PALARM with Multitasking
  6303.  
  6304.  
  6305.                PALARM and PAL have seen limited testing in multitasking
  6306.           systems.  If you have any problems using PAL and PALARM in a
  6307.           multitasking system, please let us know so that we can make it
  6308.           work for you.
  6309.  
  6310.                If you use a multitasking program, PALARM will work best if
  6311.           it is loaded prior to the multitasker.  This will ensure that
  6312.           PALARM will always be watching the system clock and that PAL and
  6313.           PALARM can communicate with each other.
  6314.  
  6315.                If, for reasons of limited memory, you must load PALARM in a
  6316.           window of the multitasker, then you have a solution to the ram
  6317.           cram problem, but the operation of PALARM will be somewhat
  6318.  
  6319.  
  6320.                                          104
  6321.  
  6322.  
  6323.  
  6324.  
  6325.                                 Pal 2.1 Documentation
  6326.  
  6327.           ─────────────────────────────────────────────────────────────────
  6328.  
  6329.           inefficient.  Following are considerations which you should be
  6330.           aware of if you load PALARM within a window of your multitasker:
  6331.  
  6332.                   1.   The PALARM window should be configured to run in the
  6333.                background.  Otherwise, PALARM won't be able to watch your
  6334.                system clock to determine when to pop up an alarm.
  6335.  
  6336.                   2.   When an alarm pops up over your current application,
  6337.                you will not be able to communicate with PALARM to snooze or
  6338.                kill the alarm unless you switch to the PALARM window first.
  6339.  
  6340.                   3.   Once you snooze or kill the alarm within the PALARM
  6341.                window, PALARM will attempt to restore your screen to its
  6342.                state at the moment before the alarm popped up.  The trouble
  6343.                here is that the visual alarm originally popped up over an
  6344.                application in an entirely different window.  Consequently,
  6345.                the PALARM window will wind up with screen information from
  6346.                your Lotus spreadsheet (or whatever you were in), and the
  6347.                Lotus spreadsheet will still have the visual alarm blinking
  6348.                in it when you return to the Lotus window.  Although this
  6349.                may be disconcerting when you see it, no harm is done.  What
  6350.                has been scrambled is only your screen information, not your
  6351.                data.  Each window's screen will be corrected the next time
  6352.                you take an action in that window which causes the screen to
  6353.                be refreshed.
  6354.  
  6355.                   4.   You will have to decide whether you want PALARM by
  6356.                itself in a small window, or whether you want PAL and PALARM
  6357.                together running in a larger window.  There are advantages
  6358.                and disadvantages to both choices.  The advantage of the
  6359.                small PALARM window is that multitasking RAM is being used
  6360.                more efficiently.  The disadvantage is that PAL will not be
  6361.                able to communicate with PALARM unless it is within the same
  6362.                window.  The advantages and disadvantages of the large
  6363.                PAL/PALARM window are, of course, the converse of the small
  6364.                PALARM window.
  6365.  
  6366.                   5.   If you choose the small PALARM window, you will
  6367.                still be able to communicate new alarms to PALARM by observ-
  6368.                ing the following procedure.  To update alarms either auto-
  6369.                matically or manually, you'll have to completely kill the
  6370.                small PALARM window, temporarily open a large PAL/PALARM
  6371.                window to communicate the alarms and create an updated data
  6372.                file (PALARM.DAT), kill the large PAL/PALARM window, then
  6373.                open a brand new PALARM window which will read the updated
  6374.                PALARM.DAT.  This procedure is clunky, but if you must save
  6375.                RAM by loading PALARM in a small window, you will find that
  6376.                it does work.
  6377.  
  6378.                                          105
  6379.  
  6380.  
  6381.  
  6382.  
  6383.                                 Pal 2.1 Documentation
  6384.  
  6385.           ─────────────────────────────────────────────────────────────────
  6386.  
  6387.                   6.   Lastly, you will have to design a batch file to be
  6388.                executed in each window.  An appropriate batch file for the
  6389.                small PALARM window would be:
  6390.  
  6391.                        PALARM
  6392.                        PAUSE
  6393.  
  6394.                The "PAUSE" is required to prevent your window from closing
  6395.                immediately.  You would add the same command for any window
  6396.                in which you want to load a program that terminates and
  6397.                stays resident.  An appropriate batch file for the large
  6398.                PAL/PALARM window would be:
  6399.  
  6400.                        PALARM
  6401.                        PAL
  6402.  
  6403.                This window will close whenever you exit PAL.
  6404.  
  6405.  
  6406.  
  6407.                15.4    PALARM and Task-switching Programs
  6408.  
  6409.  
  6410.                Task-switching programs such as Carousel are designed to
  6411.           shift programs rapidly in and out of memory.  The application
  6412.           which is shifted out of memory does not run in the background.
  6413.           For this reason, it is inappropriate to load PALARM in a window
  6414.           of a task-switching program.  Instead, PALARM should be loaded
  6415.           globally before the task-switching program.
  6416.  
  6417.  
  6418.  
  6419.  
  6420.  
  6421.  
  6422.  
  6423.  
  6424.  
  6425.  
  6426.  
  6427.  
  6428.  
  6429.  
  6430.  
  6431.  
  6432.  
  6433.  
  6434.  
  6435.  
  6436.                                          106
  6437.  
  6438.  
  6439.  
  6440.  
  6441.           ═════════════════════════════════════════════════════════════════
  6442.           ═════════════════════════════════════════════════════════════════
  6443.  
  6444.                               CHAPTER 16:  REGISTRATION
  6445.  
  6446.           ═════════════════════════════════════════════════════════════════
  6447.           ═════════════════════════════════════════════════════════════════
  6448.  
  6449.                If you use and like this product, please register.
  6450.  
  6451.                To register, send your check in the amount of $25, payable
  6452.           to PAL Software NY to the following address:
  6453.  
  6454.                   PAL Software NY
  6455.                   51 Cedar Lane
  6456.                   Ossining, NY  10562
  6457.  
  6458.                For your convenience, we have included the file ORDER.FRM,
  6459.           which you can print out and use for this purpose.
  6460.  
  6461.                If you register Pal, you will be entitled to the following:
  6462.  
  6463.                1.   You will be provided with an exclusive password which
  6464.           will tell Pal not to continually remind you that you need to
  6465.           register.
  6466.  
  6467.                2.   You will be provided with free support by mail for one
  6468.           (1) year following the date of registration.  The level of
  6469.           support which we agree to provide is to answer questions and fix
  6470.           serious bugs.  We are not required to modify the program for
  6471.           specific hardware or software environments or features.
  6472.  
  6473.                3.   You may access the PAL Software BBS at any time.  The
  6474.           telephone number is (914) 762-8055.  The BBS runs 24 hours a day
  6475.           and accepts calls at 300-9600 baud (US Robotics HST Dual modem).
  6476.           In addition, you can communicate with us on Compuserve; the PPN
  6477.           is 70475,1071.  For additional avenues of support, see Chapter 18
  6478.           below at page 110.
  6479.  
  6480.                4.   You will be added to our mailing list.
  6481.  
  6482.  
  6483.                If you are a Sysop of a BBS, kindly read SYSOP.DOC, a file
  6484.           included with the Pal distribution files, for a special
  6485.           registration offer.
  6486.  
  6487.  
  6488.  
  6489.  
  6490.  
  6491.  
  6492.  
  6493.  
  6494.                                          107
  6495.  
  6496.  
  6497.  
  6498.  
  6499.           ═════════════════════════════════════════════════════════════════
  6500.           ═════════════════════════════════════════════════════════════════
  6501.  
  6502.                                  CHAPTER 17:  LICENSE
  6503.  
  6504.           ═════════════════════════════════════════════════════════════════
  6505.           ═════════════════════════════════════════════════════════════════
  6506.  
  6507.                Pal and Palarm  (the "Licensed Program") is the exclusive
  6508.           property of PAL Software NY (the "Licensor").  Holders of the
  6509.           shareware version are granted a license to try the Licensed
  6510.           Program for a limited period of time.
  6511.  
  6512.                If you use the Licensed Program at least once a week or over
  6513.           a period in excess of one month, then it is understood that you
  6514.           are satisfied with the Licensed Program and must register and pay
  6515.           for the Licensed Program.  If you continue to use the Licensed
  6516.           Program under such circumstances without registering and paying
  6517.           for it, then you are in violation of this limited license.
  6518.  
  6519.                Registration grants to a single user the right to use the
  6520.           registered program in perpetuity.  By "single user" we mean one
  6521.           individual person.  Entities other than individuals must register
  6522.           one copy for each individual user.  Site licenses at reduced
  6523.           rates may be arranged for this purpose by direct negotiation with
  6524.           PAL Software NY.
  6525.  
  6526.                The plain English limitation here is:  If you like and use
  6527.           the program, then register and pay for it.  If, after a period of
  6528.           time of using the program you choose not to pay for it, then stop
  6529.           using it.
  6530.  
  6531.                Persons in possession of a copy of the Licensed Program are
  6532.           encouraged to share it with others by uploading it to computer
  6533.           bulletin boards, sending copies to friends, etc.  You are
  6534.           permitted to re-distribute the Licensed Program so long as no
  6535.           changes are made to the program or the documentation and the
  6536.           entire archived set is distributed unaltered.
  6537.  
  6538.                A reasonable charge may be received for the expense of
  6539.           copying and transmitting the program, but in no event must the
  6540.           person with whom you are sharing the Licensed Program be lead or
  6541.           permitted to believe that payment of such amounts constitutes
  6542.           registration or satisfies the requirements to register which are
  6543.           imposed by this license.
  6544.  
  6545.                Disk vendors who distribute shareware and public domain
  6546.           software on 5 1/4 inch and/or 3 1/2 inch floppy diskettes are
  6547.           permitted to distribute Pal and Palarm providing that the
  6548.           vendor's fee is less than $10.00 for the disk containing Pal and
  6549.           Palarm files.  Vendors who charge more than $10.00 per disk are
  6550.  
  6551.  
  6552.                                          108
  6553.  
  6554.  
  6555.  
  6556.  
  6557.                                 Pal 2.1 Documentation
  6558.  
  6559.           ─────────────────────────────────────────────────────────────────
  6560.  
  6561.           PROHIBITED from distributing Pal and Palarm in any form without
  6562.           express written consent from PAL Software NY.
  6563.  
  6564.                The catalog or other indexing material used by a disk vendor
  6565.           must contain a clear statement that the program is shareware, not
  6566.           public domain, and that the user is expected to pay for the
  6567.           program if the user likes it and intends to continue to use it.
  6568.           Disk distribution services are encouraged to contact the
  6569.           Association of Shareware Professionals for suggested language.
  6570.  
  6571.                Vendors who meet the above requirements may distribute Pal
  6572.           and Palarm only if ALL attendant files are included on the
  6573.           distribution diskette, and only if NO files are modified in any
  6574.           way.  Vendors are urged to read the file VENDOR.DOC, included
  6575.           with this distribution.
  6576.  
  6577.                Computer consultants and hardware sellers are permitted to
  6578.           distribute the Licensed Program along with their products and
  6579.           services so long as it is made clear to the end user that the
  6580.           Licensed Program is shareware and that the Licensor requires pay-
  6581.           ment if the end user continues to use the Licensed Program.  In
  6582.           no event may the end user be lead or permitted to believe that
  6583.           the fee paid for consulting, hardware or software includes the
  6584.           registration fee required for the Licensed Program.
  6585.  
  6586.                For information concerning site licenses and dealer pricing,
  6587.           please contact the Licensor.
  6588.  
  6589.                In no event is any person permitted to modify the Licensed
  6590.           Program or any of the associated documentation.
  6591.  
  6592.  
  6593.                THE LICENSOR DOES NOT WARRANT THAT THE LICENSED PROGRAM IS
  6594.           FIT FOR ANY PARTICULAR USE OR IS MERCHANTABLE.  THE LICENSED
  6595.           PROGRAM IS NOT WARRANTED TO BE FREE OF BUGS, NOR IS IT PROVIDED
  6596.           WITH ANY WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED.  IT
  6597.           IS YOUR RESPONSIBILITY TO DETERMINE WHETHER THE LICENSED PROGRAM
  6598.           IS SUITABLE FOR YOU.  IN NO EVENT SHALL THE LICENSOR, ITS OWNERS
  6599.           OR AGENTS BE HELD RESPONSIBLE FOR INCIDENTAL, SPECIAL OR CONSE-
  6600.           QUENTIAL DAMAGES, OR LOST DATA OR PROFITS TO ANY PERSON OR ENTITY
  6601.           THAT MAY ARISE OUT OF THE USE OF THE LICENSED PROGRAM, EVEN IF
  6602.           THE POSSIBILITY OF SUCH DAMAGE HAS BEEN BROUGHT TO THE ATTENTION
  6603.           OF THE LICENSOR.  RECOVERABLE DAMAGES IN ANY EVENT SHALL BE
  6604.           LIMITED TO NOT MORE THAN THE PRICE PAID FOR THE LICENSED PROGRAM.
  6605.  
  6606.  
  6607.  
  6608.  
  6609.  
  6610.                                          109
  6611.  
  6612.  
  6613.  
  6614.  
  6615.           ═════════════════════════════════════════════════════════════════
  6616.           ═════════════════════════════════════════════════════════════════
  6617.  
  6618.                               CHAPTER 18:  USER SUPPORT
  6619.  
  6620.           ═════════════════════════════════════════════════════════════════
  6621.           ═════════════════════════════════════════════════════════════════
  6622.  
  6623.                We are available for support in a number of ways.
  6624.  
  6625.                If you have a modem and are familiar with BBSing, you can
  6626.           reach us in several places:
  6627.  
  6628.                   1.   The PAL Software BBS is open 24 hours a day and
  6629.           accepts callers at 300 through 9600 baud (US Robotics Dual
  6630.           Standard modem in use).  The telephone number is 914-762-8055.
  6631.           Try to reach us here for the most immediate response.
  6632.  
  6633.                   2.   Our BBS is a member of RIME, the Relaynet
  6634.           International Message Exchange, which, as of this writing, boasts
  6635.           over 300 member boards.  We co-host the "Archives" conference,
  6636.           which might be known on your most local board as the
  6637.           "Compression" conference.  You can post support questions there.
  6638.  
  6639.                   3.   We are also available on Compuserve, monitoring
  6640.           IBMSYS, IBMAPP and IBMPRO.  You can also leave an EASYPLEX
  6641.           message.  Our Compuserve PPN is 70475,1071.
  6642.  
  6643.                Lastly, if you aren't into modems, you can always contact us
  6644.           by U.S. Mail at the address on the title page.
  6645.  
  6646.                Please note that support is guaranteed only for registered
  6647.           users.  Nonetheless, we will try to be of assistance to
  6648.           unregistered users who need our help in order to evaluate the
  6649.           program to their satisfaction prior to registering.
  6650.  
  6651.  
  6652.  
  6653.  
  6654.  
  6655.  
  6656.  
  6657.  
  6658.  
  6659.  
  6660.  
  6661.  
  6662.  
  6663.  
  6664.  
  6665.  
  6666.  
  6667.  
  6668.                                          110
  6669.  
  6670.  
  6671.  
  6672.  
  6673.           ═════════════════════════════════════════════════════════════════
  6674.           ═════════════════════════════════════════════════════════════════
  6675.  
  6676.                          CHAPTER 19:  ASP OMBUDSMAN PROCEDURE
  6677.  
  6678.           ═════════════════════════════════════════════════════════════════
  6679.           ═════════════════════════════════════════════════════════════════
  6680.  
  6681.                This program is produced by a member of the Association of
  6682.           Shareware Professionals (ASP).  ASP wants to make sure that the
  6683.           shareware principle works for you. If you are unable to resolve a
  6684.           shareware-related problem with an ASP member by contacting the
  6685.           member directly, ASP may be able to help. The ASP Ombudsman can
  6686.           help you resolve a dispute or problem with an ASP member, but
  6687.           does not provide technical support for members' products. Please
  6688.           write to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006
  6689.           or send a Compuserve message via easyplex to ASP Ombudsman
  6690.           70007,3536.
  6691.  
  6692.  
  6693.  
  6694.  
  6695.  
  6696.  
  6697.  
  6698.  
  6699.  
  6700.  
  6701.  
  6702.  
  6703.  
  6704.  
  6705.  
  6706.  
  6707.  
  6708.  
  6709.  
  6710.  
  6711.  
  6712.  
  6713.  
  6714.  
  6715.  
  6716.  
  6717.  
  6718.  
  6719.  
  6720.  
  6721.  
  6722.  
  6723.  
  6724.  
  6725.  
  6726.                                          111
  6727.  
  6728.  
  6729.  
  6730.  
  6731.           █████████████████████████████████████████████████████████████████
  6732.  
  6733.                                         INDEX
  6734.  
  6735.           █████████████████████████████████████████████████████████████████
  6736.  
  6737.           Advance Alarms  . . . . . . . . . . . . . . . . . . . . .  35, 59
  6738.           ASP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
  6739.           Auto-Repeat Alarms  . . . . . . . . . . . . . . . . . . .  56, 84
  6740.           Auto-Repeat Appointments  . . .  2, 23, 24, 27, 38, 42, 47-49, 93
  6741.           AUTOEXEC.BAT  . . . . . . . . . 12-14, 23, 50, 52, 61, 73, 74, 83
  6742.           Clock . . . . . . . . . . . . . . . 9, 18, 61, 101, 102, 104, 105
  6743.           Color . . . . . . . . . . . . . . 14, 15, 18, 20, 27, 92, 93, 102
  6744.           Customizing PAL . . . . . . . . . . . . . . . . . . . . . . .  86
  6745.           Date Control  . . . . . . . . . . . . . . . . . . . . . . . .  19
  6746.           DELETEAUTO  . . . . . . . . . . . . . . . . . . . . . . . . 7, 50
  6747.           DELETEAUTOALL . . . . . . . . . . . . . . . . . . . . . . . 7, 50
  6748.           File Handling . . . . . . . . . . . . . . . . . . . . . . . .  21
  6749.           File Location Defaults  . . . . . . . . . . . . . . . . .  86, 88
  6750.           Frequency . . . . . . . . . . . . . . . . . 26, 30, 32, 35, 38-40
  6751.           Holidays  . . . . . . . . . . . 1, 18, 20, 23, 31, 46, 86, 90, 91
  6752.           Installation  . . . . . . . . . . . . . . . 2, 12, 14, 52, 76, 93
  6753.           License . . . . . . . . . . . . . . . . . . . . . . . . .  3, 108
  6754.           Macro . . . . . . . . . . . . . . . . . . . . . 66-73, 75-85, 100
  6755.           Miscellaneous Defaults  . . . . . . . . . . . . . . .  53, 86, 92
  6756.           Multi-Tasking . . . . . . . . . . . . . . . . . . . . . .  51, 52
  6757.           Multiple SK Appointment Files . . . . . . . . . . . . . . . .  54
  6758.           Nofile  . . . . . . . . . . . . . . . . . . . . .  13, 22, 23, 89
  6759.           Noibmprn  . . . . . . . . . . . . . . . . . . . . . . . . . 1, 10
  6760.           NOIBMPRN.EXE  . . . . . . . . . . . . . . . . . . . . . . . 1, 10
  6761.           Ombudsman . . . . . . . . . . . . . . . . . . . . . . . .  3, 111
  6762.           ORDER.FRM . . . . . . . . . . . . . . . . . . . . . . . . 10, 107
  6763.           PAL.EXE . . . . . . . . . . . . . . . . . . . . . . .  10, 11, 96
  6764.           PAL.OVR . . . . . . . . . . . . . . . . . . . . . . . . .  10, 11
  6765.           PAL2.1  . . . . . . . . . . . . . . . . . . . . . . . . . . .  98
  6766.           PAL21.INF . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  6767.           PALARM.EXE  . . . . . . . . . . . . . . . . . . . . . .  9-11, 99
  6768.           PALDEMO.BAT . . . . . . . . . . . . . . . . . . . . . . 2, 10, 15
  6769.           PALDICK.APP . . . . . . . . . . . . . . . . . . . . . . .  10, 15
  6770.           PALJANE.APP . . . . . . . . . . . . . . . . . . . . . . . . .  10
  6771.           Palocate  . . . . . . . . . . . . . . . . . . . .  10, 73, 80, 81
  6772.           PALOCATE.EXE  . . . . . . . . . . . . . . . . . . . . . .  10, 73
  6773.           Paloff  . . . . . . . . . . . . . . . . . . . . . . . . .  10, 63
  6774.           PALOFF.EXE  . . . . . . . . . . . . . . . . . . . . . . .  10, 63
  6775.           PALREAD.ME  . . . . . . . . . . . . . . . . . . . . . . . . 9, 10
  6776.           Palrun  . . . . . . . . . . . . . . .  10, 65, 66, 71, 74, 75, 77
  6777.           PALRUN20.INF  . . . . . . . . . . . . . . . . . . . . . . . .  10
  6778.           Printer Defaults  . . . . . . . . . . . . . . . . . . . .  86, 95
  6779.           PURGEAUTO . . . . . . . . . . . . . . . . . . . . . . . . . 7, 50
  6780.           READIMAGE . . . . . . . . . . . . . . . . . . . . . . . 7, 12, 98
  6781.           Registration  . . . . . . . . . . . . . . . . . . . . . . 107-109
  6782.           Reminders . . . . . . . . . . .  2, 6, 18, 24, 27, 38, 41, 48, 50
  6783.  
  6784.                                          112
  6785.  
  6786.  
  6787.  
  6788.  
  6789.                                 Pal 2.1 Documentation
  6790.  
  6791.           ─────────────────────────────────────────────────────────────────
  6792.  
  6793.           Requirements  . . . . . . . . . . . . . . . . . .  2, 9, 108, 109
  6794.           RESTORE . . . . . . . . . . . . . . . . 4, 7, 15, 63, 87, 97, 105
  6795.           Restore Procedure . . . . . . . . . . . . . . . . . . . 7, 87, 97
  6796.           SAVEIMAGE . . . . . . . . . . . . . . . . . . . . . . . 7, 12, 98
  6797.           Setting Restrictions  . . . . . . . . . . . . . . . . . . . .  32
  6798.           Shell to DOS  . . . . . . . . . . . . . . . . . . . . . . . . . 4
  6799.           SK Delete and Purge . . . . . . . . . . . . . . . . . . . . .  48
  6800.           Sound . . . . . . . . . . . .  18, 57-59, 75, 76, 81-83, 100, 101
  6801.           Support . . . . . . . . . . . . . . . . . . . .  3, 107, 110, 111
  6802.           Syntax  . . . . . . . . . . . . . . . . . 2, 5, 6, 18, 25, 72, 77
  6803.           SYSOP.DOC . . . . . . . . . . . . . . . . . . . . . . . . 10, 107
  6804.           Task-Switching  . . . . . . . . . . . . . . . . . . .  50-52, 106
  6805.           Timed Event . . . . . . . . . . . . . . . . . . . . .  67, 71, 74
  6806.           Toggle Switches . . . . . . . . . . . . . . . . . . .  19, 25, 54
  6807.           VENDOR.DOC  . . . . . . . . . . . . . . . . . . . . . . . 10, 109
  6808.           WHATSNEW.PAL  . . . . . . . . . . . . . . . . . . . . . . . .  10
  6809.  
  6810.                         ***  End of Pal 2.1 Documentation  ***
  6811.  
  6812.  
  6813.  
  6814.  
  6815.  
  6816.  
  6817.  
  6818.  
  6819.  
  6820.  
  6821.  
  6822.  
  6823.  
  6824.  
  6825.  
  6826.  
  6827.  
  6828.  
  6829.  
  6830.  
  6831.  
  6832.  
  6833.  
  6834.  
  6835.  
  6836.  
  6837.  
  6838.  
  6839.  
  6840.  
  6841.  
  6842.                                          113
  6843.  
  6844.