home *** CD-ROM | disk | FTP | other *** search
/ ftp.robelle3000.ai 2014 / 2014.06.ftp.robelle3000.ai.tar / ftp.robelle3000.ai / changes / supr4p3ux.txt < prev    next >
Text File  |  2001-11-05  |  19KB  |  579 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                              SUPRTOOL Version 4.3
  7.  
  8.  
  9.                           Database Handyman for HP-UX
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                  Change Notice
  17.                            Installation Instructions
  18.                           Addendum to 4.2 User Manual
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                             Suprtool         4.3
  26.                             Suprlink         4.3
  27.                             STExport         4.3
  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 2000
  51.           Program and Manual Copyright Robelle Consulting Ltd.  1981-2001
  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.3
  67.  
  68.  
  69.                ⁿ  Highlights
  70.                ⁿ  Known Problems
  71.                ⁿ  Compatibility
  72.                ⁿ  CPU Serial Number (uname)
  73.                ⁿ  Documentation
  74.                ⁿ  Documentation in WinHelp Format
  75.  
  76.           Use Suprtool/UX to read, select, and sort  data  from  Oracle  and
  77.           Allbase  databases  and from data files with fixed-length records.
  78.           Suprtool/UX is designed to be similar to Suprtool  for  MPE  while
  79.           providing   necessary   HP-UX   features.    Suprlink/UX  provides
  80.           high-speed data-file linking based on a sort key.  Use STExport to
  81.           convert fields in a self-describing input file into an output file
  82.           that can be imported into different applications.
  83.  
  84.           We appreciate you trying Suprtool/UX.  Let us know how Suprtool/UX
  85.           meets your HP-UX data needs.
  86.  
  87.  
  88.  
  89.    Highlights in Version 4.3
  90.  
  91.  
  92.    Data functions
  93.  
  94.           ⁿ  Compute  the  absolute  value  of  an expression using the $ABS
  95.              function.
  96.  
  97.           ⁿ  Compute  the  integer  portion  of  an  expression  using   the
  98.              $TRUNCATE function.
  99.  
  100.           ⁿ  Patterns in the If command can be much larger.
  101.  
  102.  
  103.    Date functions
  104.  
  105.           ⁿ  New date formats supported: new phdate format in integer fields
  106.              for versions of PowerHouse 8.19 and higher, EDSDATE and  Julian
  107.              Day number.
  108.  
  109.           ⁿ  Convert  any  date  to  a  Julian  Day  Number  with  the $DAYS
  110.              function.
  111.  
  112.  
  113.    System functions
  114.  
  115.           ⁿ  Suprlink and STExport are now capable of  reading  and  writing
  116.              files greater than 2 Gigabytes.
  117.  
  118.           ⁿ  Suprtool  now  allows  the  '$'  character  to be used in field
  119.              names.
  120.  
  121.           ⁿ  Suprlink  and  STExport  now  support  filenames  up   to   240
  122.              characters in length.
  123.  
  124.           ⁿ  Get the version number with Verify Version in Suprtool.
  125.  
  126.  
  127.    Known Problems
  128.  
  129.           There are no known problems at this time.
  130.  
  131.  
  132.    Compatibility
  133.  
  134.           Suprtool/UX  is  compatible  with HP-UX 9.0, all versions of HP-UX
  135.           10.x, as well as Oracle version 7.1.3.2.0.
  136.  
  137.           On HP-UX 10.x,  Suprtool/UX  creates  all  of  its  temporary  and
  138.           scratch   files  in  /var/tmp,  unless  you  have  overridden  the
  139.           temporary directory with the TMPDIR environment variable.
  140.  
  141.           Suprtool for HP-UX  typically  comes  with  two  versions  in  two
  142.           different  directories  on  your tape.  The version of Suprtool in
  143.           /opt/robelle is  compatible  with  HP-UX  10.20  and  later.   The
  144.           version  of  Suprtool  in /usr/robelle is compatible with versions
  145.           earlier than HP-UX 10.20.
  146.  
  147.  
  148.  
  149.    CPU Serial Number (uname)
  150.  
  151.           This program runs only on CPUs  whose  serial  numbers  have  been
  152.           encoded (the "uname" on HP-UX).  If it fails to run and you get an
  153.           "invalid HPSUSAN" error message, call Robelle for assistance.
  154.  
  155.  
  156.    Documentation
  157.  
  158.           The user manuals for Suprtool and  its  components  are  available
  159.           on-line.   You  can  access  these  files  from within Suprtool by
  160.           simply typing "help."   We also distribute all three user  manuals
  161.           as a Windows Help file.
  162.  
  163.           If you are already familiar with Suprtool, you can access only the
  164.           Suprtool/UX topics that are different from those of  Suprtool/MPE.
  165.           The  "Running"  section  of  the  help  file  has been updated for
  166.           Suprtool/UX.  You can access it with this Help command:
  167.  
  168.                >help running
  169.  
  170.  
  171.    Documentation in WinHelp Format
  172.  
  173.           The user manuals for Suprtool and its components are all available
  174.           in  the  popular  WinHelp  file format of Microsoft Windows.  Your
  175.           tape  includes  a  WinHelp  file,  which  is   a   self-extracting
  176.           compressed  file  that  contains  all  five Help files and a Setup
  177.           program.  Use the installation instructions in this change  notice
  178.           to install the WinHelp files on your PC.
  179.  
  180.  
  181.    Installation of 4.3
  182.  
  183.  
  184.           The  following instructions describe the installation process of a
  185.           new Suprtool release.  The  new  version  overwrites  an  existing
  186.           version of Suprtool on your HP-UX system.
  187.  
  188.  
  189.    Who Should Use These Instructions?
  190.  
  191.           The  system  manager  should  use  the  following  instructions to
  192.           install Suprtool/UX.  During the installation, which  should  take
  193.           only a few minutes, no one can use Suprtool/UX.
  194.  
  195.  
  196.    Replace Any Pre-Release
  197.  
  198.           If  you  are  currently running a pre-release version of Suprtool,
  199.           you should replace it with this new official release.  Pre-release
  200.           versions  expire  within two years of their creation date, whereas
  201.           this new release has no expiry date.  You can easily  recognize  a
  202.           pre-release by the words "Pre-Release" next to the version number.
  203.  
  204.  
  205.    Summary of Installation Steps
  206.  
  207.           To install Suprtool, follow these steps:
  208.  
  209.           1. Log in as root.
  210.  
  211.           2. Create the correct directory structure.
  212.  
  213.           3. Restore  Suprtool/UX  and  its  associated   files   from   the
  214.              distribution tape.
  215.  
  216.           4. Set  up  variables  to  let  Suprtool know where its supporting
  217.              files are.
  218.  
  219.           5. Install WinHelp documentation files.  (optional)
  220.  
  221.  
  222.    Installation Assistance
  223.  
  224.           If you have any questions or run into any  problems,  please  call
  225.           us.   Technical  support is available on weekdays from 7 a.m. to 4
  226.           p.m. Pacific time at 1-888-ROBELLE (1-888-762-3553).  You can also
  227.           receive  emergency  support  outside of these hours by calling our
  228.           regular phone number and asking the operator  to  page  a  support
  229.           person for you.
  230.  
  231.  
  232.    Step 1:  Log In as Root
  233.  
  234.           There are two ways you can log in as root:
  235.  
  236.           a. Exit from HP-UX and log in with root as the user name.
  237.  
  238.           b. If you are already logged in, you can execute this command:
  239.  
  240.                   su -
  241.  
  242.           In  either case, you have to know and supply the user password for
  243.           root.
  244.  
  245.  
  246.    Step 2:  Create Robelle Directory
  247.  
  248.           Before restoring files, you must first create the directory  where
  249.           Suprtool/UX will reside:
  250.  
  251.                mkdir /opt/robelle
  252.  
  253.  
  254.    Step 3:  Restore Files
  255.  
  256.           Use  the  following  command to restore the Suprtool/UX files from
  257.           the distribution tape:
  258.  
  259.                tar xv /opt/robelle
  260.  
  261.           This command assumes your tape device is /dev/rmt/0m.   If  it  is
  262.           not,  you need to specify your tape device using the "f" option in
  263.           the tar command.  For example, if your tape device is /dev/rmt/1m,
  264.           you need to use the following command to restore the files:
  265.  
  266.                tar xvf /dev/rmt/1m /opt/robelle
  267.  
  268.  
  269.    Step 4:  Set the ROBELLE Variable
  270.  
  271.           You must set the ROBELLE environment variable so that Suprtool can
  272.           find its Help and Suprmgr files.
  273.  
  274.  
  275.    Bourne and Korn Shells
  276.  
  277.                export ROBELLE=/opt/robelle
  278.  
  279.  
  280.    C Shell
  281.  
  282.                setenv ROBELLE /opt/robelle
  283.  
  284.  
  285.    Step 5:  Install WinHelp Documentation Files (optional)
  286.  
  287.           The Suprtool documentation for both MPE and HP-UX is now available
  288.           in  the  WinHelp  format  of  Microsoft Windows.  You can only use
  289.           these files if you have Windows 3.1  or  later.   To  install  the
  290.           WinHelp files on a PC, follow these instructions.
  291.  
  292.  
  293.    Make a Temporary Directory for the Setup Program
  294.  
  295.           Create  a directory for the installation file on your PC.  You can
  296.           remove this directory after installing the WinHelp files.  At  the
  297.           DOS prompt, for example, type
  298.  
  299.                mkdir \robtemp
  300.  
  301.  
  302.    Download the Compressed File
  303.  
  304.           If  you  use  the floppy diskette that is included in the Suprtool
  305.           User Manual to copy the Help files to your hard drive, proceed  to
  306.           "Run  the  Setup  Program"  below.   Otherwise,  use Reflection to
  307.           download the self-extracting Zip file to your PC and continue with
  308.           these steps.  The file on the HP 9000 is
  309.  
  310.                /opt/robelle/winhelp/suprhelp.exe
  311.  
  312.           From  the /opt/robelle/winhelp directory, press Alt-Y to go to the
  313.           Reflection Command Line window.   Then  download  the  file  as  a
  314.           binary transfer.
  315.  
  316.                receive c:\robtemp\suprhelp.exe
  317.                       from /opt/robelle/winhelp/suprhelp.exe binary
  318.  
  319.  
  320.    Expand the Compressed Files
  321.  
  322.           You  only need the following commands to extract the files because
  323.           we provide both the Setup  program  and  the  Help  files  in  one
  324.           self-extracting Zip file.  From the DOS prompt, type the following
  325.           commands:
  326.  
  327.                cd \robtemp          {go to the new Robtemp directory}
  328.                suprhelp.exe         {extract the Help files}
  329.  
  330.  
  331.    Run the Setup Program
  332.  
  333.           From the Program Manager, run the Setup program  by  choosing  the
  334.           Run option from the File menu.  Then enter c:\robtemp\setup in the
  335.           Command Line window and  follow  the  instructions  in  the  Setup
  336.           program.
  337.  
  338.           You  can now access all of the Suprtool documentation by selecting
  339.           any of the icons in the "Robelle Help" Program Manager Group.
  340.  
  341.  
  342.    Remove the Robtemp Directory
  343.  
  344.           Before you remove the WinHelp  files,  you  can  copy  them  to  a
  345.           diskette and distribute them to other Suprtool users.
  346.  
  347.           To  delete all the WinHelp files and remove the Robtemp directory,
  348.           use either the File Manager or the following DOS commands:
  349.  
  350.                cd \robtemp
  351.                del *.*          {delete all the files in Robtemp}
  352.                cd ..
  353.                rmdir robtemp    {remove the Robtemp directory}
  354.  
  355.  
  356.    Enhancements
  357.  
  358.           Every year we provide Suprtool/UX users with  new  features.   The
  359.           following section describes the new enhancements to Suprtool since
  360.           the last major release.
  361.  
  362.  
  363.    $Abs function
  364.  
  365.           Suprtool supports a $abs function which returns the absolute value
  366.           of the number.  For example if the field credit contains the value
  367.           -547.83, the $abs function will return 547.83.
  368.  
  369.           This function will work on a field or even an expression such as:
  370.  
  371.                >if $abs(credit / 100 * 1.07)
  372.  
  373.           This function will also work in the extract command:
  374.  
  375.                >def newcredit,1,4,double
  376.                >ext newcredit = $abs(newcredit / 100 * 1.07)
  377.  
  378.  
  379.  
  380.    $Days function
  381.  
  382.           Suprtool  supports  a  $days  function  which  will  convert   any
  383.           supported  date to a Julian Day number.  (the number of days since
  384.           4713 BC).  This allows for  Date  arithmetic,  in  which  you  can
  385.           calculate  the  difference  between  two  dates, even if they have
  386.           dissimilar formats.
  387.  
  388.           For example you could find all orders that were not shipped within
  389.           30 days of being ordered.
  390.  
  391.                >form ORDFILE
  392.                    File: ORDFILE                (SD Version B.00.00)
  393.                       Entry:                  Offset
  394.                          ORDER-DATE       x8      1         <<CCYYMMDD>>
  395.                          SHIP-DATE        X8      9         <<MMDDYYYY>>
  396.                          ORDER-NUMBER     X6      17
  397.                    Limit: 10000  EOF: 15  Entry Length: 23  Blocking: 16
  398.  
  399.                >in ORDFILE
  400.                >if $days(SHIP-DATE) - $days(ORDER-DATE) >=30
  401.                >list
  402.                >xeq
  403.                IN=15, OUT=4.  CPU-Sec=1.  Wall-Sec=1.
  404.  
  405.           As  with the $stddate function, if a date is not a valid date then
  406.           the result of the $days function will be zero.
  407.  
  408.           Similar to the  $stddate  function  the  $days  function  is  also
  409.           available  to  the extract command.  You can convert any supported
  410.           date to a Julian day number in the following manner.
  411.  
  412.                >in ordfile
  413.                >def ship-days,1,4,double
  414.                >def order-days,1,4,double
  415.                >ext order-no
  416.                >ext ship-days=$days(ship-date)
  417.                >ext order-days=$days(order-date)
  418.                >out neword,link
  419.                >xeq
  420.                IN=15, OUT=15.  CPU-Sec=1.  Wall-Sec=1.
  421.  
  422.           If an invalid date is encountered the value that is extracted will
  423.           be zero.
  424.  
  425.  
  426.  
  427.    $Truncate function
  428.  
  429.           Suprtool supports a $truncate function which returns the number to
  430.           the left of a decimal place.  No rounding will  take  place.   For
  431.           example  if  the  field  stddev  contains  the  value  547.83, the
  432.           $truncate function will return 547.
  433.  
  434.           This function will work on a field or even an expression such as:
  435.  
  436.                >if $truncate(stddev / 100 * 1.07)
  437.  
  438.           This function will also work in the extract command:
  439.  
  440.                >def newdev,1,4,double
  441.                >ext newdev = $truncate(stddev / 100 * 1.07)
  442.  
  443.  
  444.  
  445.    Field Names
  446.  
  447.           Suprtool now allows the "$" character to be used in  field  names.
  448.           This  was done to allow some users read databases used in the BAAN
  449.           MRP application which uses the '$' character in all of  it's  item
  450.           names.
  451.  
  452.  
  453.  
  454.    If Command
  455.  
  456.           The  If  command  previously  only supported patterns or fields of
  457.           only up to 256 characters for a pattern matching operation.   This
  458.           restriction is no longer in effect.
  459.  
  460.                >in long
  461.                >def a,1,1000
  462.                >if a==" Company "
  463.                >list
  464.                >xeq
  465.  
  466.  
  467.  
  468.    Item Command - Date
  469.  
  470.           The  Item command now has two new date formats, these date formats
  471.           are EDSDATE and JulianDay.
  472.  
  473.  
  474.    EDSDATE
  475.  
  476.           The Item command now supports a new date  format  called  EDSDATE,
  477.           which  is  a  date in a format similar to yyymmdd, where the first
  478.           digit represents the century.
  479.  
  480.           The first digit  in  the  EDSDATE  is  either  0  or  1,  where  0
  481.           represents  a  century  of  19  and  1 represents a century of 20.
  482.           These date formats are available as either a double integer  or  a
  483.           Packed field.
  484.  
  485.                >item order-date,date,edsdate
  486.  
  487.  
  488.    JulianDay
  489.  
  490.           Another  new  date,  called  JulianDay  has been added to the Item
  491.           command.  The JulianDay number is the absolute count of  the  days
  492.           that  have  elapsed  since  Noon  1  January 4713 BC on the Julian
  493.           Calendar.
  494.  
  495.           Typically Julian Day Numbers refer to integer number corresponding
  496.           to  whole  days,  while  the  Julian Date may mean an integer plus
  497.           decimal that brings the Julian count down to precise  parts  of  a
  498.           day.   Suprtool  supports  the  "JulianDay"  number  and  does not
  499.           attempt to support an hour or point in the day.
  500.  
  501.           This date format is available  for  a  double  integer  or  double
  502.           logical data type.
  503.  
  504.                >item daydate,date,julianday
  505.  
  506.  
  507.  
  508.    Item Command - PHDate8
  509.  
  510.  
  511.    PHDate8
  512.  
  513.           PowerHouse  versions  8.19  and  higher  have changed their Phdate
  514.           format stored in a single integer  (j1)  container.   The  allowed
  515.           range of values for the year is now 00 - 127.
  516.  
  517.           The Item command has been enhanced to support this new format:
  518.  
  519.                >item daydate,date,phdate8
  520.  
  521.           Given  the  fact  that  many users may have a lot of Suprtool code
  522.           with references to the Item command we have provided a Set command
  523.           to change:
  524.  
  525.                >item daydate,date,phdate
  526.  
  527.           to mean:
  528.  
  529.                >item daydate,date,phdate8
  530.  
  531.           The set command is:
  532.  
  533.                >set date MapToPhdate8 on
  534.  
  535.           This  Set  command only changes the reference to phdate to phdate8
  536.           in the Item command, it does not change  references  that  already
  537.           exist in self-describing files nor does it change the data.
  538.  
  539.  
  540.  
  541.    Set Command - Date
  542.  
  543.           A  new  Set command has been added to help change any Item command
  544.           reference to phdate to mean phdate8, for assistance in  converting
  545.           to  the  newer  phdate format found in PowerHouse version 8.19 and
  546.           higher.
  547.  
  548.           The Set command is:
  549.  
  550.                >set date MapToPhdate8 on
  551.  
  552.           This only changes the reference to phdate8 in the Item command, it
  553.           does  not  change references that already exist in self-describing
  554.           files nor does it change the data.
  555.  
  556.  
  557.  
  558.    Suprlink and STExport
  559.  
  560.           Suprlink  and  STExport  now  support  filenames  of  up  to   240
  561.           characters in the Input, Output and Link commands .
  562.  
  563.           Suprlink and STExport are now capable of reading and writing files
  564.           greater than 2 gigabytes.
  565.  
  566.  
  567.  
  568.  
  569.    Bugs Fixed
  570.  
  571.  
  572.  
  573.    $stddate and phdate.  The $stddate function will  now  apply  the  cutoff
  574.           rules for the phdate format in small-int (I1 & J1) data fields.
  575.  
  576.  
  577.    Sort Command.  The Sort function attempts to use less heap resources when
  578.           attempting to sort files greater than 2 gigabytes.
  579.