home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0020 - 0029 / ibm0020-0029 / ibm0028.tar / ibm0028 / PDXOS2-1.ZIP / SKDOC < prev    next >
Encoding:
Text File  |  1988-12-29  |  11.0 KB  |  324 lines
  1. Using Paradox with SideKick for Presentation Manager
  2. ----------------------------------------------------
  3.  
  4. Table of Contents
  5. -----------------
  6.  
  7. I.    Paradox Files in Sidekick for Presentation Manager
  8.  
  9. II.   Concurrent File Access
  10.     A.    Concurrent Access Using Paradox OS/2
  11.     B.    Concurrent Access Using Paradox 2.0 (DOS mode)
  12.     C.    Paradox File Extensions
  13.  
  14. III.  Using Paradox and the SideKick Time Planner
  15.     A.    Description of Fields in the Appointment Table
  16.     B.    Description of Fields in the Notes Table
  17.  
  18. IV.   Using Paradox and the SideKick Phonebook
  19.  
  20. V.    SideKick for Presentation Manager Table Structures
  21.     A.    Time Planner
  22.     B.    Phonebook
  23.  
  24.  
  25.  
  26.  
  27. I.  Paradox Files in SideKick for Presentation Manager
  28. ------------------------------------------------------
  29.  
  30. The Time Planner and Phonebook main data files are actually
  31. Paradox data files.  Therefore, they can be manipulated readily
  32. within Paradox.  With some limitations, discussed below, Paradox
  33. 2.0 and Paradox OS/2 can view Time Planner and Phonebook data
  34. files while Time Planner and Phonebook are active.  Paradox 2.0
  35. and Paradox OS/2 can also modify data in SideKick for PM files. 
  36. Paradox sessions can make changes in either Edit or CoEdit mode,
  37. but must have exclusive use of the file being changed in either
  38. case.
  39.  
  40. Two applications have been provided in the \SKSAMPLE directory on
  41. the Installation/Sample Tables Disk, that illustrate how to use
  42. Paradox in conjunction with Sidekick for Presentation Manager. 
  43. There is a tool that allows you to transfer data from any Paradox
  44. table into a Phonebook format table.  It allows you to match
  45. columns in the source table with columns in the target Phonebook
  46. table and then transfer the data into that table.  There is also
  47. a tool that allows you to enter annual events into the Time
  48. Planner for a range of years.
  49.  
  50. 4Mb RAM or more is recommended when using Paradox OS/2 in
  51. conjunction with SideKick for PM.
  52.  
  53. Note:
  54. Be sure to exit all SideKick for PM applications normally,
  55. especially if you have been adding or changing data.  Don't turn
  56. off your machine with applications minimized; close them from
  57. their system menus or restore them and use their Exit menus to
  58. exit.  You can also choose Shutdown Now... from the Shutdown menu
  59. in the Task Manager to close applications.  This will close ALL
  60. open applications.  Also, since the Time Planner and Phonebook
  61. applications check their data files when they are loaded to
  62. verify that they are appropriate Time Planner or Phonebook files,
  63. each table's structure must always be the same as the structure
  64. of the default .DB file, and the related index files (.PX) must
  65. also be present and up-to-date.  See "SideKick for Presentation
  66. Manager Table Structures" below.
  67.  
  68.  
  69. II.  Concurrent File Access
  70. ---------------------------
  71.  
  72. If only one copy of the Time Planner is open to a particular
  73. file, the user can freely edit and move between Daily, Weekly and
  74. Monthly views.  However, if more than one copy of the Time
  75. Planner is open to a particular file, or a Time Planner session
  76. and a Paradox session are both open to the same file, the Daily
  77. view is not available from within the Time Planner, and the file
  78. can only be opened for viewing within Paradox.
  79.  
  80. If only one copy of the Phonebook is open to a particular file,
  81. the file is freely editable.  However, if more than one copy of
  82. the same file is open in Phonebook and Paradox OS/2 sessions, or
  83. in multiple Phonebook sessions, the file is read-only and is not
  84. editable.
  85.  
  86. During concurrent access to SideKick's datafiles, the
  87. Tools/Info/Who command will show SideKick sessions as Paradox 2.0
  88. sessions.  This is due to the usage of Paradox 2.0's dynamic link
  89. library.
  90.  
  91.  
  92.  
  93. Using Paradox OS/2 with SideKick for PM:
  94.  
  95. In order to be able to access the files at the same time as Time
  96. Planner or Phonebook, you must give Paradox OS/2 the following
  97. command-line parameters when you launch it: 
  98.  
  99.   PDOXOS2 -MULTI -NET C:\SIDEKICK\ 
  100.  
  101. This tells your Paradox OS/2 session that other Paradox sessions
  102. or other applications may be accessing its files, and that the
  103. PARADOX.NET file that controls concurrent access will be in the
  104. C:\SIDEKICK directory.  (Be sure to include the final backslash,
  105. as shown above.)
  106.  
  107. Be sure to use the -MULTI command line option; without it,
  108. Paradox's lockfile  mechanism, which protects data integrity
  109. while allowing concurrent access, cannot operate.
  110.  
  111. If SideKick resides in a drive or directory other than
  112. C:\SIDEKICK, replace "C:\SIDEKICK\" with the parent directory of
  113. the PHONE and TIMEPLAN sub-directories.  Alternatively, you may
  114. supply this information in the "Start Programs" window.  If you
  115. are just installing Paradox OS/2 or want to re-install it, you
  116. can specify during the installation that the PARADOX.NET file
  117. will be located in c:\SIDEKICK\, and omit the -net option at
  118. start-up.
  119.  
  120. If you install Paradox OS/2 in the Start Programs window, specify
  121. that it is not an OS/2 Presentation Manager program and that it
  122. should run in a text window.
  123.  
  124.  
  125. Using Paradox 2.0 (DOS mode) with SideKick for PM: 
  126.  
  127. Paradox 2.0, running in the DOS compatibility box, can share
  128. files with SideKick's Time Planner and Phonebook.  To allow
  129. Paradox 2.0 to share SideKick for PM files, you must specify
  130. during installation that you will be sharing data on a network. 
  131. If you are actually running multiple sessions on a single
  132. machine, select network type OTHER.  If you have already
  133. installed Paradox 2.0 for stand-alone use, you must re-install to
  134. select a network type.  You'll probably also want to specify the
  135. location of your PARADOX.NET file - usually C:\SIDEKICK\, as
  136. discussed for Paradox OS/2 - so you don't have to enter it from
  137. the command line.
  138.  
  139. You must also use the -SHARE command line option, so Paradox 2.0
  140. recognizes that it is running in a multiuser environment.  Your
  141. command line will say, at least:
  142.  
  143.   PARADOX2 -SHARE
  144.  
  145. To allow Paradox's lockfile mechanism to control concurrent
  146. access, be sure that you always use the -SHARE option. You may
  147. also use the -NET option to override anything set through
  148. installation, or the -USER option to provide a username.
  149.  
  150.  
  151. Paradox File Extensions:
  152.  
  153. Paradox can maintain and manipulate the following files:
  154.  
  155.   All .DB files
  156.   All .PX files
  157.   All .SET files
  158.  
  159. Within the Phonebook, the .SET file maintains the current Table
  160. View settings such as column width and order.  Paradox's .SET
  161. file is a superset of Phonebook's .SET file.  Therefore, not all
  162. features of the Paradox .SET file are supported in Phonebook.
  163. Supported settings that can be manipulated between Paradox and
  164. SideKick for PM's Phonebook include ColumnSize, and ColumnRotate.
  165.  
  166. The associated file PHONE.PX is the index file for PHONE.DB.  The
  167. Phonebook will automatically create additional data files for: 
  168.  
  169.   Speed Dial          .SPD 
  170.   Card Design         .FRM
  171.  
  172. These files are not Paradox objects and cannot be manipulated
  173. through Paradox.
  174.  
  175.  
  176. III.  Using Paradox and the SideKick Time Planner
  177. -------------------------------------------------
  178.  
  179. The Time Planner appointment files (filename+A) and Notes files
  180. (filename+N) are linked through the Date field plus the Order
  181. field which exist in both databases.  This is a one-to-many
  182. relationship where each individual appointment is associated with
  183. a potentially multi-record note file.  The appointment may have a
  184. maximum of one note linked to it.  The linked note file consists
  185. of a separate record for each line in the note.  The text of the
  186. note is limited to 80 characters per line.
  187.  
  188.  
  189. Description of the Fields in the Appointment Table:
  190.  
  191. Date:
  192. Date of the appointment in MM/DD/YY format.
  193.  
  194. Start Time:
  195. Start time of appointment in 24 hour time format (HH:MM).  A
  196. value of 0:00 indicates a start time of 12:00AM (beginning of the
  197. day).
  198.  
  199. End Time:
  200. End time of appointment also in 24 hour time format (HH:MM).  A
  201. value of 23:59 indicates an end time of 11:59PM (end of the day).
  202.  
  203. Order:
  204. Order in which the appointment was entered.  Must be a unique
  205. number for each date beginning with number 0, maximum 255.
  206.  
  207. Alarm Time:
  208. Scheduled alarm time in 24 hour format (HH:MM).  Value of -1 if
  209. no alarm is set.  A value of 0:00 if the start time is 12:00am.
  210.  
  211. Type:
  212. Type of appointment interpreted into a text string.  Possible
  213. values include: 
  214.  
  215.   Meeting
  216.   Business trip
  217.   Vacation
  218.   None
  219.   Birthday
  220.   Party
  221.   Meal
  222.   Personal
  223.   Coffee break
  224.   National Holiday
  225.   Phone call
  226.  
  227. Description:
  228. Text from the 'Activity' field.  Maximum of 80 alphanumeric
  229. characters.
  230.  
  231.  
  232. Description of Fields in the Notes Table:
  233.  
  234. Date:
  235. Date of the appointment in MM/DD/YY format.  This value will
  236. repeat x number of times where x is the number of lines in the
  237. note.
  238.  
  239. Order:
  240. Order in which the appointment was entered. The Order field is
  241. directly associated with the Order field in the appointment
  242. database.  This value will repeat x number of times where x is
  243. the number of lines in the appointment.  Order begins with 0 and
  244. has a maximum value of 255.  The combination Date+Order+Line
  245. Number creates the key and must be maintained to prevent
  246. duplicate entries.
  247.  
  248. Line Number:
  249. Line number of note.  Must be a consecutive number beginning with
  250. 0 for each unique Order number.  The maximum number of lines in a
  251. note is 32767.
  252.  
  253. Line Text:
  254. Text of associated line from the note.  Control characters such
  255. as TAB are also saved.  80 characters maximum text per line.
  256.  
  257.  
  258. IV.  Using Paradox and the SideKick Phonebook
  259. ---------------------------------------------
  260.  
  261. The Phonebook uses only one file.  It may be named any legal
  262. Paradox tablename but must have the exact table structure as
  263. noted below.  There is a default table named PHONE that may be
  264. borrowed for its structure when creating alternative Phonebook
  265. tables.
  266.  
  267.  
  268. V.  SideKick for Presentation Manager Table Structures
  269. ------------------------------------------------------
  270.  
  271. Time Planner:
  272.  
  273. The Time Planner maintains two sets of Paradox data files,
  274. PLANS00A and PLANS00N.  The PLANS00A table structure is: 
  275.  
  276.   Date               D*  
  277.   Start Time         A5* 
  278.   End Time           A5* 
  279.   Order              S*
  280.   Alarm Time         A5 
  281.   Type               A25
  282.   Description        A80
  283.  
  284. The PLANS00N table structure is:
  285.  
  286.   Date               D* 
  287.   Order              S* 
  288.   Line Number        S*
  289.   Line Text          A80
  290.  
  291.  
  292.  
  293. Phonebook:
  294.  
  295. The PHONE table structure is:
  296.  
  297.   Last Name          A20* 
  298.   First Name         A20* 
  299.   Middle Name        A20* 
  300.   Code               A10* 
  301.   Title              A35 
  302.   Company            A50 
  303.   Address            A50 
  304.   City               A20 
  305.   State              A15 
  306.   Zip                A10 
  307.   Home Phone         A30 
  308.   Business Phone     A30 
  309.   Alternate Phone    A30 
  310.   Notes              A255
  311.  
  312.  
  313. Legend:  
  314.   A - Alphanumeric (ex: A25)
  315.       Any combination of characters and spaces up to a specified
  316. width.
  317.       Maximum width is 255.
  318.   D - Date
  319.   S - Short integer, with a range between -32768 and 32767.
  320.  
  321.   An asterisk next to a field type indicates that it is a key 
  322.   field (ex: A4*)
  323.  
  324.