home *** CD-ROM | disk | FTP | other *** search
/ ftp.robelle3000.ai 2014 / 2014.06.ftp.robelle3000.ai.tar / ftp.robelle3000.ai / changes / supr4p2ix.txt < prev    next >
Text File  |  2002-07-29  |  41KB  |  1,066 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                              SUPRTOOL Version 4.2
  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.2 User Manual
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                             Suprtool         4.2
  26.                             Dbedit           4.2
  27.                             Suprlink         4.2
  28.                             STExport         4.2
  29.                             Speed Demon      4.2
  30.                             Suprtool2        4.8
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                             Robelle Consulting Ltd.
  37.                            Unit 201, 15399-102A Ave.
  38.                          Surrey, B.C.  Canada V3R 7K1
  39.  
  40.                            Toll-free:  1-888-ROBELLE
  41.                                       (1-888-762-3553)
  42.                             Phone:  (604) 582-1700
  43.                              Fax:  (604) 582-1799
  44.  
  45.                          E-mail:  support@robelle.com
  46.                              Web:  www.robelle.com
  47.  
  48.                                   March 1999
  49.           Program and Manual Copyright Robelle Consulting Ltd.  1981-2002
  50.  
  51.  
  52.           Permission  is  granted  to  reprint  this  document  (but not for
  53.           profit), provided that copyright notice is given.
  54.  
  55.  
  56.  
  57.  
  58.           QEDIT and SUPRTOOL  are  trademarks  of  Robelle  Consulting  Ltd.
  59.           Other  product  and  company  names  mentioned  herein  may be the
  60.           trademarks of their respective owners.
  61.  
  62.  
  63.  
  64.    Introducing Suprtool Version 4.2
  65.  
  66.  
  67.                ⁿ  Highlights
  68.                ⁿ  Compatibility
  69.                ⁿ  CPU Serial Number
  70.                ⁿ  Compatibility Mode vs. Native Mode
  71.                ⁿ  Documentation
  72.                ⁿ  Documentation in WinHelp Format
  73.  
  74.  
  75.           Suprtool provides fast access to your data on the HP  3000.   With
  76.           Suprtool, you can perform many necessary DP functions easily, with
  77.           just a few simple commands.  At Robelle we are constantly  working
  78.           on  your  enhancement  requests  so that we can include them every
  79.           year when we release an updated version of Suprtool.  This  change
  80.           notice  provides  you  with  detailed  installation  steps  and  a
  81.           description of Suprtool's new features.
  82.  
  83.  
  84.    Highlights in Version 4.2
  85.  
  86.  
  87.    More Date and Data Manipulation
  88.  
  89.           ⁿ  With the new $stddate function, you can use the  popular  "date
  90.              windowing" Y2K technique in the If and Extract commands.
  91.  
  92.           ⁿ  You  can compare dates with dissimilar formats or data-types by
  93.              using the new $stddate function.
  94.  
  95.           ⁿ  The If and Extract commands  now  support  the  Mod  arithmetic
  96.              operator,  allowing more flexible manipulation of numeric data,
  97.              especially numeric date data.
  98.  
  99.  
  100.    New Date Formats
  101.  
  102.           ⁿ  Suprtool now supports more new date  formats:  mmyyyy,  yyyymm,
  103.              yyddd,  ccyyddd,  aamm,  mddaa, ddmmaa and HPCalendar.  The ddd
  104.              date component is a count of the "day of the  year,"  which  is
  105.              sometimes referred to as a Julian date.
  106.  
  107.           ⁿ  The  $date  function  now permits you to enter a date without a
  108.              month or day, depending on your date format.
  109.  
  110.  
  111.    Staying Current with MPE
  112.  
  113.           ⁿ  Suprtool, Speed Demon and HowMessy  now  support  80  GB  Jumbo
  114.              datasets  that  became available in C.07.14 version of IMAGE on
  115.              MPE/iX Powerpatch 5.
  116.  
  117.  
  118.    Compatibility
  119.  
  120.           Suprtool, Speed Demon, and Suprlink are compatible with Q-Delta-2,
  121.           R-MIT,  T-MIT,  U-MIT, V-MIT, MPE XL, and MPE/iX, including MPE/iX
  122.           5.5.
  123.  
  124.  
  125.    Item Command and Date Format
  126.  
  127.           In earlier versions of Suprtool, the Item command default  allowed
  128.           an  abbreviated name of the date format.  Now this default expects
  129.           the full mnemonic for the date format.  To change the default, you
  130.           can use the new Set ItemAbbreviateDate On command.  For example,
  131.  
  132.                >def a,1,4,double
  133.                >item a,date,hpcal
  134.  
  135.               Error:  The Item command did not recognize HPCAL as a valid
  136.               date keyword
  137.  
  138.                >set itemabbreviatedate on
  139.                >do item
  140.                >item a,date,hpcal
  141.  
  142.           To enable this feature globally for all Suprtool tasks, add
  143.  
  144.                >set itemabbreviatedate on
  145.  
  146.           to the Suprmgr.Pub.Sys file.
  147.  
  148.  
  149.    CPU Serial Number (HPSUSAN)
  150.  
  151.           This  program  runs  only  on  CPUs whose serial numbers have been
  152.           encoded ("showvar hpsusan" on MPE/iX).  If it fails to run and you
  153.           get   an   "invalid  HPSUSAN"  error  message,  call  Robelle  for
  154.           assistance.
  155.  
  156.  
  157.    Compatibility Mode vs. Native Mode
  158.  
  159.           Throughout  this  change  notice  and  in  all  of  the   Suprtool
  160.           documentation,  there  are  references  to  compatibility mode and
  161.           native mode.  If you are on a Classic HP 3000 (i.e., not  MPE/iX),
  162.           you  can  use the compatibility-mode version of Suprtool.  Our job
  163.           streams  automatically  install  the  correct  version  for   your
  164.           machine.   We  use  the terms MPE XL and MPE/iX interchangeably in
  165.           our documentation.
  166.  
  167.  
  168.    Documentation
  169.  
  170.           This release includes updated user manuals for  Suprtool  and  its
  171.           components.  To print these manuals, use the Printdoc program.
  172.  
  173.                :run printdoc.pub.robelle
  174.  
  175.           This is the list of documentation files for Suprtool:
  176.  
  177.                suprtool.doc.robelle      {Suprtool user manual}
  178.                stexport.doc.robelle      {STExport user manual}
  179.                suprlink.doc.robelle      {Suprlink user manual}
  180.                dbedit.doc.robelle        {Dbedit user manual}
  181.                demon.doc.robelle         {Speed Demon user manual}
  182.                suprcall.doc.robelle      {Calling Suprtool user manual}
  183.                suprtool.docchg.robelle   {this change notice}
  184.  
  185.           If  you  know  the  file names of other Robelle documents, you can
  186.           print them with Printdoc or you can include the file name  in  the
  187.           :Run command.  For example, to print this change notice, type
  188.  
  189.                :run printdoc.pub.robelle;info="suprtool.docchg.robelle"
  190.  
  191.  
  192.    Documentation in WinHelp Format
  193.  
  194.           The user manuals for Suprtool and its components are all available
  195.           in the popular WinHelp file format  of  Microsoft  Windows.   Your
  196.           tape   includes   a  WinHelp  file,  which  is  a  self-extracting
  197.           compressed file that contains all five  Help  files  and  a  Setup
  198.           program.   Use the installation instructions in this change notice
  199.           to install the WinHelp files on your PC.
  200.  
  201.  
  202.  
  203.  
  204.    Installation of 4.2
  205.  
  206.           If you need to install this upgrade in an account other  than  the
  207.           Robelle account, use the installation instructions in the appendix
  208.           at the end of this change notice.
  209.  
  210.           The following installation instructions are for existing  Suprtool
  211.           users  who  are  installing  a new version in the Robelle account.
  212.           Please use the instructions from this change notice instead of the
  213.           user  manual  because  the  change  notice  always  has the latest
  214.           version.  The whole process should take about 30 minutes, assuming
  215.           that   no   one   uses  Suprtool  or  its  components  during  the
  216.           installation.
  217.  
  218.           To install this update of Suprtool, follow these steps:
  219.  
  220.           1. Restore the new files from tape.
  221.  
  222.           2. Upgrade the structure of the Robelle account.
  223.  
  224.           3. Install the proper program files (NM or Classic).
  225.  
  226.           4. Install Speed Demon in the system SL (only Classic).
  227.  
  228.           5. Install  the  Suprtool2  interface  in  the  system  SL   (only
  229.              Classic).
  230.  
  231.           6. Limit Suprtool's run time priority (optional).
  232.  
  233.           7. Install WinHelp documentation files (optional).
  234.  
  235.           8. Install QLIB and Bonus programs.
  236.  
  237.           9. Purge the installation files (optional).
  238.  
  239.  
  240.    Replace Any Pre-Release
  241.  
  242.           If  you  are  currently running a pre-release version of Suprtool,
  243.           you should replace it with this new official release.  Pre-release
  244.           versions  expire  within two years of their creation date, whereas
  245.           this new release has no expiry date.  You can easily  recognize  a
  246.           pre-release by the words "Pre-Release" next to the version number.
  247.  
  248.  
  249.    Installation Assistance
  250.  
  251.           If you have any questions or run into any  problems,  please  call
  252.           us.   Technical  support is available on weekdays from 7 a.m. to 4
  253.           p.m. Pacific time at 1-888-ROBELLE (1-888-762-3553).  You can also
  254.           receive  emergency  support  outside of these hours by calling our
  255.           regular phone number and asking the operator  to  page  a  support
  256.           person for you.
  257.  
  258.  
  259.    Important Note About Passwords
  260.  
  261.           None  of  the  jobs that we supply have passwords in them.  Before
  262.           streaming a job, you might have to add your system's passwords  to
  263.           the  first  line.  Users of MPE XL 3.0 and later do not have to do
  264.           this because the operating system prompts for  missing  passwords.
  265.           The  same  is true for some MPE V users who have security software
  266.           that inserts passwords.  Most MPE V users have to edit  the  jobs.
  267.           For  example,  if the system manager logon password is Qwerty, you
  268.           would do the following:
  269.  
  270.                :editor
  271.                HP32201A.07.22 EDIT/3000
  272.                /text robelle.pub.sys
  273.                FILE UNNUMBERED
  274.                /modify 1
  275.                MODIFY     1
  276.                !job robelle,manager.sys,pub;hipri;jobq=SUPRTOOL
  277.                                        i/qwerty
  278.                !job robelle,manager.sys/qwerty,pub;hipri;jobq=SUPRTOOL
  279.  
  280.                /keep robtemp
  281.                /exit
  282.                END OF SUBSYSTEM
  283.                :stream robtemp
  284.                :purge robtemp
  285.  
  286.  
  287.    STREAMX Users
  288.  
  289.           Users of STREAMX, a part of SECURITY/3000 from VESOFT  Inc.,  must
  290.           set  a  Job  Control  Word  before  streaming jobs.  This prevents
  291.           STREAMX from generating an error if the Robelle account  does  not
  292.           yet exist.  For example,
  293.  
  294.                :setjcw streamxtempnonest 1
  295.                :stream robelle.pub.sys
  296.  
  297.  
  298.    Step 1:  Restore the Files
  299.  
  300.           You begin by restoring all the files from the tape.
  301.  
  302.                :hello manager.sys
  303.                :file   rtape;   dev=tape                   {use  appropriate
  304.           device}
  305.                :restore *rtape; @.@.robelle; create    {restore everything}
  306.  
  307.           The files on the tape require approximately  80,000  sectors.   If
  308.           you  are  upgrading  Suprtool,  most  of  these files will replace
  309.           existing files because the new version of Suprtool does  not  take
  310.           up much more space than the old version.
  311.  
  312.           The  Suprtool  program  files  are located in the Pub group of the
  313.           Robelle account.  At this point in the installation  process,  the
  314.           files  do  not  have the correct names.  The next step assigns the
  315.           proper names to the program files.
  316.  
  317.  
  318.    Step 2:  Set Up the Robelle Account
  319.  
  320.           Even if you already have the Robelle account, you must stream  the
  321.           Robelle  job to ensure that the Robelle account and all its groups
  322.           have the proper security and capabilities.
  323.  
  324.                :stream robelle.job.robelle
  325.  
  326.           When the job stream is finished, it will send you a message.   The
  327.           job removes the password from the Robelle account.  Stay logged on
  328.           as Manager.Sys and put a password on the Robelle account.  If  you
  329.           are upgrading your Robelle account, use the old password.
  330.  
  331.                :altacct robelle;pass=hardpass    {hard to guess}
  332.  
  333.           Please  note  that during installation we add OP capability to the
  334.           Robelle account.  When the Suprtool installation is finished,  you
  335.           have the option to remove OP capability.
  336.  
  337.  
  338.    Step 3:  Install Suprtool into Production
  339.  
  340.           Our  installation job installs Suprtool, STExport, Suprlink, Speed
  341.           Demon, and the Suprtool2 interface.  No one can use these programs
  342.           during the installation.  Before you stream this installation job,
  343.           warn people not to use these programs for a while.
  344.  
  345.                :hello mgr.robelle
  346.                :warn @;please exit from Suprtool and Suprlink NOW!
  347.                :stream install.Suprjob
  348.  
  349.           Once Suprtool has  been  installed,  check  the  installation  job
  350.           $stdlist.    If   anyone  was  either  using  Suprtool,  STExport,
  351.           Suprlink, or Speed Demon, or  attempting  to  back  them  up,  the
  352.           installation  job will fail.  Chase away any users and ensure that
  353.           a backup is not in progress,  then  stream  the  installation  job
  354.           again.
  355.  
  356.           The installation job renames your current versions of Suprtool and
  357.           its components to the PubOld group of the Robelle account.  If you
  358.           need  to  move  these  versions  back  into  production,  use  the
  359.           Previous.Suprjob job stream.
  360.  
  361.           You can now access Suprtool by entering
  362.  
  363.                :run suprtool.pub.robelle
  364.  
  365.  
  366.    Optional Installation Steps
  367.  
  368.           On MPE/iX your installation should be complete.   If  you  have  a
  369.           copy  of  Speed  Demon  or  the Suprtool2 interface in your own XL
  370.           files, you will have to update them with the new versions (use the
  371.           instructions   in  the  Speed  Demon  and  Calling  Suprtool  user
  372.           manuals).
  373.  
  374.           To use the new versions on MPE V, you still need to install  Speed
  375.           Demon  and  Suprtool2 in the system SL.  MPE/iX users must also do
  376.           this  if  they  are  calling  Speed  Demon   or   Suprtool2   from
  377.           compatibility-mode  programs.   With so few changes to Speed Demon
  378.           and Suprtool2, you can safely ignore  them  for  this  version  of
  379.           Suprtool.
  380.  
  381.           If  you  have  a  Windows  PC,  you  can  install all the Suprtool
  382.           documentation in the popular WinHelp format of Microsoft Windows.
  383.  
  384.  
  385.  
  386.    Step 4:  Speed Demon/V Installation (optional)
  387.  
  388.           To use the new features of Speed Demon/V,  you  must  install  the
  389.           latest   version   in  the  system  SL.   You  should  follow  the
  390.           installation instructions in the Speed Demon user  manual.   These
  391.           instructions  assume  that  you  have used the Install.Suprjob job
  392.           stream to move Suprtool and its components into the Pub  group  of
  393.           the Robelle account.
  394.  
  395.                :stream demon.Suprjob.robelle
  396.  
  397.  
  398.    Step 5:  Suprtool2 Interface Installation (only Classic)
  399.  
  400.           The  Suprtool2  interface  has  been  revised.   On MPE V you must
  401.           re-install the interface.  If you do not have the latest Suprtool2
  402.           interface, programs that attempt to use totals from Suprtool2 will
  403.           fail.  You can install this interface without recompiling  any  of
  404.           your existing programs.
  405.  
  406.  
  407.    System SL Installation
  408.  
  409.           To  install  the  latest Suprtool2 interface in the system SL, use
  410.           our standard installation job:
  411.  
  412.                :stream suprcall.Suprjob.robelle
  413.  
  414.  
  415.    User SL or XL Files
  416.  
  417.           If you have a copy of the Suprtool2 interface in your  own  SL  or
  418.           XL,  you  will  need  to update it.  For instructions on how to do
  419.           this, consult the user manual for Calling Suprtool.
  420.  
  421.  
  422.    Step 6:  Limit Suprtool's Run Time Priority (optional)
  423.  
  424.           Some system managers like to restrict the amount of resources that
  425.           Suprtool  consumes.   One way to do this is by running Suprtool in
  426.           the D queue, which lets you use HP's Linkedit program.
  427.  
  428.                :linkedit
  429.                >altprog suprtool;maxpri=ds
  430.                >exit
  431.  
  432.           By forcing Suprtool to always run in the lower  queue  (even  when
  433.           Suprtool  runs  on-line),  it  competes  less  with  on-line users
  434.           because most users run in the C  queue.   System  managers  should
  435.           only  restrict  the priority of Suprtool if they are familiar with
  436.           MPE process queues and the Tune command.
  437.  
  438.  
  439.    Step 7:  Install WinHelp Documentation Files (optional)
  440.  
  441.           The Suprtool documentation for both MPE and HP-UX is now available
  442.           in  the  WinHelp  file  format  of Microsoft Windows.  You can use
  443.           these files only if you have Windows 3.1 or later.  To install the
  444.           WinHelp files on a PC, follow these instructions.
  445.  
  446.  
  447.    Make a Temporary Directory for the Setup Program
  448.  
  449.           Create  a directory for the installation file on your PC.  You can
  450.           remove this directory after installing the WinHelp files.  At  the
  451.           DOS prompt, for example, type
  452.  
  453.                mkdir \robtemp
  454.  
  455.  
  456.    Download the Compressed File
  457.  
  458.           If  you  use  the floppy diskette that is included in the Suprtool
  459.           User Manual to copy the Help files to your hard drive, proceed  to
  460.           "Run  the  Setup  Program"  below.   Otherwise,  use Reflection to
  461.           download the self-extracting Zip file to your PC and continue with
  462.           these   steps.    This   Zip   file  on  the  HP  3000  is  called
  463.           Suprhelp.Whelp.Robelle.  Log on as Mgr.Robelle and press Alt-Y  to
  464.           go  to the Reflection Command Line window.  Then download the file
  465.           as a binary transfer.
  466.  
  467.                receive c:\robtemp\suprhelp.exe
  468.                       from suprhelp.whelp.robelle binary
  469.  
  470.  
  471.    Expand the Compressed Files
  472.  
  473.           You only need the following commands to extract the files  because
  474.           we  provide  both  the  Setup  program  and  the Help files in one
  475.           self-extracting Zip file.  From the DOS prompt, type the following
  476.           commands:
  477.  
  478.                cd \robtemp          {go to the new Robtemp directory}
  479.                suprhelp.exe         {extract the Help files}
  480.  
  481.  
  482.    Run the Setup Program
  483.  
  484.           From  the  Program  Manager, run the Setup program by choosing the
  485.           Run option from the File menu.  Then enter C:\Robtemp\Setup in the
  486.           Command  Line  window  and  follow  the  instructions in the Setup
  487.           program.
  488.  
  489.           You can now access all of the Suprtool documentation by  selecting
  490.           any of the icons in the "Robelle Help" Program Manager Group.
  491.  
  492.  
  493.    Remove the Robtemp Directory
  494.  
  495.           Before  you  remove  the  WinHelp  files,  you  can copy them to a
  496.           diskette and distribute them to other Suprtool users.
  497.  
  498.           To delete all the WinHelp files and remove the Robtemp  directory,
  499.           use either the File Manager or the following DOS commands:
  500.  
  501.                cd \robtemp
  502.                del *.*          {delete all the files in Robtemp}
  503.                cd ..
  504.                rmdir robtemp    {remove the Robtemp directory}
  505.  
  506.  
  507.    Step 8:  Install QLIB and Bonus Programs
  508.  
  509.           Suprtool  comes  with an array of contributed software in the QLIB
  510.           library (in  the  QLIB  groups  of  the  Robelle  account).   QLIB
  511.           programs  may  be  used  on  any CPU and may be given away freely.
  512.           Your Robelle license may also entitle you  to  receive  our  Bonus
  513.           programs:  Compare/iX, HowMessy, Select, Spell, and Xpedit.  These
  514.           programs reside in the Pub group of the  Robelle  account.   Bonus
  515.           programs  can only be used on authorized machines, and you may not
  516.           distribute them to anyone.
  517.  
  518.           If you received Bonus programs with this version of Suprtool,  use
  519.           the  job  stream called Bonus.Job.Robelle to install both the QLIB
  520.           and Bonus programs.  If you did not receive  Bonus  programs,  use
  521.           the job stream Qlib.Job.Robelle to install the QLIB programs.
  522.  
  523.                :hello mgr.robelle
  524.                :stream bonus.job.robelle        {or Qlib.Job.Robelle}
  525.  
  526.           If  you  skip  this step, you might end up running old versions of
  527.           these programs.
  528.  
  529.  
  530.    Step 9:  Purge Installation Files (optional)
  531.  
  532.           The easiest way to clean up after an installation is to stream the
  533.           Cleanup.Purgejob.Robelle  job.   This  job saves you disc space by
  534.           purging the installation files.  It does not purge the files  that
  535.           are necessary to run the software.
  536.  
  537.  
  538.    Enhancements
  539.  
  540.  
  541.           Every year we provide Suprtool users with new features.  This year
  542.           the major enhancements include more date control functions in  the
  543.           If  and  Extract  commands, more date formats for the Item command
  544.           and  a  new  Mod  arithmetic  operator.   The  following  sections
  545.           describe  the  new  enhancements  to Suprtool since the last major
  546.           release.
  547.  
  548.  
  549.    Decimal Command - STExport
  550.  
  551.           Use the Decimal command to specify  the  symbol  for  the  decimal
  552.           place in STExport.
  553.  
  554.                DECimal PERIOD | COMMA
  555.  
  556.                                                            (Default: Period)
  557.  
  558.           The Decimal command specifies  what  separator  will  be  used  to
  559.           indicate  the  decimal place in numeric fields.  In North America,
  560.           the custom is to indicate the decimal  place  in  numbers  with  a
  561.           period  (.).  Outside North America, the custom is to indicate the
  562.           decimal place with a comma (,).  If the decimal place indicator is
  563.           incorrect, it is harder to import files into other applications.
  564.  
  565.           The Decimal command does not apply to floating-point fields.
  566.  
  567.  
  568.    If Command - $Stddate
  569.  
  570.           Suprtool  now  has a new $stddate function available in the If and
  571.           Extract commands.  This function can compare dates  of  dissimilar
  572.           formats  or data-types by converting any date format in nearly any
  573.           data-type container and internally converting it to  the  ccyymmdd
  574.           format in a double-integer container.  For example,
  575.  
  576.                > get order-detail
  577.                > item order-date,date,ccyymmdd
  578.                > item bill-date,date,mmddyyyy
  579.                > if $stddate(bill-date) <= order-date
  580.                > output badords,link
  581.                > xeq
  582.  
  583.           This feature is also available for those dates that have two-digit
  584.           years.  The century portion of the date is applied to $stddate  by
  585.           using  the  normal  cutoff  rules  that  use the value in Set Date
  586.           Cutoff.
  587.  
  588.                > get invoice-detail
  589.                > set date cutoff 20
  590.                > item invoice-date,date,yymmdd
  591.                > item close-date,date,mmddyyyy
  592.                > if $stddate(close-date) <= $stddate(invoice-date)
  593.                > out badinvs,link
  594.                > xeq
  595.  
  596.           In this case all invoice-date values with a yy portion between  20
  597.           and  99 will have 19 as the century.  All invoice-date values with
  598.           a yy portion of less than 20 will have 20 in the date generated by
  599.           the $stddate function.
  600.  
  601.           Invalid Dates
  602.  
  603.           A  date  must  be  valid  before  $stddate  can  convert it to the
  604.           ccyymmdd format.  Otherwise, a value of 0 will be returned for any
  605.           invalid dates.  An invalid date is a number in a date format whose
  606.           date equivalent cannot be found  on  a  calendar.   This  includes
  607.           dates  selected  by  the  $invalid function.  We can eliminate the
  608.           invalid dates from the above  task  by  changing  the  If  command
  609.           slightly.
  610.  
  611.                > get invoice-detail
  612.                > set date cutoff 20
  613.                > item invoice-date,date,yymmdd
  614.                > item close-date,date,mmddyyyy
  615.                > if (not $invalid(close-date) &
  616.                  or  not $invalid(invoice-date)) &
  617.                  and     $stddate(close-date) <= $stddate(invoice-date)
  618.                > out badinvs,link
  619.                > xeq
  620.  
  621.           In  this example, if either the close-date or the invoice-date are
  622.           invalid, then they will not be evaluated by the $stddate  function
  623.           and  will  not  be  selected.   Although  your requirements may be
  624.           different, you need to remember that invalid  dates  evaluated  by
  625.           the $stddate function will return a 0 value.
  626.  
  627.  
  628.    Extract Command - $Stddate
  629.  
  630.           Similar  to the If command, the Extract command is also capable of
  631.           utilizing the $stddate function, which  can  convert  any  of  the
  632.           supported  Suprtool  date  formats  into  the ccyymmdd format in a
  633.           double-integer container.
  634.  
  635.           For example,
  636.  
  637.               > get sales-detail
  638.               > def new-ship-date,1,4,double
  639.               > item ship-date,date,mmddyyyy
  640.               > ext order-no / sales-amount
  641.               > ext new-ship-date = $stddate(ship-date)
  642.               > out salesinfo,link
  643.               > xeq
  644.  
  645.           Invalid Dates
  646.  
  647.           A date must be  valid  before  $stddate  can  convert  it  to  the
  648.           ccyymmdd format.  Otherwise, a value of 0 will be returned for any
  649.           invalid dates.  An invalid date is a number in a date format whose
  650.           date  equivalent  cannot  be  found on a calendar.  If you use the
  651.           $stddate function to extract a value that is not a valid date, the
  652.           extracted value will be 0.
  653.  
  654.  
  655.    $Date Function
  656.  
  657.           The  $date  function  for  the  If  and  Extract commands has been
  658.           enhanced to have more flexible parsing of the year, month and  day
  659.           portions  for  the  yymm,  yyyymm,  ccyymm, ccyy, aamm, mmyyyy and
  660.           ccyymm date formats.
  661.  
  662.           For example, in earlier versions  the  ccyy  date  format  had  to
  663.           specify all three components (year, month and day).  Now the $date
  664.           function needs only the relevant portion of the date.
  665.  
  666.                >item year-date,date,ccyy
  667.                >if year-date = $date(*)
  668.  
  669.           For compatibility reasons, we also accept all  three  portions  of
  670.           the date in the $date function.
  671.  
  672.                >item year-date,date,ccyy
  673.                >if year-date = $date(*/*/*)
  674.  
  675.  
  676.    Item Command - Date Format
  677.  
  678.           In  earlier versions of Suprtool, the Item command default allowed
  679.           an abbreviated name of the date format.  Now this default  expects
  680.           the full mnemonic for the date format.  To change the default, you
  681.           can use the new Set ItemAbbreviateDate On command.  For example,
  682.  
  683.                >def a,1,4,double
  684.                >item a,date,hpcal
  685.  
  686.               Error:  The Item command did not recognize HPCAL as a valid
  687.               date keyword
  688.  
  689.                >set itemabbreviatedate on
  690.                >do item
  691.                >item a,date,hpcal
  692.  
  693.           To enable this feature globally for all Suprtool tasks, add
  694.  
  695.                >set itemabbreviatedate on
  696.  
  697.           to the Suprmgr.Pub.Sys file.
  698.  
  699.  
  700.    Item Command - mmyyyy
  701.  
  702.           The Item command now supports the date format of mmyyyy in X6, Z6,
  703.           J2, K2 and P8 or greater data-types.
  704.  
  705.  
  706.    Item Command - yyddd
  707.  
  708.           The  Item command now supports the date format of yyddd in X5, Z5,
  709.           J2, K2 and P8 or greater  data-types.   Because  you  cannot  have
  710.           uneven  byte  fields  in IMAGE databases, you may need to redefine
  711.           your date field for these types of dates, depending on where  your
  712.           date is padded with spaces.
  713.  
  714.           If  your  date  is  an X6 field, you can redefine your date field.
  715.           This particular date pads a yyddd-type date with a  space  at  the
  716.           end of the field.
  717.  
  718.                >def newdate,date-field[1],5
  719.                >item newdate,date,yyddd
  720.                >if newdate <= $today
  721.  
  722.  
  723.    Item Command - ccyyddd
  724.  
  725.           The  Item  command  now supports the date format of ccyyddd in X7,
  726.           Z7, J2, K2 and P10 or greater data-types.  Because you cannot have
  727.           uneven  byte  fields  in IMAGE databases, you may need to redefine
  728.           your date field for these types of dates, depending on where  your
  729.           date is padded with spaces.
  730.  
  731.           If  your  date  is  an X8 field, you can redefine your date field.
  732.           This particular date pads a ccyyddd-type date with a space at  the
  733.           beginning of the field.
  734.  
  735.                >def newdate,date-field[2],7
  736.                >item newdate,date,ccyyddd
  737.                >if newdate <= $today
  738.  
  739.  
  740.    Item Command - HPCalendar
  741.  
  742.           The  Item command now supports the date format of HPCalendar in J2
  743.           and K2 data-types.
  744.  
  745.  
  746.    Item Command - yyyymm
  747.  
  748.           The Item command now supports the date format of yyyymm in X6, Z6,
  749.           J2, K2 and P8 or greater data-types.
  750.  
  751.  
  752.    Item Command - aamm
  753.  
  754.           The  Item  command  now  supports the date format of aamm in an X4
  755.           data-type.  The Item command also supports mmddaa and ddmmaa  date
  756.           formats in an X6 data-type.
  757.  
  758.  
  759.    Jumbo Datasets 80 GB
  760.  
  761.           An  enhancement  in  TurboIMAGE/SQL  version  C.07.14 allows Jumbo
  762.           datasets to be up to 80 GB in size, which is twice as large as the
  763.           previous  limit.   This  change  to  IMAGE/SQL is now supported in
  764.           Suprtool, HowMessy and SpeedDemon.
  765.  
  766.  
  767.    If Command - Mod Operator
  768.  
  769.           Suprtool now has a new Mod arithmetic operator  that  returns  the
  770.           remainder between a dividend and a divisor.  Practical uses of the
  771.           Mod operator allow for extractions of the rightmost  numbers  from
  772.           numeric  fields.   You can use the Mod operator to do a comparison
  773.           on the rightmost numbers of a given numeric  field.   For  example
  774.           you  could  compare  the  dd  portion  of  a ccyymmdd date against
  775.           another field or constant.
  776.  
  777.                > get order-detail
  778.                > item order-date,date,ccyymmdd
  779.                > if order-date mod 100 <= 15
  780.                > out ordbegin
  781.                > xeq
  782.  
  783.           Using the same concept and data, you can also  compare  the  month
  784.           portion of a given date by using divide (/) and Mod together.
  785.  
  786.                > get order-detail
  787.                > item order-date,date,ccyymmdd
  788.                > if order-date / 100 mod 100 <= 02
  789.                > out ordbegin
  790.                > xeq
  791.  
  792.           The  Mod  operator  has  the  same  precedence  in  the  order  of
  793.           operations as multiply and divide.
  794.  
  795.  
  796.    Extract Command - Mod Operator
  797.  
  798.           The Mod operator is also available to  the  Extract  command.   It
  799.           returns the remainder between a dividend and a divisor.  Practical
  800.           uses of the Mod operator allow for extractions  of  the  rightmost
  801.           numbers from numeric fields.
  802.  
  803.                > get order-detail
  804.                > item order-date,date,ccyymmdd
  805.                > def order-date-day,1,4,double
  806.                > ext order-no
  807.                > ext order-date-day = order-date mod 100
  808.                > out ordday,link
  809.                > xeq
  810.  
  811.           Using  the  same  concept and data, you can also extract the month
  812.           portion of a given date by using divide (/) and Mod together.
  813.  
  814.                > get order-detail
  815.                > item order-date,date,ccyymmdd
  816.                > def order-date-day,1,4,double
  817.                > ext order-no
  818.                > ext order-date-day = order-date / 100 mod 100
  819.                > out ordmonth,link
  820.                > xeq
  821.  
  822.           The  Mod  operator  has  the  same  precedence  in  the  order  of
  823.           operations as multiply and divide.
  824.  
  825.  
  826.    Output Command - Suprlink
  827.  
  828.           Suprlink's  Output command now supports the Link option.  Although
  829.           it  was  already  the  default  output  file,  some  users   found
  830.           themselves  typing  the  Link  option on the Output command.  This
  831.           would cause an error, even though linked files can be  written  by
  832.           Suprlink.  We now allow the Link option to be specified.
  833.  
  834.  
  835.  
  836.    Bugs Fixed
  837.  
  838.  
  839.    Edit Command.  Dbedit now recognizes fields with Item commands.
  840.  
  841.  
  842.    Form Command.  The  Form  dataset  command  no  longer fails with certain
  843.           versions of Superdex on detail datasets with no search path.
  844.  
  845.  
  846.    Get Command.  The Get command by record range  on  a  Jumbo  dataset  now
  847.           reads the next chunk of the Jumbo dataset.
  848.  
  849.  
  850.    Get Command.  Suprtool  reads  beyond  the calculated EOF on Jumbo master
  851.           datasets.
  852.  
  853.  
  854.    If Command.  The If command no longer  reports  "Error:  Missing  symbol"
  855.           when  using  the  $date function for ccyymm, yyyymm, and ccyy date
  856.           formats.
  857.  
  858.  
  859.    If Command.  The If command's $invalid function now  reports  yymmdd  and
  860.           yymm dates as invalid in numeric containers such as J2.
  861.  
  862.  
  863.    If Command.  Suprtool  no longer incorrectly evaluates an expression with
  864.           two constants.
  865.  
  866.  
  867.    List Command.  The List command and the time 2  format  in  Set  List  no
  868.           longer  incorrectly report a.m.  when the time is between 12:00 to
  869.           12:59 p.m.
  870.  
  871.  
  872.    List Command.  The List command no longer aborts when listing  odd-length
  873.           integers in Hex.
  874.  
  875.  
  876.    Suprtool  Extracts.  Suprtool no longer fails with a "Prefetch'read'fail-
  877.           ure" on some systems with large amounts of memory.
  878.  
  879.  
  880.    Set Command.  The NM version of Suprtool no longer reports  an  incorrect
  881.           dataset  number if an IMAGE error occurred and Set DumpOnError was
  882.           enabled.
  883.  
  884.  
  885.    STExport Command.  STExport now supports ASK dates in all cases.
  886.  
  887.  
  888.    Verify Command.  The Verify item command now always prints the date type.
  889.  
  890.  
  891.  
  892.    QLIB and Bonus Enhancements
  893.  
  894.  
  895.           Suprtool  comes  with  an  array  of contributed tools in the QLIB
  896.           library.  Your Robelle license may also entitle you to receive our
  897.           five  Bonus  programs.   All of these tools are updated throughout
  898.           the year, not necessarily in  sync  with  Suprtool  or  any  other
  899.           Robelle product.
  900.  
  901.           If  you  have  the  Bonus  programs,  you  may  use  them  only on
  902.           appropriately licensed CPUs.  The QLIB programs, however,  may  be
  903.           used on any CPU and given away freely.  The most recently released
  904.           Bonus and QLIB tools are as follows:
  905.  
  906.                Bonus                   Contributed
  907.                Compare/iX 2.6          Helpcomp 2.2
  908.                HowMessy 2.6            Printdoc 1.7
  909.                Select 3.9              Prose 4.2
  910.                Spell 1.8               Pscreen 89C
  911.                Xpedit 1.7              Qcopy 4.6
  912.                                        Qhelp 2.2
  913.  
  914.  
  915.    Bonus Programs
  916.  
  917.           Since the last major release  of  Suprtool,  the  following  Bonus
  918.           programs have been enhanced with these new features:
  919.  
  920.  
  921.    Compare/iX 2.6
  922.  
  923.           The  NM Compare program compares two text files and prints out the
  924.           differences for you.  Compare works with both Qedit workfiles  and
  925.           regular  Keep files.  The input file names can be specified in the
  926.           Info= string.  See Compare.Docchg.Robelle for  a  detailed  change
  927.           notice for Compare.
  928.  
  929.  
  930.    HowMessy 2.6
  931.  
  932.           HowMessy  provides fast reports on the internal efficiency of your
  933.           database.  Now use HowMessy  to  report  statistics  on  IMAGE/SQL
  934.           datasets  up  to  80 gigabytes.  See HowMessy.Docchg.Robelle for a
  935.           detailed change notice for HowMessy.
  936.  
  937.  
  938.    Select 3.9
  939.  
  940.           Select is a menu front-end that works on  any  terminal,  allowing
  941.           people to select tasks from a list of choices.  User commands (and
  942.           UDCs) support 32  parameters  and  :Escape.   Variable-length  and
  943.           Qedit-type  command  files are allowed.  See Select.Docchg.Robelle
  944.           for a detailed change notice for Select.
  945.  
  946.  
  947.    Spell 1.8
  948.  
  949.           Spell is a fast spelling checker for the HP 3000 that  reads  both
  950.           Qedit and EDIT/3000 files.  Spell can read Qedit's Jumbo files.
  951.  
  952.  
  953.    Xpedit 1.7
  954.  
  955.           Xpedit  is  a simple screen editor that is handy for editing small
  956.           files using VPLUS block-mode.  Inverse video  was  added  to  some
  957.           error  messages  to make them stand out more prominently.  See the
  958.           file Xpedit.Docchg.Robelle for a complete description of  Xpedit's
  959.           changes.
  960.  
  961.  
  962.    QLIB Programs
  963.  
  964.           Since  the  last  major  release  of  Suprtool, the following QLIB
  965.           programs have been enhanced with these new features:
  966.  
  967.  
  968.    Printdoc 1.7
  969.  
  970.           Printdoc is an easy-to-use utility for  printing  Robelle  manuals
  971.           and  other  documentation.  Printdoc now supports LaserJet 4 and 5
  972.           printers.
  973.  
  974.  
  975.    Prose 4.2
  976.  
  977.           Prose is the text formatter that we use for all our documentation,
  978.           from  user manuals to on-line help.  Prose can now read Jumbo text
  979.           files that are wider than 256 characters.  Prose can also generate
  980.           RTF  output  with  the  .out (rtf) command.  See the Prose.Docchg.
  981.           Robelle file for a detailed change notice for Prose.
  982.  
  983.  
  984.    Qcopy 4.6
  985.  
  986.           Qcopy is a contributed program that reads and writes Qedit  files.
  987.           Its  Qeditaccess  routine  decodes  the files for Qcopy.  Although
  988.           Qeditaccess can read Qedit's new  Jumbo  files,  it  cannot  write
  989.           them.
  990.  
  991.  
  992.    Qhelp 2.2
  993.  
  994.           Qhelp  is an on-line user Help facility that you can tie into your
  995.           own software.  We use it ourselves in all our software products.
  996.  
  997.  
  998.    Appendix:  Non-Robelle Installation
  999.  
  1000.  
  1001.           Suprtool is usually installed on  your  HP  3000  in  the  Robelle
  1002.           account  (see the installation instructions earlier in this change
  1003.           notice).  However, you can easily install  Suprtool  into  another
  1004.           account by following these general steps:
  1005.  
  1006.           1. Create or upgrade the structure of your account.
  1007.  
  1008.           2. Restore the files into your account.
  1009.  
  1010.           3. Alter any installation jobs to log on to your account.
  1011.  
  1012.           4. Stream the installation jobs.
  1013.  
  1014.           For  example, to install Suprtool into an account called Tools and
  1015.           into the same groups as Suprtool would have used  in  the  Robelle
  1016.           account (Pub, Doc, Help, etc.), follow these steps.
  1017.  
  1018.  
  1019.    Step 1:  Upgrade Account Structure
  1020.  
  1021.           With   a  text  editor,  change  all  account  references  in  the
  1022.           Robelle.Pub.Sys job from "robelle" to "tools."  Don't worry  about
  1023.           changes  to  some  of the comments in the job.  Note that this job
  1024.           will change the capabilities, access flags, and logon password  of
  1025.           the  Tools  account.  Examine the job carefully to ensure that the
  1026.           changes do not cause problems for other software  in  the  Robelle
  1027.           account.
  1028.  
  1029.                :run qedit.pub.robelle
  1030.                /text robelle.job.robelle
  1031.                /change "robelle"(upshift) "tools" all
  1032.  
  1033.  
  1034.    Step 2:  Restore Files
  1035.  
  1036.           Restore  the  files  into  your  account,  which  is Tools in this
  1037.           example.
  1038.  
  1039.                :restore *rtape;@.@.@;account=tools
  1040.  
  1041.  
  1042.    Steps 3 and 4:  Alter and Stream Installation Jobs
  1043.  
  1044.           Now log on to the Tools account instead of the Robelle account.
  1045.  
  1046.                :hello mgr.tools
  1047.                :run qedit.pub.robelle
  1048.  
  1049.           Before streaming any jobs, you must alter them so that they log on
  1050.           to  the  Tools  account  instead of the Robelle account.  Make the
  1051.           following change to each job in the  Suprjob,  Job,  and  Purgejob
  1052.           groups:
  1053.  
  1054.                /text install.suprjob
  1055.                /change "robelle"(upshift smart) "tools" all
  1056.                /keep
  1057.                /exit
  1058.                :stream install.suprjob
  1059.  
  1060.           We  have  used  Robelle's  Qedit  text editor to make the required
  1061.           changes to the account name in this example, but you can  use  any
  1062.           editor.   Just  make  sure  that  all occurrences of "robelle" are
  1063.           changed,  regardless  of  whether  "robelle"  is   in   uppercase,
  1064.           lowercase,  or  mixed  case.   Only  change "robelle" when it is a
  1065.           separate word, not when it is embedded in a longer word.
  1066.