home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / spufi116.zip / README next >
Text File  |  1993-12-30  |  28KB  |  1,215 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                          SPUFI/2 From ICA
  22.  
  23.      A DBA SQL Front-end for OS/2 DB2/2 and Database Manager
  24.  
  25.                               V1.1.6
  26.  
  27.          @ Copyright ICE Computer Associates Limited 1993
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                                   ICE Computer Associates Limited
  57.                                                 31A Theydon Grove
  58.                                                            Epping
  59.                                                             Essex
  60.                                                          CM16 4PU
  61.                                                           England
  62.                                             Tel: (UK) 0992 560788
  63.  
  64.  
  65.  
  66.  
  67. December 1993                                      SPUFI/2 V1.1.6
  68.  
  69.  
  70.  
  71.  
  72.  
  73. CONTENTS
  74.  
  75.      1    What is SPUFI/2?
  76.  
  77.      2    SPUFI/2 Keyboard Mapping
  78.  
  79.      3    The SPUFI/2 Dialogue
  80.  
  81.      4    SPUFI/2 Panels
  82.  
  83.      5    SQL
  84.  
  85.      6    Command Line Parameters
  86.  
  87.      7    Installation
  88.  
  89.      8    SPUFI2.INI
  90.  
  91.      9    Automatic Binding
  92.  
  93.      10   Support
  94.  
  95.      11   Changes in Version 1.1.6
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126. Copyright ICE Computer Associates 1993                     Page 2
  127.  
  128.  
  129.  
  130.  
  131. December 1993                                      SPUFI/2 V1.1.6
  132.  
  133.  
  134.  
  135.  
  136.  
  137. 1    WHAT IS SPUFI/2?
  138.  
  139.      You must first ask what is SPUFI?  SPUFI is an IBM product
  140.      which works in the MVS TSO/ISPF environment as a
  141.      DBA/Programmer SQL front-end to DB2.  SPUFI is short for SQL
  142.      Processing Using File Input.  SPUFI/2 is an OS/2 version of
  143.      that product for use with Database Manager and DB2/2. 
  144.      SPUFI/2 was developed to fill a gap in the functionality
  145.      provided with OS/2 Database Manager.  The purpose of the
  146.      program is to enable a stream of SQL statements to be
  147.      executed, rather than executing SQL statements one at a time
  148.      as is required by Query Manager and the DBM or DB2/2 Command
  149.      Line Processor.  SPUFI/2 has the look and feel of the
  150.      mainframe product, whilst adding enhancements of its own,
  151.      including timing of queries.
  152.  
  153.      SPUFI/2 Version 1.1.6 is a 16 bit program compiled with
  154.      Microsoft C6.0, which will operate equally well with OS/2
  155.      Extended Edition Version 1.2 or 1.3, with OS/2 Version 2.0
  156.      with Extended Services and with OS/2 Version 2.1 with DB2/2.
  157.  
  158.      SPUFI/2 is Shareware.  The Shareware concept allows you to
  159.      evaluate software before purchasing it.  Shareware is not
  160.      free software.  Should you decide to use this program after
  161.      you have evaluated it, you are asked to register your use of
  162.      it with the author. Thank you for supporting this concept.
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190. Copyright ICE Computer Associates 1993                     Page 3
  191.  
  192.  
  193.  
  194.  
  195. December 1993                                      SPUFI/2 V1.1.6
  196.  
  197.  
  198.  
  199.  
  200.  
  201.      DISCLAIMER - AGREEMENT
  202.  
  203.      Users of SPUFI/2 must accept this disclaimer of warranty:
  204.  
  205.       "SPUFI/2 is supplied as is.  ICE Computer Associates
  206.      Limited and David Joice disclaim all warranties, expressed
  207.      or implied, including, without limitation, the warranties of
  208.      merchantability and of fitness for any purpose.  Neither ICE
  209.      Computer Associates Limited nor David Joice assume any
  210.      liability for damages, direct or consequential, which may
  211.      result from the use of SPUFI/2."
  212.  
  213.      SPUFI/2 is a "shareware program" and is provided at no
  214.      charge to the user for evaluation.  Feel free to share it
  215.      with your colleagues, but please do not give it away altered
  216.      or as part of another system.  The essence of "user-
  217.      supported" software is to provide personal computer users
  218.      with quality software without high prices, and yet to
  219.      provide an incentive for programmers to continue to develop
  220.      new products.  If you find this program useful and find that
  221.      you are using SPUFI/2 and continue to use SPUFI/2 after a
  222.      reasonable trial period, you must make a registration
  223.      payment of 45 Pounds Sterling for UK orders or 60 US Dollars
  224.      for overseas orders to ICE Computer Associates Limited.  UK
  225.      purchasers must add VAT at the prevailing rate.
  226.  
  227.      The 45 Pounds Sterling or 60 US Dollars registration fee
  228.      will license one copy for use on any one computer at any one
  229.      time.  Registered users will receive a copy of the latest
  230.      version of SPUFI/2.
  231.  
  232.      Commercial users of SPUFI/2 must register and pay for their
  233.      copies of SPUFI/2 within 30 days of first use or their
  234.      license is withdrawn.  Site-License arrangements may be made
  235.      by contacting ICE Computer Associates Limited.
  236.  
  237.      Anyone distributing SPUFI/2 for any kind of remuneration
  238.      must first contact ICE Computer Associates Limited for
  239.      authorization.
  240.  
  241.      You are encouraged to pass a copy of SPUFI/2 along to your
  242.      colleagues for evaluation.  Please encourage them to
  243.      register their copy if they find that they can use it.  All
  244.      registered users will receive a copy of the latest version
  245.      of SPUFI/2.
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254. Copyright ICE Computer Associates 1993                     Page 4
  255.  
  256.  
  257.  
  258.  
  259. December 1993                                      SPUFI/2 V1.1.6
  260.  
  261.  
  262.  
  263.  
  264.  
  265. 2    SPUFI/2 KEYBOARD MAPPING
  266.  
  267.      SPUFI/2 uses IBM 3270 keyboard mapping and TSO Function Key
  268.      conventions.
  269.  
  270.      ENTER     SPUFI/2 uses the right hand control key to mean
  271.                ENTER. Some portable machines do not have a right
  272.                hand control key.  For this reason both right and
  273.                left hand control keys may be used as the ENTER
  274.                key.
  275.  
  276.      HELP      Either enter the word HELP at the command line and
  277.                press ENTER or press F1.
  278.  
  279.      END       Either enter the word END at the command line and
  280.                press ENTER or press F3.
  281.  
  282.      Tab       The AT keyboard Tab key moves the cursor to the
  283.                first position of the next input field.  Shift/Tab
  284.                moves the cursor to the first position of the
  285.                previous input field.
  286.  
  287.      Return    The AT keyboard Return key moves the cursor to the
  288.                first position of the first input field on the
  289.                next line down.
  290.  
  291.      Insert    The AT keyboard Insert key puts the panel into
  292.                insert mode.  Pressing Insert again ends insert
  293.                mode.
  294.  
  295.      Escape    The AT Escape key performs in the same way as F3.
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318. Copyright ICE Computer Associates 1993                     Page 5
  319.  
  320.  
  321.  
  322.  
  323. December 1993                                      SPUFI/2 V1.1.6
  324.  
  325.  
  326.  
  327.  
  328.  
  329. 3    THE SPUFI/2 DIALOGUE
  330.  
  331.      Use of SPUFI/2 proceeds according to a pre-determined
  332.      pattern.  A simple dialogue is described below:
  333.  
  334.      The following data is entered on the SPUFI/2 main panel:
  335.  
  336.       o   the name of an input file -   this file may be empty or
  337.                                         may be an existing file
  338.                                         containing previously
  339.                                         written SQL statements.
  340.  
  341.      o    the name of a Database -      this database must
  342.           Manager Database              contain the tables
  343.                                         referenced in the input
  344.                                         SQL file.
  345.  
  346.      o    the name of an output file -  SPUFI/2 will place the
  347.                                         results of processing the
  348.                                         input SQL file into this
  349.                                         file.
  350.  
  351.      o    a set of YES/NO processing -  CHANGE DEFAULTS
  352.           options                       EDIT INPUT
  353.                                         EXECUTE
  354.                                         AUTOCOMMIT
  355.                                         BROWSE OUTPUT
  356.  
  357.      The dialogue proceeds as follows:
  358.  
  359.      1    Complete the panel as indicated above.      Press ENTER
  360.  
  361.      2    If required Database Manager will be
  362.           started.  SPUFI/2 will connect to
  363.           the Database specified.
  364.           If CHANGE DEFAULTS has been set to YES,
  365.           the SPUFI/2 DEFAULTS panel will be
  366.           displayed.  Modify the defaults as
  367.           required (See Section 4).                   Press ENTER
  368.  
  369.      3    If EDIT INPUT has been set to YES, the
  370.           editor specified on the SPUFI/2 DEFAULTS
  371.           panel will be invoked and the input file
  372.           specified will be opened.  Edit the SQL
  373.           as required.                       END the Edit Session
  374.  
  375.      4    The SPUFI/2 main panel will be displayed.
  376.           The processing options for the previously
  377.           executed steps in the dialogue will have
  378.           been set to *.                              Press ENTER
  379.  
  380.  
  381.  
  382. Copyright ICE Computer Associates 1993                     Page 6
  383.  
  384.  
  385.  
  386.  
  387. December 1993                                      SPUFI/2 V1.1.6
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      5    If EXECUTE has been set to YES, the input
  394.           SQL file will be processed against the
  395.           Database specified.  The results will be
  396.           placed in the output file specified.
  397.           If AUTOCOMMIT has been set to YES, and the
  398.           SQL was processed successfully a COMMIT
  399.           will be executed.  A ROLLBACK will be
  400.           executed if the processing was unsuccessful.
  401.           If BROWSE OUTPUT has been set to YES, the
  402.           editor specified on the SPUFI/2 DEFAULTS
  403.           panel will be invoked and the output file
  404.           specified will be opened.  Browse the results
  405.           of the SQL processing as required.
  406.                                              END the Edit Session
  407.  
  408.      6    The SPUFI/2 main panel will be re-displayed,
  409.           with the processing options reset to the
  410.           value previously specified.  To re-edit
  411.           the input file and repeat the dialogue.     Press ENTER
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446. Copyright ICE Computer Associates 1993                     Page 7
  447.  
  448.  
  449.  
  450.  
  451. December 1993                                      SPUFI/2 V1.1.6
  452.  
  453.  
  454.  
  455.  
  456.  
  457. 4    SPUFI/2 PANELS
  458.  
  459.      The SPUFI/2 Main Panel
  460.      ======================
  461.  
  462.      Line 2 the Command Line
  463.  
  464.                Enter the Commands ENTER, END or HELP and Press
  465.                the ENTER key.
  466.           e.g.
  467.  
  468.           ===>END
  469.  
  470.                This will end this SPUFI/2 session.
  471.  
  472.      Enter OS/2 input file specification:
  473.  
  474.                Enter the name of the input SQL file.  If a file
  475.                of that name does not exist one will be created. 
  476.                This is the file into which the SQL statements,
  477.                which are to be processed by SPUFI/2 are placed. 
  478.                See Section 5 for rules about the SQL used.
  479.                The full path may be specified.  If no path is
  480.                specified the file is assumed to be in the Working
  481.                Directory. (See Section 7)
  482.           e.g.
  483.  
  484.           DRIVE/PATH NAME   ===> SAMPLE.SQL
  485.  
  486.                SPUFI/2 will look for a file named SAMPLE.SQL in
  487.                the current working directory; if found this will
  488.                be the target of the edit session.  If not found,
  489.                the file will be created.
  490.  
  491.      Enter Database name:
  492.  
  493.                Enter the name of a Database Manager Database
  494.                which is catalogued on this Workstation and to
  495.                which you have access.
  496.           e.g.
  497.  
  498.           DATABASE NAME ... ===> SAMPLE
  499.  
  500.                This specifies a database called SAMPLE.  If you
  501.                have installed database Manager the sample
  502.                database is created by typing SQLSAMPL at the
  503.                command line.
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510. Copyright ICE Computer Associates 1993                     Page 8
  511.  
  512.  
  513.  
  514.  
  515. December 1993                                      SPUFI/2 V1.1.6
  516.  
  517.  
  518.  
  519.  
  520.  
  521.      The SPUFI/2 Main Panel        ... /Continued
  522.      ============================================
  523.  
  524.      Enter OS/2 output file specification:
  525.  
  526.                Enter the name of an output file.  If a file of
  527.                that name does not exist one will be created. 
  528.                This is where the results of the SQL processing
  529.                will be placed.  See also the APPEND TO OUTPUT
  530.                setting on the SPUFI/2 Defaults panel.
  531.                The full path may be specified.  If no path is
  532.                specified the file is assumed to be in the Working
  533.                Directory. (See Section 7)
  534.           e.g.
  535.  
  536.           DRIVE/PATH NAME   ===> SAMPLE.LST
  537.  
  538.      Specify processing options:
  539.  
  540.           CHANGE DEFAULTS   ===>
  541.  
  542.                Enter YES if you wish to have the SPUFI/2 Defaults
  543.                panel displayed prior to the edit session.
  544.  
  545.           EDIT INPUT ...... ===>
  546.  
  547.                Enter YES if you wish to edit the input file.
  548.  
  549.           EXECUTE ......... ===>
  550.  
  551.                Enter YES if you wish to process the SQL
  552.                statements in the input file.
  553.  
  554.           AUTOCOMMIT ...... ===>
  555.  
  556.                Enter YES if you wish SPUFI/2 to issue a COMMIT
  557.                statement if, after processing the SQL, the final
  558.                SQL return code is zero.  In the event of a non-
  559.                zero return code AUTOCOMMIT = YES will cause
  560.                SPUFI/2 to issue a ROLLBACK statement.
  561.                Enter NO if you wish to delay the decision until
  562.                after you have browsed the results file.  If NO is
  563.                entered the SPUFI/2 COMMIT OR ROLLBACK PANEL will
  564.                be displayed after the browse session.
  565.                See also the STOP AFTER ERROR setting on the
  566.                SPUFI/2 Defaults panel. 
  567.  
  568.           BROWSE OUTPUT ... ===>
  569.  
  570.                Enter YES if you wish to browse the results file.
  571.  
  572.  
  573.  
  574. Copyright ICE Computer Associates 1993                     Page 9
  575.  
  576.  
  577.  
  578.  
  579. December 1993                                      SPUFI/2 V1.1.6
  580.  
  581.  
  582.  
  583.  
  584.  
  585.      The SPUFI/2 Defaults Panel
  586.      ==========================
  587.  
  588.      ISOLATION LEVEL   ===>
  589.  
  590.           Select the isolation level for the session:
  591.                RR        Repeatable Read
  592.                CS        Cursor Stability
  593.                UR        Uncommitted Read
  594.  
  595.           Default   RR
  596.  
  597.      MAX SELECT LINES  ===>
  598.  
  599.           Select the maximum number of lines to be returned as
  600.           the result of a select statement.  If you wish the
  601.           number of lines to be unlimited enter zero.
  602.  
  603.           Default   250
  604.  
  605.      EDITOR TO BE USED ===>
  606.  
  607.           Enter the name of the editor you wish to use in edit
  608.           and browse sessions. The default editor for use with
  609.           SPUFI/2 is the OS/2 System Editor E.EXE.  Before
  610.           running SPUFI/2 it is worth executing the system editor
  611.           to set it up correctly for use with SPUFI/2.
  612.  
  613.           Select the OPTIONS Pull-down menu:
  614.  
  615.                Turn Word wrap OFF.
  616.                Set font to a fixed pitch font e.g. courier 8
  617.                Bold.
  618.  
  619.           Alternative editors
  620.  
  621.           SPUFI/2 May be used with any editor which can be
  622.           initiated by a command of the following form:
  623.  
  624.                <editorname> <filename>
  625.  
  626.                where editorname is the name of the editor and
  627.                filename is the name of the file to be edited.
  628.  
  629.           The editor program must lie within the scope of the
  630.           PATH environment variable.
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638. Copyright ICE Computer Associates 1993                    Page 10
  639.  
  640.  
  641.  
  642.  
  643. December 1993                                      SPUFI/2 V1.1.6
  644.  
  645.  
  646.  
  647.  
  648.  
  649.      The SPUFI/2 Defaults Panel         ... /Continued
  650.      =================================================
  651.  
  652.           Warning about Editors
  653.  
  654.           Select statements can return data which may, with some
  655.           editors,  cause certain display peculiarities.
  656.  
  657.           For example, SELECT * FROM SYSIBM.SYSTABLES results in
  658.           the LONG VARCHAR column PACKED_DESC being displayed in
  659.           the result.  The data in this column will probably
  660.           contain 1 or more bytes containing X'0D', which some
  661.           editors including the system editor E will interpret as
  662.           carriage return.  This in itself is not invalid, but it
  663.           will make your screen display look messy.
  664.  
  665.           SPF/2
  666.  
  667.           SPUFI/2 will operate well with the editor/browser
  668.           included in the CTC product SPF/2.  If the editor name
  669.           on the SPUFI/2 defaults panel is set to SPF2, then
  670.           SPUFI/2 will use the SPF/2 editor for the edit session
  671.           and the SPF/2 browser for the browse session.
  672.  
  673.           SPF/2 is a trademark of Command Technology Corporation.
  674.  
  675.      STOP AFTER ERROR  ===>
  676.  
  677.           Enter the error count which, when reached, will cause
  678.           processing of the SQL file to terminate.  If the value
  679.           entered is greater than 1, it is advisable to set
  680.           AUTOCOMMIT = NO.  If AUTOCOMMIT = YES and STOP AFTER
  681.           ERROR is greater than 1, SPUFI/2 will ROLLBACK if any
  682.           errors occur, even if the last SQL return code is zero. 
  683.           Using AUTOCOMMIT = NO allows you to choose whether to
  684.           ROLLBACK or COMMIT.  
  685.  
  686.           Default   1
  687.  
  688.      APPEND TO OUTPUT  ===>
  689.  
  690.           Enter YES if you wish each successive set of results to
  691.           be appended to the previous set.  Enter NO if you wish
  692.           the latest set of results to overwrite the previous
  693.           set.
  694.   
  695.           Default   NO
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702. Copyright ICE Computer Associates 1993                    Page 11
  703.  
  704.  
  705.  
  706.  
  707. December 1993                                      SPUFI/2 V1.1.6
  708.  
  709.  
  710.  
  711.  
  712.  
  713.      The SPUFI/2 Defaults Panel         ... /Continued
  714.      =================================================
  715.  
  716.      MAX NUMERIC FIELD ===>
  717.  
  718.           Enter the maximum column width for displaying numeric
  719.           fields.  If the value returned is greater then the size
  720.           specified the value will be replaced by a row of
  721.           asterisks **********.
  722.  
  723.           Default   20
  724.  
  725.      MAX CHAR FIELD .. ===>
  726.  
  727.           Enter the maximum column width for displaying character
  728.           fields.  If the size of the string returned is greater
  729.           then the size specified the string will be truncated on
  730.           the right.
  731.  
  732.           Default   80
  733.  
  734.      COLUMN HEADING .. ===>
  735.  
  736.           Not used at this time.
  737.  
  738.           Default   NAMES
  739.  
  740.  
  741.  
  742.      The SPUFI/2 COMMIT or ROLLBACK Panel
  743.      ====================================
  744.  
  745.      The COMMIT or ROLLBACK panel is displayed when an SQL file
  746.      has been processed and the AUTOCOMMIT option has been set to
  747.      NO.
  748.  
  749.           COMMIT    will save your database changes
  750.           ROLLBACK  will erase your database changes
  751.           DEFER     will defer the decision, which will allow you
  752.                     to continue processing another input SQL
  753.                     file. If you select DEFER, it is possible
  754.                     that you will tie up system resources that
  755.                     others need.
  756.  
  757.      Default   COMMIT
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766. Copyright ICE Computer Associates 1993                    Page 12
  767.  
  768.  
  769.  
  770.  
  771. December 1993                                      SPUFI/2 V1.1.6
  772.  
  773.  
  774.  
  775.  
  776.  
  777. 5    SQL
  778.  
  779.      A sample SQL file appears below:
  780.  
  781.  
  782.      --  Anything which follows double minus is treated as a
  783.      --  comment.
  784.      --  SQL statements are separated using semicolons;
  785.      --  Within SPUFI/2 V1.1.5 the length of SQL statements is
  786.      --  limited to 24000 bytes.
  787.      --  The SQL below demonstrates updating the SAMPLE database
  788.      --
  789.           select *                                -- print before
  790.           from staff
  791.           where dept = 10;
  792.           update staff                                  -- update
  793.           set salary = salary * 1.05
  794.           where dept = 10;
  795.           select *                                 -- print after
  796.           from staff
  797.           where dept = 10;
  798.           rollback;                                   -- rollback
  799.  
  800.      SPUIFI/2 will "Uppercase" all input, except where it is
  801.      between 'quotes' or where it is part of a comment. 
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830. Copyright ICE Computer Associates 1993                    Page 13
  831.  
  832.  
  833.  
  834.  
  835. December 1993                                      SPUFI/2 V1.1.6
  836.  
  837.  
  838.  
  839.  
  840.  
  841. 6    COMMAND LINE PARAMETERS
  842.  
  843.      /B   Bright
  844.  
  845.      When using screens with low contrast such as Gas Plasma or
  846.      LCD screens, the parameter /B may be used. The /B parameter
  847.      causes all text to be displayed in high intensity mode.
  848.  
  849.      /T   Timing
  850.  
  851.      Version 1.1.0 of SPUFI/2 introduced timed queries.  If the
  852.      /T runtime parameter is present then SPUFI/2 will time each
  853.      SQL query.
  854.  
  855.      The results of the timing will be presented at the end of
  856.      the query in the form:
  857.  
  858.           ---------+---------+---------+---------+---------+
  859.           NUMBER OF ROWS DISPLAYED IS 250
  860.           STATEMENT EXECUTION WAS SUCCESSFUL, SQLCODE IS 0
  861.           TIME TO FETCH FIRST ROW            7840 MSEC
  862.           TIME TO FETCH ALL ROWS            10280 MSEC
  863.           AVERAGE TIME TO FETCH EACH ROW       41 MSEC
  864.  
  865.      Note:     There will probably be a difference between the
  866.                times returned for the first and subsequent
  867.                consecutive executions of the same query.  The
  868.                timings returned from a standalone machine are
  869.                reliable, repeatable and may be used for
  870.                performance comparisons.  Care must be taken when
  871.                timing queries on a remote database.  Such timings
  872.                will be effected by other concurrent queries and
  873.                other activities taking place on the remote
  874.                database server.
  875.  
  876.      Note:     If the /T parameter and the /B parameter are used
  877.                at the same time the two parameters must be
  878.                separated by a blank character.
  879.  
  880.                e.g. /T /B
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894. Copyright ICE Computer Associates 1993                    Page 14
  895.  
  896.  
  897.  
  898.  
  899. December 1993                                      SPUFI/2 V1.1.6
  900.  
  901.  
  902.  
  903.  
  904.  
  905. 7    INSTALLATION
  906.  
  907.      SPUFI/2 is supplied on a single 720K diskette or in a single
  908.      ZIP file SPUFI2.ZIP.  The following files should be present
  909.      on the diskette or in the ZIP file.
  910.  
  911.      SPUFI2.EXE
  912.      SPUFI2.BND
  913.      SPUFI_RR.BND
  914.      SPUFI_CS.BND
  915.      SPUFI_UR.BND
  916.      SPUFI2.ICO
  917.      README
  918.  
  919.      Make a directory on your hard disk.
  920.  
  921.           for example:
  922.  
  923.                [C:\]MD SPUFI2
  924.                [C:\]CD SPUFI2
  925.                [C:\SPUFI2]
  926.  
  927.      Copy the files from the diskette in drive A: to the new
  928.      directory.
  929.  
  930.                [C:\SPUFI2]COPY A:\*.* C:
  931.  
  932.      Or, if working from a ZIP file which you have placed
  933.      temporarily on a floppy in drive A:.
  934.  
  935.                [C:\SPUFI2]PKUNZIP A:\SPUFI2.ZIP
  936.  
  937.      Now add the program to an appropriate Desktop Manager group
  938.      or if using OS/2 Version 2.0 create a program object with
  939.      the following settings.
  940.  
  941.           Program Title:           SPUFI/2 from ICA
  942.           Path and File Name:      C:\SPUFI2\SPUFI2.EXE
  943.           Parameters:              See Section 6
  944.           Working Directory:       C:\SPUFI2
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958. Copyright ICE Computer Associates 1993                    Page 15
  959.  
  960.  
  961.  
  962.  
  963. December 1993                                      SPUFI/2 V1.1.6
  964.  
  965.  
  966.  
  967.  
  968.  
  969. 8    SPUFI2.INI
  970.  
  971.      When SPUFI2 is executed it attempts to read a file called
  972.      SPUFI2.INI from the Working Directory (see Section 7).  If
  973.      no such file is found SPUFI2 will create it.  SPUFI2.INI is
  974.      the file which holds the latest settings on the SPUFI2
  975.      panels.  All panel settings are stored in SPUFI2.INI each
  976.      time you end SPUFI2.
  977.  
  978.      The settings which are used when SPUFI2.INI is created are
  979.      as follows:
  980.  
  981.                Input File          "SAMPLE.SQL"
  982.                DataBase            "SAMPLE"
  983.                Output File         "SAMPLE.LST"
  984.                Change Defaults     "NO"
  985.                Edit Input          "YES"
  986.                Execute             "YES"
  987.                AutoCommit          "YES"
  988.                Browse Output       "YES"
  989.                Isolation Level     "RR"
  990.                Max Select Lines    "250"
  991.                Editor              "E"
  992.                Stop After Errors   "1"
  993.                Append To Output    "NO"
  994.                Max Numeric Field   "20"
  995.                Max Character Field "80"
  996.                Column Heading      "NAMES"
  997.                Commit / Rollback   "COMMIT"
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022. Copyright ICE Computer Associates 1993                    Page 16
  1023.  
  1024.  
  1025.  
  1026.  
  1027. December 1993                                      SPUFI/2 V1.1.6
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033. 9    AUTOMATIC BINDING
  1034.  
  1035.      Like any other program accessing a Database Manager
  1036.      database, SPUFI/2 requires an access plan.  An access plan
  1037.      is created by the action of binding a program to a database. 
  1038.      Unlike most programs, which access only one database and
  1039.      therefore require only one access plan, SPUFI/2 is required
  1040.      to access as many different databases as the user has access
  1041.      to.  In order to enable access to these databases SPUFI/2
  1042.      will automatically bind itself to any database which it is
  1043.      required to access and for which no access plan exists.
  1044.  
  1045.      Automatic binding will take place if the following
  1046.      conditions are true:
  1047.  
  1048.           The bind files: SPUFI2.BND, SPUFI_RR.BND, SPUFI_CS.BND,
  1049.           SPUFI_UR.BND are present in the working directory.
  1050.  
  1051.           AND
  1052.  
  1053.           No access plan exists (SQL Code -805) and the user has
  1054.           CONNECT and BINDADD authority on the database.
  1055.  
  1056.           OR
  1057.  
  1058.           You have installed an updated version of SPUFI/2 and
  1059.           the existing access plan does not match the new version
  1060.           of SPUFI/2 (SQL Code -818) and the user has CONNECT and
  1061.           BIND authority on the database.
  1062.  
  1063.      If you created the database yourself you will no doubt have
  1064.      the required access, however, regardless of who created the
  1065.      database, Database Manager databases are, by default,
  1066.      created with CONNECT and BINDADD authority granted to
  1067.      PUBLIC.
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086. Copyright ICE Computer Associates 1993                    Page 17
  1087.  
  1088.  
  1089.  
  1090.  
  1091. December 1993                                      SPUFI/2 V1.1.6
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097. 10   SUPPORT
  1098.  
  1099.      SPUFI/2 is supported on CompuServe, please address messages
  1100.      to David Joice [100025,350].
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150. Copyright ICE Computer Associates 1993                    Page 18
  1151.  
  1152.  
  1153.  
  1154.  
  1155. December 1993                                      SPUFI/2 V1.1.6
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161. 11   CHANGES IN VERSION 1.1.6
  1162.  
  1163.      The fault which caused the name of the database to be
  1164.      rejected with SQLCODE -1001, which showed up in V1.1.5 when
  1165.      used with DB2/2 has been cured.
  1166.  
  1167.      A "STOP USING DATABASE" command is issued at the end of each
  1168.      query.
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214. Copyright ICE Computer Associates 1993                    Page 19
  1215.