HP 3000 Manuals

SELECTSTATEMENT [ ISQL Reference Manual for ALLBASE/SQL and IMAGE/SQL ] MPE/iX 5.0 Documentation


ISQL Reference Manual for ALLBASE/SQL and IMAGE/SQL

SELECTSTATEMENT 

When you enter the SQL SELECT statement through ISQL, the query result is
displayed.  You can scroll through the query result at the terminal and
optionally print it.

Scope 

ISQL only.

ISQL Syntax 

SelectStatement;[PA[USE];] [BrowseOption;] [...] E[ND]

Parameters 

SelectStatement         is an SQL SELECT statement.  Refer to the
                        ALLBASE/SQL Reference Manual for additional
                        information on the SELECT statement.

PAUSE                   is specified in a command file or command buffer
                        to suspend processing of commands after a SELECT
                        statement is executed.  Example:

                             SELECT * FROM PurchDB.Parts;
                             PAUSE;

                        The query result is displayed and can be examined
                        using a BrowseOption.  When you enter END on the
                        display, control returns to the command file or
                        the command buffer.

                        If you do not use the PAUSE option, you must
                        specify END.

BrowseOption            is specified in a command file or in response to
                        the prompt beneath the query result display.
                        Valid options are listed here:

                        {U[P]                    }
                        {D[OWN]                  }
                        {L[EFT]                  }
                        {R[IGHT]                 }
                        {T[OP]                   }
                        {B[OTTOM]                }
                        {N[EXT]                  }
                        {PR[INT] [NumberOfCopies]}

                        U[P]                    scrolls backward by half
                                                the number of displayed
                                                rows, along with the
                                                previous rows, and
                                                preserves the column
                                                headings.

                        D[OWN]                  scrolls forward by half
                                                the number of displayed
                                                rows, along with the
                                                previous rows, and
                                                preserves the column
                                                headings.  (Pressing
                                                Return has the same
                                                effect as pressing D.)

                        L[EFT]                  scrolls the display left
                                                40 screen columns.

                        R[IGHT]                 scrolls the display right
                                                40 screen columns.

                        T[OP]                   displays the first group
                                                of rows and the column
                                                headings.

                        B[OTTOM]                displays the last group
                                                of rows and the column
                                                headings.
                                                [REV BEG]

                        N[EXT]                  displays the next group
                                                of rows and the column
                                                headings.[REV END]

                        PR[INT] NumberOfCopies   

                                                copies the query result
                                                to the device
                                                specified[REV BEG] 
                                                by the formal file
                                                designator ISQLLP. To
                                                change the specified
                                                printer, issue a file
                                                equation such as the
                                                following:

                                                     : FILE ISQLLP;DEV=PP
                                                [REV END]

                                                NumberOfCopies can be
                                                from 1 (the default)
                                                through 20.

E[ND]                   terminates the query result display.  If the
                        PAUSE option is in effect, control returns to the
                        command file.  If the OUTPUT option of the SET
                        command is set to a file other than isqlout, the
                        entire query result is written to that file.  If,
                        however, you enter a slash (/) to terminate the
                        query result display, only the rows displayed so
                        far are written to the output file.

Description 

   *   The number of screen columns displayed is dependent on the screen
       size of your terminal.

   *   A command entry prompt appears at the bottom of the display:

            U[p], d[own], l[eft], r[ight], t[op], b[ottom], n[ext], pr[int] <n> , or e[nd]>

       You enter browse options from this list to manipulate the display.

   *   The number of rows already displayed appears beneath the query
       result as follows:

            First n rows have been selected.

       The number of rows selected is incremented whenever you enter
       DOWN. The total number of rows in the query result is displayed
       when you enter BOTTOM, or when the last row in the query result
       has been displayed:

            Number of rows selected is n.

   *   The maximum length of a row in a query result obtained through
       ISQL is the PAGEWIDTH option value of the SET command, which
       can[REV BEG] be as large as 32767 bytes.  If a row is longer than
       the PAGEWIDTH[REV END] option value, then the following occurs:

          *   Column headings are truncated.

          *   CHAR or VARCHAR data is truncated after the PAGEWIDTH
              column.

          *   Numeric data is not displayed or printed unless all the
              data fits.

   *   The following SET command options also affect the query result:

       FRACTION                determines the number of decimal digits
                               displayed for FLOAT and DECIMAL data.

       NULL                    determines the character ISQL displays to
                               signify a null value.

       OUTPUT                   

                               identifies the file to which the query
                               result is sent.  The query result is
                               stored in this file, as well as displayed
                               at the terminal.  Each line in the file is
                               as wide as the current PAGEWIDTH option
                               value of the SET command.  If the file is
                               isqlout, it is removed when the END option
                               is processed.  If the file is named
                               something other than isqlout, it is
                               created.  If the output file already
                               exists, it is overwritten with the new
                               output.  You can access and manipulate the
                               file with an editor.

   *   Object names enclosed in double quotes cannot be split across
       lines.

   *   When you execute the SELECT statement on a LONG column, the output
       device is displayed, not data.  The output device will contain the
       actual data which was selected.

   *   When you execute the SELECT statement on a BINARY or VARBINARY
       column, the hexadecimal representation is displayed.

