home *** CD-ROM | disk | FTP | other *** search
/ ftp.robelle3000.ai 2014 / 2014.06.ftp.robelle3000.ai.tar / ftp.robelle3000.ai / changes / supr4p1ux.txt < prev    next >
Text File  |  2002-07-29  |  20KB  |  603 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                             SUPRTOOL Version 4.0.17
  7.  
  8.  
  9.                           Database Handyman for HP-UX
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                  Change Notice
  17.                            Installation Instructions
  18.                           Addendum to 4.0 User Manual
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                             Suprtool         4.0.17
  26.                             Suprlink         4.0.17
  27.                             STExport         4.0.17
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                             Robelle Consulting Ltd.
  39.                            Unit 201, 15399-102A Ave.
  40.                          Surrey, B.C.  Canada V3R 7K1
  41.  
  42.                            Toll-free:  1-888-ROBELLE
  43.                                       (1-888-762-3553)
  44.                             Phone:  (604) 582-1700
  45.                              Fax:  (604) 582-1799
  46.  
  47.                          E-mail:  support@robelle.com
  48.                              Web:  www.robelle.com
  49.  
  50.                                February 9, 1998
  51.           Program and Manual Copyright Robelle Consulting Ltd.  1981-2002
  52.  
  53.  
  54.           Permission  is  granted  to  reprint  this  document  (but not for
  55.           profit), provided that copyright notice is given.
  56.  
  57.  
  58.  
  59.  
  60.           QEDIT and SUPRTOOL  are  trademarks  of  Robelle  Consulting  Ltd.
  61.           Other  product  and  company  names  mentioned  herein  may be the
  62.           trademarks of their respective owners.
  63.  
  64.  
  65.  
  66.    Introducing Suprtool/UX Version 4.0.17
  67.  
  68.  
  69.                ⁿ  Highlights
  70.                ⁿ  Known Problems
  71.                ⁿ  Compatibility
  72.                ⁿ  HP-UX 10.0 Compatibility
  73.                ⁿ  CPU Serial Number (uname)
  74.                ⁿ  Documentation
  75.                ⁿ  Documentation in WinHelp Format
  76.                ⁿ  Bugs Fixed in New Features
  77.  
  78.           Use Suprtool/UX to read, select, and sort  data  from  Oracle  and
  79.           Allbase  databases  and from data files with fixed-length records.
  80.           Suprtool/UX is designed to be similar to Suprtool  for  MPE  while
  81.           providing   necessary   HP-UX   features.    Suprlink/UX  provides
  82.           high-speed data-file linking based on a sort key.  Use STExport to
  83.           convert fields in a self-describing input file into an output file
  84.           that can be imported into different applications.
  85.  
  86.           We appreciate you trying Suprtool/UX.  Let us know how Suprtool/UX
  87.           meets your HP-UX data needs.
  88.  
  89.  
  90.    Highlights in Version 4.0.17
  91.  
  92.           ⁿ  The Item command with the SRNChronos date format now checks the
  93.              size of the field.
  94.  
  95.  
  96.    Highlights in Version 4.0.16
  97.  
  98.           ⁿ  A new Set date ifyy2000error command has been added to  control
  99.              whether or not Suprtool considers dates with two-digit years an
  100.              error if they go beyond 1999 during a relative operation.
  101.  
  102.  
  103.    Highlights in Version 4.0.15
  104.  
  105.           ⁿ  Oracle error messages were not printing properly.
  106.  
  107.           ⁿ  Numerous documentation fixes were made to the Suprtool manual.
  108.  
  109.  
  110.    Highlights in Version 4.0.14
  111.  
  112.           ⁿ  STExport was trimming the first character of some zoned decimal
  113.              fields.
  114.  
  115.           ⁿ  The  Duplicate command now allows an alternate sort level to be
  116.              specified.
  117.  
  118.           ⁿ  STExport was failing when an phdate date type was in an SD file
  119.              and sign none was specified.
  120.  
  121.  
  122.    Highlights in Version 4.0.13
  123.  
  124.  
  125.           ⁿ  Suprtool now supports the ROBELLE variable.
  126.  
  127.           ⁿ  STExport  was not properly processing Zoned Decimal fields with
  128.              zeroes leading.
  129.  
  130.  
  131.    Highlights in Version 4.0.12
  132.  
  133.  
  134.           ⁿ  Suprtool now has a readonly mode of operation whereby  adds  to
  135.              Oracle databases are disabled.
  136.  
  137.           ⁿ  Suprtool was not processing any commands in the Suprmgr file.
  138.  
  139.  
  140.    Highlights in Version 4.0.11
  141.  
  142.  
  143.           ⁿ  Suprtool  now  supports the Software Research Northwest Chronos
  144.              date format.
  145.  
  146.           ⁿ  Suprtool's if command  did  not  abort  when  doing  a  compare
  147.              against a date beyond 1999 when being entered interactively.
  148.  
  149.           ⁿ  Suprtool's  if  command  did not produce an error if a relative
  150.              $date or $today function was specified beyond 1999.
  151.  
  152.           ⁿ  Suprtool now allows use files to be nested.
  153.  
  154.           ⁿ  The Add command for Oracle did not add all the records  from  a
  155.              file in all cases.
  156.  
  157.           ⁿ  Reset Add and Verify Add now work as documented.
  158.  
  159.           ⁿ  STExport  did  not properly set the Delimiter option when using
  160.              HTML Table command in all cases.
  161.  
  162.           ⁿ  STExport did not always build an output file  with  the  proper
  163.              record size when the Heading Column option was used.
  164.  
  165.  
  166.    Highlights in Version 4.0.10
  167.  
  168.  
  169.           ⁿ  There are currently no changes in Suprtool for HP-UX.
  170.  
  171.  
  172.    Known Problems
  173.  
  174.           There are no known problems at this time.
  175.  
  176.  
  177.    Compatibility
  178.  
  179.           Suprtool/UX  is  compatible with both HP-UX 9.0 and Oracle version
  180.           7.1.3.2.0.
  181.  
  182.  
  183.  
  184.    HP-UX 10.0 Compatibility and Installation
  185.  
  186.           Suprtool/UX is compatible with all versions of HP-UX 10.x.  If you
  187.           want to use the new HP-UX 10.x naming conventions for Suprtool/UX,
  188.           you need to perform the following steps while logged in as root:
  189.  
  190.           1. Get the files off the tape:
  191.  
  192.                   tar xv
  193.  
  194.           2. Move the files to /opt/robelle:
  195.  
  196.                   mv /usr/robelle /opt
  197.  
  198.           3. Set the ROBELLE environment variable to the new directory
  199.  
  200.                   export ROBELLE=/opt/robelle
  201.  
  202.           Suprtool/UX  creates  all  its  temporary  and  scratch  files  in
  203.           /var/tmp,  unless  you have overriden the temporary directory with
  204.           the TMPDIR environment variable.  [4.0.12]
  205.  
  206.  
  207.    CPU Serial Number (uname)
  208.  
  209.           This program runs only on CPUs  whose  serial  numbers  have  been
  210.           encoded (the "uname" on HP-UX).  If it fails to run and you see an
  211.           "invalid HPSUSAN" error message, call Robelle for assistance.
  212.  
  213.  
  214.    Documentation
  215.  
  216.           Although we do not include a revised user manual with  pre-release
  217.           versions  of  Suprtool, we do provide updated Help files.  You can
  218.           access these files from within Suprtool by simply typing "help."
  219.           We also distribute all three user manuals as a Windows Help file.
  220.  
  221.           If  you are already familiar with Suprtool, you may want to access
  222.           only the Suprtool/UX topics  that  are  different  from  those  of
  223.           Suprtool/MPE.   The  "Running"  section  of the help file has been
  224.           updated for  Suprtool/UX.   You  can  access  it  with  this  help
  225.           command:
  226.  
  227.                >help running
  228.  
  229.  
  230.    Documentation in WinHelp Format
  231.  
  232.           The user manuals for Suprtool and its components are all available
  233.           in the popular WinHelp file format  of  Microsoft  Windows.   Your
  234.           tape   includes   a  WinHelp  file,  which  is  a  self-extracting
  235.           compressed file that contains all five  Help  files  and  a  Setup
  236.           program.   Use the installation instructions in this change notice
  237.           to install the WinHelp files on your PC.
  238.  
  239.  
  240.    Bugs Fixed in New Features.
  241.  
  242.  
  243.    STExport.  STExport  was  trimming  off  the  first  character  in   some
  244.           zoned-decimal fields.  [4.0.13]
  245.  
  246.  
  247.  
  248.    Installation of 4.0.16
  249.  
  250.  
  251.           The  following  general  notes  describe the installation of a new
  252.           Suprtool release.  The new version overwrites an existing  version
  253.           of Suprtool on your HP-UX system.
  254.  
  255.  
  256.    Who Should Use These Instructions?
  257.  
  258.           The  system  manager  should  use  the  following  instructions to
  259.           install Suprtool/UX.  During the installation, which  should  take
  260.           only a few minutes, no one can use Suprtool/UX.
  261.  
  262.  
  263.    This Tape Will Expire
  264.  
  265.           All Robelle pre-release software has an expiration date because it
  266.           should be replaced with our official major releases.   Suprtool/UX
  267.           pre-release tapes expire eighteen months after they are made.  The
  268.           software warns you when you are within sixty days  of  the  expiry
  269.           date.  The exact expiry date is on the tape label.
  270.  
  271.  
  272.    Summary of Installation Steps
  273.  
  274.           Installing Suprtool involves the following steps:
  275.  
  276.           1. You must log in as root.
  277.  
  278.           2. You must create the correct directory structure.
  279.  
  280.           3. You  must restore Suprtool/UX and its associated files from the
  281.              distribution tape.
  282.  
  283.           4. You can set up a PATH for Suprtool/UX or copy the program to an
  284.              existing directory in your PATH.  (optional)
  285.  
  286.           5. You can install WinHelp documentation files.  (optional)
  287.  
  288.           6. You can set the ROBELLE variable if you installed Suprtool into
  289.              a directory other than /usr/robelle.  (optional)
  290.  
  291.  
  292.    Step 1:  Log In as Root
  293.  
  294.           There are two ways you can log in as root:
  295.  
  296.           a. Exit from HP-UX and log in with root as the user name.
  297.  
  298.           b. If you are already logged in, you can execute this command:
  299.  
  300.                   su -
  301.  
  302.           In either case, you have to know and supply the user password  for
  303.           root.
  304.  
  305.  
  306.    Step 2:  Create Robelle Directory
  307.  
  308.           Suprtool/UX  is  installed  in /usr/robelle.  Before restoring its
  309.           files, you must first create /usr/robelle:
  310.  
  311.                mkdir /usr/robelle
  312.  
  313.  
  314.    Step 3:  Restore Files
  315.  
  316.           Use the following command to restore the  Suprtool/UX  files  from
  317.           the distribution tape:
  318.  
  319.                tar xv /usr/robelle
  320.  
  321.           After  successfully  restoring  the  files,  you  can  run the new
  322.           version of Suprtool/UX.
  323.  
  324.                /usr/robelle/bin/suprtool
  325.  
  326.  
  327.    Step 4:  Set Up PATH (optional)
  328.  
  329.           You can now invoke Suprtool with the following command:
  330.  
  331.                /usr/robelle/bin/suprtool
  332.  
  333.           If you want to just type
  334.  
  335.                suprtool
  336.  
  337.           to invoke Suprtool/UX, you must  either  add  /usr/robelle/bin  to
  338.           your PATH or copy /usr/robelle/bin/suprtool to a directory that is
  339.           currently on your PATH.  Similarly, the man pages for Suprtool are
  340.           in   /usr/robelle/man/man1/suprtool.1.   To  make  the  man  pages
  341.           available to everyone, you can either add /usr/robelle/man to your
  342.           MANPATH  or copy the man pages to a directory that is currently on
  343.           your MANPATH.
  344.  
  345.           If you adjust your PATH and MANPATH environment variables, you can
  346.           also invoke Suprlink/UX with
  347.  
  348.                suprlink
  349.  
  350.  
  351.    Step 5:  Install WinHelp Documentation Files (optional)
  352.  
  353.           All  of the Suprtool documentation is now available in the WinHelp
  354.           format of Microsoft Windows.  You can only use these files if  you
  355.           have a Windows PC.
  356.  
  357.  
  358.    Make a Temporary Directory for the Setup Program
  359.  
  360.           Create  a directory for the installation file on your PC.  You can
  361.           remove this directory after installing the WinHelp files.  At  the
  362.           DOS prompt for example, type
  363.  
  364.                mkdir \robtemp
  365.  
  366.  
  367.    Download the Compressed File
  368.  
  369.           In  the  next  step, download the self-extracting Zip file to your
  370.           PC.  If you are using Reflection to download the Zip file,  follow
  371.           these instructions.  The file on the HP 9000 is called
  372.  
  373.               /usr/robelle/winhelp/suprhelp.exe
  374.  
  375.           From  the /usr/robelle/winhelp directory, press Alt-Y to go to the
  376.           Reflection Command Line window.  Make sure that you use the binary
  377.           transfer.
  378.  
  379.               receive c:\robtemp\suprhelp.exe
  380.                       from suprhelp.exe binary
  381.  
  382.  
  383.    Expand the Compressed File
  384.  
  385.           You  need only the following commands to extract the files because
  386.           we  provide  the  Setup  program  and  the  Help  files   in   one
  387.           self-extracting  Zip  file.   From  the  DOS  prompt,  type  these
  388.           commands:
  389.  
  390.                cd \robtemp          {go to the new Robtemp directory}
  391.                suprhelp.exe         {extract the Help files}
  392.  
  393.  
  394.    Run the Setup Program
  395.  
  396.           Now you can run the Setup program.  In Windows 95, select Run from
  397.           the  Start  menu and enter c:\robtemp\setup in the Run dialog box.
  398.           Then follow the instructions in the Setup program.
  399.  
  400.           Once the Setup  program  is  finished,  you  can  access  all  the
  401.           Suprtool  documentation  by  selecting  any  of the "Robelle Help"
  402.           icons.
  403.  
  404.  
  405.    Remove the Robtemp Directory
  406.  
  407.           You can now remove all the files from the Robtemp directory either
  408.           from Explorer or by using the following DOS commands:
  409.  
  410.                cd \robtemp
  411.                del *.*              {delete all the files}
  412.                cd ..
  413.                rmdir robtemp        {remove the Robtemp directory}
  414.  
  415.           You  can  also  copy  the  files  in  Robtemp  to  a  diskette and
  416.           distribute them to other Suprtool users.
  417.  
  418.  
  419.    Step 6:  Set the ROBELLE Variable (optional)
  420.  
  421.           Suprtool/UX is normally installed in /usr/robelle.  If you install
  422.           Suprtool/UX  in  any  other directory, you need to perform another
  423.           step so that Suprtool can find its help and suprmgr  files.   This
  424.           additional step involves setting the ROBELLE environment variable.
  425.           If you install Suprtool into /opt/robelle for  example,  you  must
  426.           set the ROBELLE environment variable in the following manner:
  427.  
  428.                export ROBELLE="/opt/robelle"
  429.  
  430.  
  431.    Enhancements
  432.  
  433.  
  434.    Nested Usefiles  [4.0.11]
  435.  
  436.           Suprtool  now  allows  usefiles  to be nested; in other words, one
  437.           usefile can contain references to another usefile.  You  can  nest
  438.           the usefiles up to ten levels.
  439.  
  440.           For  example,  if  the  contents  of  the  usedef  usefile  had  a
  441.           references to useext, both usefiles would be executed:
  442.  
  443.                >open oracle store.suprtool
  444.                >select * from d_sales
  445.                >use usedef
  446.                define delivered,deliv_date
  447.                define purchased,purch_date
  448.                item delivered ,date ,yymmdd
  449.                item purchased ,date ,yymmdd
  450.                use useext
  451.                ext cust-account
  452.                ext deliv-date
  453.                ext product-no
  454.                ext product-price
  455.                ext purch-date
  456.                ext sales-qty
  457.                ext sales-tax
  458.                ext sales-total
  459.                >xeq
  460.  
  461.           Care must be taken when  entering  use  commands  with  a  stacked
  462.           command after the usefile reference.  For example, if you enter
  463.  
  464.                use usedef;def j,1,6,byte
  465.  
  466.           the define command will not be executed until after the usedef and
  467.           any other nested use commands are finished.
  468.  
  469.  
  470.    Duplicate Command  [4.0.14]
  471.  
  472.           The keys  num  option  determines  the  level  at  which  Suprtool
  473.           compares  sort keys.  This option controls which duplicate records
  474.           get included in (or excluded from) the output file.
  475.  
  476.           In the following example we sort by agent  and  by  bill-date  (in
  477.           descending  order),  but  only  check  for duplicates at the agent
  478.           level.
  479.  
  480.                >sort agent              {sort by agent}
  481.                >sort bill-date,desc     {sort by date }
  482.                >duplicate none keys 1   {only check for duplicate agents}
  483.                >output agents           {create roster of agents}
  484.  
  485.  
  486.    ROBELLE Environment Variable   [4.0.13]
  487.  
  488.           Suprtool looks for the files it needs in  the  /robelle  directory
  489.           (normally  /usr/robelle).   For  example, Suprtool expects to find
  490.           its help  files  in  a  subdirectory  called  help/suprtool.   The
  491.           absolute filename would be
  492.  
  493.                /usr/robelle/help/suprtool
  494.  
  495.           If  you  install  Suprtool in a directory other than /usr/robelle,
  496.           you need to set  the  ROBELLE  environment  variable  to  the  new
  497.           directory.  For example,
  498.  
  499.                ROBELLE=/usr/robhome
  500.                export ROBELLE
  501.  
  502.           There  are two limitations to the path name: the full path name of
  503.           the file must be no more than 36 characters, and the path name  to
  504.           the  /robelle  directory  must  be  no more than 22 characters.  A
  505.           slash mark (/) is optional at the end of your ROBELLE  environment
  506.           variable.
  507.  
  508.  
  509.    Set Date Ifyy2000Error On | Off  [4.0.16]
  510.  
  511.           By  default Suprtool considers Dates with a two-digit century from
  512.           the $date and $today functions to be invalid when they resolve  to
  513.           be greater than 1999 and the if operation is a relative operation.
  514.           (ie.  greater than or equal to)
  515.  
  516.           You can control whether or not Suprtool considers this an error or
  517.           not by making the following Set command:
  518.  
  519.               >set Date Ifyy2000Error Off
  520.  
  521.           Following  is  an example of what is considered to be and error by
  522.           the if command and how the Set command  can  turn  off  the  error
  523.           check:
  524.  
  525.                >def a,1,6
  526.                >item a,date,yymmdd
  527.                >if a >= $today(+2000)
  528.                           ^
  529.                 Error:  Cannot use a date beyond 1999 for this format
  530.                 >set date ifyy2000error off
  531.                 >if a >= $date(2000/01/03)
  532.  
  533.           We  have  chosen  this to be an error by default because if a date
  534.           that is in yymmdd format and resolves to be 000102 from the  $date
  535.           function  in  the if command is likely to resolve to be all of the
  536.           records for a given selecction task, which is of course, logically
  537.           incorrect.
  538.  
  539.  
  540.  
  541.    Set Limits ReadOnly On  [4.0.12]
  542.  
  543.           Suprtool   normally   allows  any  user  with  the  proper  access
  544.           capabilities to add records to an  Oracle  database.   To  prevent
  545.           users  from  accidentally  updating their database, we provide the
  546.           following setting within Suprtool:
  547.  
  548.                >set limits ReadOnly On
  549.  
  550.           The readonly setting, once turned on, cannot be turned off for the
  551.           current  run  of  Suprtool,  which  disallows  all  commands  that
  552.           potentially change data for a given database.
  553.  
  554.           If set limits readonly is enabled, the  add  command  in  Suprtool
  555.           will return an appropriate error message.
  556.  
  557.           You  can enable set limits readonly from the command line by using
  558.           the -c option.  For example, the following  command  file  can  be
  559.           used  to  restrict  who  has write access to a given database.  In
  560.           this example only the root user is allowed write access:
  561.  
  562.                if [ $USER = "root" ]
  563.                then
  564.                   /usr/robelle/bin/suprtool
  565.                else
  566.                   /usr/robelle/bin/suprtool -c'set limits readonly on'
  567.                fi
  568.  
  569.  
  570.  
  571.  
  572.    Bugs Fixed
  573.  
  574.  
  575.  
  576.    If Command.  The if command did not produce  an  error  when  a  relative
  577.           $date or $today function were specified beyond 1999.  [4.0.10]
  578.  
  579.  
  580.    Oracle.  Error  messages were not being reported properly from the Oracle
  581.           interface.  [4.0.15]
  582.  
  583.  
  584.    STExport Program.  The following problems in STExport have been fixed:
  585.  
  586.           1. STExport would not properly set the  Delimiter  to  None  on  a
  587.              second task when setting the HTML option to Table.  [4.0.11]
  588.  
  589.           2. STExport  would  fail if the total length of the Heading Column
  590.              commands exceeded the total size of the fields.  [4.0.11]
  591.  
  592.           3. STExport was failing with an invalid write-length  error  if  a
  593.              phdate  field  was  in  the  SD  file  and sign none option was
  594.              specified.  [4.0.14]
  595.  
  596.  
  597.    Suprlink.  Suprlink would not properly link files by a Quad integer  key.
  598.           (I4 or J4).  [4.0.11]
  599.  
  600.  
  601.    Suprmgr File.  Suprtool 4.0.11 did not process any of the commands in the
  602.           Suprmgr file.  [4.0.12]
  603.