home *** CD-ROM | disk | FTP | other *** search
/ ftp.robelle3000.ai 2014 / 2014.06.ftp.robelle3000.ai.tar / ftp.robelle3000.ai / changes / supr4p1ix.txt < prev    next >
Text File  |  2002-07-29  |  41KB  |  1,058 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                             SUPRTOOL Version 4.0.17
  7.  
  8.  
  9.                        Database Handyman for the HP 3000
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                            Pre-Release Change Notice
  17.                            Installation Instructions
  18.                           Addendum to 4.0 User Manual
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                             Suprtool         4.0.17
  26.                             Dbedit           4.0.17
  27.                             Suprlink         4.0.17
  28.                             STExport         4.0.17
  29.                             Speed Demon      4.0.17
  30.                             Suprtool2        4.8
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                             Robelle Consulting Ltd.
  38.                            Unit 201, 15399-102A Ave.
  39.                          Surrey, B.C.  Canada V3R 7K1
  40.  
  41.                            Toll-free:  1-888-ROBELLE
  42.                                       (1-888-762-3553)
  43.                             Phone:  (604) 582-1700
  44.                              Fax:  (604) 582-1799
  45.  
  46.                          E-mail:  support@robelle.com
  47.                              Web:  www.robelle.com
  48.  
  49.                                February 11, 1998
  50.           Program and Manual Copyright Robelle Consulting Ltd.  1981-2002
  51.  
  52.  
  53.           Permission  is  granted  to  reprint  this  document  (but not for
  54.           profit), provided that copyright notice is given.
  55.  
  56.  
  57.  
  58.  
  59.           QEDIT and SUPRTOOL  are  trademarks  of  Robelle  Consulting  Ltd.
  60.           Other  product  and  company  names  mentioned  herein  may be the
  61.           trademarks of their respective owners.
  62.  
  63.  
  64.  
  65.    Introducing Suprtool Version 4.0.17
  66.  
  67.  
  68.                ⁿ  Highlights
  69.                ⁿ  Compatibility
  70.                ⁿ  CPU Serial Number
  71.                ⁿ  Compatibility Mode vs. Native Mode
  72.                ⁿ  Documentation
  73.                ⁿ  Documentation in WinHelp Format
  74.  
  75.  
  76.           Suprtool provides fast access to your data on the HP  3000.   With
  77.           Suprtool, you can perform many necessary DP functions easily, with
  78.           just a few simple commands.  At Robelle we are constantly  working
  79.           on  your  enhancement  requests  so that we may include them every
  80.           year when we release an updated version of Suprtool.  This  change
  81.           notice  provides  you  with  detailed  installation  steps  and  a
  82.           description of Suprtool's new features.
  83.  
  84.           We would appreciate any  feedback  on  any  of  the  new  features
  85.           available  in  this  release  of Suprtool.  Thanks for agreeing to
  86.           give this new version of Suprtool a try.
  87.  
  88.  
  89.    Highlights in Version 4.0.17
  90.  
  91.           ⁿ  The Item command with the SRNChronos date format now checks the
  92.              field size.
  93.  
  94.           ⁿ  A  reset  table command would fail with an error message unable
  95.              to reset table space if more than  one  table  was  used  in  a
  96.              previous operation.
  97.  
  98.  
  99.  
  100.    Highlights in Version 4.0.16
  101.  
  102.           ⁿ  The  Form  command would now shows all TPI keys if the database
  103.              had Superdex Level 1 installed.
  104.  
  105.           ⁿ  A reset table command would fail with an error  message  unable
  106.              to  reset  table  space  if  two tables were held and the Chain
  107.              command referenced the second table.
  108.  
  109.           ⁿ  A new Set date ifyy2000error command has been added to  control
  110.              whether or not Suprtool considers dates with two-digit years an
  111.              error if they go beyond 1999 during a relative operation.
  112.  
  113.  
  114.    Highlights in Version 4.0.15
  115.  
  116.           ⁿ  Suprtool would fail with Nested too  deep  error  message  when
  117.              doing 10 activations of Suprtool.
  118.  
  119.           ⁿ  Numerous documentation fixes were made to the Suprtool manual.
  120.  
  121.  
  122.    Highlights in Version 4.0.14
  123.  
  124.           ⁿ  STExport was trimming the first character of some zoned fields.
  125.  
  126.           ⁿ  STExport was failing when an phdate date type was in an SD file
  127.              and sign none was specified.
  128.  
  129.           ⁿ  The  Duplicate command now allows an alternate sort level to be
  130.              specified.
  131.  
  132.           ⁿ  The Table command is no  longer  limited  to  15  MB  of  Table
  133.              spaces.  (NM only)
  134.  
  135.           ⁿ  CPU and Wall time have decreased for If $lookup extracts.
  136.  
  137.  
  138.    Highlights in Version 4.0.13
  139.  
  140.           ⁿ  STExport  was not properly processing Zoned decimal fields with
  141.              Zeroes leading.
  142.  
  143.           ⁿ  Suprtool will now work with Time Machine  and  the  HP  utility
  144.              Setdate.
  145.  
  146.           ⁿ  The  Form  command  would print Undefined TPI utility with some
  147.              versions of the Omnidex XL in certain cases.
  148.  
  149.           ⁿ  The installation of Suprtool now requires you to mount the tape
  150.              only once instead of twice.
  151.  
  152.  
  153.    Highlights in Version 4.0.12
  154.  
  155.           ⁿ  Suprtool now has a readonly mode where all commands that update
  156.              a database are disabled.
  157.  
  158.           ⁿ  Suprtool was not processing any commands in the Suprmgr file.
  159.  
  160.  
  161.    Highlights in Version 4.0.11
  162.  
  163.           ⁿ  Suprtool now supports the Software Research  Northwest  Chronos
  164.              date format.
  165.  
  166.           ⁿ  Suprtool's  if  command  did  not  abort  when  doing a compare
  167.              against a date beyond 1999 when being entered interactively.
  168.  
  169.           ⁿ  Suprtool's if command did not produce an error  if  a  relative
  170.              $date or $today function was specified beyond 1999.
  171.  
  172.           ⁿ  Suprtool now supports the new Btree features of IMAGE/SQL.
  173.  
  174.           ⁿ  Suprtool  now supports the new Master Dataset Expansion feature
  175.              of IMAGE/SQL.
  176.  
  177.           ⁿ  Suprtool now allows use files to be nested.
  178.  
  179.           ⁿ  Suprtool would intermittently fail on certain  sort  operations
  180.              with Data Memory Protection Trap.
  181.  
  182.           ⁿ  Suprlink  would not properly link files with a Quad integer key
  183.              (I4)
  184.  
  185.           ⁿ  STExport did not properly set the Delimiter option  when  using
  186.              HTML Table command in all cases.
  187.  
  188.           ⁿ  STExport  did  not  always build an output file with the proper
  189.              record size when the Heading Column option was used.
  190.  
  191.           ⁿ  Suprtool/V did not print an error message if the Select command
  192.              was entered.
  193.  
  194.  
  195.    Highlights in Version 4.0.10
  196.  
  197.           ⁿ  Suprtool now uses the procinfo intrinsic instead of getprocinfo
  198.              to check to see whether or not Suprlink or STExport  are  still
  199.              alive as son processes.
  200.  
  201.  
  202.  
  203.    Compatibility
  204.  
  205.           Suprtool, Speed Demon, and Suprlink are compatible with Q-Delta-2,
  206.           R-MIT, T-MIT, U-MIT, V-MIT, MPE XL, and MPE/iX,  including  MPE/iX
  207.           5.5.
  208.  
  209.           There  are  no changes that affect compatibility with Suprtool 4.0
  210.           at this time.
  211.  
  212.  
  213.    CPU Serial Number (HPSUSAN)
  214.  
  215.           This program runs only on CPUs  whose  serial  numbers  have  been
  216.           encoded ("showvar hpsusan" on MPE/iX).  If it fails to run and you
  217.           get  an  "invalid  HPSUSAN"  error  message,  call   Robelle   for
  218.           assistance.
  219.  
  220.  
  221.    Compatibility Mode vs. Native Mode
  222.  
  223.           Throughout   this  change  notice  and  in  all  of  the  Suprtool
  224.           documentation, there are  references  to  compatibility  mode  and
  225.           native  mode.  If you are on a Classic HP 3000 (i.e., not MPE/iX),
  226.           you can use the compatibility-mode version of Suprtool.   Our  job
  227.           streams   automatically  install  the  correct  version  for  your
  228.           machine.  We use the terms MPE XL and  MPE/iX  interchangeably  in
  229.           our documentation.
  230.  
  231.  
  232.    Documentation
  233.  
  234.           This  release  includes  updated user manuals for Suprtool and its
  235.           components.  To print these manuals, use the Printdoc program:
  236.  
  237.                :run printdoc.pub.robelle
  238.  
  239.           This is the list of documentation files for Suprtool.  NOTE: These
  240.           filenames assume that Install.Suprjnew has already been done.
  241.  
  242.                suprtool.doc.robelle      {Suprtool user manual}
  243.                stexport.doc.robelle      {STExport user manual}
  244.                suprlink.doc.robelle      {Suprlink user manual}
  245.                dbedit.doc.robelle        {Dbedit user manual}
  246.                demon.doc.robelle         {Speed Demon user manual}
  247.                suprcall.doc.robelle      {Calling Suprtool user manual}
  248.                suprtool.docchg.robelle   {this change notice}
  249.  
  250.           If  you  know  the  filenames  of other Robelle documents, you can
  251.           print them with Printdoc or you can include the  filename  in  the
  252.           :Run command.  For example, to print this change notice, type
  253.  
  254.                :run printdoc.pub.robelle;info="suprtool.docchg.robelle"
  255.  
  256.  
  257.    Documentation in WinHelp Format
  258.  
  259.           The user manuals for Suprtool and its components are all available
  260.           in the popular WinHelp file format  of  Microsoft  Windows.   Your
  261.           tape   includes   a  WinHelp  file,  which  is  a  self-extracting
  262.           compressed file that contains all five  Help  files  and  a  Setup
  263.           program.   Use the installation instructions in this change notice
  264.           to install the WinHelp files on your PC.
  265.  
  266.  
  267.    Bugs Fixed in New Features
  268.  
  269.  
  270.    Reset Table.  A reset table command would fail with an error  message  of
  271.           "Unable  to  reset  table  space"  if two tables were held and the
  272.           Chain command referenced the second table.  [4.0.16]
  273.  
  274.  
  275.    STExport.  STExport  was   trimming   the   first   character   in   some
  276.           zoned-decimal fields.  [4.0.13]
  277.  
  278.  
  279.    Use Command.  Suprtool  would  fail  with  Nested  too deep error message
  280.           after 10 activations of Suprtool.  [4.0.15]
  281.  
  282.  
  283.  
  284.  
  285.    Installation of 4.0.16
  286.  
  287.  
  288.           The following instructions apply to existing  Suprtool  users  who
  289.           are  installing  a  new version.  Please use the instructions from
  290.           this change notice instead of the user manual because  the  change
  291.           notice  always  has  the latest version.  The whole process should
  292.           take about 30 minutes, assuming that no one uses Suprtool  or  its
  293.           components during the installation.
  294.  
  295.           Follow these steps to install this update of Suprtool:
  296.  
  297.           1. Restore the new files from tape.
  298.  
  299.           2. Upgrade the structure of the Robelle account.
  300.  
  301.           3. Install the proper program files (NM or Classic).
  302.  
  303.           4. Install Speed Demon in the system SL (only Classic).
  304.  
  305.           5. Install   the  Suprtool2  interface  in  the  system  SL  (only
  306.              Classic).
  307.  
  308.           6. Limit Suprtool's runtime priority (optional).
  309.  
  310.           7. Install WinHelp documentation files (optional).
  311.  
  312.           8. Purge the installation files (optional).
  313.  
  314.  
  315.    This Tape Will Expire
  316.  
  317.           All Robelle pre-release software has an expiration  date,  because
  318.           you  should  be  replacing  your  pre-release  software  with  our
  319.           official  major  releases.   Pre-release  tapes   usually   expire
  320.           one-and-a-half  years after they are made.  The software will warn
  321.           you when you are within sixty days of the expiry date.
  322.  
  323.  
  324.    Installation Assistance
  325.  
  326.           If you have any questions or run into any  problems,  please  call
  327.           us.   Technical  support is available on weekdays from 7 a.m. to 4
  328.           p.m. Pacific time at 1-888-ROBELLE (1-888-762-3553).  You can also
  329.           receive  emergency  support  outside of these hours by calling our
  330.           regular phone number and asking the operator  to  page  a  support
  331.           person for you.
  332.  
  333.  
  334.    Important Note About Passwords
  335.  
  336.           None  of  the  jobs that we supply have passwords in them.  Before
  337.           streaming a job, you may have to add your  system's  passwords  to
  338.           the  first  line.  Users of MPE XL 3.0 and later do not have to do
  339.           this because the operating system prompts for  missing  passwords.
  340.           The  same  is true for some MPE V users who have security software
  341.           that inserts passwords.  Most MPE V users have to edit  the  jobs.
  342.           For  example,  if the system manager logon password is Qwerty, you
  343.           would do the following:
  344.  
  345.                :editor
  346.                HP32201A.07.22 EDIT/3000
  347.                /text robelle.pub.sys
  348.                FILE UNNUMBERED
  349.                /modify 1
  350.                MODIFY     1
  351.                !job robelle,manager.sys,pub;hipri;jobq=SUPRTOOL
  352.                                        i/qwerty
  353.                !job robelle,manager.sys/qwerty,pub;hipri;jobq=SUPRTOOL
  354.  
  355.                /keep robtemp
  356.                /exit
  357.                END OF SUBSYSTEM
  358.                :stream robtemp
  359.                :purge robtemp
  360.  
  361.  
  362.    STREAMX Users
  363.  
  364.           Users of STREAMX, a part of SECURITY/3000 from VESOFT  Inc.,  must
  365.           set  a  Job  Control  Word  before  streaming jobs.  This prevents
  366.           STREAMX from generating an error if the Robelle account  does  not
  367.           yet exist.  For example,
  368.  
  369.                :setjcw streamxtempnonest 1
  370.                :stream robelle.pub.sys
  371.  
  372.  
  373.    Step 1:  Restore the Files
  374.  
  375.           You begin by restoring all the files from the tape.
  376.  
  377.               :hello manager.sys
  378.               :file   rtape;   dev=tape                    {use  appropriate
  379.           device}
  380.               :restore *rtape; @.@.robelle; create    {restore everything}
  381.  
  382.           The Suprtool program files are located in the Pubnew group of  the
  383.           Robelle account.  These are the names of the various files:
  384.  
  385.                suprcm.pubnew      suprnm.pubnew         {Suprtool}
  386.                linkcm.pubnew      linknm.pubnew         {Suprlink}
  387.                stexpcm.pubnew     stexpnm.pubnew        {STExport}
  388.                demoncm.pubnew     demonnm.pubnew        {Demon Program}
  389.                demonusl.pubnew                          {SPDE USL File}
  390.                                   demonxl.pubnew        {SPDE XL File}
  391.                st2usl.pubnew                            {ST2 USL File}
  392.                                   st2xl.pubnew          {ST2 XL File}
  393.  
  394.  
  395.    Step 2:  Set Up the Robelle Account
  396.  
  397.           Even  if you already have the Robelle account, you must stream the
  398.           Robelle job to ensure that the Robelle account and all its  groups
  399.           have the proper security and capabilities.
  400.  
  401.                :stream robelle.job.robelle
  402.  
  403.           When  the job stream is finished, it will send you a message.  The
  404.           job removes the password from the Robelle account.  Stay logged on
  405.           as  Manager.Sys and put a password on the Robelle account.  If you
  406.           are upgrading your Robelle account, use the old password.
  407.  
  408.                :altacct robelle;pass=hardpass    {hard to guess}
  409.  
  410.           Please note that during installation we add OP capability  to  the
  411.           Robelle  account.  When the Suprtool installation is finished, you
  412.           have the option to remove OP capability.
  413.  
  414.  
  415.    Step 3:  Install Suprtool into Production
  416.  
  417.           Our installation job installs Suprtool, STExport, Suprlink,  Speed
  418.           Demon, and the Suprtool2 interface.  No one can use these programs
  419.           during the installation.  Before you stream this installation job,
  420.           warn people not to use these programs for a while.
  421.  
  422.                :hello mgr.robelle
  423.                :warn @;please exit from Suprtool and Suprlink NOW!
  424.                :stream install.Suprjnew
  425.  
  426.           Once  Suprtool  has  been  installed,  check  the installation job
  427.           $stdlist.   If  anyone  was  either  using   Suprtool,   STExport,
  428.           Suprlink,  or  Speed  Demon,  or  attempting  to back them up, the
  429.           installation job will fail.  Chase away any users, ensure  that  a
  430.           backup is not in progress, then stream the installation job again.
  431.  
  432.           The installation job renames your current versions of Suprtool and
  433.           its components to the PubOld group of the Robelle account.  If you
  434.           need  to  move  these  versions  back  into  production,  use  the
  435.           Previous.Suprjnew job stream.
  436.  
  437.           You can now access Suprtool by entering
  438.  
  439.                :run suprtool.pub.robelle
  440.  
  441.  
  442.    Optional Installation Steps
  443.  
  444.           On  MPE/iX  your  installation  should be complete.  If you have a
  445.           copy of Speed Demon or the Suprtool2  interface  in  your  own  XL
  446.           files, you will have to update them with the new versions (use the
  447.           instructions  in  the  Speed  Demon  and  Calling  Suprtool   user
  448.           manuals).
  449.  
  450.           To  use the new versions on MPE V, you still need to install Speed
  451.           Demon and Suprtool2 in the system SL.  MPE/iX users must  also  do
  452.           this   if   they   are  calling  Speed  Demon  or  Suprtool2  from
  453.           compatibility-mode programs.  With so few changes to  Speed  Demon
  454.           and  Suprtool2,  you  can  safely  ignore them for this version of
  455.           Suprtool.
  456.  
  457.           If you have a  Windows  PC,  you  can  install  all  the  Suprtool
  458.           documentation  on  it  in  the popular WinHelp format of Microsoft
  459.           Windows.
  460.  
  461.  
  462.  
  463.    Step 4:  Speed Demon/V Installation (optional)
  464.  
  465.           To use the new features of Speed Demon/V,  you  must  install  the
  466.           latest   version   in  the  system  SL.   You  should  follow  the
  467.           installation instructions in the Speed Demon user  manual.   These
  468.           instructions  assume  that  you have used the Install.Suprjnew job
  469.           stream to move Suprtool and its components into the Pub  group  of
  470.           the Robelle account.
  471.  
  472.                :stream demon.Suprjnew.robelle
  473.  
  474.  
  475.    Step 5:  Suprtool2 Interface Installation (only Classic)
  476.  
  477.           The  Suprtool2  interface  has  been  revised.   On MPE V you must
  478.           re-install the interface.  If you do not have the latest Suprtool2
  479.           interface, programs that attempt to use totals from Suprtool2 will
  480.           fail.  You can install this interface without recompiling  any  of
  481.           your existing programs.
  482.  
  483.  
  484.    System SL Installation
  485.  
  486.           To  install  the  latest Suprtool2 interface in the system SL, use
  487.           our standard installation job:
  488.  
  489.                :stream suprcall.Suprjnew.robelle
  490.  
  491.  
  492.    User SL or XL Files
  493.  
  494.           If you have a copy of the Suprtool2 interface in your  own  SL  or
  495.           XL,  you  will  need  to update it.  For instructions on how to do
  496.           this, consult the user manual for Calling Suprtool.
  497.  
  498.  
  499.    Step 6:  Limit Suprtool's Runtime Priority (optional)
  500.  
  501.           Some system managers like to restrict the amount of resources that
  502.           Suprtool  consumes.   One way to do this is by running Suprtool in
  503.           the D queue, which lets you use HP's Linkedit program.
  504.  
  505.                :linkedit
  506.                >altprog suprtool;maxpri=ds
  507.                >exit
  508.  
  509.           By forcing Suprtool to always run in the lower  queue  (even  when
  510.           Suprtool  runs  on-line),  it  competes  less  with  on-line users
  511.           because most users run in the C  queue.   System  managers  should
  512.           only  restrict  the priority of Suprtool if they are familiar with
  513.           MPE process queues and the Tune command.
  514.  
  515.  
  516.    Step 7:  Install WinHelp Documentation Files (optional)
  517.  
  518.           All of the Suprtool documentation is now available in the  WinHelp
  519.           format for Microsoft Windows.  You can only use these files if you
  520.           have a Windows PC.
  521.  
  522.  
  523.    Make a Temporary Directory for the Setup Program
  524.  
  525.           Create a new directory for the installation files on your PC.  You
  526.           can  remove  this  directory  after  the  WinHelp  files have been
  527.           installed.  From the DOS prompt for example, type
  528.  
  529.                mkdir \robtemp
  530.  
  531.  
  532.    Download the Compressed File
  533.  
  534.           In the next step, download the self-extracting Zip file to your PC
  535.           with   Reflection.    The   file   on   the   HP  3000  is  called
  536.           Suprhelp.Whelp.Robelle.  You should be logged on as Mgr.Robelle.
  537.  
  538.           Press Alt-Y to go to the Reflection  Command  Line  window.   Make
  539.           sure that you use the binary transfer.
  540.  
  541.                receive c:\robtemp\suprhelp.exe
  542.                       from suprhelp.whelp.robelle binary
  543.  
  544.  
  545.    Expand the Compressed File
  546.  
  547.           You  need only the following commands to extract the files because
  548.           we  provide  the  Setup  program  and  the  Help  files   in   one
  549.           self-extracting Zip file.  From the DOS prompt, type
  550.  
  551.                cd \robtemp          {go to the new Robtemp directory}
  552.                suprhelp.exe         {extract the Help files}
  553.  
  554.  
  555.    Run the Setup Program
  556.  
  557.           Now you can run the Setup program.  In Windows 95, select Run from
  558.           the Start menu and  enter  c:\robtemp\setup  in  the  Run  window.
  559.           Follow the instructions in the Setup program.
  560.  
  561.           Once  the  Setup  program  is  finished, you can access all of the
  562.           Suprtool documentation by selecting  any  of  the  "Robelle  Help"
  563.           icons.
  564.  
  565.  
  566.    Remove the Robtemp Directory
  567.  
  568.           Delete  all  of  the  files  in  the Robtemp directory either from
  569.           Explorer in Windows 95 or with the following DOS commands:
  570.  
  571.                cd \robtemp
  572.                del *.*                 {delete all the files}
  573.                cd ..
  574.                rmdir robtemp           {remove the Robtemp directory}
  575.  
  576.           You can  also  copy  the  files  in  Robtemp  to  a  diskette  and
  577.           distribute them to other Suprtool users.
  578.  
  579.  
  580.  
  581.    Step 8:  Purge Installation Files (optional)
  582.  
  583.           The easiest way to clean up after an installation is to stream the
  584.           Cleanup.Purgejob.Robelle job.  This job saves you  disc  space  by
  585.           purging  the installation files.  It does not purge the files that
  586.           are necessary to run the software.
  587.  
  588.  
  589.    Enhancements
  590.  
  591.  
  592.           The following are enhancements made to  Suprtool  since  the  last
  593.           major release.
  594.  
  595.  
  596.    Btree Support [4.0.11]
  597.  
  598.  
  599.           HP  added  a  generic  search and partial key retrieval feature to
  600.           IMAGE/SQL by attaching Btrees to a given master dataset key  item.
  601.           This  feature  is  available  in versions of IMAGE/SQL C.07.03 and
  602.           later.  To determine the version number of IMAGE, run Query  (:Run
  603.           Query.Pub.Sys) and enter the Version command.
  604.  
  605.              :run query.pub.sys
  606.              >version
  607.  
  608.           Similarly, you can also run Dbutil.Pub.Sys, type Help and look for
  609.           the Addindex command.
  610.  
  611.           Btrees are allowed to be built only on the key  item  of  a  given
  612.           manual  or  automatic master dataset.  However, if the path into a
  613.           given detail dataset has an attached  Btree,  you  can  implicitly
  614.           take  advantage of the Btree and a partial key lookup will work on
  615.           the associated detail.
  616.  
  617.           Suprtool has been enhanced to take advantage of these  Btrees  via
  618.           the  Chain  command.   Suprtool  also shows any Btrees that it can
  619.           utilize through the Form command.
  620.  
  621.  
  622.    Chain Command  [4.0.11]
  623.  
  624.           The Chain command only takes advantage of these if the  BtreeMode1
  625.           setting  is  turned on at the root level.  This setting means that
  626.           all DBFIND mode-1 calls will utilize the Btree.
  627.  
  628.           You can turn BtreeMode1 on by doing the following:
  629.  
  630.              :run dbutil.pub.sys
  631.              >>set BtreeMode1=on
  632.  
  633.           The Chain command has been  enhanced  to  allow  the  partial  key
  634.           retrieval  on  X and U items on the master dataset, and implicitly
  635.           on any associated detail dataset.  For example,
  636.  
  637.             >base cd.db.data,5,reader
  638.             >chain a-songs,song-title="w@"
  639.             >list
  640.             >xeq
  641.             Warning:  Using DBGET for the input records
  642.             >GET A-SONGS (289) >OUT $NULL (0)
  643.             SONG-TITLE      = we only come out at night
  644.  
  645.             >GET A-SONGS (56) >OUT $NULL (1)
  646.             SONG-TITLE      = where boys fear to tread
  647.  
  648.             IN=2, OUT=2.  CPU-Sec=1.  Wall-Sec=1.
  649.  
  650.           As previously mentioned, we can search a detail dataset  by  using
  651.           the implicit Btree or the search item that has a Btree attached to
  652.           the associated master.
  653.  
  654.             >chain d-songs,song-title="w@"
  655.             >list
  656.             >xeq
  657.             Warning:  Using DBGET for the input records
  658.             >GET D-SONGS (37) >OUT $NULL (0)
  659.             CD-NO      = 2                    CD-TITLE    = Mellon Collie
  660.             ARTIST     = Smashing Pumpkins    SONG-NO     = 10
  661.             SONG-TITLE = we only come out at night
  662.  
  663.             >GET D-SONGS (28) >OUT $NULL (1)
  664.             CD-NO      = 2                    CD-TITLE    = Mellon Collie
  665.             ARTIST     = Smashing Pumpkins    SONG-NO     = 1
  666.             SONG-TITLE = where boys fear to tread
  667.  
  668.             IN=2, OUT=2.  CPU-Sec=1.  Wall-Sec=1.
  669.  
  670.  
  671.  
  672.    Form Command  [4.0.11]
  673.  
  674.  
  675.           The Form command has been  enhanced  to  show  whether  there  are
  676.           Btrees that the Suprtool Chain command can utilize.  Currently the
  677.           Chain command utilizes only those Btrees that are  type  X  or  U.
  678.           The Form command does not show Btrees that it cannot utilize, even
  679.           if the Btree does exist.
  680.  
  681.           The Form command also reports a damaged Btree.
  682.  
  683.            >form sets
  684.  
  685.            Database: CD.DB.DATA
  686.                      BtreeMode1 = ON       Wildcard character : @
  687.  
  688.                         Set       Item            Entry  Load   Entry
  689.            Sets:        Num Type  Count Capacity  Count  Factor Length  B/F
  690.             M-ARTIST    1   M  i  2     211       3      1  %   75      4
  691.             A-SONGS     2   A  i  1     307       41     13 %   20      16
  692.             A-CD-TITLE  3   A  i  1     211       3      1  %   20      16
  693.             D-SONGS     4   D     6     1004      41     4  %   78      4
  694.  
  695.            >form m-artist
  696.            Database: CD.DB.DATA
  697.                      BtreeMode1 = ON       Wildcard character : @
  698.  
  699.                M-ARTIST         Master    Indexed       Set 1
  700.                   Entry:                     Offset
  701.                      ARTIST               X30     1  <<Search Field>>
  702.                      NOTES               2X60    31
  703.                Capacity: 211 (4)  Entries: 3  Bytes: 150
  704.  
  705.            >form d-songs
  706.            Database: CD.DB.DATA
  707.                      BtreeMode1 = ON       Wildcard character : @
  708.  
  709.              D-SONGS          Detail                  Set 4
  710.                  Entry:                     Offset
  711.                    CD-NO                J2      1
  712.                    CD-TITLE             X40     5  (!A-CD-TITLE) <<Indexed>>
  713.                    SUB-TITLE            X40    45
  714.                    ARTIST               X30    85  (M-ARTIST) <<Indexed>>
  715.                    SONG-NO              J1    115
  716.                    SONG-TITLE           X40   117  (A-SONGS) <<Indexed>>
  717.             Capacity: 1004 (4)  Entries: 41  Highwater: 41  Bytes: 156
  718.  
  719.  
  720.    Master Dataset Expansion (MDX)
  721.  
  722.           In  a  soon  to  be released version of IMAGE/SQL, master datasets
  723.           will be able to expand  while  records  are  being  put  into  the
  724.           database.   This  new  capability is similar to the Detail Dataset
  725.           Expansion (DDX), which was made available with MPE/iX 5.0.
  726.  
  727.  
  728.    Form Command  [4.0.11]
  729.  
  730.           The Form Sets command indicates which datasets have  MDX  enabled.
  731.           A  Form command on these datasets shows details of their expansion
  732.           setting.
  733.  
  734.  
  735.           >form sets
  736.  
  737.           Database: STORE.MDX.DATA
  738.  
  739.                          Set       Item           Entry  Load   Entry
  740.            Sets:         Num Type  Count Capacity Count  Factor Length B/F
  741.             M-CUSTOMER   1   MDX   9     2009     401     20 %   55     7
  742.             M-PRODUCT    2   MDX   3     3012     0       0  %   24     12
  743.             M-SUPPLIER   3   MDX   6     2008     0       0  %   49     8
  744.             D-INVENTORY  4   D     6     462      0       0  %   15     22
  745.             D-SALES      5   D     8     6006     0       0  %   19     14
  746.  
  747.           >form m-customer
  748.  
  749.           Database: STORE.SUPRMDX.GREEN
  750.  
  751.               M-CUSTOMER       Master                  Set 1
  752.                  Entry:                     Offset
  753.                     CITY                 X12     1
  754.                     CREDIT-RATING        J2     13
  755.                     CUST-ACCOUNT         Z8     17  <<Search Field>>
  756.                     CUST-STATUS          X2     25
  757.                     NAME-FIRST           X10    27
  758.                     NAME-LAST            X16    37
  759.                     STATE-CODE           X2     53
  760.                     STREET-ADDRESS      2X25    55
  761.                     POSTAL-CODE          X6    105
  762.             Capacity: 469 (7), 217, 252, 2009  Entries: 401 Highwater: 401
  763.  
  764.           As you can see, the master dataset  summary  information  for  the
  765.           Capacity  shows  the  Current  Capacity (469), the Blocking Factor
  766.           (7), the Initial Capacity (217), the Increment (252)  and  finally
  767.           the  Maximum  Capacity  (2009).   The  Increment  is the number of
  768.           entries by which the master dataset  increases  from  the  current
  769.           capacity.
  770.  
  771.           Unlike  DDX,  the percentage at which an expansion is triggered is
  772.           not documented (nor shown) and  may  change  between  versions  of
  773.           IMAGE.
  774.  
  775.  
  776.    Duplicate Command  [4.0.14]
  777.  
  778.           The  Keys  Num  option  determines  the  level  at  which Suprtool
  779.           compares sort keys.  This option controls which duplicate  records
  780.           get included in (or excluded from) the output file.
  781.  
  782.           In  the  following  example  we sort by agent and by bill-date (in
  783.           descending order), but only check  for  duplicates  at  the  agent
  784.           level.
  785.  
  786.                >sort agent              {sort by agent}
  787.                >sort bill-date,desc     {sort by date }
  788.                >duplicate none keys 1   {only check for duplicate agents}
  789.                >output agents           {create roster of agents}
  790.  
  791.  
  792.    Item Command  [4.0.11]
  793.  
  794.           Software  packages  from  Software  Research  Northwest use a date
  795.           format known as Chronos, which stores  the  date  and  time  in  a
  796.           compressed 6-byte format.  In Suprtool, you specify this format by
  797.           using the Srnchronos date attribute.
  798.  
  799.                >item box-timestamp,date,srnchronos
  800.  
  801.           Once you have used the Item command to identify these  dates,  you
  802.           can do the following:
  803.  
  804.           1. Select  on  these  dates  using the $date and $today functions.
  805.              For example, to select records with a timestamp before today:
  806.  
  807.                   >if   box-timestamp < $today
  808.  
  809.           2. Extract these dates using $date and $today.
  810.  
  811.           3. See the date attribute in the Form command.
  812.  
  813.           4. Pass the date attribute to STExport by using the Link option of
  814.              the Output command.
  815.  
  816.           5. Format these dates into a readable value by using STExport.
  817.  
  818.  
  819.    Item Command Abbreviations  [4.0.11]
  820.  
  821.           If  you specify the Date keyword, you can now use a leading subset
  822.           for the date attribute.  In previous versions of Suprtool, you had
  823.           to always fully specify the date attribute.
  824.  
  825.  
  826.    Nested Use Files  [4.0.11]
  827.  
  828.           Suprtool  now  allows  usefiles  to be nested; in other words, one
  829.           usefile can contain references to another usefile.  You  can  nest
  830.           the usefiles up to ten levels.
  831.  
  832.           For example, if the contents of the Usedef usefile had a reference
  833.           to Useext, both usefiles would be executed:
  834.  
  835.                >base store.suprtool
  836.                >get d-sales
  837.                >use usedef
  838.                define delivered,deliv_date
  839.                define purchased,purch_date
  840.                item delivered ,date ,yymmdd
  841.                item purchased ,date ,yymmdd
  842.                use useext
  843.                ext cust-account
  844.                ext deliv-date
  845.                ext product-no
  846.                ext product-price
  847.                ext purch-date
  848.                ext sales-qty
  849.                ext sales-tax
  850.                ext sales-total
  851.                >xeq
  852.  
  853.           Care must be taken when  entering  Use  commands  with  a  stacked
  854.           command after the usefile reference.  For example, if you enter
  855.  
  856.                use usedef;def j,1,6,byte
  857.  
  858.           the Define command will not be executed until after the Usedef and
  859.           any other nested Use commands are finished.
  860.  
  861.  
  862.    Set Date Ifyy2000Error On | Off  [4.0.16]
  863.  
  864.           By default Suprtool considers Dates with a two-digit century  from
  865.           the  $date and $today functions to be invalid when they resolve to
  866.           be greater than 1999 and the if operation is a relative operation.
  867.           (ie.  greater than or equal to)
  868.  
  869.           You can control whether or not Suprtool considers this an error or
  870.           not by making the following Set command:
  871.  
  872.               >set Date Ifyy2000Error Off
  873.  
  874.           Following is an example of what is considered to be and  error  by
  875.           the  if  command  and  how  the Set command can turn off the error
  876.           check:
  877.  
  878.                >def a,1,6
  879.                >item a,date,yymmdd
  880.                >if a >= $today(+2000)
  881.                           ^
  882.                 Error:  Cannot use a date beyond 1999 for this format
  883.                 >set date ifyy2000error off
  884.                 >if a >= $date(2000/01/03)
  885.  
  886.           We have chosen this to be an error by default because  if  a  date
  887.           that  is in yymmdd format and resolves to be 000102 from the $date
  888.           function in the if command is likely to resolve to be all  of  the
  889.           records  for  a  given  dataset.   This  is  of  course, logically
  890.           incorrect and if you include a delete command in this task you can
  891.           potentially remove all of your records.
  892.  
  893.  
  894.    Set Limits ReadOnly On  [4.0.12]
  895.  
  896.           Suprtool   normally   allows  any  user  with  the  proper  access
  897.           capabilities to add, update and delete records to a database.   To
  898.           prevent  users  from  accidentally  updating  their  database,  we
  899.           provide the following setting within Suprtool:
  900.  
  901.  
  902.                >set limits ReadOnly On
  903.  
  904.           The ReadOnly setting, once turned on, cannot be turned off for the
  905.           current  run  of  Suprtool,  which  disallows  all  commands  that
  906.           potentially change data for a given database.
  907.  
  908.           If Set Limits ReadOnly is enabled,  the  following  commands  from
  909.           within  Suprtool  and Dbedit will not be processed and will return
  910.           an error:
  911.  
  912.               Suprtool
  913.                 Delete
  914.                 Put
  915.                 Update
  916.               Dbedit
  917.                 Add
  918.                 Change
  919.                 Delete
  920.                 Modify
  921.  
  922.           You can enable Set Limits ReadOnly from the command line by  using
  923.           the  Info  String  and  Parm  option.   For example, the following
  924.           command file can be used to restrict who has  write  access  to  a
  925.           given  database.   In  this  example  only the Mgr user is allowed
  926.           write access:
  927.  
  928.             IF HPUSER = "MGR" THEN
  929.                Run Suprtool.pub.robelle
  930.             else
  931.                Run suprtool.pub.robelle;parm=8;info='set limits readonly on'
  932.             endif
  933.  
  934.  
  935.  
  936.    Set Limits Tablesize num  [4.0.14]
  937.  
  938.           Suprtool  previously  allowed  a  total  of  15  megabytes for all
  939.           tables.  Now Suprtool allows each of the ten tables up to 2 GB.
  940.  
  941.                >set limits Tablesize 200
  942.  
  943.           The default size of a table is 2,047 megabytes.
  944.  
  945.  
  946.  
  947.    Tables  [4.0.14]
  948.  
  949.           The Table command is no longer limited to 15 megabytes for all ten
  950.           tables, but is now limited to 2,047 megabytes per table.
  951.  
  952.           If $Lookup
  953.  
  954.           CPU  and  Wall  time  has been reduced in table $lookup functions.
  955.           Our tests have shown that the CPU and Wall has been cut in half on
  956.           tests  with  a  single  table  of approximately 10 megabytes.  The
  957.           performance improvement is less for extracts with multiple tables.
  958.           Your  performance  may  vary  because  it is dependant on numerous
  959.           factors, of which memory is the most important.
  960.  
  961.           Notes
  962.  
  963.           We have tested loading and utilizing a table five (5) times bigger
  964.           than  the  available memory.  Specifically, we have loaded a table
  965.           with 630 megabytes of information on a system with  112  megabytes
  966.           of memory.
  967.  
  968.           We  do  not  recommend loading a table with the File option if the
  969.           total size of the table is greater than 50% of the total memory on
  970.           your  system.   We  recommend that you sort the file with Suprtool
  971.           before loading the table with the Table command.
  972.  
  973.           We are interested in  getting  feedback  on  both  functional  and
  974.           performance  data  in regards to table functions in the NM version
  975.           of Suprtool.
  976.  
  977.  
  978.  
  979.    Year 2000 Testing
  980.  
  981.           Testing software to see if it works in the year 2000 and beyond is
  982.           difficult.   Currently  there are three software tools that change
  983.           the software date for specific sessions or applications, making it
  984.           easier to test software for year 2000 compliance.  The three tools
  985.           are:
  986.  
  987.  
  988.           1. Hourglass from Allegro Consultants, Inc.
  989.  
  990.           2. Time Machine from SolutionSoft Systems, Inc.
  991.  
  992.           3. Setdate from the HP Jazz machine on the Web.
  993.  
  994.           Previous versions of Suprtool  would  only  work  with  Hourglass.
  995.           This  new version of Suprtool now works with both Time Machine and
  996.           Setdate.  Note that  this  change  only  applies  to  non-expiring
  997.           versions  of  Suprtool.   Expiring  versions  of Suprtool (such as
  998.           trials, pre-releases, and products obtained through VARs)  do  not
  999.           work with Time Machine or Setdate.  [4.0.13]
  1000.  
  1001.  
  1002.    Bugs Fixed
  1003.  
  1004.  
  1005.    Export Command.  The  Export  command  in  Suprtool now uses the procinfo
  1006.           intrinsic  instead  of  the  getprocinfo  intrinsic  in  order  to
  1007.           determine  if the process is still alive.  This is to workaround a
  1008.           problem in the getprocinfo intrinsic, which intermittently  caused
  1009.           STExport to hang.
  1010.  
  1011.  
  1012.    Export Command.  The following problems in STExport have been fixed:
  1013.  
  1014.           1. STExport  would  not  properly  set  the Delimiter to None on a
  1015.              second task when setting the HTML option to Table.  [4.0.11]
  1016.  
  1017.           2. STExport would fail if the total length of the  Heading  Column
  1018.              commands exceeded the total size of the fields.  [4.0.11]
  1019.  
  1020.           3. STExport  would  not  handle zoned-decimal fields properly when
  1021.              zero was set to leading.  [4.0.13]
  1022.  
  1023.           4. STExport was failing  with  invalid  write-length  error  if  a
  1024.              phdate  field  was  in  the  SD  file  and sign none option was
  1025.              specified.  [4.0.14]
  1026.  
  1027.  
  1028.    Form  Command.  The  Form  command  from  within  Suprtool  would   print
  1029.           Undefined  TPI  Utility  if  run  with  xl="xl.pub.disc"  and  the
  1030.           database did not have any Omnidex indexes configured.  [4.0.13]
  1031.  
  1032.  
  1033.    Form  Command.  The Form command would not print  all  TPI  indexes  when
  1034.           using Superdex Level One.  [4.0.16]
  1035.  
  1036.  
  1037.    If Command.  The  If command did not produce an error if a relative $date
  1038.           or $today function were specified beyond 1999.  [4.0.10]
  1039.  
  1040.  
  1041.    Link Command.  The  Link  command  from  within  Suprtool  now  uses  the
  1042.           procinfo  intrinsic  instead of the getprocinfo intrinsic in order
  1043.           to determine if the process is still alive.  This is to workaround
  1044.           a problem in the getprocinfo intrinsic which intermittently caused
  1045.           Suprlink to hang.
  1046.  
  1047.  
  1048.    Link Command.  Suprlink would not properly link files by a  Quad  integer
  1049.           key.  (I4 or J4).  [4.0.11]
  1050.  
  1051.  
  1052.    Select Command.  Suprtool/V  did  print  an error message when the Select
  1053.           command was entered.  [4.0.11]
  1054.  
  1055.  
  1056.    Suprmgr File.  Suprtool 4.0.11 did not process any of the commands in the
  1057.           Suprmgr file.  [4.0.12]
  1058.