home *** CD-ROM | disk | FTP | other *** search
/ ftp.robelle3000.ai 2014 / 2014.06.ftp.robelle3000.ai.tar / ftp.robelle3000.ai / changes / supr4p4ix.txt < prev    next >
Text File  |  2001-12-02  |  43KB  |  1,063 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                              SUPRTOOL Version 4.4
  7.  
  8.  
  9.                       Database Handyman for the HP e3000
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                  Change Notice
  17.                            Installation Instructions
  18.                           Addendum to 4.3 User Manual
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                             Suprtool         4.4
  26.                             Dbedit           4.4
  27.                             Suprlink         4.4
  28.                             STExport         4.4
  29.                             Speed Demon      4.4
  30.                             Suprtool2        4.8
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                          Robelle Solutions Technology
  38.                           Suite 201, 15399-102A Ave.
  39.                          Surrey, B.C.  Canada V3R 7K1
  40.  
  41.                            Toll-free:  1.888.robelle
  42.                              Phone:  604.582.1700
  43.                               Fax:  604.582.1799
  44.  
  45.                          E-mail:  support@robelle.com
  46.                              Web:  www.robelle.com
  47.  
  48.                                  February 2001
  49.           Program and Manual Copyright  Robelle  Solutions  Technology  Inc.
  50.           1981-2001
  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 Solutions  Technology
  60.           Inc.   Other product and company names mentioned herein may be the
  61.           trademarks of their respective owners.
  62.  
  63.  
  64.  
  65.    Introducing Suprtool Version 4.4
  66.  
  67.  
  68.                *  Highlights
  69.                *  Compatibility
  70.                *  CPU Serial Number and CPU Name
  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 e3000.   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 can 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.  
  85.    Highlights
  86.  
  87.  
  88.           *  Suprtool now supports string expressions in  both  the  Extract
  89.              and  If commands.  String expressions allow users to select and
  90.              format  their  byte-type  data  in  numerous  new  ways.   This
  91.              includes  combining  byte-type  fields together, upshifting and
  92.              downshifting data, and trimming  blanks.   These  new  features
  93.              combine  to  reduce  the  number  of tasks needed to select and
  94.              format the data the way you need it.
  95.  
  96.           *  Suprtool, Speed Demon and HowMessy now support the new database
  97.              limits  of  1,200  items,  240  sets  and 64 paths for a master
  98.              dataset.
  99.  
  100.           *  Suprtool now supports the new Entrynumber format for  databases
  101.              available in IMAGE version C.09.00 and later.
  102.  
  103.           *  Suprtool now supports 5,100 bytes of constants to be extracted.
  104.              (only NM and HP-UX)
  105.  
  106.           *  Suprtool, Suprlink and STExport now have the ability to  create
  107.              their own persistent redo stacks.  The contents of these stacks
  108.              can be recalled not only in the current session, but also in  a
  109.              future session.
  110.  
  111.  
  112.    Known Problems
  113.  
  114.           There are no known problems at this time.
  115.  
  116.  
  117.    Compatibility
  118.  
  119.           Suprtool/iX  is  compatible  with  MPE  V,  MPE  XL,  and  MPE/iX,
  120.           including MPE/iX 6.5 and MPE/iX 7.0.
  121.  
  122.           Suprtool has been changed to no longer save an output file  if  no
  123.           records have been written and an error has occurred.
  124.  
  125.  
  126.    CPU Serial Number and CPU Name (HPSUSAN & HPCPUNAME)
  127.  
  128.           This  program  runs  only  on  CPUs whose serial numbers have been
  129.           encoded ("showvar hpsusan" on MPE/iX).  This program may  also  be
  130.           encoded  with  your  HPCPUNAME values.  If it fails to run and you
  131.           get an "invalid HPCPUNAME" or  "invalid  HPSUSAN"  error  message,
  132.           contact Robelle for assistance.
  133.  
  134.  
  135.    Compatibility Mode vs. Native Mode
  136.  
  137.           Throughout   this  change  notice  and  in  all  of  the  Suprtool
  138.           documentation, there are  references  to  compatibility  mode  and
  139.           native mode.  If you are on a Classic HP e3000 (i.e., not MPE/iX),
  140.           you can use the compatibility-mode version of Suprtool.   Our  job
  141.           streams   automatically  install  the  correct  version  for  your
  142.           machine.  We use the terms MPE XL and  MPE/iX  interchangeably  in
  143.           our documentation.
  144.  
  145.  
  146.    Documentation
  147.  
  148.           This  release  includes  updated user manuals for Suprtool and its
  149.           components.  To print these manuals, use the Printdoc program.
  150.  
  151.                :run printdoc.pub.robelle
  152.  
  153.           This is the list of documentation files for Suprtool :
  154.  
  155.                suprtool.doc.robelle      {Suprtool user manual}
  156.                stexport.doc.robelle      {STExport user manual}
  157.                suprlink.doc.robelle      {Suprlink user manual}
  158.                dbedit.doc.robelle        {Dbedit user manual}
  159.                demon.doc.robelle         {Speed Demon user manual}
  160.                suprcall.doc.robelle      {Calling Suprtool user manual}
  161.                suprtool.docchg.robelle   {this change notice}
  162.  
  163.           If you know the file names of other  Robelle  documents,  you  can
  164.           print  them  with Printdoc or you can include the file name in the
  165.           :Run command.  For example, to print this change notice, type
  166.  
  167.                :run printdoc.pub.robelle;info="suprtool.docchg.robelle"
  168.  
  169.  
  170.    Documentation in WinHelp Format
  171.  
  172.           The user manuals for Suprtool and its components are all available
  173.           in  the  WinHelp  file  format  of  Microsoft  Windows.  Your tape
  174.           includes a WinHelp file, which  is  a  self-extracting  compressed
  175.           file  that  contains  all the Help files and a Setup program.  Use
  176.           the installation instructions in this change notice to install the
  177.           WinHelp files on your PC.
  178.  
  179.  
  180.    Installation of 4.4
  181.  
  182.           If  you  need to install this upgrade in an account other than the
  183.           Robelle account, use the installation instructions in the appendix
  184.           at the end of this change notice.
  185.  
  186.           The  following installation instructions are for existing Suprtool
  187.           users who are installing a new version  in  the  Robelle  account.
  188.           Please use the instructions from this change notice instead of the
  189.           user manual because  the  change  notice  always  has  the  latest
  190.           version.  The whole process should take about 30 minutes, assuming
  191.           no one uses Suprtool or its components during the installation.
  192.  
  193.           To install this update of Suprtool, follow these steps:
  194.  
  195.           1. Restore the new files from tape.
  196.  
  197.           2. Upgrade the structure of the Robelle account.
  198.  
  199.           3. Install the proper program files (NM or Classic).
  200.  
  201.           4. Install Speed Demon in the system SL (only Classic).
  202.  
  203.           5. Install  the  Suprtool2  interface  in  the  system  SL   (only
  204.              Classic).
  205.  
  206.           6. Limit Suprtool's run time priority (optional).
  207.  
  208.           7. Install WinHelp documentation files (optional).
  209.  
  210.           8. Install QLIB and Bonus programs.
  211.  
  212.           9. Purge the installation files (optional).
  213.  
  214.  
  215.    Ecometry Users
  216.  
  217.           Users  of  the  Ecometry  application need to use the installation
  218.           instructions supplied by Ecometry Corporation.  Those instructions
  219.           have extra steps for updating the Ecometry code accounts.
  220.  
  221.           You  will  find  the  Ecometry  version  of  these instructions at
  222.           http://www.robelle.com/ecometry/
  223.  
  224.  
  225.    Installation Assistance
  226.  
  227.           If you have any questions about the upgrade process  or  run  into
  228.           any  problems,  please call us.  Technical support is available on
  229.           weekdays from 7  a.m. to  4  p.m. Pacific  time  at  1.888.robelle
  230.           (1.888.762.3553).
  231.  
  232.  
  233.    Important Note about Passwords
  234.  
  235.           None  of  the  jobs that we supply have passwords in them.  Before
  236.           streaming a job, you might have to add your system's passwords  to
  237.           the  first  line.  Users of MPE XL 3.0 and later do not have to do
  238.           this because the operating system prompts for  missing  passwords.
  239.           The  same  is true for some MPE V users who have security software
  240.           that inserts passwords.  Most MPE V users have to edit  the  jobs.
  241.           For  example,  if the system manager logon password is Qwerty, you
  242.           would do the following:
  243.  
  244.                :editor
  245.                HP32201A.07.22 EDIT/3000
  246.                /text robelle.pub.sys
  247.                FILE UNNUMBERED
  248.                /modify 1
  249.                MODIFY     1
  250.                !job robelle,manager.sys,pub;hipri
  251.                                        i/qwerty
  252.                !job robelle,manager.sys/qwerty,pub;hipri
  253.  
  254.                /keep robtemp
  255.                /exit
  256.                END OF SUBSYSTEM
  257.                :stream robtemp
  258.                :purge robtemp
  259.  
  260.  
  261.    STREAMX Users
  262.  
  263.           Users of STREAMX, a part of SECURITY/3000 from VESOFT  Inc.,  must
  264.           set  a  Job  Control  Word  before  streaming jobs.  This prevents
  265.           STREAMX from generating an error if the Robelle account  does  not
  266.           yet exist.  For example,
  267.  
  268.                :setjcw streamxtempnonest 1
  269.                :stream robelle.pub.sys
  270.  
  271.  
  272.    Step 1:  Restore the Files
  273.  
  274.           You begin by restoring all the files from the tape.
  275.  
  276.                :hello manager.sys
  277.                :file   rtape;   dev=tape                   {use  appropriate
  278.           device}
  279.                :restore *rtape; @.@.robelle; create  {restore everything}
  280.  
  281.           The files on the tape require approximately 120,000  sectors.   If
  282.           you  are  upgrading  Suprtool,  most  of  these files will replace
  283.           existing files, because the new version of Suprtool does not  take
  284.           up much more space than the old version.
  285.  
  286.           The  Suprtool  program  files  are located in the Pub group of the
  287.           Robelle account.  At this point in the installation  process,  the
  288.           files  do not yet have the correct names.  The install job assigns
  289.           the proper names to the program files.
  290.  
  291.  
  292.    Step 2:  Set Up the Robelle Account
  293.  
  294.           Even if you already have the Robelle account, you must stream  the
  295.           Robelle  job to ensure that the Robelle account and all its groups
  296.           have the proper security and capabilities.
  297.  
  298.                :stream robelle.job.robelle
  299.  
  300.           When the job stream is finished, it will send you a message.   The
  301.           job removes the password from the Robelle account.  Stay logged on
  302.           as Manager.Sys and put a password on the Robelle account.  If  you
  303.           are upgrading your Robelle account, use the old password.
  304.  
  305.                :altacct robelle;pass=hardpass    {hard to guess}
  306.  
  307.           Note  that during installation we add OP capability to the Robelle
  308.           account.  After installing Suprtool, you have the option to remove
  309.           OP capability.
  310.  
  311.  
  312.    Step 3:  Install Suprtool into Production
  313.  
  314.           Our  installation job installs Suprtool, STExport, Suprlink, Speed
  315.           Demon, and the Suprtool2 interface.  No one can use these programs
  316.           during the installation.  Before you stream this installation job,
  317.           warn people not to use these programs for a while.
  318.  
  319.                :hello mgr.robelle
  320.                :warn @;please exit from Suprtool and Suprlink NOW!
  321.                :stream install.suprjob
  322.  
  323.           Once Suprtool has  been  installed,  check  the  installation  job
  324.           $stdlist.    If   anyone  was  either  using  Suprtool,  STExport,
  325.           Suprlink, or Speed Demon, or  attempting  to  back  them  up,  the
  326.           installation  job will fail.  Chase away any users and ensure that
  327.           a backup is not in progress,  then  stream  the  installation  job
  328.           again.
  329.  
  330.           The installation job renames your current versions of Suprtool and
  331.           its components to the PubOld group of the Robelle account.  If you
  332.           need  to  move  these  versions  back  into  production,  use  the
  333.           Previous.Suprjob job stream.
  334.  
  335.           You can now access Suprtool by entering
  336.  
  337.                :run suprtool.pub.robelle
  338.  
  339.  
  340.    Optional Installation Steps
  341.  
  342.           On MPE/iX your installation should be complete.   If  you  have  a
  343.           copy  of  Speed  Demon  or  the Suprtool2 interface in your own XL
  344.           files, you will have to update them with the new versions (use the
  345.           instructions   in  the  Speed  Demon  and  Calling  Suprtool  user
  346.           manuals).
  347.  
  348.           To use the new versions on MPE V, you still need to install  Speed
  349.           Demon  and  Suprtool2 in the system SL.  MPE/iX users must also do
  350.           this  if  they  are  calling  Speed  Demon   or   Suprtool2   from
  351.           compatibility-mode  programs.   With so few changes to Speed Demon
  352.           and Suprtool2, you can safely ignore  them  for  this  version  of
  353.           Suprtool.
  354.  
  355.           If  you  have  a  Windows  PC,  you  can  install all the Suprtool
  356.           documentation in the popular WinHelp format of Microsoft Windows.
  357.  
  358.  
  359.  
  360.    Step 4:  Speed Demon/V Installation (optional)
  361.  
  362.           To use the new features of Speed Demon/V,  you  must  install  the
  363.           latest   version   in  the  system  SL.   You  should  follow  the
  364.           installation instructions in the Speed Demon user  manual.   These
  365.           instructions  assume  that  you  have used the Install.Suprjob job
  366.           stream to move Suprtool and its components into the Pub  group  of
  367.           the Robelle account.
  368.  
  369.                :stream demon.suprjob.robelle
  370.  
  371.  
  372.    Step 5:  Suprtool2 Interface Installation (only Classic)
  373.  
  374.           The  Suprtool2  interface  has  been  revised.   On MPE V you must
  375.           re-install the interface.  If you do not have the latest Suprtool2
  376.           interface, programs that attempt to use totals from Suprtool2 will
  377.           fail.  You can install this interface without recompiling  any  of
  378.           your existing programs.
  379.  
  380.  
  381.    System SL Installation
  382.  
  383.           To  install  the  latest Suprtool2 interface in the system SL, use
  384.           our standard installation job:
  385.  
  386.                :stream suprcall.suprjob.robelle
  387.  
  388.  
  389.    User SL or XL Files
  390.  
  391.           If you have a copy of the Suprtool2 interface in your  own  SL  or
  392.           XL,  you  will  need  to update it.  For instructions on how to do
  393.           this, consult the user manual for Calling Suprtool.
  394.  
  395.  
  396.    Step 6:  Limit Suprtool's Run Time Priority (optional)
  397.  
  398.           Some system managers like to limit the amount  of  resources  that
  399.           Suprtool  consumes.   One way to do this is by running Suprtool in
  400.           the D queue.  You can configure this using HP's Linkedit program.
  401.  
  402.                :linkedit
  403.                >altprog suprtool;maxpri=ds
  404.                >exit
  405.  
  406.           By forcing Suprtool to always run in the lower  queue  (even  when
  407.           Suprtool  runs  on-line),  it  competes  less  with on-line users,
  408.           because most users run in the C  queue.   System  managers  should
  409.           restrict  the  priority of Suprtool only if they are familiar with
  410.           MPE process queues and the Tune command.
  411.  
  412.  
  413.    Step 7:  Install WinHelp Documentation Files (optional)
  414.  
  415.           The Suprtool documentation for both MPE and HP-UX is now available
  416.           in  the  WinHelp file format of Microsoft Windows.  To install the
  417.           WinHelp files on a PC, follow these instructions.
  418.  
  419.  
  420.    Make a Temporary Directory for the Setup Program
  421.  
  422.           From either DOS or Windows Explorer, make a directory  into  which
  423.           you  can  copy  the  installation  files.  For example, at the DOS
  424.           prompt type
  425.  
  426.                mkdir \robtemp
  427.  
  428.           You can remove this directory after installing the WinHelp files.
  429.  
  430.  
  431.    Download the Compressed File
  432.  
  433.           Use Reflection to download the self-extracting Zip file to your PC
  434.           and  continue  with these steps.  This Zip file on the HP e3000 is
  435.           called Suprhelp.WHelp.Robelle.  Log on as Mgr.Robelle,  and  press
  436.           Alt-Y  to  go to the Reflection Command Line window.  Then use the
  437.           following command to download the file using a binary transfer:
  438.  
  439.                receive c:\robtemp\suprhelp.exe
  440.                       from suprhelp.whelp.robelle binary
  441.  
  442.  
  443.    Expand the Compressed Files
  444.  
  445.           You only need the following commands to extract the files  because
  446.           we  provide  both  the  Setup  program  and  the Help files in one
  447.           self-extracting Zip file.  From the DOS prompt, type the following
  448.           commands:
  449.  
  450.                cd \robtemp          {go to the new Robtemp directory}
  451.                suprhelp.exe         {extract the Help files}
  452.  
  453.  
  454.    Run the Setup Program
  455.  
  456.           To  run  the  Setup program, select the Run command from the Start
  457.           menu.  When the Run window appears, enter C:\robtemp\setup in  the
  458.           Command  Line  window  and  follow  the  instructions in the Setup
  459.           program.
  460.  
  461.           When the Setup program ends, you can access all  of  the  Suprtool
  462.           documentation  by selecting any of the icons in the "Robelle Help"
  463.           Program Manager Group.
  464.  
  465.  
  466.    Remove the Robtemp Directory
  467.  
  468.           Before you remove the WinHelp  files,  you  can  copy  them  to  a
  469.           diskette or a CD and distribute them to other Suprtool users.
  470.  
  471.           To  delete all the WinHelp files and remove the Robtemp directory,
  472.           use either Windows Explorer or the following DOS commands:
  473.  
  474.                cd \robtemp
  475.                del *.*          {delete all the files in Robtemp}
  476.                cd ..
  477.                rmdir robtemp    {remove the Robtemp directory}
  478.  
  479.  
  480.    Step 8:  Install QLIB and Bonus Programs
  481.  
  482.           Suprtool comes with an array of contributed software in  the  QLIB
  483.           library  (in  the  QLIB  groups  of  the  Robelle  account).  QLIB
  484.           programs may be used on any CPU and  may  be  given  away  freely.
  485.           Your  Robelle  license  may  also entitle you to receive our Bonus
  486.           programs:  Compare/iX, HowMessy, Select, Spell, and Xpedit.  These
  487.           programs  reside  in  the Pub group of the Robelle account.  Bonus
  488.           programs can only be used on authorized machines, and you may  not
  489.           distribute them to anyone.
  490.  
  491.           If  you received Bonus programs with this version of Suprtool, use
  492.           the job stream called Bonus.Job.Robelle to install both  the  QLIB
  493.           and  Bonus  programs.   If you did not receive Bonus programs, use
  494.           the job stream Qlib.Job.Robelle to install the QLIB programs.
  495.  
  496.                :hello mgr.robelle
  497.                :stream bonus.job.robelle        {or Qlib.Job.Robelle}
  498.  
  499.           If you skip this step, you might end up running  old  versions  of
  500.           these programs.
  501.  
  502.  
  503.    Step 9:  Purge Installation Files (optional)
  504.  
  505.           The easiest way to clean up after an installation is to stream the
  506.           Cleanup.Purgejob.Robelle job.  This job saves you  disc  space  by
  507.           purging  the installation files.  It does not purge the files that
  508.           are necessary to run the software.
  509.  
  510.  
  511.    Enhancements
  512.  
  513.  
  514.           Every year we provide  Suprtool  users  with  new  features.   The
  515.           following section describes the new enhancements to Suprtool since
  516.           the last major release.
  517.  
  518.  
  519.    IMAGE Limits
  520.  
  521.           Starting with MPE/iX 6.5  Express  2,  a  new  version  of  IMAGE,
  522.           C.09.00,  will  be  available.   This version of IMAGE, as well as
  523.           later versions, now supports 1,200  items,  240  datasets  and  64
  524.           paths  from  a  master  dataset.  The previous limits for a master
  525.           were 1,023 items, 199 datasets and 16 paths.
  526.  
  527.           Suprtool, Speed Demon, Dbedit and HowMessy now  support  this  new
  528.           version of IMAGE.
  529.  
  530.  
  531.    Large Datasets
  532.  
  533.           IMAGE  now  supports  datasets  larger than 80 GB.  In order to do
  534.           this, the IMAGE label was changed to keep track of records and the
  535.           pointers that hold them together.  Prior to version C.09.00, IMAGE
  536.           stored records in what is known as  Entryname  format.   In  IMAGE
  537.           version  C.09.00 and later, you can now select a new option called
  538.           the Entrynumber format.
  539.  
  540.           This change to IMAGE must be invoked  either  by  building  a  new
  541.           database  or  by converting a database with an HP-supplied utility
  542.           called Dbbigset.Pub.Sys.  You can read more about this  change  in
  543.           the  MPE/iX  6.5  Express  2  Communicator (available at www.docs.
  544.           hp.com) or get more details from the Robelle Web site.
  545.  
  546.           Suprtool has been enhanced to support this new internal change  to
  547.           IMAGE.   HowMessy  currently  returns an error when you attempt to
  548.           report on a dataset with this feature enabled, because  the  block
  549.           number  calculations  are  no  longer  relevant  for  this type of
  550.           database.  We are currently reviewing how best to  report  on  the
  551.           efficiency of databases that use this new format.
  552.  
  553.  
  554.    Extracting Constants
  555.  
  556.           Until  now,  Suprtool  was limited to 1,530 bytes of constants for
  557.           MPE/iX and HP-UX versions of Suprtool.  This limit  has  now  been
  558.           increased  to 5,100 bytes.  The MPE/V version of Suprtool is still
  559.           limited to 1,275 bytes.
  560.  
  561.  
  562.    Persistent Redo
  563.  
  564.           Commands entered at the Suprtool prompt  are  saved  in  something
  565.           called the redo stack.  You can recall commands from this stack by
  566.           using other commands such as Before, Do and Redo.  By default, the
  567.           redo  stack is stored in a temporary file and discarded as soon as
  568.           you exit Suprtool.  This temporary stack is not  preserved  across
  569.           Suprtool invocations.
  570.  
  571.           The  new  Set  Redo  command  assigns a permanent file to the redo
  572.           stack, allowing the stack to become available for future  Suprtool
  573.           invocations.   For  example,  to  assign  the  Myredo  file  as  a
  574.           persistent redo stack, enter
  575.  
  576.                >set redo myredo
  577.  
  578.           If the file does  not  exist,  Suprtool  creates  it.   Otherwise,
  579.           Suprtool  uses  the  existing  file.   All subsequent commands are
  580.           written to the persistent redo stack.  This setting is  valid  for
  581.           the  duration  of  the  Suprtool  session.   As  soon  as you exit
  582.           Suprtool, the setting is discarded.  Next time you  run  Suprtool,
  583.           you will get the temporary stack.
  584.  
  585.           If  the  file  name is not qualified, the redo stack is created in
  586.           the logon group and account.  This may be desirable if you want to
  587.           have  separate  stacks.   If  you  want  to  always  use  the same
  588.           persistent stacks, you should qualify the name.
  589.  
  590.           The Verify command shows which stack is currently in use.   If  it
  591.           shows  <temporary>,  then  Suprtool  is  using  the default stack.
  592.           Anything else is the name  of  the  file  used  on  the  Set  Redo
  593.           command.
  594.  
  595.           If  a  file  with  the  specified  name already exists, it must be
  596.           specifically created by a Set Redo  command.   Suprtool,  Suprlink
  597.           and STExport do not overwrite an existing file.
  598.  
  599.  
  600.    Concurrency
  601.  
  602.           When  Suprtool  uses the default temporary stack, it is accessible
  603.           only to that particular instance of Suprtool.  You can run as many
  604.           Suprtool  instances  as  you  need  and each one gets its own redo
  605.           stack.  With temporary stacks, you  will  never  have  concurrency
  606.           problems.
  607.  
  608.           If  you  start  using  a persistent redo stack, however, you might
  609.           start running into concurrency problems.  A persistent redo  stack
  610.           can  be  used by only one Suprtool instance at a time.  If you try
  611.           to use a persistent redo stack that is already in  use,  you  will
  612.           get the following message:
  613.  
  614.                >set redo myredo
  615.                EXCLUSIVE VIOLATION: FILE BEING ACCESSED  (FSERR 90)
  616.                Unable to open file for REDO stack
  617.  
  618.           In this situation, Suprtool continues to use the redo stack active
  619.           at the time and lets you continue working as normal.
  620.  
  621.           Qedit can also have permanent redo stacks.   To  prevent  products
  622.           from  writing  to each other's redo stack, it is advisable to have
  623.           separate stacks for each product by  giving  them  different  file
  624.           names.  For example, if you use
  625.  
  626.                >set redo myredo
  627.  
  628.           you  will  have  a  redo  stack  called  Myredo  for your Suprtool
  629.           commands.  If you exit Suprtool, then run  Qedit  and  supply  the
  630.           same  Set Redo command, your Qedit commands will be written to the
  631.           same file that was used for your Suprtool commands.
  632.  
  633.  
  634.    String Expressions
  635.  
  636.           Both the Extract and If  commands  have  been  enhanced  to  allow
  637.           string expressions, which can be used to:
  638.  
  639.  
  640.           1. Combine two fields together (using the + operator).
  641.  
  642.           2. Remove spaces (using the built-in trim functions).
  643.  
  644.           3. Upshift or downshift characters.
  645.  
  646.           String  expressions  reduce  the number of tasks required for many
  647.           common operations involving byte-type fields.  Fewer  tasks  means
  648.           that  Suprtool delivers data to your applications faster than ever
  649.           before.
  650.  
  651.           These  changes  are  so  extensive  that  string  expressions  are
  652.           described  separately  for  the  Extract and If Commands.  See the
  653.           sections  below  for  specific  details  and  examples  of  string
  654.           expressions.
  655.  
  656.  
  657.    Extract Command
  658.  
  659.           You  can  now use string expressions in the Extract command.  They
  660.           allow you to  combine  byte-type  fields  together  (using  the  +
  661.           operator)  or  operate on byte-type fields with special functions.
  662.           In many cases, you can now reduce the number of tasks required  to
  663.           format  your  data  the  way  you  want.   Fewer  tasks means that
  664.           Suprtool delivers the data where you  need  it  faster  than  ever
  665.           before.  To extract a string expression, use this syntax:
  666.  
  667.                     EXTRACT target-field = expression
  668.  
  669.  
  670.    Target-Field
  671.  
  672.           The  target-field  determines  the  byte-length of the expression.
  673.           The data-type must be Byte or Char.  The expression  is  extracted
  674.           during  the  output  phase  and  cannot  be used by other Suprtool
  675.           commands that accept fields (e.g., Sort).
  676.  
  677.  
  678.    Examples
  679.  
  680.                >extract id-no = warehouse-no + bin-no
  681.  
  682.                >extract full-name = first-name + last-name
  683.  
  684.  
  685.    Constants vs. Expressions
  686.  
  687.           If you have  a  string  expression  that  starts  with  a  string,
  688.           Suprtool  assumes  that  you  are  attempting  to extract a single
  689.           string value and not a string expression.   To  specify  a  string
  690.           expression  that  starts  with a constant, surround the expression
  691.           with parentheses.  For example,
  692.  
  693.                Incorrect
  694.                >extract name = " " + product-desc
  695.  
  696.                Error:  Missing comma or invalid arithmetic expression
  697.  
  698.                Correct
  699.                >extract name = (" " + product-desc)
  700.  
  701.  
  702.    Variable Length Strings
  703.  
  704.           String expressions use variable-length  strings.   Suprtool  keeps
  705.           track  of  the length of every string, and all operations are done
  706.           using the actual string length.  For fields,  the  length  of  the
  707.           string  is  the length of the field.  If you do not want to retain
  708.           all the spaces in a  field,  use  one  of  the  built-in  trimming
  709.           functions.
  710.  
  711.           String  constants  are  created  with  the  exact  length  of  the
  712.           constant.  For example, the string "abc" is three characters  long
  713.           and the string "a" is one.
  714.  
  715.           When assigning the string expression to the target field, Suprtool
  716.           pads the final string value with spaces to  fill  out  the  target
  717.           field.   String  expressions longer than the target field generate
  718.           an error.
  719.  
  720.                >in testfile
  721.                >def a,1,10,byte
  722.                >ext a="I'm too long for this container"
  723.  
  724.                Error:  String is too long for the specified item
  725.  
  726.  
  727.    String Truncation
  728.  
  729.           Suprtool produces an error if the string expression is longer than
  730.           the  target field.  You cannot override this error with Set Ignore
  731.           On.  To help avoid the error, you may want to trim trailing spaces
  732.           from  the expression before assigning it to the target field.  For
  733.           example,
  734.  
  735.                >extract new-field = $trim(a + b + c)
  736.  
  737.  
  738.    Upshifting Strings ($Upper)
  739.  
  740.           Use the built-in function $upper to upshift all the characters  of
  741.           a  string expression into uppercase characters.  This function can
  742.           be  used  to  upshift  a  single  field,  a   complicated   string
  743.           expression,  or  any  subpart  of  an  expression.  Both ASCII and
  744.           Roman-8 characters are upshifted by $upper.  For example,
  745.  
  746.                >extract city-up = $upper(city)
  747.  
  748.                >extract full-name = $upper(first + last)
  749.  
  750.                >extract desc = desc-1 + $upper(desc-2)
  751.  
  752.  
  753.    Downshifting Strings ($Lower)
  754.  
  755.           If you want to downshift all characters of a string expression  to
  756.           lowercase, use the built-in function $lower.  This function can be
  757.           used to downshift a single field, a complicated string expression,
  758.           or   any  subpart  of  an  expression.   Both  ASCII  and  Roman-8
  759.           characters are downshifted by $lower.  For example,
  760.  
  761.                >extract city-lower-case = $lower(city)
  762.  
  763.                >extract city-state = $lower(city + state)
  764.  
  765.                >extract desc = desc-1 + $lower(desc-2)
  766.  
  767.  
  768.    Trimming Spaces ($Trim, $Ltrim, $Rtrim)
  769.  
  770.           Use one of three built-in string functions to  remove  leading  or
  771.           trailing  spaces  from  a  string expression.  The three functions
  772.           are:
  773.  
  774.  
  775.           $Trim:      Remove leading and trailing  spaces  from  the  string
  776.                       expression.
  777.  
  778.           $Ltrim:     Remove leading spaces.
  779.  
  780.           $Rtrim:     Remove trailing spaces.
  781.  
  782.  
  783.    If Command
  784.  
  785.           You  can  do  comparisons  with  byte-type fields in numerous ways
  786.           using Suprtool.  These powerful features minimize  the  number  of
  787.           tasks  you must execute in order to select the data you need.  The
  788.           fewer the number of tasks, the faster your data  is  delivered  to
  789.           the users and applications that need it.
  790.  
  791.           You  can  combine  byte-type  fields together and use the built-in
  792.           string functions to create string expressions.  String expressions
  793.           involve  the  + operator and any of the built-in string functions,
  794.           which are $lower, $upper, $trim, $ltrim and $rtrim.
  795.  
  796.  
  797.    Fixed vs.  Variable Length Strings
  798.  
  799.           String comparisons  are  done  using  fixed-  and  variable-length
  800.           strings.   For  most  users, there should be no difference between
  801.           the two types of strings.  When doing string comparisons, Suprtool
  802.           always pads shorter strings with spaces, with the one exception of
  803.           comparing two fixed-length fields (see "Byte Fields" below).
  804.  
  805.           String expressions involving the + operator or the $lower, $upper,
  806.           $trim,  $ltrim  and  $rtrim  built-in  functions  are  done  using
  807.           variable-length strings.  Suprtool keeps track of  the  length  of
  808.           every  string, and all operations are done using the actual string
  809.           length.  For fields, the length of the string is the length of the
  810.           field.   If  you  do not want to retain all the spaces in a field,
  811.           use one of the built-in trimming functions.
  812.  
  813.           When creating string expressions,  string  constants  are  created
  814.           with  the  exact  length of the constant.  For example, the string
  815.           "abc" is three characters long and the string "a" is one.
  816.  
  817.  
  818.    Byte Fields
  819.  
  820.           For historical reasons, comparing two  byte-type  fields  to  each
  821.           other  is  a special case.  If the two fields are exactly the same
  822.           length, Suprtool  compares  them  completely.   If  one  field  is
  823.           shorter,  the  comparison  is  done for the length of the shortest
  824.           field.  Suprtool  does  not  check  for  spaces  in  the  trailing
  825.           characters of the longer field.  For example,
  826.  
  827.                >define  short, 1,10   {10-character field}
  828.                >define  long ,11,15   {15-character field}
  829.                >if      short = long
  830.  
  831.           In this example, Suprtool compares the 10 bytes in the short field
  832.           with the first 10 bytes of the long field, but  ignores  the  last
  833.           five bytes of the long field.  If the expression on either side of
  834.           the equal sign consisted of more  than  one  field  (using  the  +
  835.           operator)  or  involved any of the built-in string functions, such
  836.           as $lower, $upper, $trim, $ltrim and $rtrim, Suprtool  would  have
  837.           compared both sides of the equal sign by padding the shorter field
  838.           with spaces.  It is only the case where you are directly comparing
  839.           one  byte-type  field  to another that Suprtool uses the length of
  840.           the shortest field for the comparison.
  841.  
  842.  
  843.    Trimming Spaces ($Trim, $Ltrim, $Rtrim)
  844.  
  845.           Use one of three built-in string functions to  remove  leading  or
  846.           trailing  spaces  from  a  string expression.  The three functions
  847.           are:
  848.  
  849.  
  850.           $Trim:      Remove leading and trailing  spaces  from  the  string
  851.                       expression.
  852.  
  853.           $Ltrim:     Remove leading spaces.
  854.  
  855.           $Rtrim:     Remove trailing spaces.
  856.  
  857.           Because  Suprtool  pads  shorter  strings  with  spaces when doing
  858.           comparisons, trimming  spaces  is  most  useful  when  creating  a
  859.           combined  string with several fields.  For example, you might want
  860.           to combine a person's first  and  last  name  (including  a  space
  861.           between the two):
  862.  
  863.                >if $trim(first) + " " + $trim(last) = "Joe Smith"
  864.  
  865.  
  866.    Mixed Case ($Upper and $Lower)
  867.  
  868.           By default, Suprtool does an exact match when comparing two string
  869.           expressions.  If the expressions vary  in  the  capitalization  of
  870.           characters,  Suprtool  finds  them  to be unequal.  To do caseless
  871.           string comparisons or pattern matches, use the  $upper  or  $lower
  872.           functions.   Both  ASCII  and  Roman-8  characters  are shifted by
  873.           $upper and $lower.  For example,
  874.  
  875.                >if $upper(city) = "VANCOUVER"
  876.  
  877.                >if $lower(city) = "edmonton"
  878.  
  879.           Note that if you use the $upper or $lower functions, Suprtool does
  880.           not  shift  any  constants in the comparison.  You must explicitly
  881.           specify the constants in the correct case or you can use $upper or
  882.           $lower with the constant:
  883.  
  884.                >if $upper(city) = $upper("vancouver")
  885.  
  886.           Use  the $upper or $lower functions for caseless pattern matching.
  887.           As with other comparison operators, you must specify constants  in
  888.           the correct case when doing pattern matching:
  889.  
  890.                >if $upper(city) == "VAN "
  891.  
  892.                >if $lower(city) == "ed "
  893.  
  894.           You can use $upper and $lower with string expressions that combine
  895.           many fields and string functions.  In the  following  example,  we
  896.           create
  897.  
  898.                >if $read
  899.                -   $upper($trim(first) +
  900.                -             " "             +
  901.                -             $trim(last))
  902.                -   = "JOE SMITH"
  903.                -
  904.  
  905.  
  906.    Bugs Fixed
  907.  
  908.  
  909.  
  910.    Arithmetic  Operations.   Suprtool now has a better error message when an
  911.           arithmetic operation has an invalid decimal operand length.
  912.  
  913.  
  914.    Extract Command.    When  extracting  constants,   Suprtool   no   longer
  915.           incorrectly reports that the constant limit has been reached.
  916.  
  917.  
  918.    Extract Command.    When  extracting one field into another, invalid data
  919.           is no longer produced if the  two  fields  are  exactly  the  same
  920.           length  and  type,  but have a different number of implied decimal
  921.           places.
  922.  
  923.  
  924.    Extract Command.   When the  maximum  limit  of  extracted  constants  is
  925.           reached,  Suprtool  no  longer  incorrectly  reports the following
  926.           message:
  927.  
  928.            Error:  Number of constants in >EXTRACT exceeds maximum
  929.  
  930.           This error message has now been changed to
  931.  
  932.            Error:  Total size of constants in >EXTRACT exceeds maximum
  933.  
  934.  
  935.  
  936.    Get Command and Speed Demon.   Suprtool no longer incorrectly  determines
  937.           the  highwater  mark  if the dataset is non-Jumbo, the capacity is
  938.           large, and the blocking factor is one or two.
  939.  
  940.  
  941.    Prefetch'point Failure.   Suprtool no longer fails with a  prefetch'point
  942.           failure  if  the  input file has an odd record size and the record
  943.           being selected is the last record in the file.
  944.  
  945.  
  946.    Set Ignore On.    Suprtool  now  honors  the  Set  Ignore  On  flag  when
  947.           encountering  an  illegal  packed  decimal  number in the $stddate
  948.           function.
  949.  
  950.  
  951.    Suprmgr Commands.   Suprtool no longer prints  a  blank  line  for  every
  952.           command in the Suprmgr.Pub.Sys file.
  953.  
  954.  
  955.    QLIB and Bonus Enhancements
  956.  
  957.  
  958.           Suprtool  comes  with  an  array  of contributed tools in the QLIB
  959.           library.  Your Robelle license may also entitle you to receive our
  960.           five  Bonus  programs.   All of these tools are updated throughout
  961.           the year, not necessarily in  sync  with  Suprtool  or  any  other
  962.           Robelle product.
  963.  
  964.           If  you  have  the  Bonus  programs,  you  may  use  them  only on
  965.           appropriately licensed CPUs.  The QLIB programs, however,  may  be
  966.           used on any CPU and given away freely.  The most recently released
  967.           Bonus and QLIB tools are as follows:
  968.  
  969.                Bonus                   QLIB
  970.                Compare/iX 2.7          Helpcomp 2.2
  971.                HowMessy 2.8            Printdoc 1.7
  972.                Select 4.0              Prose 4.3
  973.                Spell 1.9               Pscreen 89C
  974.                Xpedit 1.8              Qcopy 4.6
  975.                                        Qhelp 2.2
  976.  
  977.  
  978.    Bonus Programs
  979.  
  980.           Since the last major release of Suprtool, version 4.3,  the  Bonus
  981.           programs have been enhanced with the following new features:
  982.  
  983.    HowMessy 2.8
  984.  
  985.           HowMessy  provides fast reports on the internal efficiency of your
  986.           database.  It is compatible with IMAGE C.09.00, and  now  supports
  987.           an  increased  number  of  items,  sets,  and  paths  for a master
  988.           dataset.  See HowMessy.Docchg.Robelle for a detailed change notice
  989.           for HowMessy.
  990.  
  991.  
  992.    QLIB Programs
  993.  
  994.           Since  the last major release of Suprtool, version 4.3, there have
  995.           been no changes to the QLIB programs.
  996.  
  997.  
  998.  
  999.    Appendix:  Non-Robelle Installation
  1000.  
  1001.  
  1002.           Suprtool is usually installed on your  HP  e3000  in  the  Robelle
  1003.           account  (see the installation instructions earlier in this change
  1004.           notice).  However, you can easily install  Suprtool  into  another
  1005.           account by following these general steps:
  1006.  
  1007.           1. Restore  the  files  into  your  account instead of the Robelle
  1008.              account.
  1009.           2. Stream the account upgrade job (with modifications).
  1010.           3. Stream the installation jobs (with modifications).
  1011.  
  1012.           For example, to install Suprtool into an account called Tools  and
  1013.           into  the  same  groups as Suprtool would have used in the Robelle
  1014.           account (Pub, Doc, Help, etc.), follow these steps.
  1015.  
  1016.  
  1017.    Step 1:  Restore Files
  1018.  
  1019.           Restore the files into your account (Tools in this example):
  1020.  
  1021.                :restore *rtape;@.@.@;create;account=tools
  1022.  
  1023.  
  1024.    Step 2:  Stream the Account Upgrade Job (with modifications)
  1025.  
  1026.           With  a  text  editor,  change  all  account  references  in   the
  1027.           Robelle.Job.Tools  job  from  "robelle"  to  "tools."  Don't worry
  1028.           about changes to some of the comments in the job.  Note that  this
  1029.           job will change the capabilities, access flags, and logon password
  1030.           of the Tools account.  Examine the job carefully  to  ensure  that
  1031.           the  changes do not cause problems for other software in the Tools
  1032.           account.
  1033.  
  1034.                :qedit                   {or editor/quad/etc.}
  1035.                /text robelle.job.tools
  1036.                /change "robelle"(upshift) "tools" all
  1037.  
  1038.  
  1039.    Step 3:  Stream the Installation Jobs (with modifications)
  1040.  
  1041.           Now log on to the Tools account instead of the Robelle account.
  1042.  
  1043.                :hello mgr.tools
  1044.                :qedit                   {or editor/quad/etc.}
  1045.  
  1046.           Before streaming any jobs, you must alter them so that they log on
  1047.           to  the  Tools  account  instead of the Robelle account.  Make the
  1048.           following change to each job in the  Suprjob,  Job,  and  Purgejob
  1049.           groups:
  1050.  
  1051.                /text install.suprjob
  1052.                /change "robelle"(upshift smart) "tools" all
  1053.                /keep
  1054.                /exit
  1055.                :stream install.suprjob
  1056.  
  1057.           In  the example above, we have used Robelle's Qedit text editor to
  1058.           make the required changes to the account name, but you can use any
  1059.           editor.   Just  make  sure  that  all occurrences of "robelle" are
  1060.           changed,  regardless  of  whether  "robelle"  is   in   uppercase,
  1061.           lowercase,  or mixed case.  But change "robelle" only when it is a
  1062.           separate word, not when it is embedded in a longer word.
  1063.