Authorization 

To issue the SELECT statement, you must have the authority defined in the
ALLBASE/SQL Reference Manual.

Example 

     isql=> SELECT * FROM System.Table; 

     SELECT * from System.Table;
     --------------------+---------------------+--------------------+------+-----
     NAME                |OWNER                |DBEFILESET          |TYPE  |RTYPE
     --------------------+---------------------+--------------------+------+-----
     COUNTER             |SYSTEM               |SYSTEM              |     0|
     USER                |SYSTEM               |SYSTEM              |     0|
     TRANSACTION         |SYSTEM               |SYSTEM              |     0|
     CALL                |SYSTEM               |SYSTEM              |     0|
     ACCOUNT             |SYSTEM               |SYSTEM              |     0|
     TABLE               |SYSTEM               |SYSTEM              |     1|
     COLUMN              |SYSTEM               |SYSTEM              |     1|
     INDEX               |SYSTEM               |SYSTEM              |     1|
     SECTION             |SYSTEM               |SYSTEM              |     1|
     DBEFILESET          |SYSTEM               |SYSTEM              |     1|
     DBEFILE             |SYSTEM               |SYSTEM              |     1|
     SPECAUTH            |SYSTEM               |SYSTEM              |     1|
     TABAUTH             |SYSTEM               |SYSTEM              |     1|
     COLAUTH             |SYSTEM               |SYSTEM              |     1|
     MODAUTH             |SYSTEM               |SYSTEM              |     1|
     GROUP               |SYSTEM               |SYSTEM              |     1|
     ----------------------------------------------------------------------------
     First 16 rows have been selected.
     U[p], d[own], l[eft], r[ight], t[op], b[ottom], pr[int] <n>, or e[nd]>r; 

     -+--------------------+------+------+-----------+-----------+-----------+---
      |DBEFILESET          |TYPE  |RTYPE |NUMC       |NUMI       |NUMIC      |NR
     -+--------------------+------+------+-----------+-----------+-----------+---
      |SYSTEM              |     0|     3|          3|          0|          0|
      |SYSTEM              |     0|     3|          2|          0|          0|
      |SYSTEM              |     0|     3|          4|          0|          0|
      |SYSTEM              |     0|     3|          5|          0|          0|
      |SYSTEM              |     0|     3|          6|          0|          0|
      |SYSTEM              |     1|     0|         12|          0|          2|
      |SYSTEM              |     1|     0|         10|          0|          0|
      |SYSTEM              |     1|     0|         10|          0|          0|
      |SYSTEM              |     1|     0|          7|          0|          0|
      |SYSTEM              |     1|     0|          5|          0|          0|
      |SYSTEM              |     1|     0|          7|          0|          0|
      |SYSTEM              |     1|     0|          4|          0|          0|
      |SYSTEM              |     1|     0|         10|          0|          0|
      |SYSTEM              |     1|     0|          4|          0|          0|
      |SYSTEM              |     1|     0|          3|          0|          0|
      |SYSTEM              |     1|     0|          4|          0|          0|
     ----------------------------------------------------------------------------
     First 16 rows have been selected.
     U[p], d[own], l[eft], r[ight], t[op], b[ottom], pr[int] <n>, or e[nd]>e; 



MPE/iX 5.0 Documentation