home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0020 - 0029 / ibm0020-0029 / ibm0028.tar / ibm0028 / PDXOS2-1.ZIP / SKAPPS < prev    next >
Encoding:
Text File  |  1988-12-29  |  6.7 KB  |  189 lines
  1. SideKick for PM Utilities
  2. -------------------------
  3.  
  4. Table of Contents
  5. -----------------
  6.  
  7. I.        Overview
  8.  
  9. II.        Installation
  10.  
  11. III.        PB - Phonebook Insert Utility
  12.  
  13. IV.        TP - Time Planner Annual Event Insert Utility
  14.  
  15.  
  16.  
  17. I.  Overview
  18. ------------
  19.  
  20.   PB:       Inserts any existing Paradox table into a SideKick
  21.             Phonebook table.  You may insert data into an
  22.             existing Phonebook table or create a new one.
  23.  
  24.   TP:       Inserts a list of user entered annual events into an
  25.             existing Time Planner table for a specified number of
  26.             years.
  27.  
  28. *** NOTE: SAVE COPIES OF YOUR SideKick Phonebook and Time Planner
  29. tables, before using either of these utilities.
  30.  
  31.  
  32. II.  Installation
  33. -----------------
  34.  
  35. Copy all of the files from the \SKSAMPLE directory on your
  36. Installation/Sample Tables Disk into a directory on your hard
  37. disk.  Launch Paradox OS/2 or Paradox 2.0 using this directory as
  38. your working directory and run the "sksetup" script.  
  39.  
  40. Type Script/Play "sksetup"
  41.  
  42. The SideKick for PM applications will be prepared for use.
  43.  
  44.  
  45. III.  PB - Phonebook Insert Utility
  46. -----------------------------------
  47.  
  48. To use the PB application play the script named "pb".
  49.  
  50. Type Script/Play "pb"
  51.  
  52. This script allows you to take any Paradox table and insert it
  53. into a SideKick Phonebook table.  The Phonebook table contains a
  54. fixed structure, and cannot be modified.
  55.  
  56. Screen 1:
  57.  
  58. You are prompted to enter the name of the SideKick Phonebook
  59. table you wish to add the data.  Type in the table name if it is
  60. in the current directory.  Type in the full pathname if it is in
  61. another directory.  Paradox checks the structure to see if it is
  62. a valid SideKick Phonebook structure.  If the structure is
  63. invalid, you are returned to the prompt.  
  64.  
  65. If the tablename does not exist, the program asks you if you want
  66. to create a new SideKick Phonebook table.  If you respond with a
  67. "Y", a table is created under the specified name with the correct
  68. SideKick Phonebook table structure.  If you respond with a "N",
  69. you are returned to the prompt.
  70.  
  71. Next, you are prompted to enter the name of the Paradox table you
  72. wish to insert.  You may use the full pathname or just the table
  73. name if it is in the current directory.  If the table does not
  74. exist, you are returned to the prompt.  If a valid table name is
  75. entered, Screen 2 is displayed.
  76.  
  77. (Note: You cannot add a SideKick Phonebook table to itself).
  78.  
  79.  
  80. Screen 2:
  81.  
  82. You see a table with four fields.  The first two fields are the
  83. field names and field types of a SideKick Phonebook table.  The
  84. next two fields are the field names and field types of the table
  85. you wish to insert.  The cursor is always in the Field Name
  86. field.  You can type in a field name or press <F1> to see a list
  87. of fields in the Paradox table.  
  88.  
  89. When <F1> is pressed, you may select the field to insert with the
  90. highlight bar, and press enter.  The corresponding field type is
  91. automatically filled in.  Make sure that at least one entry is
  92. made in one of the first four SideKick fields.  These four fields
  93. make up the primary index for the file and must contain at least
  94. one entry to avoid a key violation.
  95.  
  96. The SideKick Phonebook table has all alphanumeric fields.  The
  97. Paradox table can have fields of any data type.  If a longer
  98. field is inserted into a shorter SideKick Phonebook field, a
  99. warning message tells you that characters may be truncated upon
  100. the transfer of information.
  101.  
  102. Press <F2> when you have finished matching fields from one table
  103. to the other.  You are asked if you are done entering data. 
  104. Respond with a "Y" or "N".  "N" returns you to editing the table,
  105. while "Y" initiates the insertion of the data.  The program
  106. performs the necessary steps to convert and transfer the data
  107. into your SideKick Phonebook table.  When the processing is
  108. complete, the updated SideKick Phonebook table is displayed on
  109. the screen.
  110.  
  111.  
  112.  
  113.  
  114. IV.  TP - Time Planner Annual Event Insert Utility
  115. --------------------------------------------------
  116.  
  117. To use the TP application play the script "tp".
  118.  
  119. Type Script/Play "tp"
  120.  
  121. This script inserts a list of annual events into the SideKick
  122. Time Planner.  You can specify a starting year and ending year,
  123. and TP inserts the annual event for each year within the
  124. specified range.
  125.  
  126.  
  127. Screen 1:
  128.  
  129. You are prompted to enter the name of the SideKick Time Planner
  130. table to which you wish to add the events.  You MUST choose an
  131. existing valid Time Planner tablename.  This application DOES NOT
  132. allow you to create a new Time Planner table.  Type in the
  133. tablename if it is in the current directory.  Type in the full
  134. pathname if it is in another directory.  The filename for a Time
  135. Planner table must have the letter A as the last letter, i.e.
  136. PLANS00A, CALENDRA, XXXXXXXA (a maximum of 8 characters in total)
  137. are all valid table names.  
  138.  
  139.  
  140. Paradox checks the structure to see if it is a valid SideKick
  141. Time Planner structure.  If the structure is invalid or if the
  142. tablename does not exist, you are returned to the prompt.  
  143.  
  144. Next, you are prompted to enter the range of years in which you
  145. wish to add your annual events.  The minimum year is 1900 and the
  146. maximum year is 2099.  Press <Esc> if you have made an error or
  147. press <Enter> to continue.
  148.  
  149. NOTE: If you add events for many years, the size of your Time
  150. Planner table increases significantly.  Therefore, only enter
  151. date ranges including years that are necessary and appropriate
  152. for your purposes.
  153.  
  154. Screen 2:
  155.  
  156. You see a table with seven fields
  157.  
  158.   Month
  159.   Day
  160.   Icon Type
  161.   Alarm
  162.   Description
  163.  
  164. For each annual event, fill in the first five fields where
  165. appropriate.  You MUST enter a complete valid date (month and
  166. day).  Leap year dates are not allowed (i.e. 29 Feb).
  167.  
  168. The Month value may contain any value from 01 to 12.  The Day
  169. value may contain any value from 01 to 31.  In both cases, the
  170. leading zero is necessary for the numbers 01 - 09.
  171.  
  172. In the Icon Type field, press the <F1> key to bring up a list of
  173. available Icon Types.  Select the appropriate Icon Type with the
  174. highlight bar and press enter.  You must make a selection from
  175. this list and cannot make up your own icon type.
  176.  
  177. Placing a "Y" in the Alarm field, schedules an alarm to go off at
  178. 12:00 noon on the day of the annual event.  Placing an "N" in the
  179. Alarm field or leaving it blank does not set an alarm for that
  180. event.
  181.  
  182.  
  183. Press <F2> when you have finished entering events.  You are asked
  184. if you are done entering data.  Respond with a "Y" or "N".  "N"
  185. returns you to editing the table, while "Y" initiates the
  186. insertion of the annual events.  The program performs the
  187. necessary steps to insert the annual events into your SideKick
  188. Time Planner table.  When the processing is complete, the updated
  189. SideKick Time Planner table is displayed on the screen.