home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / d / dtu11b.zip / MANUAL.DOC < prev    next >
Text File  |  1993-03-26  |  160KB  |  5,456 lines
  1.  
  2.                              * Delta Tango(tm)/PRO *
  3.  
  4.                                LICENSE AGREEMENT
  5.  
  6.  
  7.  
  8.                                 Delta Tango(tm)
  9.  
  10.  
  11.  
  12.      The shareware version is NOT to considered in ANY way "free" or
  13.      "public domain", and NO distributor may advertise it as such.
  14.  
  15.      You are limited to a 30 day trail period for use of the shareware or
  16.      evaluation copy of Delta Tango(tm). If you decide to continue using
  17.      Delta Tango after an initial 30 day trail period, you MUST register
  18.      the Delta Tango program.
  19.  
  20.      You may not run Delta Tango(tm) on more than one computer at a time.
  21.      For example, you may keep a copy of Delta Tango(tm) on a work
  22.      computer, home computer, and on a laptop used for traveling purposes.
  23.      However, Delta Tango(tm) cannot be used on more than one computer
  24.      simultaneously without the purchase of additional licenses. One
  25.      license per computer.
  26.  
  27.      You may NOT share or distribute the registered copy of Delta
  28.      Tango(tm). You may NOT share or distribute the registered copy of
  29.      Delta Tango PRO or Delta Tango PRO User. However, Delta Tango PRO
  30.      DEMO may be freely distributed, and used on multiple computers.
  31.  
  32.  
  33.      THIS SOFTWARE PROGRAM AND DOCUMENTATION (Delta Tango(tm)), ARE BEING
  34.      OFFERED "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OR
  35.      MERCHANTABILITY. BY USING Delta Tango(tm), YOU ARE EXPRESSLY RELEASING
  36.      ENCOURAGER SOFTWARE AND THE AUTHOR, DAVID TROXELL, FROM ANY LIABILITY
  37.      RESULTING FROM THE USE OF THIS SOFTWARE AND DOCUMENTATION.
  38.  
  39.      THIS LIMITED WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS. YOU MAY HAVE
  40.      OTHERS WHICH MAY VARY FROM STATE TO STATE. SOME STATES DO NOT ALLOW
  41.      THE EXCLUSION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, OR THE
  42.      LIMITATION ON HOW LONG AN IMPLIED WARRANTY LASTS, SO SOME OF THE ABOVE
  43.      MAY NOT APPLY TO YOU.
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                              * Delta Tango(tm)/PRO *
  63.  
  64.  
  65.      Copyright  1992 by Encourager Software   All Rights Reserved
  66.  
  67.      This publication could possibly contain technical or typographical
  68.      errors. Encourager Software provides this publication, AS IS, without
  69.      warranty of any kind, either express or implied.
  70.  
  71.  
  72.  
  73.  
  74.      Trademark Acknowledgements:
  75.  
  76.      dBaseII, and dBaseIII are registered trademarks of Borland
  77.      International.
  78.  
  79.      Clarion, Clarionet, Clarion Professional Developer, and Clarion Report
  80.      Writer are trademarks of Clarion Software Corporation.
  81.  
  82.      CompuServe is a registered trademark of Compuserve Incorporated.
  83.  
  84.      Delta Tango and Delta Tango PRO are trademarks of Encourager Software.
  85.  
  86.      QSQL is a trademark of Cook Database Design, Inc.
  87.  
  88.      FoxPro is a trademark of Microsoft Corporation.
  89.  
  90.      Printed in the United States of America.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                              * Delta Tango(tm)/PRO *
  121.  
  122.                                   Foreword
  123.  
  124.      I would like to introduce you to this product by way of saying thanks
  125.      to just some of the people who have contributed ideas and products
  126.      to the Clarion community. Delta Tango/PRO is an integration of a lot
  127.      of the products and ideas mentioned.
  128.  
  129.  
  130.      Thanks
  131.  
  132.      My wife, Pamela, for her endless support in my endeavor to provide
  133.      some useful software for the Clarion community.
  134.  
  135.      Bruce Barrington, Chairman/CEO, Clarion Software Corporation
  136.  
  137.      (and all of the various employees of Clarion Software Corporation
  138.      who have contributed to the success through the years) for giving
  139.      us such a excellent Flagship product, Clarion Professional
  140.      Developer(tm). And thanks for continuing to develop more ground
  141.      shaking ideas.
  142.  
  143.      Clarionet(tm) Tech Support - For their wonderful example files, and
  144.      explanations of Clarion code, and especially to Paul, Tech 22, for his
  145.      RW_IN_DE.ZIP, integrating Report Writer reports into Designer
  146.      applications example, which was the initial catalyst for this project.
  147.  
  148.      Mike Hanson, Boxsoft Development, for SuperModels - Both Public Domain
  149.      and Commercial Versions.
  150.  
  151.      Jim and Cathy Cook, Cook Database Design, for their special "Q"
  152.      products, especially QSQL(tm).
  153.  
  154.      Dave Howington and his crew at Logix Development Corporation for
  155.      marketing LPM Link VM.
  156.  
  157.      RJ Dollard - RJ wrote a Sorter demo file (CSRT_DES.ZIP) for Clarion
  158.      users based upon my RW Shell example - RWSHEL11.ZIP (which was based
  159.      upon Paul, Tech 22's example). I took some of his basic ideas and
  160.      greatly expanded them for Delta Tango/PRO.
  161.  
  162.      FOO SAY HOW for his example in WARNA.ZIP, incorporating user defined
  163.      colors (which was based on Dale Hans - CHNGCOLR.ZIP example)
  164.  
  165.      Clarion Techies on FidoNet and RIMEnet - The Clarion echos on these
  166.      networks do not LACK for interesting discussions.
  167.  
  168.      Delta Tango Author,
  169.      Dave Troxell
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.                                        i
  177.  
  178.                              * Delta Tango(tm)/PRO *
  179.  
  180.                             Chapter 1. Introduction
  181.  
  182.      What is Delta Tango(tm)?....................................1-2
  183.  
  184.      What is Delta Tango PRO(tm)?................................1-3
  185.  
  186.      File Interchangeability.....................................1-3
  187.  
  188.      Networks....................................................1-4
  189.  
  190.      Manual Overview.............................................1-4
  191.  
  192.      Features Overview...........................................1-6
  193.  
  194.  
  195.  
  196.                             Chapter 2. Installation
  197.  
  198.      System Requirements.........................................2-2
  199.  
  200.      Installation................................................2-2
  201.  
  202.      Delta Tango(tm) SET.........................................2-3
  203.  
  204.      Temporary Files.............................................2-3
  205.  
  206.      DESQview Support Help.......................................2-3
  207.  
  208.      Getting Started.............................................2-4
  209.  
  210.      Files Created By Delta Tango(tm)/PRO........................2-6
  211.  
  212.  
  213.  
  214.                    Chapter 3. Delta Tango(tm)/PRO Terminology
  215.  
  216.      F1 - Help...................................................3-2
  217.  
  218.      Delta Tango PRO **PRO** ONLY................................3-2
  219.  
  220.      Editing Conventions.........................................3-2
  221.  
  222.      List/Update Form (Record)...................................3-2
  223.  
  224.      Delta Tango/PRO Conventions.................................3-3
  225.  
  226.      File Interchangeability.....................................3-3
  227.  
  228.      Clarion File Utility Extensions.............................3-4
  229.  
  230.      Sorter Operation Notes......................................3-4
  231.  
  232.      Special Test Mode **PRO** ONLY..............................3-5
  233.  
  234.                                        ii
  235.  
  236.                              * Delta Tango(tm)/PRO *
  237.  
  238.      Batch File Parameters.......................................3-5
  239.  
  240.      FILER.......................................................3-6
  241.  
  242.      SORTER......................................................3-6
  243.  
  244.      CONVERTER...................................................3-6
  245.  
  246.      Delta Tango(tm)/PRO Task List and Related File Utilities....3-7
  247.  
  248.  
  249.                  Chapter 4. Overview of Clarion File Utilities
  250.  
  251.      FILER.......................................................4-2
  252.  
  253.      CREATE Statement - "Memory Birds and Bees Talk".............4-2
  254.  
  255.  
  256.      "Corrupted Key File Caught - Story At Five".................4-2
  257.  
  258.      SORTER......................................................4-3
  259.  
  260.      RECLAIM Attribute - "Space Lease Option Available"..........4-4
  261.  
  262.      CONVERTER...................................................4-4
  263.  
  264.      "String Delimiter/Field Separator - Cite Irreconcilable
  265.      Differences"................................................4-5
  266.  
  267.      BASIC Source - Clarion File Definition Source -
  268.      "Anonymous Source"..........................................4-5
  269.  
  270.      Access To Other Clarion File Utility Programs...............4-6
  271.  
  272.  
  273.                           Chapter 5. Photogenic Tasks
  274.  
  275.      File Utilities - Task List..................................5-2
  276.  
  277.      Backup A Single File List...................................5-3
  278.  
  279.      Backup/Restore List For Single File.........................5-4
  280.  
  281.      New File Structure - Single File List.......................5-4
  282.  
  283.      Set Color Program...........................................5-5
  284.  
  285.      Menu for Manual Use of File Utilities.......................5-6
  286.  
  287.      DTU SQL Interactive User Interface for QSQL(tm) Program.....5-7
  288.  
  289.      SQL Task In Progress........................................5-8
  290.  
  291.  
  292.                                       iii
  293.  
  294.                              * Delta Tango(tm)/PRO *
  295.  
  296.  
  297.      ERROR Screens...............................................5-9
  298.  
  299.      Record Maintenance List.....................................5-10
  300.  
  301.      Manual File Utilities - Sorter, Filer, and Converter........5-11
  302.  
  303.      Creating Delta Tango(tm)/PRO Data Files.....................5-13
  304.  
  305.      FUTILS File Not Found - Create?.............................5-13
  306.  
  307.      Table is Empty. Do You Wish to Add....?.....................5-13
  308.  
  309.      Record Maintenance..........................................5-14
  310.  
  311.      Single File.................................................5-14
  312.  
  313.      Multiple File...............................................5-15
  314.  
  315.      Backup/Restore Locations....................................5-16
  316.  
  317.      Join Two Files..............................................5-16
  318.  
  319.      Conversion..................................................5-17
  320.  
  321.      SQL Expressions.............................................5-21
  322.  
  323.      Sorter Options..............................................5-22
  324.  
  325.  
  326.  
  327.                          Chapter 6. Record Maintenance
  328.  
  329.      HOW Does This Thing Work, Anyway?!..........................6-2
  330.  
  331.      Delta Tango(tm)/PRO To The Rescue!..........................6-3
  332.  
  333.      List Screens................................................6-4
  334.  
  335.      DOS Batch File for Single Backup (Sorter Task)..............6-5
  336.  
  337.      Limitations Of Characters On A DOS Prompt Line..............6-5
  338.  
  339.      PRO New File Structure - Single or Multiple - Limitations...6-5
  340.  
  341.      PRO Sorter Options - Limitations............................6-6
  342.  
  343.      Record Maintenance - Update Forms...........................6-7
  344.  
  345.      Single File.................................................6-7
  346.  
  347.      Multiple Files..............................................6-11
  348.  
  349.  
  350.                                        iv
  351.  
  352.                              * Delta Tango(tm)/PRO *
  353.  
  354.      Backup/Restore Locations....................................6-15
  355.  
  356.      Join Two Files..............................................6-16
  357.  
  358.      Conversion..................................................6-19
  359.  
  360.      SQL.........................................................6-21
  361.  
  362.      Sorter Options..............................................6-24
  363.  
  364.  
  365.                 Chapter 7. SQL - Support In Delta Tango(tm)/PRO
  366.  
  367.      QSQL(tm)....................................................7-2
  368.  
  369.      QSQL(tm) Support In Delta Tango(tm)/PRO.....................7-2
  370.  
  371.      Create New Clarion Databases Using SQL......................7-3
  372.  
  373.      DTU SQL Program.............................................7-3
  374.  
  375.      SQL Expression Update Form..................................7-5
  376.  
  377.      Fixing Date Problem With Fields With Long Type..............7-5
  378.  
  379.      SQL Update Form Field Entries...............................7-6
  380.  
  381.      File Utilities - Tasks - SQL Files List.....................7-9
  382.  
  383.      Removing OWNER ID/Encryption To Work With SQL...............7-9
  384.  
  385.  
  386.                                   Appendix  A
  387.  
  388.      Special Hints...............................................A-2
  389.  
  390.      Command Line................................................A-2
  391.  
  392.      Error Screens...............................................A-2
  393.  
  394.      Invalid Record Declaration..................................A-3
  395.  
  396.      Out of Memory Screen........................................A-3
  397.  
  398.      STOP Error Screens..........................................A-4
  399.  
  400.      Rebuilding Key Files........................................A-4
  401.  
  402.      Temporary Files.............................................A-4
  403.  
  404.      Date Problems With Conversion to dBase Files................A-5
  405.  
  406.      Assorted Utility Batch Files................................A-5
  407.  
  408.                                        v
  409.  
  410.                              * Delta Tango(tm)/PRO *
  411.  
  412.      Delta Tango(tm)/PRO Support.................................A-7
  413.  
  414.  
  415.  
  416.      Appendix  B - List of Figures
  417.  
  418.      Chapter 5...................................................B-1
  419.  
  420.      Chapter 6...................................................B-2
  421.  
  422.      Chapter 7...................................................B-3
  423.  
  424.      Note: Appendix B is not included in the disk file version of the
  425.      user's manual. Over 60 figures are included in the published
  426.      manual.
  427.  
  428.  
  429.      Glossary
  430.  
  431.  
  432.  
  433.      INDEX
  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.  
  463.  
  464.  
  465.  
  466.                                        vi
  467.  
  468.                              * Delta Tango(tm)/PRO *
  469.  
  470.                             Chapter 1. Introduction
  471.  
  472.      What is Delta Tango(tm)?....................................1-2
  473.  
  474.      What is Delta Tango PRO(tm)?................................1-3
  475.  
  476.      File Interchangeability.....................................1-3
  477.  
  478.      Networks....................................................1-4
  479.  
  480.      Manual Overview.............................................1-4
  481.  
  482.      Features Overview...........................................1-6
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.                                       1-1
  525.  
  526.                              * Delta Tango(tm)/PRO *
  527.  
  528.  
  529.  
  530.      What is Delta Tango(tm)?
  531.  
  532.      Automation for three of Clarion's file utilities, Filer, Sorter, and
  533.      Converter!
  534.  
  535.      Backup Clarion data files in a compressed format, and restore them,
  536.      one at a time or up to TEN at a time!
  537.  
  538.      Pack files, single or up to 10.
  539.  
  540.      Need to restructure data files to conform to an updated Clarion .exe?
  541.      Load the new source file and the .EXE on a Client's computer and with
  542.      a couple key presses, you are updated.
  543.  
  544.      Need to create new empty data files, again a couple key presses.
  545.  
  546.      Join Two Files, no problem!
  547.  
  548.      Convert Clarion files to other file formats. It's as easy as filling
  549.      in some filenames and format types, and pressing a few keys.
  550.  
  551.      Easy to use interface for the utilities.
  552.  
  553.      You accomplish this, and much more, with some initial record
  554.      maintenance, but that information is stored to be used again and
  555.      again, modified or copied at will. No more batch file writing!
  556.  
  557.      Convert Clarion to other formats, and other formats to Clarion files.
  558.  
  559.      Why work with batch files or manually work the file utilities when
  560.      you can enter just the essential information into a Clarion record,
  561.      and let it do some batch file writing for you. Very easy to use!
  562.  
  563.      Delta Tango(tm) provides an automated interface for the three file
  564.      utilities mentioned. It cannot accomplish any more than the three file
  565.      utilities are capable of, however, it does it in a very useful,
  566.      repeatable way.
  567.  
  568.      Think of Delta Tango(tm) as a automated batch file writer for Sorter,
  569.      Filer, and Converter that's as easy as filling in filenames, and other
  570.      parameters.
  571.  
  572.      It also provides a shell interface for QSQL(tm), including the
  573.      automated conversion of a SQL query to a workable Clarion data file.
  574.      This is OPTIONAL and a separate license MUST be purchased from Cook
  575.      Database Design if you desire to use the interface and automated
  576.      conversion.
  577.  
  578.      The Clarion file utilities are a wonderful set of tools, and provide
  579.      great usefulness, but there can be many repetitive tasks during the
  580.      development stage of a Clarion database project that can only be
  581.  
  582.                                       1-2
  583.  
  584.                              * Delta Tango(tm)/PRO *
  585.  
  586.      accomplished by use of numerous DOS batch files to automate the use of
  587.      the file utilities, or manual manipulation of file utilities. Delta
  588.      Tango(tm) is an attempt to provide a standard common interface to the
  589.      utilities with the emphasis on automating tasks.
  590.  
  591.      In addition, Delta Tango(tm) provides primarily these functions for
  592.      the QSQL(tm) program.
  593.  
  594.      1. A Interactive User Interface to QSQL(tm) Use of the interface can
  595.      be called from within Delta Tango(tm) or from the dos prompt -
  596.      DTUSQL.EXE.
  597.  
  598.      2. Online summary help while using the shell interface. Lots of
  599.      examples, SQL expression commands, etc.
  600.  
  601.      3. Automate converting an SQL query to a usable Clarion file.
  602.  
  603.      4. If you have used the Update clause in SQL, a Delta Tango(tm) Filer
  604.      task can be run if you have updated a field that has a key on it.
  605.  
  606.      What is Delta Tango PRO(tm)?
  607.  
  608.      This is an enhanced version of Delta Tango(tm) and consists of two
  609.      programs, Delta Tango PRO(tm) and Delta Tango PRO(tm) User.
  610.  
  611.                     * Delta Tango PRO(tm) * **PRO** ONLY
  612.  
  613.      The manual is written to include support for both the Delta Tango(tm)
  614.      program and the Delta Tango PRO(tm) program. You will sometimes see a
  615.      **PRO** ONLY prompt to alert you to a feature available only to the
  616.      Delta Tango PRO(tm) program.
  617.  
  618.      Delta Tango PRO(tm) User is for developers who have not developed a
  619.      file utility section of their own to sell to clients, and would like a
  620.      ready made product. It restricts the users to only carrying out the
  621.      file utility tasks, with no access to configuring the tasks to provide
  622.      a little more security for you.
  623.  
  624.      You can use Delta Tango PRO(tm) to develop File Utility tasks for the
  625.      User program or run Delta Tango PRO(tm) by itself. And it provides
  626.      more advanced features for automated tasks during the development
  627.      stages.
  628.  
  629.      Some developers have already included support for the file utilities
  630.      inside their programs, or need more customization than is provided
  631.      for by Delta Tango PRO(tm). Is it still useful?
  632.  
  633.      YES, definitely during development stages for the developer. Here's
  634.      just some of the benefits you'll gain from using the PRO version.
  635.  
  636.      1. With the PRO version, you could keep ALL your source (file
  637.      definition) files in one subdirectory location, regardless of the
  638.      project. **PRO** ONLY
  639.  
  640.                                       1-3
  641.  
  642.                              * Delta Tango(tm)/PRO *
  643.  
  644.      2. Pass the Owner ID to Filer (Sorter, or Converter) without using
  645.      batch files. **PRO** ONLY
  646.  
  647.      3. With the OPTIONAL QSQL(tm) program, create subsets of your data to
  648.      work with easily. Easily automate the process of removing Owner
  649.      ID/Encryption from your files to work with the QSQL(tm) program and
  650.      then adding Owner ID/Encryption again. And, instead of writing batch
  651.      files to convert your query into a usable Clarion file, let Delta
  652.      Tango PRO(tm) help you automate the conversion.
  653.  
  654.      4. With the Sorter Options section, automate up to 4 sort parameters
  655.      and/or join up to 4 files. Instead of writing batch files or manually
  656.      using Sorter, you can save each setup. Copy them, modify, easily
  657.      access these setups. **PRO** ONLY
  658.  
  659.      5. Instead of writing batch files, or manually manipulating the file
  660.      utilities, you can save important batch parameters in Clarion files
  661.      that can be easily recalled, copied, modified, etc. Both the regular
  662.      and the PRO versions offer this, but the PRO program provides more
  663.      features to automate the process even further and save you time. A
  664.      special Test (**PRO** ONLY) mode is provided to track problems of
  665.      entering the wrong parameter information.
  666.  
  667.                            File Interchangeability
  668.  
  669.      Data files produced by Delta Tango(tm) or Delta Tango PRO(tm) are
  670.      completely interchangeable with all Delta Tango PRO(tm)grams. However,
  671.      a Retain Deletions choice made in PRO is not available in Delta
  672.      Tango(tm).
  673.  
  674.      You may decide to go with Delta Tango(tm) initially, and upgrade to
  675.      Delta Tango PRO(tm). Your data files are completely usable, and with
  676.      the PRO version you may add the new parameters as desired.
  677.  
  678.                                   Networks
  679.  
  680.      The initial release will be for single computer use only, and is not
  681.      available currently in a Network version. A future release will
  682.      incorporate network features.
  683.  
  684.                                Manual Overview
  685.  
  686.      Chapter 1 - Introduction
  687.  
  688.      You are reading this chapter now. Basic description of the program
  689.      in general terms, with a summary feature overview.
  690.  
  691.      Chapter 2 - Installation
  692.  
  693.      Introduction to system requirements and installing the program. Be
  694.      sure to read about temporary files while installing the program. This
  695.      is a very important concept to the program.
  696.  
  697.  
  698.                                       1-4
  699.  
  700.                              * Delta Tango(tm)/PRO *
  701.  
  702.      Chapter 3 - Delta Tango(tm)/PRO Terminology
  703.  
  704.      Introduces you to Delta Tango(tm)/PRO specifics and how they relate to
  705.      the utilities.
  706.  
  707.      Chapter 4 - Overview of Clarion File Utilities
  708.  
  709.      This is an abbreviated discussion about how the utilities operate,
  710.      some suggestions for program development, and how Delta Tango(tm)/PRO
  711.      operations interact with the utilities.
  712.  
  713.      Chapter 5 - Photogenic Tasks
  714.  
  715.      This whole chapter is devoted to screen shots of the program with
  716.      abbreviated comments. A lot of example tasks are shown. This would
  717.      be a good chapter to browse through after the introduction and
  718.      installation chapters before referring to more intense chapters.
  719.  
  720.      Chapter 6 - Record Maintenance
  721.  
  722.      This chapter is loaded with detailed field by field instructions for
  723.      the update forms. A good reference chapter for completing records.
  724.      Couple this with chapter 5 for a good idea how to complete most tasks.
  725.  
  726.      Chapter 7 - SQL
  727.  
  728.      This chapter gives you detailed information about using the QSQL(tm)
  729.      (Optional) program with Delta Tango(tm)/PRO. This is still no
  730.      substitute for learning SQL. Use the tutorial documents included with
  731.      QSQL(tm) for an easy learning curve.
  732.  
  733.      Appendix A
  734.  
  735.      Includes information about error screens, rebuilding key files,
  736.      temporary files, date problems with conversion to dBase files,
  737.      assorted utility batch files and support.
  738.  
  739.      Appendix B
  740.  
  741.      List of Figures
  742.  
  743.      Glossary
  744.  
  745.      Most Delta Tango(tm)/PRO terms are defined here for easy reference.
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.                                       1-5
  757.  
  758.                              * Delta Tango(tm)/PRO *
  759.  
  760.                               * Features Overview *
  761.  
  762.      Delta Tango(tm)/PRO is divided into basically two sections, Tasks
  763.      (File Utilities) and Record Maintenance for the Tasks. Tasks are the
  764.      actual file operations. First, you must complete the minimal
  765.      information needed to complete the task in a update form in the record
  766.      maintenance section.
  767.  
  768.      NOTE: All Sorter operations (Backup, Restore, and Join Two Files)
  769.      in the regular Delta Tango(tm) Program, by default, do NOT retain
  770.      deletions. Only the PRO program offers a choice.
  771.  
  772.      TASKS
  773.  
  774.      1. Backup Single File
  775.  
  776.              **PRO** ONLY
  777.  
  778.              Owner ID/Retain Deletions Choice
  779.  
  780.      2. Backup Multiple
  781.  
  782.              **PRO** ONLY
  783.  
  784.              Global Owner ID/Retain Deletions Choice
  785.  
  786.      3. Restore Single
  787.  
  788.              **PRO** ONLY
  789.  
  790.              Owner ID/Retain Deletions Choice
  791.  
  792.      4. Restore Multiple
  793.  
  794.              **PRO** ONLY
  795.  
  796.              Global Owner ID/Retain Deletions Choice
  797.  
  798.      5. Pack Single
  799.  
  800.              **PRO** ONLY
  801.  
  802.              Owner ID
  803.  
  804.      6. Pack Multiple
  805.  
  806.              **PRO** ONLY
  807.  
  808.              Global Owner ID
  809.  
  810.      7. Join 2 Files
  811.  
  812.              **PRO** ONLY
  813.  
  814.                                       1-6
  815.  
  816.                              * Delta Tango(tm)/PRO *
  817.  
  818.              Owner ID/Retain Deletions Choice
  819.  
  820.      8. New File Structure - Single
  821.  
  822.          a. New file structure
  823.  
  824.          b. Create empty file structure
  825.  
  826.              **PRO** ONLY
  827.  
  828.              Owner ID/Rename File/Source Location
  829.  
  830.      9. New File Structure - Multiple
  831.  
  832.          a. New file structure
  833.  
  834.          b. Create empty file structure
  835.  
  836.              **PRO** ONLY
  837.  
  838.              Global Owner ID/Global Source Location
  839.  
  840.      A. Convertor
  841.  
  842.          a. Convert Clarion to DIF file.
  843.  
  844.          b. Convert Clarion to BASIC file.
  845.  
  846.          c. Convert Clarion to dBase2 file.
  847.  
  848.          d. Convert Clarion to dBase3 file.
  849.  
  850.          e. Convert dbase to Clarion
  851.  
  852.          f. Convert DIF to Clarion
  853.  
  854.          g. Convert BASIC to Clarion
  855.  
  856.      **PRO** ONLY
  857.  
  858.      Owner ID
  859.  
  860.      B. SQL Files
  861.  
  862.      Use QSQL(tm) expressions to create new Clarion databases.
  863.  
  864.      Output is converted to BASIC file, then Filer run to make a usable
  865.      Clarion data file in a very automated process.
  866.  
  867.                   Three ways to make new Clarion databases.
  868.  
  869.      1. Run DTUSQL program, load an sql expression, then return to Delta
  870.      Tango(tm), use in a SQL Update form and then run SQL task.
  871.  
  872.                                       1-7
  873.  
  874.                              * Delta Tango(tm)/PRO *
  875.  
  876.      2. Rename a DTUSQL.IN query and use in SQL Task update form, and then
  877.      run SQL task.
  878.  
  879.      3. Write an QSQL(tm) expression in the SQL update form and then run
  880.      SQL task.
  881.  
  882.              **PRO** ONLY
  883.  
  884.              Source Location
  885.  
  886.      C. Set user colors
  887.  
  888.      D. Sorter Options **PRO** ONLY
  889.  
  890.          a. Join as many as 4 files at one time.
  891.  
  892.          b. Create as many as 4 physical sorts.
  893.  
  894.          c. Optionally choose yes or no for the following.
  895.  
  896.              Compress file
  897.  
  898.              Retain deletions
  899.  
  900.              Remove key files
  901.  
  902.          d. Owner ID supported
  903.  
  904.      E. Manual Utils - Ability to use Clarion File Utilities in a Manual
  905.      Mode called from within the Delta Tango(tm) Program.
  906.  
  907.      Delta Tango(tm)
  908.  
  909.         Sorter
  910.  
  911.         Filer
  912.  
  913.         Converter
  914.  
  915.      Delta Tango PRO(tm)
  916.  
  917.         Sorter
  918.  
  919.         Filer
  920.  
  921.         Converter
  922.  
  923.         * Scanner
  924.  
  925.         * Editor
  926.  
  927.         ! Report Writer(tm)
  928.  
  929.  
  930.                                       1-8
  931.  
  932.                              * Delta Tango(tm)/PRO *
  933.  
  934.         * Director
  935.  
  936.         * Helper
  937.  
  938.         * Must own Clarion Professional Developer(tm) to access.
  939.  
  940.         ! Must own Clarion Report Writer(tm) to access.
  941.  
  942.      F. DTU SQL Program
  943.  
  944.      Shell interface to QSQL(tm) program including ONLINE Help! Can be
  945.      called from within the Delta Tango(tm)/PRO program.
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.                                       1-9
  989.  
  990.                              * Delta Tango(tm)/PRO *
  991.  
  992.                             Chapter 2. Installation
  993.  
  994.      System Requirements.........................................2-2
  995.  
  996.      Installation................................................2-2
  997.  
  998.      Delta Tango(tm) SET.........................................2-3
  999.  
  1000.      Temporary Files.............................................2-3
  1001.  
  1002.      DESQview Support Help.......................................2-3
  1003.  
  1004.      Getting Started.............................................2-4
  1005.  
  1006.      Files Created By Delta Tango(tm)/PRO........................2-6
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.                                       2-1
  1047.  
  1048.                              * Delta Tango(tm)/PRO *
  1049.  
  1050.                             * System Requirements *
  1051.  
  1052.      An IBM PC, XT, AT, PS/2, or 100% Compatible
  1053.  
  1054.      An IBM or MS DOS 3.0 or higher operating system
  1055.  
  1056.      At least 512KB of memory (640K when running the SQL program)
  1057.  
  1058.      NOTE: After allowances for DOS, Menu program, etc. you should have
  1059.      440K of memory free before starting Delta Tango (as much as possible
  1060.      when running the SQL program)
  1061.  
  1062.      This may be higher if running under a Desqview or Windows environment.
  1063.  
  1064.      One Double-sided diskette drive and one hard disk (approximately 2
  1065.      Megabytes free)
  1066.  
  1067.      A Color or Monochrome monitor
  1068.  
  1069.      A Mouse is NOT supported at this time, but will appear in a future
  1070.      version.
  1071.  
  1072.      Clarion File Utilities - Filer, Sorter, and Converter - Version 2
  1073.      or higher (2.18A included).
  1074.  
  1075.      QSQL(tm) - Version 2.0 or higher - OPTIONAL program - MUST buy a
  1076.      separate license to use.
  1077.  
  1078.                                *  Installation *
  1079.  
  1080.      Please, make backups of your original disks and install from the
  1081.      backups. PLEASE!
  1082.  
  1083.      Place Program Disk 1 in your A or B floppy drive. At the A: or B:
  1084.      DOS prompt, type 'install' (without the quotes). Follow the prompts
  1085.      on screen. The install program will give you a choice of copying the
  1086.      files to a particular hard drive. It will, however, copy these files
  1087.      to a subdirectory named - 'TESTDTU' after it creates the subdirectory.
  1088.  
  1089.      This will allow you to initially test the program with the sample
  1090.      files. BUT, you will want to move some of the files (Delta Tango SET)
  1091.      to a subdirectory in your DOS path on a more permanent basis.
  1092.  
  1093.      Most of the time, Delta Tango/PRO works with the files in the current
  1094.      subdirectory. In order for Delta Tango/PRO to do this, you must keep
  1095.      one SET of the following files in a subdirectory in your DOS path.
  1096.  
  1097.      For Owners of Clarion Professional Developer(tm), the Clarion
  1098.      Subdirectory would be a good place to keep these files. The Clarion
  1099.      file utilities should already be available in the Clarion directory.
  1100.  
  1101.  
  1102.  
  1103.  
  1104.                                       2-2
  1105.  
  1106.                              * Delta Tango(tm)/PRO *
  1107.  
  1108.                                 Delta Tango SET
  1109.  
  1110.      DTU.EXE (or DTUP.EXE and DTUPE.EXE if you own the PRO version),
  1111.      DTU.HLP and SETEC.EXE.
  1112.  
  1113.      Also, the Clarion file utilities -
  1114.  
  1115.      CFIL.EXE  CFIL.HLP  CCVT.EXE  CCVT.HLP  CRST.EXE  CRST.HLP
  1116.  
  1117.      NOTE: The six file utilities are installed to the TESTDTU subdirectory
  1118.      during the initial installation procedure. If these files are already
  1119.      installed on your hard drive in a DOS pathed subdirectory, delete
  1120.      these six files from the TESTDTU subdirectory.
  1121.  
  1122.      If you have bought the optional SQL program, include these files as
  1123.      well in the pathed subdirectory - SQL.EXE and DTUSQL.EXE
  1124.  
  1125.      1. To check for pathed subdirectories, type 'path' (without the
  1126.      quotes) at any DOS prompt. If the DOS prompt says 'No Path', you must
  1127.      add at least one subdirectory in a path statement. It is best to put
  1128.      this path statement in your autoexec.bat. Refer to your DOS manual for
  1129.      details. Optional - You may need to reboot the computer in order for
  1130.      the pathed directory to be usable.
  1131.  
  1132.      2. Copy the Delta Tango SET of files into your pathed subdirectory.
  1133.  
  1134.      3. Use DOS commands to change to the TESTDTU subdirectory and type
  1135.      'dtu' (without the quotes) or 'dtup' if you have bought the PRO
  1136.      version. Review the examples, or configure some of your own.
  1137.  
  1138.      5. Now, you can type 'dtu' or 'dtup' (**PRO** ONLY) at the DOS prompt
  1139.      in any subdirectory you have Clarion data files and begin automated
  1140.      use of the three Clarion file utilities - Sorter, Filer, or Converter.
  1141.  
  1142.      Or, if you use a DOS menu program, and you want to access a certain
  1143.      Clarion data subdirectory on a regular basis, you could configure
  1144.      the menu selection to start the Delta Tango/PRO program.
  1145.  
  1146.                               Temporary Files
  1147.  
  1148.      When a task is being completed, or you are running one of the
  1149.      utilities in a manual mode, a temporary file on the hard disk is
  1150.      created, and then after the operation is finished, the file is
  1151.      deleted. This file will be approximately 400K or larger. Also, about
  1152.      8K RAM of conventional memory is used as well.
  1153.  
  1154.      Using a RAM disk for the temporary files will speed up the operation,
  1155.      and help keep your hard disk from becoming fragmented. Also, if you
  1156.      loose power during a Delta Tango task, the temporary file will remain
  1157.      on the hard disk, wasting space. Using a RAM disk alleviates this
  1158.      problem.
  1159.  
  1160.      Use this DOS SET command before entering the Delta Tango/PRO program.
  1161.  
  1162.                                       2-3
  1163.  
  1164.                              * Delta Tango(tm)/PRO *
  1165.  
  1166.      A good place to keep your SET command is in your autoexec.bat file.
  1167.  
  1168.      i.e. SET CLATMP=E:\
  1169.  
  1170.      E is the name of the RAM drive in this example, substitute yours.
  1171.  
  1172.      It is recommended your RAM drive be at least 512K in size. It may
  1173.      need to be more under a Desqview or Windows environment.
  1174.  
  1175.                              DESQview Support Help
  1176.  
  1177.      Delta Tango automatically detects and supports the DESQview
  1178.      environment.
  1179.  
  1180.      The "Video time-out" and "beep" features are disabled
  1181.      automatically.
  1182.  
  1183.      Two command line switches are available at the DOS prompt for starting
  1184.      Delta Tango under DESQview.
  1185.  
  1186.      DTU L=YES
  1187.  
  1188.      (will force keyboard locks)
  1189.  
  1190.      DTU B=YES
  1191.  
  1192.      (will force beeps)
  1193.  
  1194.      NOTE - Substitute DTUP for Delta Tango PRO/ DTUPE for Delta Tango
  1195.      PRO User
  1196.  
  1197.                                 Getting Started
  1198.  
  1199.      List refers to the Clarion term - Table, and Update Form refers to
  1200.      the Clarion term, Record. They are used interchangeably.
  1201.  
  1202.      These are some general hints on using the program. If you are familiar
  1203.      with using the Clarion utilities, you should be able to use Delta
  1204.      Tango in a productive way in a fairly short time. If not, after
  1205.      installing the program, read chapter 4. Then, browse the examples in
  1206.      chapter 5, (and/or look at some of the examples given with the install
  1207.      disk). Refer to Chapter 6 for more detailed information on filling in
  1208.      the update forms.
  1209.  
  1210.      Think of the Delta Tango/PRO program as two main sections -
  1211.  
  1212.      A File Utilities (Tasks) section - The actual file operation is run
  1213.      from this section.
  1214.  
  1215.      A Record Maintenance section - You need to complete the fields in
  1216.      a update form, FIRST, in order to perform a task in the file utilities
  1217.      section.
  1218.  
  1219.  
  1220.                                       2-4
  1221.  
  1222.                              * Delta Tango(tm)/PRO *
  1223.  
  1224.      Chapters 1, 2 and 5 would be good chapters to read first. Since 5
  1225.      is mostly screen shots, you'll do more browsing, then reading, but
  1226.      the examples will help you design your own tasks.
  1227.  
  1228.      Preview the sample files that were provided with the install disk
  1229.      (s), or copy some of your own data files to a test directory, and
  1230.      start the program. Menu selections are chosen by pressing the first
  1231.      number or letter of the selection or by highlighting the selection
  1232.      and pressing Enter.
  1233.  
  1234.                               MONOCHROME Monitors
  1235.  
  1236.      NOTE: If you are using a monochrome monitor and the List (Table)
  1237.      selections do not show a highlight, delete the COLOR.DAT file in the
  1238.      current subdirectory (however, save the COLOR.DAT originally supplied
  1239.      with the program for work with color monitors for a standard color
  1240.      reference). The program will create a default COLOR.DAT that should
  1241.      show List highlighting on a monochrome monitor. Menu selection
  1242.      highlighting may not show on a monochrome monitor, but you still can
  1243.      use a number or letter to choose a selection.
  1244.  
  1245.      Go to the record maintenance section.
  1246.  
  1247.      If you start with the program with no FUTILS.DAT in the test
  1248.      subdirectory, you will be greeted with at least two messages.
  1249.  
  1250.      'FUTILS File not found! Do you want to create it?' Press y for yes
  1251.      and Enter.
  1252.  
  1253.      At any List (table) screen that is empty, you will get this message.
  1254.  
  1255.      'This Table is empty. Do you wish to add a record?' Press y for yes
  1256.      and Enter.
  1257.  
  1258.      Use the examples in Chapter 5 to enter information about your files
  1259.      and/or use Chapter 6 for more details about filling in the update
  1260.      forms.
  1261.  
  1262.      When you complete an update form, escape back to the File Utilities
  1263.      menu. Select a task. Most are run by choosing a Task list,
  1264.      highlighting the task description, and pressing F7. As the task is
  1265.      being completed, you will see a flashing task name.
  1266.  
  1267.      The backup and restore tasks add one more step. After highlighting
  1268.      the task, and pressing F7, you will be presented with a Locations
  1269.      List. Highlight the proper location and press Enter. Your locations
  1270.      List must have a valid DOS name. The data file will copied and
  1271.      compressed to the destination you chose.
  1272.  
  1273.      The backup and restore tasks are NOT intended as a substitute for
  1274.      a good standalone DOS backup program. Delta Tango/PRO does not compute
  1275.      the available hard disk space or floppy disk space (nor will it prompt
  1276.      you for additional floppy disks). So you will need to estimate in
  1277.  
  1278.                                       2-5
  1279.  
  1280.                              * Delta Tango(tm)/PRO *
  1281.  
  1282.      advance if your destination location has enough available space to
  1283.      complete the task. At present, only the capabilities of the file
  1284.      utilities are used to complete the tasks.
  1285.  
  1286.      However, you can accomplish several useful functions with these tasks.
  1287.  
  1288.      These include:
  1289.  
  1290.      1. Send all your data files to one subdirectory in a compressed
  1291.      format. Then, using a standalone DOS backup program, backup this
  1292.      subdirectory. This could possibly save in the number of disks or tapes
  1293.      needed to backup the data files.
  1294.  
  1295.      2. For distribution purposes. If Delta Tango/PRO is not available
  1296.      on the restoration computer, you could rename the compressed files
  1297.      before sending them, since Delta Tango/PRO uses a .CBK extension.
  1298.      You can do this by giving the following command at the DOS prompt.
  1299.  
  1300.      'rename *.cbk *.dat' (without the quotes)
  1301.  
  1302.                       Files Created By Delta Tango(tm)/PRO
  1303.  
  1304.      The following files are created by Delta Tango(tm)/PRO, the Set Color
  1305.      program, or DTU SQL program.
  1306.  
  1307.      Files created by the Delta Tango(tm)/PRO program.
  1308.  
  1309.      FUTILS.DAT  Data File - contains batch file parameters
  1310.  
  1311.      FUTILS.K01  K01 - K07 are Key Files
  1312.      FUTILS.K02
  1313.      FUTILS.K03
  1314.      FUTILS.K04
  1315.      FUTILS.K05
  1316.      FUTILS.K06
  1317.      FUTILS.K07
  1318.  
  1319.      File produced by the Set Color program - SETEC.EXE.
  1320.  
  1321.      COLOR.DAT   Data file - contains color definition.
  1322.  
  1323.      When the OPTIONAL QSQL(tm) program is bought, the DTU SQL program
  1324.      produces the following files.
  1325.  
  1326.      DTUFILE.DAT Data file - contains SQL queries
  1327.  
  1328.      DTUFILE.K01 Key file
  1329.  
  1330.      DTUSQL.IN   ascii file - contains last run query
  1331.  
  1332.      Any other files produced are the result of the file utility programs
  1333.      or temporary files that did not get erased after the task operation.
  1334.  
  1335.  
  1336.                                       2-6
  1337.  
  1338.                              * Delta Tango(tm)/PRO *
  1339.  
  1340.                    Chapter 3. Delta Tango(tm)/PRO Terminology
  1341.  
  1342.      F1 - Help...................................................3-2
  1343.  
  1344.      Delta Tango PRO **PRO** ONLY................................3-2
  1345.  
  1346.      Editing Conventions.........................................3-2
  1347.  
  1348.      List/Update Form (Record)...................................3-2
  1349.  
  1350.      Delta Tango/PRO Conventions.................................3-3
  1351.  
  1352.      File Interchangeability.....................................3-3
  1353.  
  1354.      Clarion File Utility Extensions.............................3-4
  1355.  
  1356.      Sorter Operation Notes......................................3-4
  1357.  
  1358.      Special Test Mode **PRO** ONLY..............................3-5
  1359.  
  1360.      Batch File Parameters.......................................3-5
  1361.  
  1362.      FILER.......................................................3-6
  1363.  
  1364.      SORTER......................................................3-6
  1365.  
  1366.      CONVERTER...................................................3-6
  1367.  
  1368.      Delta Tango(tm)/PRO Task List and Related File Utilities....3-7
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.                                       3-1
  1395.  
  1396.                              * Delta Tango(tm)/PRO *
  1397.  
  1398.                                  * F1 - Help *
  1399.  
  1400.      Online help is available at MOST screens by pressing the function
  1401.      key, F1.
  1402.  
  1403.                         * Delta Tango PRO * **PRO** ONLY
  1404.  
  1405.      The manual is written to include support for both the Delta Tango
  1406.      program and the Delta Tango PRO program. You will sometimes see a
  1407.      **PRO** ONLY prompt to alert you to a feature available only to the
  1408.      Delta Tango PRO program.
  1409.  
  1410.                             * Editing Conventions *
  1411.  
  1412.      Delta Tango/PRO consists primarily of four screen Types.
  1413.  
  1414.      Menu - Select Lists to carry out tasks, record maintenance, and choose
  1415.      other menu selections.
  1416.  
  1417.      Lists - Presents an indexed list or table of update forms. At this
  1418.      level, update forms (records) can be added, changed, copied, or
  1419.      deleted.
  1420.  
  1421.      Update Forms (records) - This is where the actual information is
  1422.      stored for the database.
  1423.  
  1424.      Information Screens - Help screens and screens to let you know a task
  1425.      is being performed.
  1426.  
  1427.      Screen will blank out after about 10 minutes of inactivity, press
  1428.      space key once to resume.
  1429.  
  1430.                                  List Screen
  1431.  
  1432.      Keys for moving selector bar -
  1433.  
  1434.         PgDn    Scrolls down one screen.
  1435.  
  1436.         PgUp    Scrolls up one screen.
  1437.  
  1438.         ^PgDn   Scrolls to last record in the list.
  1439.  
  1440.         ^PgUp   Scrolls to the first record in the list.
  1441.  
  1442.         End     Scrolls to last record on screen.
  1443.  
  1444.         Home    Scrolls to first record on screen.
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.                                       3-2
  1453.  
  1454.                              * Delta Tango(tm)/PRO *
  1455.  
  1456.                            Keys for record operations
  1457.  
  1458.      Symbol  Key     Operation
  1459.  
  1460.      +       Insert  Add a new record.
  1461.  
  1462.      -       Delete  Delete the highlighted record. Highlighted record is
  1463.                      shown, the press enter to delete.
  1464.  
  1465.      *       Enter   Change the highlighted record. 
  1466.  
  1467.      C       F7      Copy record. Highlight record and press F7
  1468.  
  1469.      M       ^m      Add Multiple records - Control + m
  1470.  
  1471.      + - * C M are Symbols ONLY - Cannot be used for action.
  1472.  
  1473.      ^ - Control Key (used in combination with others)
  1474.  
  1475.                               Update Form (Record)
  1476.  
  1477.      To advance forward one field, use the Enter, Tab or Down Arrow key.
  1478.      To backup one field, use the Esc, Shift + Tab, or Up Arrow key.
  1479.  
  1480.      Insert key may be used in text fields.
  1481.  
  1482.      To delete a whole text field, use Control + End Key combination from
  1483.      leftmost position.
  1484.  
  1485.      To save a record at any field, press Control + Enter or F10. However,
  1486.      minimally one field will be required and must be filled in before
  1487.      saving.
  1488.  
  1489.      To escape without saving, press Control + Escape or F2. At the prompt
  1490.      'Save changes', press 'y' for save changes, press 'n' for escape
  1491.      without saving changes, or press 'c' for cancel.
  1492.  
  1493.                                   Locate Field
  1494.  
  1495.      On each of the list screens, there is a Locate field at the top. This
  1496.      will assist you in finding a particular record more readily. To use,
  1497.      type in the first couple letters of the Task description.
  1498.  
  1499.                           Delta Tango/PRO Conventions
  1500.  
  1501.                           * File Interchangeability *
  1502.  
  1503.      Data files produced by Delta Tango or Delta Tango PRO are completely
  1504.      interchangeable with all Delta Tango programs.
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.                                       3-3
  1511.  
  1512.                              * Delta Tango(tm)/PRO *
  1513.  
  1514.      You may decide to go with Delta Tango initially, and upgrade to Delta
  1515.      Tango PRO. Your data files are completely usable, and with the PRO
  1516.      version you may add the new parameters as desired.
  1517.  
  1518.      Also, configurations developed with the PRO model work fine with
  1519.      regular Delta Tango, BUT you will lack the PRO parameters. For
  1520.      instance, on single files in the PRO version, you can rename the
  1521.      output file for Backup, Restore, Pack and New File Structure. Any
  1522.      single file tasks run on the regular version after PRO Task
  1523.      development will have an output name the same as the input name.
  1524.  
  1525.      One important note on exchanging data files between Delta Tango
  1526.      programs. In the PRO version, you have a retain deletions choice for
  1527.      all Sorter operations. However, if you run a PRO developed Sorter task
  1528.      with Retain Deletions - Yes on a regular Delta Tango program, any
  1529.      deletions will be permanently removed, NO questions asked! Course, why
  1530.      anyone would want to go back to the regular Delta Tango version, after
  1531.      using the PRO version will be talked about in Clarion circles for
  1532.      years.
  1533.  
  1534.                         Clarion File Utility Extensions
  1535.  
  1536.      Delta Tango/PRO uses most of the default extensions of the Clarion
  1537.      file utilities. These include:
  1538.  
  1539.         .CLA    -   Source Files (file definitions)
  1540.  
  1541.         .DAT    -   Data Files
  1542.  
  1543.         .BAS    -   BASIC (ascii delimited) files for conversion to BASIC.
  1544.  
  1545.         .DBF    -   dBase Files
  1546.  
  1547.         .DIF    -   DIF files
  1548.  
  1549.         .TMP    -   Source File created during certain Converter tasks.
  1550.  
  1551.      An exception to a default extension is the backup and restoration
  1552.      tasks. Delta Tango/PRO assigns an extension of .CBK to files that
  1553.      have been compressed. And it expects to see a .CBK extension in order
  1554.      to restore as well.
  1555.  
  1556.      This makes it easier to recognize data files that have been compressed
  1557.      by Sorter. If you want to restore Clarion data files that were
  1558.      compressed using Sorter and do not have a .CBK extension, merely
  1559.      rename the file with a .CBK extension.
  1560.  
  1561.                              Sorter Operation Notes
  1562.  
  1563.      All Sorter operations - Backup, Restore, Pack, and Join Two Files,
  1564.      in the regular Delta Tango version, by default, do NOT retain
  1565.      deletions.
  1566.  
  1567.  
  1568.                                       3-4
  1569.  
  1570.                              * Delta Tango(tm)/PRO *
  1571.  
  1572.      Backup operations utilize the compress file option by default for
  1573.      both the regular Delta Tango and PRO versions.
  1574.  
  1575.      **PRO** ONLY - ALL Sorter operations in the PRO version include a
  1576.      yes/no choice to retain deletions.
  1577.  
  1578.      **PRO** ONLY - Pack, obviously, doesn't make any sense if you want
  1579.      to retain deletions, since it's main function is to get rid of record
  1580.      deletions permanently. However, a single form is used to store file
  1581.      information about backup, restore, pack, and new file structures for
  1582.      your convenience. If your end user accidentally chose to pack a single
  1583.      file, or multiple file set, and you had configured that file or
  1584.      multiple file set to retain deletions, the Pack task in the PRO
  1585.      version will NOT remove the record deletions. This is a safeguard for
  1586.      your choices.
  1587.  
  1588.                         Special Test Mode - **PRO** ONLY
  1589.  
  1590.      **PRO** ONLY - A special test mode to track down problems of entering
  1591.      the wrong parameter information. The Clarion file utilities not only
  1592.      do tasks well, but help you tremendously to input the correct
  1593.      information while manually manipulating the programs. In Delta
  1594.      Tango/PRO, you are developing automated batch processes, and the
  1595.      program doesn't know if you misspelled a filename.
  1596.  
  1597.      However, one very important batch parameter for each file utility
  1598.      is '/V'. By default, Delta Tango and Delta Tango PRO User pass this
  1599.      parameter to the batch process. This prevents a display of the Clarion
  1600.      file utility windows while the task is being performed. However, in
  1601.      the PRO version, you have the option of passing this parameter or
  1602.      not.
  1603.  
  1604.      By leaving the Test Flip field blank, you are essentially saying,
  1605.      I want a Clarion file utility window to appear as a task is being
  1606.      performed. If you have misspelled a filename, the batch process will
  1607.      stop, and you will receive an error message. Usually, these error
  1608.      messages will give you enough information for you to debug your task.
  1609.      You can then escape from the window, and go back to the record
  1610.      maintenance section to correct your error.
  1611.  
  1612.      By pressing F6 at the Test Flip field and pressing Enter, this
  1613.      automatically fills in the field with '/V' and a Clarion file utility
  1614.      window will NOT appear as a task is being performed.
  1615.  
  1616.                              Batch File Parameters
  1617.  
  1618.      Only the batch file parameters of the Clarion file utilities are
  1619.      supported. The file utilities, by default, look for files to be
  1620.      located in the current subdirectory. Delta Tango/PRO provides certain
  1621.      exceptions to this as noted. The batch file parameters include:
  1622.  
  1623.  
  1624.  
  1625.  
  1626.                                       3-5
  1627.  
  1628.                              * Delta Tango(tm)/PRO *
  1629.  
  1630.                                      FILER
  1631.  
  1632.      S - Source Line Looks for file in current directory
  1633.  
  1634.          **PRO** ONLY - Looks for file in current directory or a designated
  1635.          alternative DOS location.
  1636.  
  1637.      L - Label Line
  1638.  
  1639.      I - Input Line
  1640.  
  1641.      P - Owner ID    **PRO** ONLY
  1642.  
  1643.      O - Output Line The input and output line filenames are the same in
  1644.          regular Delta Tango.
  1645.  
  1646.          **PRO** ONLY - Single Files can have different input and output
  1647.          names.
  1648.  
  1649.                                      SORTER
  1650.  
  1651.      I - Input Line
  1652.  
  1653.      P - Owner ID    **PRO** ONLY
  1654.  
  1655.      O - Output Line The input and output line filenames are the same in
  1656.          regular Delta Tango except for Join Two Files.
  1657.  
  1658.          **PRO** ONLY - All Single Files can have different input and
  1659.          output names. Only the multiple file operations (Backup, Restore,
  1660.  
  1661.  
  1662.          Pack, and NFS Multiple) cannot have different input and output
  1663.          names.
  1664.  
  1665.      K - Sort Line   **PRO** ONLY - Choice in Sorter Options.
  1666.  
  1667.      C - Compress File Line  **PRO** ONLY - A choice is available under
  1668.          Sorter Options. The Compress File Line choice is YES, By default,
  1669.          for all backup operations for both regular Delta Tango and PRO
  1670.          versions.
  1671.  
  1672.      D - Retain Deletions Line   **PRO** ONLY - A choice is always present.
  1673.          Retain deletions choice, by default, is NO for all regular Delta
  1674.          Tango sorter operations.
  1675.  
  1676.      N - Remove Key Files    **PRO** ONLY - Choice in Sorter Options.
  1677.  
  1678.                                    CONVERTER
  1679.  
  1680.      T - Input Type Line
  1681.  
  1682.      I - Input File Line
  1683.  
  1684.                                       3-6
  1685.  
  1686.                              * Delta Tango(tm)/PRO *
  1687.  
  1688.      O - Output Type Line
  1689.  
  1690.      F - Output File Line
  1691.  
  1692.      S - Source File Line
  1693.  
  1694.      P - Owner ID    **PRO** ONLY
  1695.  
  1696.               Delta Tango/PRO Task List and Related File Utilities
  1697.  
  1698.      Backup Single           Sorter
  1699.  
  1700.      Backup Multiple         Sorter
  1701.  
  1702.      Restore Single          Sorter
  1703.  
  1704.      Restore Multiple        Sorter
  1705.  
  1706.      Pack Single             Sorter
  1707.  
  1708.      Pack Multiple           Sorter
  1709.  
  1710.      Join Two Files          Sorter
  1711.  
  1712.      New File Structure - Single       Filer
  1713.  
  1714.      New File Structure - Multiple     Filer
  1715.  
  1716.      Converter List                    Converter
  1717.  
  1718.      SQL Files   OPTIONAL - QSQL(tm) program, Converter, Filer
  1719.  
  1720.      Set Colors  Delta Tango/PRO SETEC.EXE program
  1721.  
  1722.      Sorter Options  **PRO** ONLY -    Sorter
  1723.  
  1724.                                   Manual Utils
  1725.  
  1726.      Access to Clarion Utilities to Operate in a Manual Mode
  1727.  
  1728.      Delta Tango
  1729.  
  1730.         Sorter
  1731.         Filer
  1732.         Converter
  1733.  
  1734.      Delta Tango PRO
  1735.  
  1736.         Sorter
  1737.         Filer
  1738.         Converter
  1739.  
  1740.  
  1741.  
  1742.                                       3-7
  1743.  
  1744.                              * Delta Tango(tm)/PRO *
  1745.  
  1746.         * Scanner
  1747.         * Editor
  1748.         ! Report Writer(tm)
  1749.         * Director
  1750.         * Helper
  1751.         * Must own Clarion Professional Developer(tm) to access all PRO
  1752.           selections.
  1753.         ! Must own Clarion Report Writer(tm) to access.
  1754.  
  1755.      DTU SQL Program OPTIONAL - MUST own a separate QSQL(tm) license to
  1756.      use.
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.                                       3-8
  1801.  
  1802.                              * Delta Tango(tm)/PRO *
  1803.  
  1804.                  Chapter 4. Overview of Clarion File Utilities
  1805.  
  1806.      FILER.......................................................4-2
  1807.  
  1808.      CREATE Statement - "Memory Birds and Bees Talk".............4-2
  1809.  
  1810.      "Corrupted Key File Caught - Story At Five".................4-2
  1811.  
  1812.      SORTER......................................................4-3
  1813.  
  1814.      RECLAIM Attribute - "Space Lease Option Available"..........4-4
  1815.  
  1816.      CONVERTER...................................................4-4
  1817.  
  1818.      "String Delimiter/Field Separator - Cite Irreconcilable
  1819.      Differences"................................................4-5
  1820.  
  1821.      BASIC Source - Clarion File Definition Source -
  1822.      "Anonymous Source"..........................................4-5
  1823.  
  1824.      Access To Other Clarion File Utility Programs...............4-6
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.                                       4-1
  1859.  
  1860.                              * Delta Tango(tm)/PRO *
  1861.  
  1862.                                      FILER
  1863.  
  1864.      DOS Filename - CFIL.EXE
  1865.  
  1866.      Clarion Filer utility can -
  1867.  
  1868.      1. Create a new file or make an existing file with records match a
  1869.      revised file structure definition.
  1870.  
  1871.      2. It can also rebuild or create new key files and create memo files.
  1872.  
  1873.                  CREATE Statement - "Memory Birds and Bee Talk"
  1874.  
  1875.      To make a Clarion data file, either you need to use the CREATE
  1876.      statement in your program, and when you run the Clarion .EXE, it will
  1877.      create an empty data file for you, or use Filer with the appropriate
  1878.      file definition source file. For Designer users, using the CREATE
  1879.      statement is as easy as choosing - Create File - Yes - under the File
  1880.      Options Window (When the File window is open, press Control O).
  1881.      However, there is a penalty for using CREATE - memory allocation.
  1882.  
  1883.      To avoid sacrificing precious conventional memory allocation, using
  1884.      Filer to create files makes sense. However, there may be a few cases
  1885.      where you might want to use the CREATE statement for one or two files,
  1886.      and then use Filer to create the rest of your files. Delta Tango/PRO
  1887.      is a good case in point to use the CREATE statement for a single file.
  1888.      For your convenience, starting up the program in a subdirectory with
  1889.      no Delta Tango data files will automatically create the FUTILS.DAT
  1890.      and it's associated Key files.
  1891.  
  1892.      One task Delta Tango/PRO does not support is allowing you to change
  1893.      which input fields will be assigned to the output fields. This must
  1894.      be accomplished by manually manipulating Filer. Delta Tango/PRO only
  1895.      supports parameters that are supported in batch files.
  1896.  
  1897.                   "Corrupted Key File Caught - Story at Five"
  1898.  
  1899.      One way to shut down a Clarion program in a hurry or not allow one
  1900.      to start up is to have corrupted Key files. Deleting the keys and
  1901.      letting the program rebuild them is one way. Using Filer to rebuild
  1902.      them is another way. Using a task selection such as in the Single
  1903.      or Multiple New File Structures in Delta Tango/PRO can provide a
  1904.      simple solution to help ease some of your Client's PANIC when their
  1905.      program doesn't work as promised!
  1906.  
  1907.      Delta Tango/PRO uses Filer for the following tasks.
  1908.  
  1909.      NFS (New File Structure) Single or Multiple. By running these tasks,
  1910.      you can -
  1911.  
  1912.      1. Create a new file or make an existing file with records match a
  1913.      revised file structure definition.
  1914.  
  1915.  
  1916.                                       4-2
  1917.  
  1918.                              * Delta Tango(tm)/PRO *
  1919.  
  1920.      2. It can also rebuild or create new key files and create memo files.
  1921.  
  1922.      3. SQL Files - After converting a SQL query to a BASIC file, the Filer
  1923.      utility is run to create a usable Clarion data file.
  1924.  
  1925.      Check the Filer Utility chapter of your Clarion Professional
  1926.      Developer's Utilities Guide for more general information about Filer
  1927.      operations and examples.
  1928.  
  1929.                                      SORTER
  1930.  
  1931.      DOS filename - CSRT.EXE
  1932.  
  1933.      This Clarion utility has a lot of useful abilities and accounts for
  1934.      a majority of the Delta Tango/PRO's present tasks.
  1935.  
  1936.      Clarion Sorter Utility can -
  1937.  
  1938.      1. Sort, or physically rearrange, the order of the records in a
  1939.      Clarion data file when you specify an order sequence.
  1940.  
  1941.      **PRO** ONLY - Specific Delta Tango PRO task - SORTER Options
  1942.  
  1943.      Under Sorter Options, you can define up to 4 sort parameters, and
  1944.      join up to four files. This Delta Tango PRO task gives you the ability
  1945.      to use all of the batch parameters of Sorter.
  1946.  
  1947.      2. Compress a Clarion data file - useful for backups and distribution.
  1948.  
  1949.      Specific Delta Tango/PRO tasks - Backup Single or Multiple Files
  1950.  
  1951.      The program assigns a .CBK extension to the Clarion filename to help
  1952.      distinguish it as a file that has been compressed when the backup
  1953.      task is used.
  1954.  
  1955.      **PRO** ONLY - Sorter Options gives a choice of compressing the data
  1956.      file or not.
  1957.  
  1958.      3. Concatenate (or join/merge) data files that have the same record
  1959.      layout.
  1960.  
  1961.      Specific Delta Tango/PRO tasks - Join Two Files **PRO** ONLY - Sorter
  1962.      Options Join up to Four Files
  1963.  
  1964.      One good reason to join files together is to increase the count of
  1965.      your test records without adding more records individually. The
  1966.      ability to increase your data file size dramatically in a short period
  1967.      of time might help you to decide how well your program works with
  1968.      larger files. Or test for printing times, etc.
  1969.  
  1970.      4. Permanently remove deleted files (in Delta Tango/PRO, this is
  1971.      referred to as packing the file). The batch parameter for this is
  1972.      Retain Deletions.
  1973.  
  1974.                                       4-3
  1975.  
  1976.                              * Delta Tango(tm)/PRO *
  1977.  
  1978.      Retain Deletions - No is the same as saying permanently remove deleted
  1979.      records.
  1980.  
  1981.      Specific Delta Tango/PRO tasks - Pack Single or Multiple,  Backup
  1982.      Single or Multiple,  Restore Single or Multiple, and Join Two Files.
  1983.  
  1984.      **PRO** ONLY - Sorter Options - Retain Deletions Choice
  1985.  
  1986.      By default, all Sorter operations in the regular Delta Tango program
  1987.      execute the pack operation (or Retain Deletions - No). However, in
  1988.      the PRO version, you have a choice of retaining deletions or not in
  1989.      ALL the sorter operations.
  1990.  
  1991.                RECLAIM Attribute - "Space Lease Option Available"
  1992.  
  1993.      If you choose the RECLAIM attribute in the file definition, space
  1994.      for any deleted records in the file will automatically be used for
  1995.      any new records added to the file. For Designer users, using the
  1996.      RECLAIM attribute is as easy as choosing - Reclaim Space - Yes - under
  1997.      the File Options Window (When the File window is open, press Control
  1998.      O).
  1999.  
  2000.      This would analogous to a continuous pack operation. However, if you
  2001.      deleted a large number of records at one time, it might take some
  2002.      time to fill in the space and decrease the file size. You may want
  2003.      to pack the files after a large number of deletes.
  2004.  
  2005.      On the other hand, you may not want to reclaim the space and possibly
  2006.      keep all deleted records for a historical file, or some other use.
  2007.      Only the PRO version gives you the flexibility of a Retain Deletions
  2008.      choice for ALL sorter operations.
  2009.  
  2010.      5. Create a sorted data file without any key files (remove key files).
  2011.  
  2012.          Specific Delta Tango PRO tasks - **PRO** ONLY - Sorter Options
  2013.  
  2014.      You may not want to build and constantly update a key file for a
  2015.      report that may be printed infrequently. Refer to the Utilities Guide
  2016.      for expanded instructions.
  2017.  
  2018.      Check the Sorter Utility chapter of your Clarion Professional
  2019.      Developer's Utilities Guide for more general information about Sorter
  2020.      operations and examples.
  2021.  
  2022.                                    CONVERTER
  2023.  
  2024.      DOS Filename - CCVT.EXE
  2025.  
  2026.      This utility gives the ability to convert from the following formats
  2027.      to Clarion, and to Convert Clarion to those same formats.
  2028.  
  2029.      dBaseII, dBaseIII, DIF(Data Interchange Format), and BASIC (ascii)
  2030.  
  2031.  
  2032.                                       4-4
  2033.  
  2034.                              * Delta Tango(tm)/PRO *
  2035.  
  2036.      String Delimiter - Field Separator - "Cite Irreconcilable Differences
  2037.      with Delta Tango/PRO"
  2038.  
  2039.      The Converter utility offers two parameters at the Converter Window
  2040.      that are not available as batch parameters. Delta Tango/PRO can only
  2041.      work with batch parameters. These two parameters are String Delimiter
  2042.      and Field Separator. Therefore, Delta Tango/PRO can only work with
  2043.      BASIC files that have the default parameter settings -
  2044.  
  2045.      String Delimiter '' double quotes
  2046.  
  2047.      Field Separator , comma
  2048.  
  2049.      You will need to work the Converter utility in a manual mode to
  2050.      convert files that do not conform to the default for those two
  2051.      parameters.
  2052.  
  2053.        BASIC Source - Clarion File Definition Source - "Anonymous Source"
  2054.  
  2055.      When you convert from another format to a Clarion file, a source file
  2056.      that contains a Clarion FILE structure declaration that matches the
  2057.      new Clarion data file is created. By default, this is the name of
  2058.      the output file with the .TMP extension. However, this file should
  2059.      not be confused with a source file that contains the actual file
  2060.      layout your Clarion .EXE program expects to see and use.
  2061.  
  2062.      In order to use the 'converted to Clarion' file with a Clarion .EXE
  2063.      program, you will still need to run Filer to change the file header
  2064.      to match what your Clarion application is expecting. The file layout
  2065.      can be found in the main .CLA of your application. You can extract
  2066.      just the file definition code from the main .CLA and copy it to a
  2067.      source file that you can name to be used with Filer. However, Delta
  2068.      Tango/PRO expects the file to have an extension of .CLA.
  2069.  
  2070.      Check the Converter Utility chapter of your Clarion Professional
  2071.      Developer's Utilities Guide for more general information about
  2072.      Converter operations and examples. There is considerable discussion on
  2073.      how differing field types are handled during the conversion.
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.                                       4-5
  2091.  
  2092.                              * Delta Tango(tm)/PRO *
  2093.  
  2094.  
  2095.                  Access To Other Clarion File Utiltity Programs
  2096.  
  2097.     **PRO** ONLY
  2098.  
  2099.     Note: Only license holders of Clarion Professional Developer(tm) have
  2100.     access to the following programs in a manual mode. These programs
  2101.     can be called from within Delta Tango PRO. This is, essentially, the
  2102.     same as typing in their DOS filenames at the DOS prompt.
  2103.  
  2104.     Director - Clarion DOS shell, lets you view your directories and issue
  2105.     DOS commands. DOS filename is CDIR.EXE.
  2106.  
  2107.     Editor - Clarion editor - Use to write source code for your program,
  2108.     to create screens, and reports, or to modify the source code produced
  2109.     by Designer. DOS filename is CEDT.EXE.
  2110.  
  2111.     Helper - Clarion utility used to create and revise context-sensitive
  2112.     help windows for your Clarion applications. DOS filename is CHLP.EXE.
  2113.  
  2114.     Report Writer(tm) - Clarion Report Writer(tm) - Used to generate ad-hoc
  2115.     reports and screen queries. DOS filename is REPORTER.EXE.
  2116.     Note: Only license holders of Clarion Report Writer have access to
  2117.     this program.
  2118.  
  2119.     Scanner - Clarion file utility to display Clarion data file records
  2120.     in a spreadsheet format. Can be used in DOS mode to revise DOS files.
  2121.     DOS filename is CSCN.EXE.
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.                                       4-6
  2149.  
  2150.                              * Delta Tango(tm)/PRO *
  2151.  
  2152.                           Chapter 5 - Photogenic Tasks
  2153.  
  2154.     Chapter 5 is completely devoted to screen shots with short
  2155.     comments. It is not included with the disk file version of
  2156.     the user's manual. Presently, the published manual contains
  2157.     23 pages of screen shots in Chapter 5.
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.                                       5-1
  2207.  
  2208.                              * Delta Tango(tm)/PRO *
  2209.  
  2210.                          Chapter 6. Record Maintenance
  2211.  
  2212.      HOW Does This Thing Work, Anyway?!..........................6-2
  2213.  
  2214.      Delta Tango(tm)/PRO To The Rescue!..........................6-3
  2215.  
  2216.      List Screens................................................6-4
  2217.  
  2218.      DOS Batch File for Single Backup (Sorter Task)..............6-5
  2219.  
  2220.      Limitations Of Characters On A DOS Prompt Line..............6-5
  2221.  
  2222.      PRO New File Structure - Single or Multiple - Limitations...6-5
  2223.  
  2224.      PRO Sorter Options - Limitations............................6-6
  2225.  
  2226.      Record Maintenance - Update Forms...........................6-7
  2227.  
  2228.      Single File.................................................6-7
  2229.  
  2230.      Multiple Files..............................................6-11
  2231.  
  2232.      Backup/Restore Locations....................................6-15
  2233.  
  2234.      Join Two Files..............................................6-16
  2235.  
  2236.      Conversion..................................................6-19
  2237.  
  2238.      SQL.........................................................6-21
  2239.  
  2240.      Sorter Options..............................................6-24
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.                                       6-1
  2265.  
  2266.                              * Delta Tango(tm)/PRO *
  2267.  
  2268.      This section contains detailed information to fill in records for
  2269.      the appropriate tasks.
  2270.  
  2271.      Batch parameter information is stored in records to be later recalled
  2272.      for use with pre-written batch file statements.
  2273.  
  2274.      Parameters refer to the lines of information a file utility needs
  2275.      to use in order to accomplish a task. In Filer, this would be Source
  2276.      Line, Label Line, Input Line, Owner ID, and Output Line.
  2277.  
  2278.      Throughout the Delta Tango/PRO program, two words normally referred
  2279.      to in Clarion terminology as Table and Record are also referred to
  2280.      as List and Update Form, respectively.
  2281.  
  2282.                        HOW Does This Thing Work, Anyway?!
  2283.  
  2284.      If you were going to update a data file after creating a new Clarion
  2285.      .EXE with new file definitions, you would use Filer to update the
  2286.      data file.
  2287.  
  2288.      You might accomplish this task in any number of ways. These could
  2289.      include:
  2290.  
  2291.      1. Manually manipulating Filer
  2292.  
  2293.      2. Create a DOS batch file using Filer and the batch parameters
  2294.  
  2295.      3. Use Delta Tango/PRO.
  2296.  
  2297.      4. Develop code in a Clarion program.
  2298.  
  2299.      Files are found in the current subdirectory for the purposes of these
  2300.      examples.
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.                                       6-2
  2323.  
  2324.                              * Delta Tango(tm)/PRO *
  2325.  
  2326.      The first three are illustrated below.
  2327.  
  2328.      ╔════════════════════════════════════════════════════╗
  2329.      ║                  The CLARION Filer                 ║
  2330.      ║                                                    ║
  2331.      ║  Source File:D:\DTPRO\DTPCH.CLA                    ║
  2332.      ║  Label      :DTPRO                                 ║
  2333.      ║  Input File :D:\DTPRO\DTPRO.DAT                    ║
  2334.      ║  Output File:D:\DTPRO\DTPRO.DAT                    ║
  2335.      ╟────────────────────────────────────────────────────╢
  2336.  
  2337.                                  DOS Batch File
  2338.  
  2339.      CFIL S=DTPCH L=DTPRO I=DTPRO O=DTPRO
  2340.  
  2341.                         Delta Tango Update Form (Record)
  2342.  
  2343.                 ╟──────────────────────────────────────────────╢
  2344.                 ║            Backup/Restore/Pack/NFS           ║
  2345.                 ║               Single File List               ║
  2346.                 ║  Description                                 ║
  2347.                 ║  Delta Tango Test File                       ║
  2348.                 ║  Filename to Backup/Restore/Pack/NFS         ║
  2349.                 ║  DTPRO                                       ║
  2350.                 ║  Source Filename  Label                      ║
  2351.                 ║  DTPCH            dtpro                      ║
  2352.                 ╟────────────┬─────────────────────────────────╢
  2353.                 ║ + - * C M  │ F7 Copy                         ║
  2354.                 ╚════════════╧═════════════════════════════════╝
  2355.  
  2356.      Manually manuipulating the File Utilities can help in development
  2357.      of file maintenance tasks, but you cannot save your parameters.
  2358.  
  2359.      Batch file writing helps automate the task making process somewhat,
  2360.      but it can be difficult keeping track of a lot of batch files.
  2361.  
  2362.                          Delta Tango/PRO to the rescue!
  2363.  
  2364.      Delta Tango/PRO takes the DOS Batch process capabilities of the
  2365.      Clarion File Utilities and gives it some real horsepower.
  2366.  
  2367.      By using batch parameters stored in Clarion fields, and feeding those
  2368.      to pre-written batch file statements, you can accomplish most tasks
  2369.      that you'll need for file maintenance.
  2370.  
  2371.      Since Delta Tango/PRO is an stand alone program, you have two built
  2372.      in advantages. You can use it during development to help you run file
  2373.      maintenance tasks in which you previously wrote batch files. And then
  2374.      you can use it to accomplish tasks for your clients as well. And with
  2375.      the PRO version, you have a more secure User version available as
  2376.      well.
  2377.  
  2378.  
  2379.  
  2380.                                       6-3
  2381.  
  2382.                              * Delta Tango(tm)/PRO *
  2383.  
  2384.      By using fields to store parameter information, you can now copy
  2385.      information easily for similar tasks. With the Hot Table feature, you
  2386.      can easily see all the parameters for a particular task as you scroll
  2387.      from one record to the next.
  2388.  
  2389.      Instead of using 8 characters to describe a DOS batch filename, you
  2390.      can enter up to 40 characters to describe your file maintenance task.
  2391.  
  2392.      You have one common interface to run the Clarion file utilities. The
  2393.      Clarion environment provides this too, but you can only manually
  2394.      manipulate the utilities.
  2395.  
  2396.                                   List Screens
  2397.  
  2398.      At each List screen in the Record Maintenance section, you can add,
  2399.      delete, copy, multiple add, or change (modify) records.
  2400.  
  2401.      List Symbols - These symbols appear at each of the List screens. You
  2402.      must use the corresponding key to perform the operation.
  2403.  
  2404.      Symbol  Corresponding Key   Operation
  2405.  
  2406.      +       INS (Insert Key)    Add A Record (Update Form)
  2407.  
  2408.      -       DEL (Delete Key)    Delete A Record
  2409.  
  2410.      *       Enter Key           Change A Record
  2411.  
  2412.      C       F7                  Copy A Record
  2413.  
  2414.      M       Control + m         Multiple Add of Records
  2415.  
  2416.      The General Format for each Update form is as follows.
  2417.  
  2418.       Field Name
  2419.  
  2420.      Length of Field
  2421.  
  2422.      Required - Must fill in.
  2423.  
  2424.      Note:
  2425.  
  2426.      While there are a few required fields that will not let you go onto
  2427.      the next field until a response is entered, Required - Yes means that
  2428.      the File Utilities need a entry in those fields. Leaving the field
  2429.      blank will cause an error when the task is run.
  2430.  
  2431.      Each of the description fields are required, and you will hear a beep
  2432.      if you try to save a record or go onto the next field without filling
  2433.      in the description field.
  2434.  
  2435.      NFS is an abbreviation for New File Structure Tasks.
  2436.  
  2437.  
  2438.                                       6-4
  2439.  
  2440.                              * Delta Tango(tm)/PRO *
  2441.  
  2442.      F2 - Function Key - Primary use in the program is for an exit key.
  2443.      If the exit is from a record, and the record has been altered, a 'Save
  2444.      Changes' prompt will appear. Alternate key combination is
  2445.      Control-Escape.
  2446.  
  2447.      F10 - Function Key - Primary use in the program is for a save key
  2448.      in the file maintenance section. You may use this function key to
  2449.      save the form at any field, after entering any REQUIRED fields in
  2450.      the form. Alternate key combination is Control-Enter.
  2451.  
  2452.      Since the Single and Multiple File List - Maintenance contain fields
  2453.      that are used for both Sorter and Filer Operations, technically
  2454.      speaking, you would only need to fill in the appropriate fields.
  2455.  
  2456.                                  SPECIAL NOTE:
  2457.  
  2458.      While the rules for entry of the batch parameters in the Clarion data
  2459.      file fields closely follows the same technique as using a DOS batch
  2460.      file, there are exceptions. However, each field is documented with
  2461.      the expected entries.
  2462.  
  2463.      Exception Example -
  2464.  
  2465.                  DOS Batch File for Single Backup (Sorter Task)
  2466.  
  2467.      CSRT I=DTPRO C=Y
  2468.  
  2469.      In the PRO version, if the Output Field is not filled in, the task
  2470.      cannot be completed. The reason for this is Delta Tango PRO creates
  2471.      an invalid DOS filename - '.CBK'. Even if the PRO version used the
  2472.      standard default extension of '.DAT', the result would be the same,
  2473.      invalid DOS filename - '.DAT'. Regular Delta Tango uses the same name
  2474.      for Input File and Output File, so there is no conflict. But having
  2475.      the ability to rename the output field in the PRO version gives you
  2476.      greater flexibility.
  2477.  
  2478.                  Limitations Of Characters On A DOS Prompt Line
  2479.  
  2480.      Essentially, Delta Tango/PRO works just like the DOS batch file method
  2481.      of using the Clarion File Utilities with a lot more automation. That
  2482.      does introduce some limitations as well.
  2483.  
  2484.      Up to a total of 128 characters are allowed on a DOS prompt line.
  2485.  
  2486.      For All of the Delta Tango tasks, and most of the Delta Tango PRO
  2487.      tasks, this is not a problem. The PRO tasks, New File Structure
  2488.      -Single or Multiple, and Sorter Options do require some special
  2489.      consideration.
  2490.  
  2491.      **PRO** ONLY
  2492.  
  2493.            PRO New File Structure - Single or Multiple - Limitations
  2494.  
  2495.  
  2496.                                       6-5
  2497.  
  2498.                              * Delta Tango(tm)/PRO *
  2499.  
  2500.      If you use the maximum length for Owner ID field and the maximum
  2501.      length for Source File Location field, and the maximum lengths for all
  2502.      the other fields, you will be go over the DOS prompt line character
  2503.      maximum. Your task will not be completed. If you use all the maximums
  2504.      minus at least a total of 10 characters or more, you will be in a
  2505.      safety margin, and will be able to complete the task.
  2506.  
  2507.      For example: You complete a record with every field filled to it's
  2508.      maximum length, but the Owner ID is only 31 characters long, you will
  2509.      be in the safety margin, and your task can be completed.
  2510.  
  2511.      NOTE: This does not apply to the description field, since it is never
  2512.      used in a batch file statement, only internally to the Delta Tango/PRO
  2513.      programs.
  2514.  
  2515.                         PRO Sorter Options - Limitations
  2516.  
  2517.      In order, to give maximum usefulness and flexibility to the Sorter
  2518.      Options sections, you have many more fields and options to choose
  2519.      from then what is necessary for a single sorter task.
  2520.  
  2521.      You have a total combined length of 157 in all the fields, but only
  2522.      a total combined length of 92 can be filled and the task can still
  2523.      be completed.
  2524.  
  2525.      Examples -
  2526.  
  2527.      You could do 4 file joins at a time, with a maximum Owner ID, with
  2528.      no sorter lines filled in.
  2529.  
  2530.      You could NOT do a task with all 4 sort lines filled to the maximum,
  2531.      and also have an Owner ID filled to the maximum length.
  2532.  
  2533.      If you have to use a lot of the fields filled to their maximum length,
  2534.      consider breaking a more complicated task into several individual
  2535.      ones.
  2536.  
  2537.      Example -
  2538.  
  2539.      Join 4 files together as the first individual task.
  2540.  
  2541.      Then, depending on Owner ID length, and Sorter Line lengths, you may
  2542.      be able to sort on the newly created file as the second individual
  2543.      task.
  2544.  
  2545.      The idea is to find the right combination of total lengths for any
  2546.      Sorter Option task.
  2547.  
  2548.      NOTE: This does not apply to the description field, since it is never
  2549.      used in a batch file statement, only internally to the Delta Tango/PRO
  2550.      programs.
  2551.  
  2552.  
  2553.  
  2554.                                       6-6
  2555.  
  2556.                              * Delta Tango(tm)/PRO *
  2557.  
  2558.      The following section lists all the fields used in Delta Tango/PRO
  2559.      and notes about them. First, an edited screen shot is shown of both
  2560.      the regular Delta Tango and PRO Update Forms. The number on the left
  2561.      is the maximum number of characters a field can contain, and the
  2562.      asterisks indicate graphically a field filled to it's maximum.
  2563.  
  2564.  
  2565.                            Single File - Maintenance
  2566.  
  2567.                      Single File Update Form - Delta Tango
  2568.  
  2569.                 ╟──────────────────────────────────────────────╢
  2570.                 ║            Backup/Restore/Pack/NFS           ║
  2571.                 ║               Single File List               ║
  2572.                 ║  Description                                 ║
  2573.                 ║  40**************************************    ║
  2574.                 ║  Filename to Backup/Restore/Pack/NFS         ║
  2575.                 ║  8******                                     ║
  2576.                 ║  Source Filename  Label                      ║
  2577.                 ║  8*******         16**************           ║
  2578.                 ╟────────────┬─────────────────────────────────╢
  2579.                 ║ + - * C M  │ F7 Copy                         ║
  2580.                 ╚════════════╧═════════════════════════════════╝
  2581.  
  2582.                    Single File Update Form - Delta Tango PRO
  2583.  
  2584.                 ╟──────────────────────────────────────────────╢
  2585.                 ║            Backup/Restore/Pack/NFS           ║
  2586.                 ║               Single File List               ║
  2587.                 ║  Description                                 ║
  2588.                 ║  40**************************************    ║
  2589.                 ║  Filename to Backup/Restore/Pack/NFS         ║
  2590.                 ║  8******                   Test Flip         ║
  2591.                 ║  Source Filename Location  /V               ║
  2592.                 ║  34********************************          ║
  2593.                 ║  Source Filename  Label             Output   ║
  2594.                 ║  8*******         16**************  8******* ║
  2595.                 ║  Owner ID         Retain Deletions N         ║
  2596.                 ║  41***************************************   ║
  2597.                 ╟────────────┬─────────────────────────────────╢
  2598.                 ║ + - * C M  │ F7 Copy                         ║
  2599.                 ╚════════════╧═════════════════════════════════╝
  2600.  
  2601.  
  2602.      General Notes: Since this single file update form is used for both
  2603.      Sorter and Filer tasks, here is a summary of where the fields are
  2604.      used. Although it would be more efficient to fill in all the batch
  2605.      parameters for both utilities to act on one file, you could fill in
  2606.      only the parameters needed for a single utility. Backup, Restore,
  2607.      and Pack are Sorter Tasks. New File Structure is a Filer task. Use
  2608.      the following as a guide.
  2609.  
  2610.  
  2611.  
  2612.                                       6-7
  2613.  
  2614.                              * Delta Tango(tm)/PRO *
  2615.  
  2616.      Common to both Sorter and Filer.
  2617.  
  2618.         Filename
  2619.  
  2620.         Test Flip **PRO** ONLY
  2621.  
  2622.         Output **PRO** ONLY
  2623.  
  2624.         Owner ID **PRO** ONLY
  2625.  
  2626.      Used only in Filer Tasks
  2627.  
  2628.         Source Filename Location **PRO** ONLY
  2629.  
  2630.         Source Filename
  2631.  
  2632.         Label
  2633.  
  2634.      Used only in Sorter Tasks
  2635.  
  2636.         Retain Deletions **PRO** ONLY
  2637.  
  2638.      Field Name
  2639.  
  2640.      Description
  2641.  
  2642.      Length - 40
  2643.  
  2644.      Required - Yes
  2645.  
  2646.      Note: Describe your files, task, etc.
  2647.  
  2648.      Filename to Backup/Restore/Pack/NFS
  2649.  
  2650.      Length - 8
  2651.  
  2652.      Required - Yes Exception, you could leave this field blank in the
  2653.      PRO version, and name the output file. This would create an empty
  2654.      data file in the current subdirectory when the New File Structure
  2655.      task is run. If the output file name is the same as a previously
  2656.      existing data file in the current subdirectory, it will cause that
  2657.      file to loose any data, and become an empty data file.
  2658.  
  2659.      Note: This is the input filename.
  2660.  
  2661.      Test Flip **PRO** ONLY
  2662.  
  2663.      Length - 2
  2664.  
  2665.      Required - No
  2666.  
  2667.  
  2668.  
  2669.  
  2670.                                       6-8
  2671.  
  2672.                              * Delta Tango(tm)/PRO *
  2673.  
  2674.      Note: This field should be left blank or be filled with /V by pressing
  2675.      F6. If the field is blank, when the task is run, a Clarion file
  2676.      utility base window will show, and if an error stops the task, usually
  2677.      there will be enough error information to debug the task. If the field
  2678.      is /V, no base windows will be shown.
  2679.  
  2680.      Source Filename Location **PRO** ONLY
  2681.  
  2682.      Length - 34
  2683.  
  2684.      Required - No
  2685.  
  2686.      Note: With the use of this field in all your records, you could keep
  2687.      all your source files that contain file definitions in one
  2688.      subdirectory.
  2689.  
  2690.      Source location MUST end with a '\' (back-slash) at the end of the
  2691.      DOS pathname.
  2692.  
  2693.      Source Filename
  2694.  
  2695.      Length - 8
  2696.  
  2697.      Required - Yes for NFS tasks, Not required for Sorter Tasks (backup,
  2698.      restore, pack)
  2699.  
  2700.      Note: This is the name of the source file that contains your file
  2701.      definitions. In Designer, the main .app file contains this
  2702.      information. For example: The .app is office.app. It produces a file
  2703.      called office.cla. Office.cla contains the file definitions for your
  2704.      Clarion program. You could copy only the file definition code to
  2705.      another ascii file.
  2706.  
  2707.      Label
  2708.  
  2709.      Length - 16
  2710.  
  2711.      Required - Yes for NFS tasks, Not rquired for Sorter Tasks (backup,
  2712.      restore, pack)
  2713.  
  2714.      Note:
  2715.  
  2716.      Output **PRO** ONLY
  2717.  
  2718.      Length - 8
  2719.  
  2720.      Required - YES
  2721.  
  2722.      Note: Normally the same as the input name, however, this gives you
  2723.      a choice to rename the input file if desired.
  2724.  
  2725.  
  2726.  
  2727.  
  2728.                                       6-9
  2729.  
  2730.                              * Delta Tango(tm)/PRO *
  2731.  
  2732.      Retain Deletions N Y **PRO** ONLY
  2733.  
  2734.      Length - 1
  2735.  
  2736.      Required - Default is N - NO. This is a Choice field, either N or
  2737.      Y - Yes.
  2738.  
  2739.      Note: This is only used for Sorter Operations. When you highlight
  2740.      a record shown on a List (Table) and press DEL for Delete, this record
  2741.      is marked for deletion, although it will no longer appear in the
  2742.      table.
  2743.  
  2744.      If your file has a RECLAIM attribute in the file definition, space
  2745.      for any marked deleted records in the file will automatically be used
  2746.      for any new records added to the file.
  2747.  
  2748.      If that is the case, a retain deletions choice won't help you much.
  2749.      However, if you want to maintain a historical file, including deleted
  2750.      records, you have the option to mark - Retain Deletions Y in all your
  2751.      Sorter operations. This is ONLY available in the PRO version.
  2752.  
  2753.      Owner ID **PRO** ONLY
  2754.  
  2755.      Length - 41
  2756.  
  2757.      Required - Only for files with Owner ID's.
  2758.  
  2759.      Note:
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.                                       6-10
  2787.  
  2788.                              * Delta Tango(tm)/PRO *
  2789.  
  2790.                           Multiple Files - Maintenance
  2791.  
  2792.                     Multiple Files Update Form - Delta Tango
  2793.  
  2794.                 ╠╡Backup/Restore/Pack/NFS  Multiple Files List╞╣
  2795.                 ║ Description                                  ║
  2796.                 ║ 40**************************************     ║
  2797.                 ║   Data            Label             Source   ║
  2798.                 ║  8*******  (1)   16**************   8******* ║
  2799.                 ║  8*******  (2)   16**************            ║
  2800.                 ║  8*******  (3)   16**************            ║
  2801.                 ║  8*******  (4)   16**************            ║
  2802.                 ║  8*******  (5)   16**************            ║
  2803.                 ║  8*******  (6)   16**************            ║
  2804.                 ║  8*******  (7)   16**************            ║
  2805.                 ║  8*******  (8)   16**************  ┌─────────╢
  2806.                 ║  8*******  (9)   16**************  │  + - M  ║
  2807.                 ║  8*******  (10)  16**************  │  * C    ║
  2808.                 ╚════════════════════════════════════╧═════════╝
  2809.  
  2810.                   Multiple Files Update Form - Delta Tango PRO
  2811.  
  2812.                 ╠╡Backup/Restore/Pack/NFS  Multiple Files List╞╣
  2813.                 ║Desc 40************************************** ║
  2814.                 ║ Test Flip     /V                            ║
  2815.                 ║ ID 41*************************************** ║
  2816.                 ║ Source Location   Retain Deletions N         ║
  2817.                 ║ 34********************************           ║
  2818.                 ║   Data            Label             Source   ║
  2819.                 ║  8*******  (1)   16**************   8******* ║
  2820.                 ║  8*******  (2)   16**************            ║
  2821.                 ║  8*******  (3)   16**************            ║
  2822.                 ║  8*******  (4)   16**************            ║
  2823.                 ║  8*******  (5)   16**************            ║
  2824.                 ║  8*******  (6)   16**************            ║
  2825.                 ║  8*******  (7)   16**************            ║
  2826.                 ║  8*******  (8)   16**************  ┌─────────╢
  2827.                 ║  8*******  (9)   16**************  │  + - M  ║
  2828.                 ║  8*******  (10)  16**************  │  * C    ║
  2829.                 ╚════════════════════════════════════╧═════════╝
  2830.  
  2831.  
  2832.      General Notes: Since this Multiple files update form is used for both
  2833.      Sorter and Filer tasks, here is a summary of where the fields are
  2834.      used. Although it would be more efficient to fill in all the batch
  2835.      parameters for both utilities to act on one file, you could fill in
  2836.      only the parameters needed for a single utility. Backup, Restore,
  2837.      and Pack are Sorter Tasks. New File Structure is a Filer task. Use
  2838.      the following as a guide.
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.                                       6-11
  2845.  
  2846.                              * Delta Tango(tm)/PRO *
  2847.  
  2848.      Common to both Sorter and Filer.
  2849.  
  2850.         Filename
  2851.  
  2852.         Test Flip **PRO** ONLY
  2853.  
  2854.         Owner ID **PRO** ONLY
  2855.  
  2856.      Used only in Filer Tasks
  2857.  
  2858.         Source Filename Location **PRO** ONLY
  2859.  
  2860.         Source Filename
  2861.  
  2862.         Label
  2863.  
  2864.      Used only in Sorter Tasks
  2865.  
  2866.         Retain Deletions **PRO** ONLY
  2867.  
  2868.  
  2869.      Field Name
  2870.  
  2871.      Desc (description)
  2872.  
  2873.      Length - 40
  2874.  
  2875.      Required - Yes
  2876.  
  2877.      Note: Describe files, task, etc.
  2878.  
  2879.      Test Flip **PRO** ONLY
  2880.  
  2881.      Length - 2
  2882.  
  2883.      Required - No
  2884.  
  2885.      Note: This field should be left blank or be filled with /V by pressing
  2886.      F6. If the field is blank, when the task is run, a Clarion file
  2887.      utility base window will show, and if an error stops the task, usually
  2888.      there will be enough error information to debug the task. If the field
  2889.      is /V, no base windows will be shown.
  2890.  
  2891.      ID **PRO** ONLY
  2892.  
  2893.      Length - 41
  2894.  
  2895.      Required - Only for files with Owner ID's.
  2896.  
  2897.      Note: This is a global owner ID. All filenames on this update form
  2898.      must use the same Owner ID. Use Single File Update forms for
  2899.      individual owner ID's.
  2900.  
  2901.  
  2902.                                       6-12
  2903.  
  2904.                              * Delta Tango(tm)/PRO *
  2905.  
  2906.      Retain Deletions N Y **PRO** ONLY
  2907.  
  2908.      Length - 1
  2909.  
  2910.      Required - Default is N - NO. This is a Choice field, either N or
  2911.      Y -Yes.
  2912.  
  2913.      Note: This is only used for Sorter Operations. When you highlight
  2914.      a record shown on a List (Table) and press DEL for Delete, this record
  2915.      is marked for deletion, although it will no longer appear in the
  2916.      table.
  2917.      If your file has a RECLAIM attribute in the file definition, space
  2918.      for any marked deleted records in the file will automatically be used
  2919.      for any new records added to the file.
  2920.  
  2921.      If that is the case, a retain deletions choice won't help you much.
  2922.      However, if you want to maintain a historical file, including deleted
  2923.      records, you have the option to mark - Retain Deletions Y in all your
  2924.      Sorter operations. This is ONLY available in the PRO version.
  2925.  
  2926.      Source Location **PRO** ONLY
  2927.  
  2928.      Length - 34
  2929.  
  2930.      Required - No
  2931.  
  2932.      Note: This source location is global, common to all the files. You
  2933.      cannot have source locations for files individually in the Multiple
  2934.      File Update Form. Source location MUST end with a '\' (back-slash)
  2935.      at the end of the DOS pathname.
  2936.  
  2937.      Data (1 - 10)
  2938.  
  2939.      Length - 8
  2940.  
  2941.      Required - At least one filename, but as many as 10
  2942.  
  2943.      Note: These MUST be entered sequentially. ie. - Data 1, then Data
  2944.      2, etc.
  2945.  
  2946.      Label (1 - 10)
  2947.  
  2948.      Length - 16
  2949.  
  2950.      Required - At least one, but as many as 10. Required only for NFS
  2951.      tasks.
  2952.  
  2953.      Note:
  2954.  
  2955.      Source
  2956.  
  2957.      Length - 8
  2958.  
  2959.  
  2960.                                       6-13
  2961.  
  2962.                              * Delta Tango(tm)/PRO *
  2963.  
  2964.      Required - Yes for NFS tasks. No for Sorter Tasks (backup, restore,
  2965.      pack)
  2966.  
  2967.      Note: This is the name of the source file that contains your file
  2968.      definitions. In Designer, the main .app file contains this
  2969.      information. For example: The .app is office.app. It produces a file
  2970.      called office.cla. Office.cla contains the file definitions for your
  2971.      Clarion program. You could copy only the file definition code to
  2972.      another ascii file.
  2973.  
  2974.      This source file is global. It must contain ALL the file definitions
  2975.      in one source file for the data filenames on this update form.
  2976.  
  2977.  
  2978.  
  2979.  
  2980.  
  2981.  
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  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.  
  3015.  
  3016.  
  3017.  
  3018.                                       6-14
  3019.  
  3020.                              * Delta Tango(tm)/PRO *
  3021.  
  3022.                      Backup/Restore Locations - Maintenance
  3023.  
  3024.                   ╔═══╡                                     ╖
  3025.                   ║   34********************************    ║
  3026.                   ║                                         ║
  3027.                   ║                                         ║
  3028.                   ║                                         ║
  3029.                   ║                                         ║
  3030.                   ║                                         ║
  3031.                   ║     Backup/Restore From - Locations     ║
  3032.                   ╠═══════════╤═════════╤═══════════════════╣
  3033.                   ║  F7 Copy  │  + - M  │                   ║
  3034.                   ║           │  * C    │                   ║
  3035.                   ╚═══════════╧═════════╧═══════════════════╝
  3036.  
  3037.      Field Name
  3038.  
  3039.      Location
  3040.  
  3041.      Length - 34
  3042.  
  3043.      Required - Yes for Backup/Restore Tasks
  3044.  
  3045.      Note: This update form is the same for Delta Tango and Delta Tango
  3046.      PRO. It is ONLY used for the Backup/Restore Tasks.
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.                                       6-15
  3077.  
  3078.                              * Delta Tango(tm)/PRO *
  3079.  
  3080.                           Join Two Files - Maintenance
  3081.  
  3082.                     Join Two Files Update Form - Delta Tango
  3083.  
  3084.                ╟───────────────────────────────────────────────╢
  3085.                ║              Join Two Files List              ║
  3086.                ║  Description                                  ║
  3087.                ║  40**************************************     ║
  3088.                ║  Primary Data Filename                        ║
  3089.                ║  8*******                                     ║
  3090.                ║  Secondary Data Filename                      ║
  3091.                ║  8*******                                     ║
  3092.                ║  Merged Data Filename                         ║
  3093.                ║  8*******                                     ║
  3094.                ╟─────────────┬─────────────────────────────────╢
  3095.                ║  + - * C M  │  F7 Copy                        ║
  3096.                ╚═════════════╧═════════════════════════════════╝
  3097.  
  3098.                   Join Two Files Update Form - Delta Tango PRO
  3099.  
  3100.                ╟───────────────────────────────────────────────╢
  3101.                ║              Join Two Files List              ║
  3102.                ║  Description                                  ║
  3103.                ║  40**************************************     ║
  3104.                ║  ID 41*************************************** ║
  3105.                ║  Primary Data Filename    Retain Deletions    ║
  3106.                ║  8*******                 N                   ║
  3107.                ║  Secondary Data Filename  Test Flip           ║
  3108.                ║  8*******                 /V                 ║
  3109.                ║  Merged Data Filename                         ║
  3110.                ║  8*******                                     ║
  3111.                ╟─────────────┬─────────────────────────────────╢
  3112.                ║  + - * C M  │  F7 Copy                        ║
  3113.                ╚═════════════╧═════════════════════════════════╝
  3114.  
  3115.      JOIN Two Files (Concatenation)
  3116.  
  3117.      Field Name
  3118.  
  3119.      Description
  3120.  
  3121.      Length - 40
  3122.  
  3123.      Required - Yes
  3124.  
  3125.      Note: Describe your files, task, etc.
  3126.  
  3127.      ID **PRO** ONLY
  3128.  
  3129.      Length - 41
  3130.  
  3131.      Required - Only for files with Owner ID's.
  3132.  
  3133.      Note:
  3134.                                       6-16
  3135.  
  3136.                              * Delta Tango(tm)/PRO *
  3137.  
  3138.      Primary Data Filename
  3139.  
  3140.      Length - 8
  3141.  
  3142.      Required - Yes
  3143.  
  3144.      Note: You can use the same filename for primary and secondary if you
  3145.      want to increase the size of your file for test purposes.
  3146.  
  3147.      Retain Deletions N Y **PRO** ONLY
  3148.  
  3149.      Length - 1
  3150.  
  3151.      Required - Default is N - NO. This is a Choice field, either N or
  3152.      Y - Yes.
  3153.  
  3154.      Note: This is only used for Sorter Operations. When you highlight
  3155.      a record shown on a List (Table) and press DEL for Delete, this record
  3156.      is marked for deletion, although it will no longer appear in the
  3157.      table.
  3158.  
  3159.      If your file has a RECLAIM attribute in the file definition, space
  3160.      for any marked deleted records in the file will automatically be used
  3161.      for any new records added to the file. If that is the case, a retain
  3162.      deletions choice won't help you much.
  3163.  
  3164.      You may want to maintain a historical file and want deleted records
  3165.      preserved. So for files without the RECLAIM attribute, you have the
  3166.      option to mark - Retain Deletions Y in your Sorter operations. This
  3167.      is ONLY available in the PRO version.
  3168.  
  3169.      Secondary Data Filename
  3170.  
  3171.      Length - 8
  3172.  
  3173.      Required - Yes
  3174.  
  3175.      Note:
  3176.  
  3177.      Test Flip **PRO** ONLY
  3178.  
  3179.      Length - 2
  3180.  
  3181.      Required - No
  3182.  
  3183.      Note: This field should be left blank or be filled with /V by pressing
  3184.      F6. If the field is blank, when the task is run, a Clarion file
  3185.      utility base window will show, and if an error stops the task, usually
  3186.      there will be enough error information to debug the task. If the field
  3187.      is /V, no base windows will be shown.
  3188.  
  3189.  
  3190.  
  3191.  
  3192.                                       6-17
  3193.  
  3194.                              * Delta Tango(tm)/PRO *
  3195.  
  3196.      Merged Data Filename
  3197.  
  3198.      Length - 8
  3199.  
  3200.      Required - Yes
  3201.  
  3202.      Note:
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.  
  3247.  
  3248.  
  3249.  
  3250.                                       6-18
  3251.  
  3252.                              * Delta Tango(tm)/PRO *
  3253.  
  3254.                              Convert - Maintenance
  3255.  
  3256.                        Convert Update Form - Delta Tango
  3257.  
  3258.                ╟───────────────────────────────────────────────╢
  3259.                ║               Convert Files List              ║
  3260.                ║  Description                                  ║
  3261.                ║  40**************************************     ║
  3262.                ║  Input Type   Input File   Source Filename    ║
  3263.                ║  8*******     8*******     8*******           ║
  3264.                ║  Output Type  Output File                     ║
  3265.                ║  8*******     8*******                        ║
  3266.                ║                                               ║
  3267.                ║                                               ║
  3268.                ╟─────────────┬─────────────────────────────────╢
  3269.                ║  + - * C M  │  F7 Copy                        ║
  3270.                ╚═════════════╧═════════════════════════════════╝
  3271.  
  3272.                      Convert Update Form - Delta Tango PRO
  3273.  
  3274.                ╟───────────────────────────────────────────────╢
  3275.                ║               Convert Files List              ║
  3276.                ║  Description                                  ║
  3277.                ║  40**************************************     ║
  3278.                ║  Input Type   Input File    Source Filename   ║
  3279.                ║  8*******     8*******      8*******          ║
  3280.                ║  Output Type  Output File   Test Flip         ║
  3281.                ║  8*******     8*******      /V               ║
  3282.                ║  Owner ID                                     ║
  3283.                ║  41***************************************    ║
  3284.                ╟─────────────┬─────────────────────────────────╢
  3285.                ║  + - * C M  │  F7 Copy                        ║
  3286.                ╚═════════════╧═════════════════════════════════╝
  3287.  
  3288.  
  3289.      Field Name
  3290.  
  3291.      Description
  3292.  
  3293.      Length - 40
  3294.  
  3295.      Required - Yes
  3296.  
  3297.      Note: Describe your files, tasks, etc.
  3298.  
  3299.      Input Type
  3300.  
  3301.      Length - 8
  3302.  
  3303.      Required - Yes
  3304.  
  3305.      Note: Choices are Clarion, dBaseII, dBaseIII, DIF, or BASIC
  3306.  
  3307.  
  3308.                                       6-19
  3309.  
  3310.                              * Delta Tango(tm)/PRO *
  3311.  
  3312.      Input File
  3313.  
  3314.      Length - 8
  3315.  
  3316.      Required - Yes
  3317.  
  3318.      Note:
  3319.  
  3320.      Source Filename
  3321.  
  3322.      Length - 8
  3323.  
  3324.      Required - Yes, but only on conversion from other formats to Clarion.
  3325.  
  3326.      Note:
  3327.  
  3328.      Output Type
  3329.  
  3330.      Length - 8
  3331.  
  3332.      Required - Yes - Exceptions - Not required when converting from other
  3333.      formats to Clarion
  3334.  
  3335.      Note: Choices are BASIC, dBase, or DIF
  3336.  
  3337.      Output File
  3338.  
  3339.      Length - 8
  3340.  
  3341.      Required - Yes
  3342.  
  3343.      Note:
  3344.  
  3345.      Test Flip **PRO** ONLY
  3346.  
  3347.      Length - 2
  3348.  
  3349.      Required - No
  3350.  
  3351.      Note: This field should be left blank or be filled with /V by pressing
  3352.      F6. If the field is blank, when the task is run, a Clarion file
  3353.      utility base window will show, and if an error stops the task, usually
  3354.      there will be enough error information to debug the task. If the field
  3355.      is /V, no base windows will be shown.
  3356.  
  3357.      Owner ID **PRO** ONLY
  3358.  
  3359.      Length - 41
  3360.  
  3361.      Required - Only for files with Owner ID's.
  3362.  
  3363.      Note:
  3364.  
  3365.  
  3366.                                       6-20
  3367.  
  3368.                              * Delta Tango(tm)/PRO *
  3369.  
  3370.                          SQL Update Form - Delta Tango
  3371.  
  3372.      ╟───────────────────────────────────────────────╨════════════════════
  3373.      ║                              SQL Expression List
  3374.      ║  Description
  3375.      ║  40**************************************
  3376.      ║  BASIC File  DRIVE  Clarion File  Source 1  Source 2  Label
  3377.      ║  8*******    E      8*******      8*******  8*******  16***********
  3378.      ║SQL Expression
  3379.      ║100*****************************************************************
  3380.      ║
  3381.      ║
  3382.      ╟─────────────┬──────────────────────────────────────────────────────
  3383.      ║  + - * C M  │  F7 Copy
  3384.      ╚═════════════╧══════════════════════════════════════════════════════
  3385.  
  3386.                        SQL Update Form - Delta Tango PRO
  3387.  
  3388.      ╟───────────────────────────────────────────────╨════════════════════
  3389.      ║                              SQL Expression List
  3390.      ║  Description                               Test Flip
  3391.      ║  40**************************************  /V
  3392.      ║  BASIC File  DRIVE  Clarion File  Source 1  Source 2  Label
  3393.      ║  8*******    E      8*******      8*******  8*******  16***********
  3394.      ║SQL Expression
  3395.      ║100*****************************************************************
  3396.      ║  Source Filename Location
  3397.      ║  34********************************
  3398.      ╟─────────────┬──────────────────────────────────────────────────────
  3399.      ║  + - * C M  │  F7 Copy
  3400.      ╚═════════════╧══════════════════════════════════════════════════════
  3401.  
  3402.      Field Name
  3403.  
  3404.      Description
  3405.  
  3406.      Length - 40
  3407.  
  3408.      Required - Yes
  3409.  
  3410.      Note: Describe your SQL task
  3411.  
  3412.      Test Flip **PRO** ONLY
  3413.  
  3414.      Length - 2
  3415.  
  3416.      Required - No
  3417.  
  3418.      Note: This field should be left blank or be filled with /V by pressing
  3419.      F6. If the field is blank, when the task is run, a Clarion file
  3420.      utility base window will show, and if an error stops the task, usually
  3421.      there will be enough error information to debug the task. If the field
  3422.      is /V, no base windows will be shown.
  3423.  
  3424.                                       6-21
  3425.  
  3426.                              * Delta Tango(tm)/PRO *
  3427.  
  3428.      BASIC File
  3429.  
  3430.      Length - 8
  3431.  
  3432.      Required - Yes
  3433.  
  3434.      Note: Since this file is being created as your SQL query is output
  3435.      to an ascii file, name this file whatever you like.
  3436.  
  3437.      DRIVE
  3438.  
  3439.      Length - 1
  3440.  
  3441.      Required - Yes
  3442.  
  3443.      Note: This drive designation is used for sort operations with the
  3444.      SQL program. A RAM drive can speed up processing, but if the RAM drive
  3445.      is not large enough to handle the processing, your task will not be
  3446.      completed.
  3447.  
  3448.      Clarion File
  3449.  
  3450.      Length - 8
  3451.  
  3452.      Required - Yes
  3453.  
  3454.      Note: If you do not name this file differently from the filename you
  3455.      are referenced in your SQL query, your original file will be
  3456.      overwritten. Copy your original file to another directory first, and
  3457.      then work with the copied file if you want to keep the same name.
  3458.  
  3459.      Source 1
  3460.  
  3461.      Length - 8
  3462.  
  3463.      Required - Yes
  3464.  
  3465.      Note: This is the filename of the source file containing your file
  3466.      definitions. To overcome a date problem with LONG type fields and
  3467.      QSQL(tm), the program runs Filer twice over a SQL query converted
  3468.      to a BASIC file. See the SQL Chapter for greater detail.
  3469.  
  3470.      Source 2
  3471.  
  3472.      Length - 8
  3473.  
  3474.      Required - Yes
  3475.  
  3476.      Note: See note for Source 1
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.                                       6-22
  3483.  
  3484.                              * Delta Tango(tm)/PRO *
  3485.  
  3486.      Label
  3487.  
  3488.      Length - 17
  3489.  
  3490.      Required - Yes
  3491.  
  3492.      Note:
  3493.  
  3494.      SQL Expression
  3495.  
  3496.      Length - 100
  3497.  
  3498.      Required - Yes
  3499.  
  3500.      Note: Although only a length of 78 is shown on the screen, you can
  3501.      scroll and add data up to a length of 100. Only threes types of entry
  3502.      are expected here.
  3503.  
  3504.          <dtusql.in
  3505.  
  3506.          Renamed dtusql.in query such as <datefilt
  3507.  
  3508.          Or a valid SQL expression. See SQL chapter for greater detail.
  3509.  
  3510.      Source Filename Location **PRO** ONLY
  3511.  
  3512.      Length - 34
  3513.  
  3514.      Required - No
  3515.  
  3516.      Note: Source location MUST end with a '\' (back-slash) at the end
  3517.      of the DOS pathname.
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.                                       6-23
  3541.  
  3542.                              * Delta Tango(tm)/PRO *
  3543.  
  3544.                           Sorter Options - Maintenance
  3545.  
  3546.                   Sorter Options Update Form - Delta Tango PRO
  3547.  
  3548.                ╟───────────────────────────────────────────────╢
  3549.                ║                Sorter Options                 ║
  3550.                ║  Description                                  ║
  3551.                ║  40**************************************     ║
  3552.                ║  Filename 1    Test Flip     Output Filename  ║
  3553.                ║  8*******      /V           8*******         ║
  3554.                ║  Filename 2    Filename 3    Filename 4       ║
  3555.                ║   + 8*******    + 8*******    + 8*******      ║
  3556.                ║  Sort Lines                                   ║
  3557.                ║    1 17***************  2 17***************   ║
  3558.                ║    3 17***************  4 17***************   ║
  3559.                ║  Compress File N      Retain Deletions N      ║
  3560.                ║  Remove Key Files N                           ║
  3561.                ║  ID 41*************************************** ║
  3562.                ╟────────────┬──────────────────────────────────╢
  3563.                ║ + - * C M  │ F7 Copy                          ║
  3564.                ╚════════════╧══════════════════════════════════╝
  3565.  
  3566.  
  3567.      Field Name
  3568.  
  3569.      Description
  3570.  
  3571.      Length - 40
  3572.  
  3573.      Required - Yes
  3574.  
  3575.      Note:
  3576.  
  3577.      Filename 1
  3578.  
  3579.      Length - 8
  3580.  
  3581.      Required - Yes
  3582.  
  3583.      Note:
  3584.  
  3585.      Test Flip
  3586.  
  3587.      Length - 2
  3588.  
  3589.      Required - No
  3590.  
  3591.      Note: This field should be left blank or be filled with /V by pressing
  3592.      F6. If the field is blank, when the task is run, a Clarion file
  3593.      utility base window will show, and if an error stops the task, usually
  3594.      there will be enough error information to debug the task. If the field
  3595.      is /V, no base windows will be shown.
  3596.  
  3597.  
  3598.                                       6-24
  3599.  
  3600.                              * Delta Tango(tm)/PRO *
  3601.  
  3602.      Output Filename
  3603.  
  3604.      Length - 8
  3605.  
  3606.      Required - Yes
  3607.  
  3608.      Note:
  3609.  
  3610.      +
  3611.  
  3612.      Length - 1
  3613.  
  3614.      Required - Yes, if joining files.
  3615.  
  3616.      Note:
  3617.  
  3618.      Filename 2
  3619.  
  3620.      Length - 8
  3621.  
  3622.      Required - Yes, if joining files.
  3623.  
  3624.      Note:
  3625.  
  3626.      +
  3627.  
  3628.      Length - 1
  3629.  
  3630.      Required - Yes, if joining files.
  3631.  
  3632.      Note:
  3633.  
  3634.      Filename 3
  3635.  
  3636.      Length - 8
  3637.  
  3638.      Required - Yes, if joining files.
  3639.  
  3640.      Note:
  3641.  
  3642.      +
  3643.  
  3644.      Length - 1
  3645.  
  3646.      Required - Yes, if joining files.
  3647.  
  3648.      Note:
  3649.  
  3650.      Filename 4
  3651.  
  3652.      Length - 8
  3653.  
  3654.      Required - Yes, if joining files.
  3655.  
  3656.                                       6-25
  3657.  
  3658.                              * Delta Tango(tm)/PRO *
  3659.  
  3660.      Note:
  3661.  
  3662.      Sort Lines (1 - 4)
  3663.  
  3664.      Length - 17
  3665.  
  3666.      Required - Yes, if physically sorting files.
  3667.  
  3668.      Note:
  3669.  
  3670.      Compress File N Y
  3671.  
  3672.      Length - 1
  3673.  
  3674.      Required - Default is N - NO. This is a Choice field, either N or
  3675.      Y - Yes.
  3676.  
  3677.      Note:
  3678.  
  3679.      Retain Deletions N Y
  3680.  
  3681.      Length - 1
  3682.  
  3683.      Required - Default is N - NO. This is a Choice field, either N or
  3684.      Y - Yes.
  3685.  
  3686.      Note: When you highlight a record shown on a List (Table) and press
  3687.      DEL for Delete, this record is marked for deletion, although it will
  3688.      no longer appear in the table. If your file has a RECLAIM attribute
  3689.      in the file definition, space for any marked deleted records in the
  3690.      file will automatically be used for any new records added to the file.
  3691.      If that is the case, a retain deletions choice won't help you much.
  3692.  
  3693.      You may want to maintain a historical file and want deleted records
  3694.      preserved. So for files without the RECLAIM attribute, you have the
  3695.      option to mark - Retain Deletions Y in your Sorter operations. This
  3696.      is ONLY available in the PRO version.
  3697.  
  3698.      Remove Key Files N Y
  3699.  
  3700.      Length - 1
  3701.  
  3702.      Required - Default is N - NO. This is a Choice field, either N or
  3703.      Y - Yes.
  3704.  
  3705.      Note:
  3706.  
  3707.      ID
  3708.  
  3709.      Length - 41
  3710.  
  3711.      Required - Only for files with Owner ID's.
  3712.  
  3713.  
  3714.                                       6-26
  3715.  
  3716.                              * Delta Tango(tm)/PRO *
  3717.  
  3718.                 Chapter 7. SQL - Support In Delta Tango(tm)/PRO
  3719.  
  3720.      QSQL(tm)....................................................7-2
  3721.  
  3722.      QSQL(tm) Support In Delta Tango(tm)/PRO.....................7-2
  3723.  
  3724.      Create New Clarion Databases Using SQL......................7-3
  3725.  
  3726.      DTU SQL Program.............................................7-3
  3727.  
  3728.      SQL Expression Update Form..................................7-5
  3729.  
  3730.      Fixing Date Problem With Fields With Long Type..............7-5
  3731.  
  3732.      SQL Update Form Field Entries...............................7-6
  3733.  
  3734.      File Utilities - Tasks - SQL Files List.....................7-9
  3735.  
  3736.      Removing OWNER ID/Encryption To Work With SQL...............7-9
  3737.  
  3738.  
  3739.  
  3740.  
  3741.  
  3742.  
  3743.  
  3744.  
  3745.  
  3746.  
  3747.  
  3748.  
  3749.  
  3750.  
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.  
  3758.  
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.  
  3772.                                       7-1
  3773.  
  3774.                              * Delta Tango(tm)/PRO *
  3775.  
  3776.      When outlining the purpose of Delta Tango/PRO was first begun, one
  3777.      of the criteria was to automate or facilitate the processing of
  3778.      Clarion files. This first led to the strong support for the three
  3779.      Clarion file utilities; Sorter, Filer, and Converter. Since these
  3780.      files can be freely distributed with your Clarion applications, it
  3781.      seemed appropriate to concentrate on increasing their usefulness
  3782.      through automation.
  3783.  
  3784.      Yet, after studying various Clarion message threads (discussions on
  3785.      Electronic Bulletin Boards), it was determined that possibly some
  3786.      automation with other products that enhance Clarion file processing
  3787.      would be of benefit to users of the Delta Tango/PRO programs.
  3788.  
  3789.                                     QSQL(tm)
  3790.  
  3791.      The first of these products to be supported is QSQL(tm).
  3792.  
  3793.      QSQL(tm) is a separate optional standalone query program for the
  3794.      Clarion database environment. It provides a powerful subset of the
  3795.      ANSI SQL language with special enhancements which were made to support
  3796.      the Clarion environment. A separate license must be purchased to use
  3797.      the program.
  3798.  
  3799.      Here is a short list of just some of the many useful file processing
  3800.      capabilities you'll enjoy using QSQL(tm).
  3801.  
  3802.      Perform a join on any number of tables only limited by memory.
  3803.  
  3804.      Perform mass updates of your databases.
  3805.  
  3806.      Display only the fields you want to see in your query.
  3807.  
  3808.      Sorting
  3809.  
  3810.      Statistics: Aggregate functions are available to perform operations
  3811.      on a field including: Average, Count, SUM, Minimum Value, and Maximum
  3812.      Value.
  3813.  
  3814.      Has an interface to Designer. Display only the records which are
  3815.      selected in a designer table for your users to browse or update.
  3816.  
  3817.      Output can be sent to a ascii, comma delimited format.
  3818.  
  3819.      Clarion files can be created from the output of your query.
  3820.  
  3821.                       QSQL(tm) Support in Delta Tango/PRO
  3822.  
  3823.      Delta Tango provides several useful functions for QSQL(tm). Some of
  3824.      these include:
  3825.  
  3826.      1. A Interactive User Interface to QSQL(tm) Use of the interface can
  3827.      be called from within Delta Tango/PRO or from the dos prompt -
  3828.      DTUSQL.EXE.
  3829.  
  3830.                                       7-2
  3831.  
  3832.                              * Delta Tango(tm)/PRO *
  3833.  
  3834.      2. Online summary help while using the shell interface. Lots of
  3835.      examples, SQL expression commands, etc.
  3836.  
  3837.      3. Automate converting an SQL query to a usable Clarion file.
  3838.  
  3839.      4. If you have used the Update clause in SQL, a Delta Tango/PRO Filer
  3840.      task can be run if you have updated a field that has a key on it.
  3841.  
  3842.      This chapter will mainly focus on how to use QSQL(tm) with Delta
  3843.      Tango/PRO. Refer to the excellent QSQL(tm) tutorial for general use of
  3844.      the SQL program itself. SQL can be run for many useful purposes, not
  3845.      just those that are listed here.
  3846.  
  3847.      Use of the QSQL(tm) program will be referred to as SQL for the
  3848.      remainder of the chapter.
  3849.  
  3850.      Have you ever wanted to:
  3851.  
  3852.      Selectively choose the records from one database and make another
  3853.      from it.
  3854.  
  3855.                      Create New Clarion Databases Using SQL
  3856.  
  3857.      There are three ways to make new Clarion databases using SQL.
  3858.  
  3859.      1. Run DTU SQL program, load an sql expression, then return to Delta
  3860.      Tango, use in a SQL Update form and then run SQL task.
  3861.  
  3862.      2. Rename a DTUSQL.IN query and use in SQL Task update form, and then
  3863.      run SQL task.
  3864.  
  3865.      3. Write an SQL expression in the SQL update form and then run SQL
  3866.      task.
  3867.  
  3868.                                 DTU SQL Program
  3869.  
  3870.      DTU SQL is a interactive user interface for SQL.EXE. You could use
  3871.      SQL at the DOS prompt, and type in your SQL expressions, but DTU SQL
  3872.      gives you a chance of saving your expressions in a Clarion data file.
  3873.      Also, DTU SQL has online help, examples, etc. available to help you
  3874.      prepare a proper expression.
  3875.  
  3876.      Here are some steps to converting an SQL query into a usable Clarion
  3877.      data file by running DTU SQL first.
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.  
  3886.  
  3887.  
  3888.                                       7-3
  3889.  
  3890.                              * Delta Tango(tm)/PRO *
  3891.  
  3892.      A. Run DTU SQL (it's a menu choice on the File Utilities section of
  3893.      Delta Tango/PRO).
  3894.  
  3895.      ╔══════════════════════════════════════════════════════════════════
  3896.      ║ Version 1.0               Delta Tango SQL Utilities
  3897.      ║ F1 Summary Help          Interactive User Interface
  3898.      ╠══════════════════════════════════════════════════════════════════
  3899.      ║ SELECT *
  3900.      ║  FROM dtpro
  3901.      ║   WHERE city = 'Atlanta';
  3902.      ║
  3903.      ║
  3904.      ║
  3905.      ║
  3906.      ║
  3907.      ║
  3908.      ║
  3909.      ║
  3910.      ║
  3911.      ╠══════════════════════════════════════════════════════════════════
  3912.      ║ QUERY SYNTAX: SELECT fieldnames FROM files WHERE conditions
  3913.      ║
  3914.      ║ CTRL-ENTER To Execute Your Query        CTRL-L  Load A Previously
  3915.      ║ CTRL-ESC   To Exit From This Package    CTRL-S  Save This Query
  3916.      ║ CTRL-V     View Output From Last Query  CTRL-F  List Of All .DAT
  3917.      ║ CTRL-E     Erase Current Query          CTRL-D  Toggle DEBUG ON
  3918.      ║           COPYRIGHT 1992  Encourager Software - All Rights Reserv
  3919.      ╚══════════════════════════════════════════════════════════════════
  3920.  
  3921.      Type in your SQL expression. When you type your SELECT clause, it's
  3922.      a good idea to use '*' to select all the fields.
  3923.  
  3924.      Press Control Enter, and preview your query on the screen. If it ran
  3925.      OK, go onto the next step. Otherwise, correct your SQL expression.
  3926.  
  3927.      The DTU SQL program produces an ascii query file named 'dtusql.in'.
  3928.      This is used in the SQL update form.
  3929.  
  3930.      NOTE: Each time you run DTU SQL, and enter a query or recall a
  3931.      previous query, and press Control-Enter to run the query, the file
  3932.      'dtusql.in' is produced with the SQL query information. Obviously,
  3933.      this overwrites the previous query. You could rename this file, any
  3934.      legitimate DOS filename is acceptable. Then, you could use that name
  3935.      in the SQL expression field in the SQL update form.
  3936.  
  3937.  
  3938.  
  3939.  
  3940.  
  3941.  
  3942.  
  3943.  
  3944.  
  3945.  
  3946.                                       7-4
  3947.  
  3948.                              * Delta Tango(tm)/PRO *
  3949.  
  3950.                            SQL Expression Update Form
  3951.  
  3952.      B. Now, quit DTU SQL, and return to Delta Tango (either Escape or
  3953.      Control-Escape keys).
  3954.  
  3955.      Select the Record Maintenance menu selection, and then the SQL Files
  3956.      selection.
  3957.  
  3958.                       File Utilities
  3959.      ╔════╡                                          ╖
  3960.      ║    'ar' in name string                        ║
  3961.      ║    Atlanta - Filter              <dtusql.in   ║
  3962.      ║    Atlanta(2) - Filter           <dtusql.in   ║
  3963.      ║    Date after 03/01/92           <datefilt    ║
  3964.      ║                                               ║
  3965.      ║                                               ║
  3966.      ║                                               ║
  3967.      ║                                               ║
  3968.      ║                                               ║
  3969.      ╟───────────────────────────────────────────────╨══════════════════
  3970.      ║                              SQL Expression Update
  3971.      ║  Description                               Test Flip(F6)
  3972.      ║  'ar' in name string                       /V
  3973.      ║  BASIC File  DRIVE  Clarion File  Source 1  Source 2  Label
  3974.      ║  DT          D      AR            DTPRO1    DTPRO     dtpro
  3975.      ║SQL Expression
  3976.      ║"SELECT * FROM dtpro WHERE name LIKE '%ar%';
  3977.      ║  Source Filename Location
  3978.      ║
  3979.      ╟─────────────┬──────────    Record will be Changed    ────────────
  3980.      ║  + - * C M  │  F7 Copy
  3981.      ╚═════════════╧════════════════════════════════════════════════════
  3982.  
  3983.  
  3984.                  Fixing Date Problem With Fields With Long Type
  3985.  
  3986.      Note: There is a problem in using the LONG type in a field definition
  3987.      for date fields. Essentially, after converting the query to a BASIC
  3988.      file, and then while running Filer, your dates will be lost. To
  3989.      overcome this problem, you must use two different source files, and
  3990.      Filer is run twice over the converted query.
  3991.  
  3992.      The Source 1 field on the SQL update form would be filled in with
  3993.      'DTPRO1' in this example, while Source 2 field would be filled in
  3994.      with 'DTPRO'. Delta Tango/PRO expects the DOS filename to have an
  3995.      extension of '.CLA' although you don't need to type this in the form.
  3996.  
  3997.      Make a copy of your source file, and change your DATE fields to a
  3998.      STRING(@D1) as illustrated in the first source file, and then in the
  3999.      second, back to a LONG type.
  4000.  
  4001.      If the two periods at the end of the file structure are missing,
  4002.      you'll see a compiler error message when running Filer.
  4003.  
  4004.                                       7-5
  4005.  
  4006.                              * Delta Tango(tm)/PRO *
  4007.  
  4008.      Here are two file definitions to illustrate the changes.
  4009.  
  4010.      DOS filename in this example: DTPRO1.CLA
  4011.  
  4012.      DTPRO   FILE,PRE(DTP),CREATE,RECLAIM
  4013.      BY_NAME   KEY(DTP:NAME),DUP,NOCASE,OPT
  4014.      RECORD    RECORD
  4015.      NAME        STRING(10)
  4016.      DATE        STRING(@D1) ! Use a string field in Source 1
  4017.      CITY        STRING(15)
  4018.      ST          STRING(2)
  4019.              . .
  4020.  
  4021.      DOS filename in this example: DTPRO.CLA
  4022.  
  4023.      DTPRO   FILE,PRE(DTP),CREATE,RECLAIM
  4024.      BY_NAME   KEY(DTP:NAME),DUP,NOCASE,OPT
  4025.      RECORD    RECORD
  4026.      NAME        STRING(10)
  4027.      DATE        LONG ! Now, you can change it back to a LONG type
  4028.      CITY        STRING(15)
  4029.      ST          STRING(2)
  4030.              . .
  4031.  
  4032.                          SQL Update Form Field Entries
  4033.  
  4034.      Field Name
  4035.  
  4036.      Description
  4037.  
  4038.      Length - 40
  4039.  
  4040.      Required - Yes
  4041.  
  4042.      Note: Describe your SQL task
  4043.  
  4044.      Test Flip **PRO** ONLY
  4045.  
  4046.      Length - 2
  4047.  
  4048.      Required - No
  4049.  
  4050.      Note: This field should be left blank or be filled with /V by pressing
  4051.      F6. If the field is blank, when the task is run, a Clarion file
  4052.      utility base window will show, and if an error stops the task, usually
  4053.      there will be enough error information to debug the task. If the field
  4054.      is /V, no base windows will be shown.
  4055.  
  4056.  
  4057.  
  4058.  
  4059.  
  4060.  
  4061.  
  4062.                                       7-6
  4063.  
  4064.                              * Delta Tango(tm)/PRO *
  4065.  
  4066.      BASIC File
  4067.  
  4068.      Length - 8
  4069.  
  4070.      Required - Yes
  4071.  
  4072.      Note: Since this file is being created as your SQL query is output
  4073.      to an ascii file, name this file whatever you like.
  4074.  
  4075.      DRIVE
  4076.  
  4077.      Length - 1
  4078.  
  4079.      Required - Yes
  4080.  
  4081.      Note: This drive designation is used for sort operations with the
  4082.      SQL program. A RAM drive can speed up processing, but if the RAM drive
  4083.      is not large enough to handle the processing, your task will not be
  4084.      completed.
  4085.  
  4086.      Clarion File
  4087.  
  4088.      Length - 8
  4089.  
  4090.      Required - Yes
  4091.  
  4092.      Note: If you do not name this file differently from the filename you
  4093.      have referenced in your SQL query, your original file will be
  4094.      overwritten. Copy your original file to another directory first, and
  4095.      then work with the copied file if you want to keep the same name.
  4096.  
  4097.      Source 1
  4098.  
  4099.      Length - 8
  4100.  
  4101.      Required - Yes
  4102.  
  4103.      Note: This is the filename of the source file containing your file
  4104.      definitions. To overcome a date problem with LONG type fields and
  4105.      QSQL(tm), the program runs Filer twice over a SQL query converted to
  4106.      a BASIC file.
  4107.  
  4108.      Source 2
  4109.  
  4110.      Length - 8
  4111.  
  4112.      Required - Yes
  4113.  
  4114.      Note: See note for Source 1
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.                                       7-7
  4121.  
  4122.                              * Delta Tango(tm)/PRO *
  4123.  
  4124.      Label
  4125.  
  4126.      Length - 17
  4127.  
  4128.      Required - Yes
  4129.  
  4130.      Note:
  4131.  
  4132.      SQL Expression
  4133.  
  4134.      Length - 100
  4135.  
  4136.      Required - Yes
  4137.  
  4138.      SQL Expression - Refers to either the syntax of an SQL query or an
  4139.      ascii file containing an SQL query that is redirected to the SQL
  4140.      program.
  4141.  
  4142.      Note: Although only a length of 78 is shown on the screen, you can
  4143.      scroll and add data up to a length of 100. Only threes types of entry
  4144.      are expected here.
  4145.  
  4146.         <dtusql.in
  4147.  
  4148.         Renamed dtusql.in query such as <datefilt
  4149.  
  4150.      Or a valid SQL expression can be typed in as in the following example
  4151.  
  4152.         "SELECT * FROM dtpro WHERE name LIKE '%ar%';
  4153.  
  4154.      Source Filename Location **PRO** ONLY
  4155.  
  4156.      Length - 34
  4157.  
  4158.      Required - No
  4159.  
  4160.      Note:
  4161.  
  4162.  
  4163.  
  4164.  
  4165.  
  4166.  
  4167.  
  4168.  
  4169.  
  4170.  
  4171.  
  4172.  
  4173.  
  4174.  
  4175.  
  4176.  
  4177.  
  4178.                                       7-8
  4179.  
  4180.                              * Delta Tango(tm)/PRO *
  4181.  
  4182.                     File Utilities - Tasks - SQL Files List
  4183.  
  4184.  
  4185.                       File Utilities                       Exit
  4186.               ╔══╡                                           ╖
  4187.               ║   'ar' in name string                        ║
  4188.               ║   Atlanta - Filter              <dtusql.in   ║
  4189.               ║   Atlanta(2) - Filter           <dtusql.in   ║
  4190.               ║   Date after 03/01/92           <datefilt    ║
  4191.               ║                                              ║
  4192.               ║                                              ║
  4193.               ╟──────────────  SQL Files List  ──────────────╢
  4194.               ║              Press   to Point              ║
  4195.               ║    Highlight Filename Description for SQL    ║
  4196.               ║                 and Press F7                 ║
  4197.               ╚══════════════════════════════════════════════╝
  4198.                     └────────────────────────┘
  4199.  
  4200.  
  4201.      C. After completing the update form, choose the SQL List from the
  4202.      File Utilities section of Delta Tango/PRO. Highlight the description,
  4203.      and press F7. While the task is being run, the QSQL(tm) program will
  4204.      take over part of the screen, and display Option and Query
  4205.      information.
  4206.  
  4207.                  Removing Owner ID/Encryption to work with SQL
  4208.  
  4209.      SQL will not work with OWNER ID/Encrypted files, so you must first
  4210.      remove the OWNER statement. You can easily accomplish this by running
  4211.      a New File Structure task to remove the OWNER statement/ENCRYPT
  4212.      attribute, and then add the OWNER statement again. This is illustrated
  4213.      in the two file definitions below. Take your original file definition,
  4214.      copy the file and rename it. Then, delete the OWNER ID line in the
  4215.      file definition file.
  4216.  
  4217.      Run a New File Structure task using the modified file definition
  4218.      first. Now you can use SQL. After you finish, use the original file
  4219.      definition to add the OWNER statement again by running another New
  4220.      File Structure task.
  4221.  
  4222.                             Modified File Definition
  4223.  
  4224.      DOS filename in this example: DTPRO.CLA
  4225.  
  4226.  
  4227.      DTPRO   FILE,PRE(DTP),CREATE,RECLAIM
  4228.      BY_NAME   KEY(DTP:NAME),DUP,NOCASE,OPT
  4229.      RECORD    RECORD
  4230.      NAME        STRING(10)
  4231.      DATE        LONG
  4232.      CITY        STRING(15)
  4233.      ST          STRING(2)
  4234.              . .
  4235.  
  4236.                                       7-9
  4237.  
  4238.                              * Delta Tango(tm)/PRO *
  4239.  
  4240.      Original File Definiton
  4241.  
  4242.      DOS filename in this example: DTPROID.CLA
  4243.  
  4244.      DTPRO   FILE,PRE(DTP),CREATE,RECLAIM
  4245.                OWNER('itsasecret'),ENCRYPT
  4246.      BY_NAME   KEY(DTP:NAME),DUP,NOCASE,OPT
  4247.      RECORD    RECORD
  4248.      NAME        STRING(10)
  4249.      DATE        LONG
  4250.      CITY        STRING(15)
  4251.      ST          STRING(2)
  4252.              . .
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258.  
  4259.  
  4260.  
  4261.  
  4262.  
  4263.  
  4264.  
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.  
  4288.  
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294.                                       7-10
  4295.  
  4296.                              * Delta Tango(tm)/PRO *
  4297.  
  4298.                                   Appendix  A
  4299.  
  4300.      Special Hints...............................................A-2
  4301.  
  4302.      Command Line................................................A-2
  4303.  
  4304.      Error Screens...............................................A-2
  4305.  
  4306.      Invalid Record Declaration..................................A-3
  4307.  
  4308.      Out of Memory Screen........................................A-3
  4309.  
  4310.      STOP Error Screens..........................................A-4
  4311.  
  4312.      Rebuilding Key Files........................................A-4
  4313.  
  4314.      Temporary Files.............................................A-4
  4315.  
  4316.      Date Problems With Conversion to dBase Files................A-5
  4317.  
  4318.      Assorted Utility Batch Files................................A-5
  4319.  
  4320.      Delta Tango(tm)/PRO Support.................................A-7
  4321.  
  4322.  
  4323.  
  4324.  
  4325.  
  4326.  
  4327.  
  4328.  
  4329.  
  4330.  
  4331.  
  4332.  
  4333.  
  4334.  
  4335.  
  4336.  
  4337.  
  4338.  
  4339.  
  4340.  
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.  
  4348.  
  4349.  
  4350.  
  4351.  
  4352.                                       A-1
  4353.  
  4354.                              * Delta Tango(tm)/PRO *
  4355.  
  4356.                                * Special Hints *
  4357.  
  4358.      This is a collection of special hints to help you run the program
  4359.      more smoothly.
  4360.  
  4361.      Command Line - To disable the screen blanker, NUM locks, etc. use
  4362.      these commands.
  4363.  
  4364.      Error Screens - Common error screens you may encounter.
  4365.  
  4366.      Key Files - Complete rebuilding of these files is sometimes necessary.
  4367.  
  4368.      Temporary Files - These files are created during certain operations.
  4369.  
  4370.      Date Problems - With conversions to dBase files.
  4371.  
  4372.      Assorted Utility Batch Files - Copy COLOR.DAT and future FUTILS file
  4373.      definition
  4374.  
  4375.                                   Command Line
  4376.  
  4377.      When you start Delta Tango either from the DOS prompt, or from a menu,
  4378.      use the following command line prompts if necessary (Substitute 'dtup'
  4379.      or 'dtupe' for the PRO/User versions).
  4380.  
  4381.      DTU B=NO    - Disables Error Beep
  4382.  
  4383.      DTU /C  - Disables Control Break
  4384.  
  4385.      DTU V=0 - Disables screen blanking (0 is zero)
  4386.  
  4387.      DTU V=X - Screen blanks out after X minutes.
  4388.  
  4389.          Default is 10. ie. FT V=5 Screen blanks out after 5 minutes.
  4390.  
  4391.      DTU /L  - Disables keyboard locks. Use if having a problem with Number
  4392.      locks.
  4393.  
  4394.      DTU /E  - Specifies that the system keyboard is an enhanced keyboard.
  4395.  
  4396.                                  Error Screens
  4397.  
  4398.      Probably one of the most common errors you or your client will
  4399.      eventually encounter is when you try to use a data file that is not
  4400.      structured for the current Clarion .EXE program you are running. It
  4401.      WILL halt the program and drop you to DOS.
  4402.  
  4403.  
  4404.  
  4405.  
  4406.  
  4407.  
  4408.  
  4409.  
  4410.                                       A-2
  4411.  
  4412.                              * Delta Tango(tm)/PRO *
  4413.  
  4414.      Below, is a Clarion Error screen that will appear when this happens.
  4415.  
  4416.          Program Halt
  4417.  
  4418.      Clarion Version 2.1 Release 218A 3/03/92 9:45AM
  4419.      D:\FT\PRODUCT.DAT ERROR
  4420.      CODE:47 INVALID RECORD DECLARATION
  4421.      DOS ERROR :O
  4422.  
  4423.      In this example, Filer would need to be used on the data file,
  4424.      PRODUCT.DAT.
  4425.  
  4426.                             Additional Error Screens
  4427.  
  4428.      Out of Memory Clarion Error Screen
  4429.  
  4430.  
  4431.          Program Halt
  4432.  
  4433.      Clarion Version 2.1 Release 218A 3/04/92 1:43 PM
  4434.      ERROR CODE:8 INSUFFICIENT MEMORY
  4435.      DOS ERROR :O
  4436.  
  4437.      Result - Will drop you to DOS.
  4438.  
  4439.      Correction Possibilities
  4440.  
  4441.      Unload TSR Programs
  4442.  
  4443.      Utilize Memory Management program
  4444.  
  4445.      Delta Tango needs at least 512K of Conventional memory minimum to
  4446.      operate properly. This may need to be higher under a Desqview or
  4447.      Windows environment.
  4448.  
  4449.      Having expanded or extended memory will help in configuring a RAM
  4450.      drive for temporary file writes.
  4451.  
  4452.  
  4453.  
  4454.  
  4455.  
  4456.  
  4457.  
  4458.  
  4459.  
  4460.  
  4461.  
  4462.  
  4463.  
  4464.  
  4465.  
  4466.  
  4467.  
  4468.                                       A-3
  4469.  
  4470.                              * Delta Tango(tm)/PRO *
  4471.  
  4472.                        STOP Delta Tango/PRO Error Screens
  4473.  
  4474.      This screen could appear for a number of reasons.
  4475.  
  4476.             ┌─────────────────────────────────────────────┐
  4477.             │    ▄▄▄▄▄   ▄▄▄▄▄▄▄  ▄▄▄▄▄▄   ▄▄▄▄▄▄   ▄     │
  4478.             │    █          █     █    █   █    █   █     │
  4479.             │    █▄▄▄▄      █     █    █   █▄▄▄▄█   █     │
  4480.             │        █      █     █    █   █        █     │
  4481.             │    ▄▄▄▄█      █     █▄▄▄▄█   █        ▄     │
  4482.             │                                             │
  4483.             │  An unexpected error has occurred.  Write   │
  4484.             │  down the information contained in the box  │
  4485.             │  below and contact your support person      │
  4486.             │  as soon as possible.                       │
  4487.             │    ┌───────────────────────────────────┐    │
  4488.             │    │ INVALID KEY FILE                  │    │
  4489.             │    │ Open_/135                         │    │
  4490.             │    └───────────────────────────────────┘    │
  4491.             │         Press any key to Exit to DOS        │
  4492.             └─────────────────────────────────────────────┘
  4493.  
  4494.      There will be a message in a box telling you the error.
  4495.  
  4496.      The error in this box indicates a corrupt key file. If this happens
  4497.      while running Delta Tango/PRO, delete keys files and restart the
  4498.      program. They will be rebuilt. Key files begin with a DOS Filename
  4499.      extension of .K?? ie. FUTILS.K?? Note: Normally you could use a Delta
  4500.      Tango/PRO Filer task to rebuild key files, but in this case, you would
  4501.      have to use Filer, called from DOS, or just delete the key files as
  4502.      noted.
  4503.  
  4504.                               Rebuilding Key Files
  4505.  
  4506.      There are occasions when the Key files may get corrupt. These files
  4507.      help sort your databases alphabetically or numerically. However, there
  4508.      is a VERY easy solution to this problem.
  4509.  
  4510.      Run a Filer Task on the data file. Key files will be rebuilt,
  4511.      automatically.
  4512.  
  4513.      However, remember to do frequent backups of all your data files. You
  4514.      can utilize the File Utilities section to do backups of ALL your .DAT
  4515.      files or backup individual .DAT files.
  4516.  
  4517.                                 Temporary Files
  4518.  
  4519.      When a task is being completed, or you are running one of the
  4520.      utilities in a manual mode, a temporary file on the hard disk is
  4521.      created, and then after the operation is finished, the file is
  4522.      deleted. This file will be approximately 400K or larger. Also, about
  4523.      8K RAM of conventional memory is used as well.
  4524.  
  4525.  
  4526.                                       A-4
  4527.  
  4528.                              * Delta Tango(tm)/PRO *
  4529.  
  4530.      Using a RAM disk for the temporary files will speed up the operation,
  4531.      and help keep your hard disk from becoming fragmented. Also, if you
  4532.      loose power during a Delta Tango task, the temporary file will remain
  4533.      on the hard disk, wasting space. Using a RAM drive alleviates this
  4534.      problem.
  4535.  
  4536.      Use this DOS SET command before entering the Delta Tango/PRO program.
  4537.  
  4538.      A good place to keep your SET command is in your autoexec.bat file.
  4539.  
  4540.      i.e. SET CLATMP=E:\
  4541.  
  4542.      E is the name of the RAM drive in this example, substitute yours.
  4543.  
  4544.      It is recommended your RAM drive be at least 512K in size. It may
  4545.      need to be more under a Desqview or Windows environment.
  4546.  
  4547.                  Date Problems with Conversions to dBase Files
  4548.  
  4549.      At this time, Delta Tango/PRO does not solve date field problems
  4550.      during conversion to dbase files. It can only automate the batch
  4551.      operations of the Clarion file utilities. However, dates are
  4552.      definitely important, and here is one variation of a work around that
  4553.      you might use to overcome losing your dates when you convert a Clarion
  4554.      data file to a dbase file.
  4555.  
  4556.      Here's an example using Delta Tango/PRO, Filer, Converter, and
  4557.      FoxPro(tm).
  4558.  
  4559.      You have a Clarion database file named product.dat. Create an empty
  4560.      Clarion database for product.dat. Now, convert this empty file to
  4561.      dbaseIII using a conversion task. Also, convert the product.dat
  4562.      database containing the records to BASIC using a conversion task.
  4563.  
  4564.      Next, open the empty database in FoxPro(tm), go to Setup, and modify
  4565.      the fields needed (ie. date fields). Then using the Append command
  4566.      (it's a menu choice), import your BASIC file with the delimited file
  4567.      with commas option. Your date fields will now be correct.
  4568.  
  4569.      Variation of this with other xbase programs may be possible too.
  4570.  
  4571.                           Assorted Utility Batch Files
  4572.  
  4573.      MODIFY the following batch files for your computer.
  4574.  
  4575.                  Copy Color definition into a new subdirectory.
  4576.  
  4577.      Once you have found a good color combination for the program, you
  4578.      may want to place the COLOR.DAT file in one directory (D:\dtpro in
  4579.      this example, substitute yours), and put this example batch file in
  4580.      a directory in your DOS path. Then, at the DOS prompt of the directory
  4581.      you want to copy the COLOR.DAT file into, give the batch file name,
  4582.      'CCDAT' (no quotes).
  4583.  
  4584.                                       A-5
  4585.  
  4586.                              * Delta Tango(tm)/PRO *
  4587.  
  4588.      Name of batch file - CCDAT.BAT
  4589.  
  4590.      copy D:\dtpro\color.dat color.dat
  4591.  
  4592.                   Update Future Delta Tango/PRO data structure
  4593.  
  4594.      In the future, when you receive upgrades, and the file structure for
  4595.      Delta Tango/PRO FUTILS.DAT has changed, you cannot update the file
  4596.      structure of Delta Tango/PRO with the program itself. You must do
  4597.      it using Filer or a batch file such as the following. The example
  4598.      new file definition (DTUP.CLA) has been placed in the subdirectory,
  4599.      D:\dtpro - SUBSTITUTE your own, when you modify this batch file.
  4600.  
  4601.      Put the batch file in a subdirectory located in your DOS path.
  4602.  
  4603.      Name of batch file - DTUNEW.BAT
  4604.  
  4605.      cfil S=D:\dtpro\dtup L=futils I=futils /V
  4606.  
  4607.  
  4608.  
  4609.  
  4610.  
  4611.  
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.  
  4628.  
  4629.  
  4630.  
  4631.  
  4632.  
  4633.  
  4634.  
  4635.  
  4636.  
  4637.  
  4638.  
  4639.  
  4640.  
  4641.  
  4642.                                       A-6
  4643.  
  4644.                              * Delta Tango(tm)/PRO *
  4645.  
  4646.                           Delta Tango(tm)/PRO Support
  4647.  
  4648.      Initially, phone support is available from 9 AM to 3 PM,
  4649.      Eastern Standard Time - Monday thru Thursday at (813) 647 5742.
  4650.  
  4651.      Message support will be available on the following bulletin board
  4652.      services.
  4653.  
  4654.      User ID is Dave Troxell except for Clarionet(tm), CompuServe(R) and GE
  4655.      Mail
  4656.  
  4657.      Fidonet - Clarion conference
  4658.  
  4659.      RIMEnet - Clarion conference
  4660.  
  4661.      SMARTnet - Clarion conference
  4662.  
  4663.      Clarionet(tm) - Clarion Software Corporation BBS
  4664.  
  4665.      Clarionet(tm) User ID - DaveT
  4666.  
  4667.      CompuServe(R) User ID - 71165,2560
  4668.  
  4669.      GE Mail - User ID - D.TROXELL2
  4670.  
  4671.      Exec-PC BBS - Office Conference - Database Topic
  4672.  
  4673.  
  4674.  
  4675.      Written correspondence should be addressed to
  4676.  
  4677.      Encourager Software
  4678.      ATTN: Dave Troxell
  4679.      PO Box 1060
  4680.      Highland City, FL 33846-1060
  4681.  
  4682.  
  4683.  
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.  
  4691.  
  4692.  
  4693.  
  4694.  
  4695.  
  4696.  
  4697.  
  4698.  
  4699.  
  4700.                                       A-7
  4701.  
  4702.                              * Delta Tango(tm)/PRO *
  4703.  
  4704.                                     Glossary
  4705.  
  4706.      **PRO** ONLY
  4707.  
  4708.      Refers to features that are only available with the PRO version of
  4709.      Delta Tango.
  4710.  
  4711.      Add A Record
  4712.  
  4713.      (Symbol +) By pressing the INS (insert) key at any one of the List
  4714.      screens that shows a + symbol, an update form (record) can be added.
  4715.  
  4716.      Backup
  4717.  
  4718.      Refers to the process of backing up the data files in the program.
  4719.      Data files end with the extension .DAT, however, in order to
  4720.      distinguish files that have been backed up with Delta Tango, these
  4721.      files have an extension of .CBK.
  4722.  
  4723.      Backup Locations
  4724.  
  4725.      Subdirectory or floppy disk location for backing up data files.
  4726.  
  4727.      Batch Parameters
  4728.  
  4729.      Batch parameters are the equivalent of certain lines in each utility's
  4730.      base window. In Filer, these lines include Source Line, Label Line,
  4731.      Input Line, Owner ID, and Output Line. They are used in DOS batch
  4732.      file statements with the Utilities.
  4733.  
  4734.      Change A Record
  4735.  
  4736.      (Symbol *) By highlighting a record at any one of the List screens
  4737.      that shows a * symbol, and pressing Enter, the record can be edited.
  4738.  
  4739.      Command Line
  4740.  
  4741.      Options to start the Delta Tango program. For example, using DTU V=0
  4742.      at the DOS prompt disables the screen blanking feature of Delta Tango.
  4743.  
  4744.      Compress File
  4745.  
  4746.      Clarion data files (those ending in the extension .DAT) can be
  4747.      compressed for easier storage and distribution.
  4748.  
  4749.      Concatenation
  4750.  
  4751.      The process of combining ALL the records of a data file with all the
  4752.      records of another data file. This process is illustrated in Join
  4753.      Two Files and Sorter Options (**PRO** ONLY).
  4754.  
  4755.  
  4756.  
  4757.  
  4758.                                       G-1
  4759.  
  4760.                              * Delta Tango(tm)/PRO *
  4761.  
  4762.      Converter
  4763.  
  4764.      Clarion file utility to convert dBaseII, dBaseIII, DIF(Data
  4765.      Interchange Format) and BASIC(ascii text) files to Clarion data files.
  4766.      It can also change Clarion files to the above forms. DOS filename is
  4767.      CCVT.EXE.
  4768.  
  4769.      Copy A Record
  4770.  
  4771.      (Symbol C) By highlighting a record and pressing F7 at any one of
  4772.      the List screens that shows a 'C' symbol, you can copy that record.
  4773.  
  4774.      Data Files
  4775.  
  4776.      All Clarion files ending with the extension .DAT.
  4777.  
  4778.      Description
  4779.  
  4780.      This field is used to describe the file utility task you need to
  4781.      perform. It is a REQUIRED field (information must be entered).
  4782.  
  4783.      Delete A Record
  4784.  
  4785.      (Symbol -) By highlighting a record at any one of the List screens
  4786.      that shows a '-' symbol, and pressing the DEL (Delete) key, the record
  4787.      will be shown to you and you can delete it by pressing Enter.
  4788.  
  4789.      Director
  4790.  
  4791.      Clarion DOS shell, lets you view your directories and issue DOS
  4792.      commands. DOS filename is CDIR.EXE. * NOTE 1
  4793.  
  4794.      DOS Prompt Line Limit
  4795.  
  4796.      Only a total of 128 characters can be typed on the DOS prompt line.
  4797.      This must be taken into consideration when writing DOS batch files
  4798.      using Clarion Utility batch parameters.
  4799.  
  4800.      Drive
  4801.  
  4802.      Refers to temporary drive the SQL program uses for some of it's tasks.
  4803.      It is a REQUIRED field.
  4804.  
  4805.      DTU SQL Program
  4806.  
  4807.      This is a shell interface for Cook Database Design's QSQL(tm) program.
  4808.      You can prepare SQL expressions and carry out SQL tasks using this
  4809.      interface. QSQL(tm) is an optional program, and must be purchased
  4810.      separately.
  4811.  
  4812.  
  4813.  
  4814.  
  4815.  
  4816.                                       G-2
  4817.  
  4818.                              * Delta Tango(tm)/PRO *
  4819.  
  4820.      Editor
  4821.  
  4822.      Clarion editor - use to write source code for your program, to create
  4823.      screens, and reports, or to modify the source code produced by
  4824.      Designer. DOS filename is CEDT.EXE. * NOTE 1
  4825.  
  4826.      Error Screens
  4827.  
  4828.      When a program error occurs that may possibly shut down the program
  4829.      and send you back to your DOS prompt (or your own menu program for
  4830.      the computer), these screens give information to help you understand
  4831.      the problem that occurred at the time. Check special hints and the
  4832.      error section of the manual for remedies.
  4833.  
  4834.      F2 - Function Key
  4835.  
  4836.      Primary use in the program is for an exit key. If the exit is from
  4837.      a record, and the record has been altered, a 'Save Changes' prompt
  4838.      will appear. Alternate key combination is Control-Escape.
  4839.  
  4840.      F10 - Function Key
  4841.  
  4842.      Primary use in the program is for a save key in the file maintenance
  4843.      section. You may use this function key to save the form at any field,
  4844.      after entering any REQUIRED fields in the form. Alternate key
  4845.      combination is Control-Enter.
  4846.  
  4847.      Field
  4848.  
  4849.      Each update form (record) is composed of fields. This is where the
  4850.      information for the program is contained.
  4851.  
  4852.      File Utilities
  4853.  
  4854.      The automated Clarion file utilities are accomplished at each of the
  4855.      List screens on the File Utilities Menu. Access to Manual utilities,
  4856.      Set User Colors, DTU SQL shell program, and file maintenance is also
  4857.      provided.
  4858.  
  4859.      File Maintenance
  4860.  
  4861.      This major section of the Delta Tango program allows you to configure
  4862.      your Clarion utility tasks.
  4863.  
  4864.      Filer
  4865.  
  4866.      Clarion file utility to create empty (new) data files or to convert
  4867.      an existing file to a new file definition. DOS filename is CFIL.EXE.
  4868.  
  4869.  
  4870.  
  4871.  
  4872.  
  4873.  
  4874.                                       G-3
  4875.  
  4876.                              * Delta Tango(tm)/PRO *
  4877.  
  4878.      Flashing Task Names
  4879.  
  4880.      When a task is being run, a small screen will appear to overlap a
  4881.      previous screen. This screen will have at least one or two flashing
  4882.      words to let you know the task is still running.
  4883.  
  4884.      Global Owner ID
  4885.  
  4886.      **PRO** ONLY In a multiple files task, only one Owner ID field is
  4887.      available in the update form. All the files in a multiple set must
  4888.      use the same owner ID, or you must use single file update forms.
  4889.  
  4890.      Global Source Location
  4891.  
  4892.      **PRO** ONLY In a multiple files task, only one source location field
  4893.      is available in the update form. You must have all the file
  4894.      definitions in a single source file for the multiple set, and it must
  4895.      be located in a single source location.
  4896.  
  4897.      Help
  4898.  
  4899.      Help is available at most screens and is context sensitive at the
  4900.      screen level by pressing the function key, F1.
  4901.  
  4902.      Helper
  4903.  
  4904.      Clarion utility used to create and revise context-sensitive help
  4905.      windows for your Clarion applications. DOS filename is CHLP.EXE.
  4906.      * NOTE 1
  4907.  
  4908.      Join Two Files
  4909.  
  4910.      The process of combining ALL the records of a secondary data file
  4911.      with all the records of a primary data file. This process is also
  4912.      called concatenation of two files.
  4913.  
  4914.      Key Files
  4915.  
  4916.      These files help sort your lists alphabetically or numerically.
  4917.  
  4918.      Label
  4919.  
  4920.      Refers to either the label of the field (used in sort line) or label
  4921.      of the file structure (used in new file structure).
  4922.  
  4923.      List
  4924.  
  4925.      This is a table of update forms (records). At the list screen update
  4926.      forms can be added, changed, copied or deleted.
  4927.  
  4928.  
  4929.  
  4930.  
  4931.  
  4932.                                       G-4
  4933.  
  4934.                              * Delta Tango(tm)/PRO *
  4935.  
  4936.      List Symbols
  4937.  
  4938.      These symbols appear at each of the List screens if their record
  4939.      operation (add, delete, change, copy, or multiple add) can be
  4940.      performed. Note: Some List screens will have all 5 symbols and some
  4941.      will have none. You must use the corresponding key to perform the
  4942.      operation.
  4943.  
  4944.      Locate
  4945.  
  4946.      On a List screen, there is a locate field at the flashing cursor.
  4947.      Type in the first few letters or numbers to locate a record more
  4948.      easily.
  4949.  
  4950.      Manual Utils
  4951.  
  4952.      Menu to choose Clarion utilities. These utilities can be manipulated
  4953.      in a manual mode as if you typed their DOS .EXE name from the DOS
  4954.      prompt. Delta Tango includes access to Sorter, Filer, and Converter.
  4955.  
  4956.      **PRO** ONLY - Delta Tango PRO includes access to Sorter, Filer,
  4957.      Converter, Scanner, Editor, Report Writer(tm), Director, and Helper.
  4958.  
  4959.      Menu
  4960.  
  4961.      Any screen that allows selections for other screens.
  4962.  
  4963.      Multi-Add Records
  4964.  
  4965.      (Symbol M) Normally pressing the Insert key allows you to add only
  4966.      one record at a time, and then you are returned to the List screen.
  4967.      Pressing Control + m as a combination key, at any one of the List
  4968.      screens that shows a 'M' symbol, will allow multiple adds without
  4969.      returning to the List screen.
  4970.  
  4971.      Multiple - File Utilities
  4972.  
  4973.      Up to 10 Clarion files at a time can be backed up, restored, packed,
  4974.      and new file structures can be made.
  4975.  
  4976.      NFS
  4977.  
  4978.      Abbreviation for New File Structure.
  4979.  
  4980.      New File Structure
  4981.  
  4982.      When a new Clarion .EXE program is issued, this operation is used
  4983.      to restructure any data files (those file ending with the extension
  4984.      .DAT) to work with the new Clarion program .EXE. It is also used to
  4985.      create new data files containing no records. Additionally, it can
  4986.      be used to create or rebuild key files.
  4987.  
  4988.  
  4989.  
  4990.                                       G-5
  4991.  
  4992.                              * Delta Tango(tm)/PRO *
  4993.  
  4994.      NOTE 1
  4995.  
  4996.      Only license holders of Clarion Professional Developer(tm) have access
  4997.      to these programs.
  4998.  
  4999.      Output File
  5000.  
  5001.      After the input file is processed by one of the file utilities, this
  5002.      file is the result. If an Output File field is on the maintenance
  5003.      update form, you have the option of renaming your input file. If the
  5004.      Output File field is not available, your output file will retain the
  5005.      same name as the input file.
  5006.  
  5007.      Owner ID
  5008.  
  5009.      **PRO** ONLY - If the input data file was created from a file
  5010.      structure with an OWNER statement, then the owner ID field must filled
  5011.      in. Delta Tango does not support files with Owner ID statements, only
  5012.      Delta Tango PRO.
  5013.  
  5014.      Pack
  5015.  
  5016.      When you delete files in a data file, the space allocated for that
  5017.      deleted record may or may not be reused depending upon the Reclaim
  5018.      Space Option choice under File Options in Designer (or appropriate
  5019.      hand coded file structures). However, packing a file will permanently
  5020.      eliminate all records marked for deletion and free up space. This
  5021.      operation helps reduce the data file size after deletions. There is
  5022.      an exception to this operation in the PRO version. Refer to sorter
  5023.      operation notes in Chapter 3 for details.
  5024.  
  5025.      PRO Version
  5026.  
  5027.      Delta Tango PRO has more features and also includes a separate User
  5028.      version program. Some of the added features include Owner ID support,
  5029.      retain deletions on backup and restore, source file location, single
  5030.      file output rename, and separate expanded sorter section.
  5031.  
  5032.      QSQL(tm)
  5033.  
  5034.      QSQL(tm) is a separate optional standalone query program for the
  5035.      Clarion database environment. It provides a powerful subset of the
  5036.      ANSI SQL language with special enhancements which were made to support
  5037.      the Clarion environment. A separate license must be purchased to use
  5038.      the program. QSQL(tm) is a Copyrighted Trademark of Cook Database
  5039.      Design, Inc. Delta Tango provides a shell interface to QSQL(tm) and
  5040.      online summary help.
  5041.  
  5042.      Record
  5043.  
  5044.      Same as Update Form.
  5045.  
  5046.  
  5047.  
  5048.                                       G-6
  5049.  
  5050.                              * Delta Tango(tm)/PRO *
  5051.  
  5052.      Record Maintenance
  5053.  
  5054.      Refers to the part of the File Utilities section where file utility
  5055.      records can be modified, added, deleted, or copied.
  5056.  
  5057.      Redirection
  5058.  
  5059.      Feeding an SQL expression to the SQL program. A good example of this
  5060.      is '<dtusql.in' in the SQL maintenance form.
  5061.  
  5062.      Report Writer(tm)
  5063.  
  5064.      Clarion Report Writer(tm) - Used to generate ad-hoc reports and screen
  5065.      queries. Clarion Report Writer(tm) is a trademark of Clarion Software
  5066.      Corporation. DOS filename is REPORTER.EXE.
  5067.  
  5068.      REQUIRED field
  5069.  
  5070.      Information for these fields MUST be entered before you can save the
  5071.      update form. Currently, these include description fields and the Drive
  5072.      field in the SQL form.
  5073.  
  5074.      Restore
  5075.  
  5076.      Data files that are backed up and compressed with the Delta Tango
  5077.      program need to be restored.
  5078.  
  5079.      Restore Locations
  5080.  
  5081.      Subdirectory where the data backup files are contained.
  5082.  
  5083.      Remove Key Files
  5084.  
  5085.      **PRO** ONLY - This sorter option is used to create a sorted Clarion
  5086.      data file without producing key files. Can be used for running
  5087.      infrequent reports.
  5088.  
  5089.      Retain Deletions
  5090.  
  5091.      **PRO** ONLY - When sorter is run on a Clarion data file, records
  5092.      marked for deletion are permanently removed unless the retain
  5093.      deletions choice is Y. By default, all sorter options in Delta Tango
  5094.      mark the records for permanent deletion. However, Delta Tango PRO
  5095.      offers a retain deletions choice when sorter is run.
  5096.  
  5097.      Save Changes
  5098.  
  5099.      When F2 is used to escape from a update form (record), you might see
  5100.      this prompt. Type 'y' for yes, 'n' for no, or 'c' for cancel.
  5101.  
  5102.  
  5103.  
  5104.  
  5105.  
  5106.                                       G-7
  5107.  
  5108.                              * Delta Tango(tm)/PRO *
  5109.  
  5110.      Set Colors
  5111.  
  5112.      You have the option of setting colors for the program. The menu
  5113.      selection for set colors is in the File Utilities section.
  5114.  
  5115.      Scanner
  5116.  
  5117.      Clarion file utility to display Clarion data file records in a
  5118.      spreadsheet format. Can be used in DOS mode to revise DOS files. DOS
  5119.      filename is CSCN.EXE. * NOTE 1
  5120.  
  5121.      Single - File Utilities
  5122.  
  5123.      These operations can be applied to a single file: backup, restore,
  5124.      pack, and new file structure.
  5125.  
  5126.      Sort Lines
  5127.  
  5128.      **PRO** Only - These are used to sort, or physically rearrange, the
  5129.      order of the records in a Clarion data file. A sort parameter can
  5130.      be a field label or an offset type. Up to 4 sort parameters can be
  5131.      entered into the Delta Tango PRO program.
  5132.  
  5133.      Sorter
  5134.  
  5135.      Clarion file utility to sort, merge, reorganize, back up and restore
  5136.      your Clarion data files. DOS filename is CSRT.EXE.
  5137.  
  5138.      Sorter Options
  5139.  
  5140.      **PRO** ONLY - A number of sorter tasks are already built into the
  5141.      Delta Tango program, including Backup, Restore, and Packing of Clarion
  5142.      data files. Join Two Files is another sorter operation. However,
  5143.      sorter options lets you choose more selectively what sorter tasks you
  5144.      want to accomplish. This includes support for joining up to 4 Clarion
  5145.      data files, and up to 4 sort parameters, Owner ID, Output rename, and
  5146.      yes/no choices for the following: Compress Files, Retain Deletions,
  5147.      and Remove Key Files.
  5148.  
  5149.      Source File
  5150.  
  5151.      This is the name of the file that contains your Clarion FILE
  5152.      structure. It could include the FILE structures for multiple Clarion
  5153.      files.
  5154.  
  5155.      Source File Location
  5156.  
  5157.      **PRO** ONLY - Normally, the Delta Tango program looks for source
  5158.      files in the current subdirectory, however, the PRO version allows
  5159.      you to put your source files in another subdirectory and reference
  5160.      them at that location.
  5161.  
  5162.  
  5163.  
  5164.                                       G-8
  5165.  
  5166.                              * Delta Tango(tm)/PRO *
  5167.  
  5168.      Special Hints
  5169.  
  5170.      This is a collection of special hints to help you run the program
  5171.      more smoothly and includes the following: command line prompts, error
  5172.      screens, key files, data files in other subdirectories, and temporary
  5173.      files.
  5174.  
  5175.      SQL
  5176.  
  5177.      SQL (structured query language) - OPTIONAL program - Must buy a
  5178.      separate license to use. SQL can be used to perform joins on multiple
  5179.      tables, perform mass updates, and selectively filter a clarion file
  5180.      and produce another clarion file after a conversion process.
  5181.  
  5182.      Specifically, the QSQL(tm) program from Cook Database Design, Inc. is
  5183.      supported through a shell interface for the SQL program, and Delta
  5184.      Tango automates converting a SQL query into another usable Clarion
  5185.      data file.
  5186.  
  5187.      SQL Expression
  5188.  
  5189.      Refers to either the syntax of an SQL query or an ascii file
  5190.      containing an SQL query that is redirected to the SQL program. For an
  5191.      example of a syntax of an SQL query, look at the 'ar' in string
  5192.      example in Photogenic Tasks, Chapter 5. For an example of a redirected
  5193.      SQL query, look at the other examples provided in the same chapter.
  5194.  
  5195.      Table
  5196.  
  5197.      Term used interchangeably with 'List'.
  5198.  
  5199.      Tasks
  5200.  
  5201.      These are commonly used file maintenance functions for Clarion data
  5202.      files. This is the File Utilities section of Delta Tango/PRO. These
  5203.      include backup, restore, pack, new file structure, join two files,
  5204.      and others to enhance working with Clarion data files.
  5205.  
  5206.      Temporary Files
  5207.  
  5208.      During certain operations of the Delta Tango program, it creates a
  5209.      temporary file on the hard disk, and then after the operation if
  5210.      finished, the file is deleted.
  5211.  
  5212.      Test Mode (Test Flip)
  5213.  
  5214.      **PRO** ONLY - This test mode allows the Base window of each utility
  5215.      to appear while running a task. If an incorrect parameter was input
  5216.      in the record maintenance section, often an error message will help
  5217.      you identify the problem.
  5218.  
  5219.  
  5220.  
  5221.  
  5222.                                       G-9
  5223.  
  5224.                              * Delta Tango(tm)/PRO *
  5225.  
  5226.      Update Form
  5227.  
  5228.      This is where the actual information is stored for the database. Term
  5229.      is used interchangeably with 'record'. Each update form is composed of
  5230.      fields. These fields are used to store batch parameter information.
  5231.  
  5232.      User Version Menu
  5233.  
  5234.      **PRO** ONLY - For the owners of Delta Tango PRO, a separate program
  5235.      is provided so only the task list is shown, no record maintenance
  5236.      section can be accessed. Your client can buy a separate Delta Tango
  5237.      PRO license, and you could install the User Version program, so the
  5238.      End User cannot access the file maintenance section to provide
  5239.      security  for your configurations.
  5240.  
  5241.  
  5242.  
  5243.  
  5244.  
  5245.  
  5246.  
  5247.  
  5248.  
  5249.  
  5250.  
  5251.  
  5252.  
  5253.  
  5254.  
  5255.  
  5256.  
  5257.  
  5258.  
  5259.  
  5260.  
  5261.  
  5262.  
  5263.  
  5264.  
  5265.  
  5266.  
  5267.  
  5268.  
  5269.  
  5270.  
  5271.  
  5272.  
  5273.  
  5274.  
  5275.  
  5276.  
  5277.  
  5278.  
  5279.  
  5280.                                       G-10
  5281.  
  5282.                             * Delta Tango(tm)/PRO *
  5283.  
  5284.      **PRO** ONLY  1-3                   DOS prompt line  6-5
  5285.   
  5286.      Add a record  3-3                   Drive  6-22, 7-7
  5287.   
  5288.      Backup a file  2-5, 6-7             DTU SQL program  3-8, 7-3, 7-4
  5289.   
  5290.      Backup locations  2-5               DTUSQL.IN  1-8, 6-23, 7-3, 7-4
  5291.   
  5292.      BASIC  4-5                          Editing Conventions  3-2
  5293.   
  5294.      BASIC source  4-5                   Editor  1-8, 3-8, 4-6
  5295.   
  5296.      Batch file parameters  3-5          Error screens  A-2
  5297.  
  5298.      Batch parameters  6-2               F2 - Function Key  3-3, 6-5
  5299.  
  5300.      CBK  3-4                            F10 - Function Key   3-3, 6-5
  5301.  
  5302.      Change a record  3-3                Field  3-3, 6-3
  5303.   
  5304.      Command line  2-4, A-2              Field Separater  4-5
  5305.   
  5306.      Command line prompt  A-2            File Utilities  1-2, 6-3
  5307.   
  5308.      Compress file  3-5, 3-6             File definition  3-4, 7-6
  5309.   
  5310.      Compiler Errors  7-5                File extensions  3-3
  5311.   
  5312.      Concatenation  4-3, 6-16            File interchangeability  3-3
  5313.   
  5314.      Conversion  1-2, 4-4, A-5           Filer  3-6, 4-2, A-3
  5315.   
  5316.      Converter  4-4                      Flashing task name  2-5
  5317.  
  5318.      Copy a record  3-3                  FUTILS.DAT  2-5, 4-2, A-6
  5319.  
  5320.      CREATE statement  4-2               Getting started  2-4
  5321.  
  5322.      Data files  3-3                     Global Owner ID  6-12
  5323.  
  5324.      Date problems  7-5, A-5             Global source location  6-13
  5325.  
  5326.      dBase  A-5                          Help  1-3, 3-2, 7-3
  5327.  
  5328.      Delete a record  3-3                Helper  1-8, 3-8, 4-6
  5329.  
  5330.      Description  6-4                    Installation  2-2
  5331.  
  5332.      DESQview  2-4                       Interactive User Interface 7-2
  5333.  
  5334.      DIF  3-4, 4-4                       Join two files  1-2, 3-4, 4-3
  5335.  
  5336.      Director  1-9, 3-8, 4-6             Key files  3-6, 4-2, A-4
  5337.  
  5338.                                       I-1
  5339.  
  5340.                             * Delta Tango(tm)/PRO *
  5341.  
  5342.      Label  3-6, 6-9, 6-13, 6-23         Record Maintenance
  5343.   
  5344.      Limitations  6-5                        Join Two Files  6-16
  5345.   
  5346.      List screens  3-2, 6-4                  Conversion  6-19
  5347.   
  5348.      List symbols  3-3, 6-4                  SQL  6-21
  5349.   
  5350.      Locate field  3-3                       Sorter Options  6-24
  5351.   
  5352.      Locations list  2-5, 6-15           Redirected  7-8
  5353.   
  5354.      Manual utils  1-8, 3-7              Remove key files  3-6, 4-4
  5355.   
  5356.      Menu  3-2                           Report Writer(tm)  1-8, 4-6
  5357.  
  5358.      Multi-add records  3-3              Required field  6-4
  5359.  
  5360.      Multiple files  3-6, 6-5, 6-11      Restore  3-7
  5361.  
  5362.      New file structure  1-6, 3-7        Restore locations  6-15
  5363.   
  5364.      NFS  6-4                            Retain deletions  3-5
  5365.   
  5366.      Output file  6-9, 6-20, 6-25        Save changes  3-3, 6-5
  5367.   
  5368.      Owner ID  3-6                       Scanner  1-8, 3-8, 4-6
  5369.   
  5370.      Pack  3-5                           Set colors  3-7
  5371.   
  5372.      Photogenic tasks  - Chapter 5       SET command  2-3, A-5
  5373.   
  5374.      PRO User   1-3                      SETEC.EXE  3-7
  5375.   
  5376.      PRO version  1-3                    Single File  6-7
  5377.  
  5378.      QSQL(tm)  1-2, 7-2                  Sort lines  3-6, 6-24
  5379.  
  5380.      RAM drive  2-3, A-5                 Sort parameters  4-3
  5381.  
  5382.      RECLAIM attribute  4-4              Sorter  3-4, 3-7, 4-3
  5383.  
  5384.      Record  6-2                         Sorter Options  4-3, 6-24
  5385.  
  5386.      Record Maintenance  6-2             Sorter Operation Notes  3-4
  5387.  
  5388.          Update Forms 6-7                Source file  6-9, 6-13, 6-22
  5389.  
  5390.          Single File  6-7                Source file location  6-9
  5391.  
  5392.          Multiple Files  6-11            Special hints  A-2
  5393.  
  5394.          Backup/Restore Loc.  6-15       SQL  1-3, 2-3, 7-3
  5395.  
  5396.                                       I-2
  5397.  
  5398.                             * Delta Tango(tm)/PRO *
  5399.  
  5400.  
  5401.      SQL expression  1-7, 6-23, 7-4
  5402.  
  5403.      String Delimiter  4-5
  5404.   
  5405.      Support  A-7
  5406.   
  5407.      Table  6-2
  5408.   
  5409.      Tasks  1-6
  5410.   
  5411.      Temporary files  2-3, A-4
  5412.  
  5413.      Test Flip  3-5
  5414.   
  5415.      Test mode  3-5
  5416.   
  5417.      Update form  6-3
  5418.  
  5419.  
  5420.  
  5421.  
  5422.  
  5423.  
  5424.  
  5425.  
  5426.  
  5427.  
  5428.  
  5429.  
  5430.  
  5431.  
  5432.  
  5433.  
  5434.  
  5435.  
  5436.  
  5437.  
  5438.  
  5439.  
  5440.  
  5441.  
  5442.  
  5443.  
  5444.  
  5445.  
  5446.  
  5447.  
  5448.  
  5449.  
  5450.  
  5451.  
  5452.  
  5453.  
  5454.                                       I-3
  5455.  
  5456.