home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR16 / DTSDDS.ZIP / DTSDDS.DOC next >
Text File  |  1993-07-26  |  5KB  |  98 lines
  1.   DTSDDS.DOC                                               July 25, 1993
  2.   Samuel W. Bellamy III (76200,2531)
  3.  ══════════════════════════════════════════════════════════════════════════
  4.          Hello all,
  5.  
  6.          If you're reading this document then it is likely you have
  7.          experienced one of CDD 3.0 deficiencies in early batch releases,
  8.          the lack of a DICTIONARY print facility.
  9.  
  10.          For those of us dealing with large data dictionaries, it is
  11.          impractical, if not impossible, to retain all of the DICTIONARY
  12.          properties to memory.  Therefore, I have invested the time
  13.          to create a DDSList template to dump DICTIONARY properties
  14.          to file.
  15.  
  16.          Now, since Clarion Software has announced the development of
  17.          a print facility, we have decided to NOT enter into a Third-
  18.          Party relationship in this or similar projects.  However, if
  19.          you haven't already heard about Clarion Third-Party product
  20.          offerings from Diversified Technology Solutions, you should
  21.          soon.
  22.  
  23.          Back to the solution at hand....let's look at the disclaimer,
  24.          function, and caveats regarding this utility.
  25.  
  26.       DISCLAIMER
  27.          Diversified Technology Solutions nor its principals nor
  28.          employees vow to the validity and operation of this
  29.          program. Use this utility by your own free will AND at your
  30.          own risk.
  31.  
  32.          Distributed as FREEWARE you are responsible to taking
  33.          necessary precautions to protect your investment,
  34.          particularly CLA and/or DCT files.  This means MAKE A BACKUP.
  35.  
  36.          This product does not provide any means of error checking
  37.          to preclude overwriting any previously developed CLAs of
  38.          similar naming convention.  Therefore, if you create an APP
  39.          with a Module Name for the DCT listing with a similar name
  40.          to another CLA source file, GENERATOR will over-write the
  41.          original source.
  42.  
  43.       FUNCTION
  44.          Perhaps the best method of describing the implementation of
  45.          this utility is to describe how we use it.
  46.  
  47.        1.  Install DTSDDS.TPL into the \CLARION3  directory.
  48.        2.  After selecting the desired default directory from within the
  49.            Clarion environment, select the Application Generator <F4>.
  50.        3.  Select the NEW button to create a new APP.
  51.        4.  Enter the name of the APP.  (Generally, we give it a name
  52.            somewhat representative of the DCT, but include DDS in the
  53.            name.)
  54.        5.  Select \CLARION3\DTSDDS.TPL as the Template File.
  55.        6.  Select the desired DCT for documenting.
  56.        7.  Enter a FirstProcedure. (This APP will have a single procedure.
  57.            We generally call it DCTListing.)
  58.        8.  Create the procedure as a DDSList.  (NOTE: The TODO and
  59.            EXTERNAL procedure types are present in DTSDDS.TPL because
  60.            CDD 3.0 requires them for the APP preloading.)
  61.        9.  Select the FILE button and select one of the FILEs. (This is
  62.            required because the Source Generator needs a starting point
  63.            in the DCT to determing file RELATIONSHIPs.)
  64.        10. Enter the Module Name for the output redirection.
  65.        11. Select the desired check box for Full or Brief DDS listing.
  66.        12. Select the OK button.
  67.        13. Press <ALT G> to Generate Source. (NOTE: Do NOT attempt to
  68.            compile this code as it is not valid Clarion code.)
  69.        14. Press <ALT F><S> to save the dictionary.
  70.        15. Press <F8> to load the Clarion Editor and load the
  71.            <AppName.CLA>.   This <AppName.CLA> contains the DCT listing.
  72.  
  73.    CAVEATS
  74.        1.  As mentioned above, remember that the CDD source code generator
  75.            generates the code into the file specified in 'Module Name'.
  76.            Should you enter an existing name, the original file is
  77.            over-written.
  78.        2.  Due to the manner in which code is generated via the template,
  79.            columnar output is NOT supported.  The first template
  80.            symbol provides a selected column position. However, due to
  81.            the string concatenation, subsequent symbol values are
  82.            output in relative position to the end of the previous symbol
  83.            output.  This yields a jagged output, particularly noticable
  84.            in the BRIEF listing.
  85.  
  86.    Feel free to distribute this template freely and/or modify it as
  87.    desired.
  88.  
  89.    Should you have any questions or comments regarding this template, feel
  90.    free to contact me via CompuServe (76200,2531) or the Clarion Software
  91.    Forum.
  92.  
  93.    Finally, I'll be the first to state this is not a perfect or optimal
  94.    solution, but the price is right AND its only intended to be a
  95.    temporary solution.
  96.  
  97.    cu, Sam
  98.