home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / mumps / latest.doc < prev    next >
Text File  |  1986-08-21  |  11KB  |  273 lines
  1.             VA FILEMAN VERSION 17
  2.  
  3.         Release Notes for Users of Previous Versions
  4.  
  5. The 'DINIT' routine must be run after the new copies of `DI` routines are
  6. loaded.  %DT, %DTC, and %RCR must be refiled in the 'MGR' directory.
  7.  
  8.  
  9.                   *****    NEW FEATURES    *****
  10.  
  11. I. Relational Syntax
  12.  
  13. The FileMan includes new 'relational' capabilities that will allow the user to
  14. integrate input to and output from multiple associated files.  FileMan
  15. software implicitly understands the 'backwards-pointer' relationship between a
  16. given file and those other files which have fields 'pointing' to it.  Thus, if
  17. a PATIENT file is 'pointed to' (cross-referenced) by an "ENCOUNTER PATIENT"
  18. field in an ENCOUNTER file, a user is able to start out in the PATIENT file,
  19. and by typing 'ENCOUNTER:' automatically 'navigate' to any field within the
  20. ENCOUNTER file without any 'ENCOUNTER' pointer having been defined in the 
  21. patient file.  In effect, ENCOUNTER is treated as a 'virtual' multiple field
  22. within the PATIENT file.
  23.  
  24. The SEARCH, SORT, PRINT, and ENTER/EDIT components of FileMan software respond
  25. to a simple new syntax that signals 'relational' navigation'. This syntax is
  26. simply the addition of a colon (:) at the end of the field specification.
  27. Within the SEARCH Option the user is able to enter the name of a 
  28. pointer-valued field followed by a colon and proceed to specify fields to 
  29. search within the file pointed to by the pointer field.  Alternately, he is
  30. able to use an 'Extended Pointer' (database JOIN) syntax, followed by a colon,
  31. to move from the original file to any other file.  For example, at the prompt
  32. 'SEARCH FOR PATIENT FIELD:' , the user is able to enter 'STATE:' and then
  33. proceed to specify fields to search within the STATE file.  Finally the user
  34. is able to search the entries of any file that points to the original file by
  35. entering the name of that 'pointing' file followed by a colon. The 'relational
  36. navigation' is available at the level of the search.  Thus using the 
  37. PATIENT/ENCOUNTER example, one is able to start out within the PATIENT file,
  38. type 'ENCOUNTER:', and then specify the specific fields within the ENCOUNTER
  39. file to search. Similarly, having spceified some search criteria within
  40. ENCOUNTER, one can also move on from ENCOUNTER to PROCEDURE.
  41.  
  42. The SORT and PRINT components of the PRINT Option of FileMan are usable in the
  43. same ways as the SEARCH logic described.  At the "SORT BY:" question, the user
  44. is able to enter a 'Pointer Field' name of an 'Extended Pointer' or a 'virtual
  45. multiple' file name - all with the colon suffix.  Similarly when asked "THEN
  46. PRINT FIELD:" the same syntax is allowed.  In all cases, the subsequent
  47. question is referenced to the 'new' file context: so that, for example, "THEN
  48. PRINT FIELD: ENCOUNTER:" is followed by "THEN PRINT ENCOUNTER FIELD:".
  49.  
  50. The same three types of 'relational' syntax shall be available for the
  51. ENTER/EDIT Option to edit data in more than one file.
  52.  
  53.  
  54. II.  Compiled Print Templates
  55.  
  56. A user with 'programmer-level' security is allowed to turn any existing Print
  57. Template into one or more automatically-generated MUMPS routines.  Whenever a
  58. Print Template has such a MUMPS routine associated with it, it shall
  59. automatically invoke that routine until fields comprising the Template are
  60. modified.
  61.  
  62.  
  63.  
  64.  
  65. III.  Input Captions
  66.  
  67. Captions can now be specified as different from the field label (User Manual
  68. VI.F).  To specify a different 'prompt', simply answer the "EDIT WHICH FIELD:"
  69. query with the label, followed by ";" and the desired prompt within quotation
  70. marks.  Thus:
  71.  
  72.     EDIT WHICH FIELD:  DOB;"Date of Birth"
  73.  
  74. will cause the DOB field to be asked in the form:
  75.  
  76.     Date of Birth:
  77.  
  78. IV.  New Data Dictionary Listing Options
  79.  
  80. Using the LIST FILE ATTRIBUTES Option, users are able to produce a 
  81. 'Templates-only' list for any file.  Alternatively, they are able to produce a
  82. 'Modified Standard' listing that suppresses the display of all MUMPS code and
  83. that includes or excludes certain data fields based on their GROUP
  84. memberships.
  85.  
  86.  
  87. V.  Suppressing Sub-headers for Print Templates
  88.  
  89. Certain Print Templates are designed for fixed-form output such as those that
  90. must fit on special pre-printed paper.  The PRINT Option allows the creator of
  91. a Print Template to declare that no 'sub-headers' shall appear in the output
  92. from such Templates.  Thus end-users need not remember to specify their 'SORT
  93. BY' criteria with sub-header suppression ("@").
  94.  
  95.  
  96. VI.  Search Conditions
  97.  
  98. The SEARCH Option allows the user to enter "=" rather than "EQUALS", ">"
  99. rather than "GREATER THAN", "<" rather than "LESS THAN", and "[" rather than
  100. "CONTAINS".
  101.  
  102.  
  103. VII.  Improvements in 'Trigger' Logic
  104.  
  105. In processing 'Conditions' for Triggers, the Cross-Reference Utility has been
  106. modified to accept lengthy complex expressions.  For triggered fields
  107. resulting in new entries or sub-entries being dynamically created, the user
  108. has control over whether this kind of 'LAYGO' trigger shall happen on both the
  109. 'SET' and the 'KILL' or just on the 'SET'.
  110.  
  111.  
  112. IX.  "Center" Tab Position
  113.  
  114. For enhanced word-processing formatting, the 'SETTAB' function allows a "C"
  115. argument to indicate column-centering of input following the corresponding
  116. tab.
  117.  
  118.  
  119. X.  Editing Input Templates
  120.  
  121. Any user-entered Input Template specification is now recallable in its 
  122. original form for editing of the template.
  123.  
  124.  
  125. XI. Forcing Number entry on Lookup
  126.  
  127. The 'DIC' lookup program accepts the inputting of the Internal Entry Number
  128. for any file of sub-file even if the file is not normally understood to be
  129. 'number-meaningful' by preceeding the number with an accent grave (').
  130.  
  131.  
  132. XII.  Line Mode Option for Word-processing Fields
  133.  
  134. Word-processing fields can be defined so that they customarily are displayed
  135. line-for-line, rather than 'word-wrapped' (User's Manual, VI.B).  When 
  136. creating a word-processing field, the user will be asked:
  137.  
  138.     SHALL THIS TEXT NORMALLY APPEAR IN WORD-WRAP MODE? YES//
  139.  
  140. a 'NO' response here will cause the text to be printed in line mode.
  141.  
  142.  
  143. XIII.  Format Control
  144.  
  145. The ";C" and ";Y" Print Field qualifiers now allow negative parameters to
  146. handle indentation from the right or the bottom margin (User's Manual IV.C).
  147. Thus:
  148.  
  149.     ;C-10    start this Field 10 columns in from the right margin.
  150.  
  151.     ;Y-4    start printing this field four lines up from the bottom 
  152.         of the page.
  153.  
  154.  
  155. XIV.  Underlining
  156.  
  157. Underlining can be controlled with the "|_|" window (User's Manual VI.B.).
  158. Underlining will continue until the second "|_|" is encountered.
  159.  
  160.  
  161. XV.  New Functions
  162.  
  163. Three new Functions have been added to the Function File:
  164.  
  165.     BETWEEN       three argument function which will equal '1' if the 1st
  166.            lies between the 2nd and the 3rd; '0' otherwise.
  167.     MAXIMUM       return the maximum value in a multiple field.
  168.     MINIMUM       return the minimum value in a multiple field.
  169.  
  170.  
  171. XVI.  DIFROM
  172.  
  173. Recipients of packages will now be asked if they want to write over existing 
  174. file security codes if they already have a version of the package.  Namespaced
  175. help frames are included in the initialization routines when a package is 
  176. created.
  177.  
  178.  
  179. XVII.  Date/Time Fields
  180.  
  181. A user can now specify that time is required on input.  Answer 'YES' to the
  182. 'Is Time Allowed' query, and FileMan will the ask 'Is Time Required'.
  183.  
  184.  
  185. XVIII. DIM
  186.  
  187. The FileMan syntax checker (DIM*) has been updated to include the following 
  188. aspects of the 1984 MUMPS standard.  In addition, the killing of any
  189. unsubscripted global has been disallowed.
  190.  
  191.     a) Set $Piece
  192.     b) Single-Argument $Extract
  193.     c) Double-Argument $Piece
  194.     d) Double-Argument $Length
  195.     e) Pattern Matches containing ranges, e.g. X?1.5NA
  196.  
  197.  
  198. XIX.  Descriptions on Templates
  199.  
  200. Input, Print, and Sort Templates now have a description field which can be
  201. viewed by typing '[???' at the appropriate places when wishing to select a 
  202. template.  They will also show on Standard, Modified, and Templates Only
  203. dictionary listings.  In order to facilitate the entering of these
  204. descriptions, the SORT TEMPLATE EDIT Option under Utility Functions has been 
  205. changed to TEMPLATE EDIT.  The user will now specify which type of template to
  206. edit and then proceed as before.
  207.  
  208.  
  209. XX.  %DT
  210.  
  211. Two new parameters have been added to the %DT variable.  If %DT contains:
  212.  
  213.     N    Numeric data input, e.g. 121177 is NOT allowed.
  214.     R    Time is required (T need not be present).
  215.  
  216. Also, a default answer may be passed to %DT by defining the variable %DT("B"),
  217. e.g. %DT("B")="TODAY".
  218.  
  219.  
  220. XXI.  Up-Arrow out of Print-Outs
  221.  
  222. When directing output from the Print Option to a CRT, it is now possible to 
  223. type an up-arrow (^) after you hear the beep at the bottom of a screen to
  224. terminate the print-out and return to the menu.
  225.  
  226.  
  227.  
  228.         ****    BUGS FIXED    ****
  229.  
  230.  
  231. Version 17 is designed to be backwards-compatible with all existing FileMan
  232. systems.  Since, however, a number of errors have been fixed in the new
  233. Version, a few incongruities might arise:
  234.  
  235.  
  236. TABS in Word-processing Text - Version 16 did not properly count column
  237. positions for TABS; "TAB5" would generate output that started in column
  238. position 4.  This has now been corrected.  It can be expected that documents 
  239. with TABS in them will now appear to have all TABS shifted on position to the 
  240. right.  If this is a problem, remember that the SETTAB function can re-specify
  241. TAB positions for parts or all of a document.
  242.  
  243. Multiple Identifiers - Previous FileMan versions would allow any number of
  244. Identifier Fields to be specified at any File or Sub-File level, but would not
  245. necessarily display them all on a lookup.  In Version 17, all Identifiers that
  246. have been defined to be displayable are indeed displayed.  This could result 
  247. in a surprise for data entry personnel who were not expecting to see all 
  248. Identifiers.  If this is a problem, simply delete the unexpected Identifiers,
  249. or re-define them as 'non-displaying'.
  250.  
  251. Compiled Input Template - An Input Template that contains something like
  252. "Field Name//^S X=DG" where the Field is a Word-processing type will now be 
  253. compiled correctly.  Also, if the same field appears twice, the proper default
  254. will be displayed.
  255.  
  256. Date Type Multiple Fields - The user entry for the .01f field of a multiple
  257. that is defined to be a DATE will now be screened correctly.  Previous
  258. versions of FileMan accepted time entry even though the field definition
  259. specified that time may not be entered.
  260.  
  261. DIFROM - Any 'INITs' generated using Version 17 will run only under FileMan
  262. Version 17.  It will also now defoult to a maximum routine size of 2000 bytes.
  263.  
  264. Cross-Reference Suppression - If DIC(0) contains "C" before invoking the
  265. routine ^DIC, then FileMan will turn off suppression of MNEMONIC
  266. cross-references.
  267.  
  268. DINIT - Error will no longer occur if the user answers '?' to MUMPS OPERATING
  269. SYSTEM.
  270.  
  271.  
  272.  
  273.