Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

More Information

aliases

catalogs

collating sequences

connections

cursors

databases

default

domains

indexes

privileges or protection

query confirm

query limit

schemas

session information

storage areas

storage maps

tables

triggers

users granting

users with

views

COLUMNS

COMMENT

CONSTRAINTS

INDEXES

STORAGE_MAPS

TRIGGERS

table name

schema name

TO

FROM

COLUMNS

COMMENT

SOURCE

RDB/VMS SQL SHOW — VMS RDB_4.1_M

   SHOW ──┬─> show-aliases ──────────────┬──>
          ├─> show-catalogs ─────────────┤
          ├─> show-collating-sequence ───┤
          ├─> show-connections ──────────┤
          ├─> show-cursors ──────────────┤
          ├─> show-databases ────────────┤
          ├─> show-domains ──────────────┤
          ├─> show-indexes ──────────────┤
          ├─> show-privileges ───────────┤
          ├─> show-query-confirm  ───────┤
          ├─> show query-limit ──────────┤
          ├─> show-schemas ──────────────┤
          ├─> show-session-information ──┤
          ├─> show-storage-areas ────────┤
          ├─> show-storage-maps ─────────┤
          ├─> show-tables ───────────────┤
          ├─> show-triggers ─────────────┤
          ├─> show-users-granting────────┤
          ├─> show-users-with ───────────┤
          └─> show-views ────────────────┘

Additional information available:

More Informationaliasescatalogscollating sequencesconnections
cursorsdatabasesdefaultdomainsindexesprivileges or protection
query confirmquery limitschemassession informationstorage areas
storage mapstablestriggersusers grantingusers withviews

More Information

 The SHOW statement displays information about the database and
 its definitions, and information about the current interactive
 SQL session.  You can use the SHOW statement only in interactive
 SQL.

aliases

 show-aliases =

 ───> 
A

L

I

A

S

E

S
──┬──────────────┬─> └─┬─> alias ─┬─┘ └─── , <───┘ An alias is a name for a particular attachment to a database. Once you have specified an alias, you must use it when referring to the database in subsequent SQL statements, unless those statements are within a single CREATE DATABASE statement. For each alias, SQL displays the pathname or filename of the current default database (Rdb/VMS or VIDA), and the file specification for the database file.

catalogs

 show-catalogs =

 ───> 
C

A

T

A

L

O

G

S
──┬───────────────────────┬───> └┬───> catalog-name ──┬─┘ └──────── , <────────┘ A catalog is a group of schemas within a multischema database For each catalog, SQL displays the pathname, filename or alias of the current default database (Rdb/VMS or VIDA), any defined collating sequence, and the file specification for the database file. If the catalog was declared using a data dictionary path name, SQL also displays that path name. If you do not specify any aliases with SHOW CATALOGS, SQL displays information about all declared databases.

collating sequences

 show-collating-sequence =

 ───> 
C

O

L

L

A

T

I

N

G

S

E

Q

U

E

N

C

E
──┬─────────────────┬─> └─ sequence-name ─┘ A collating sequence is the sequence in which characters are ordered for sorting, merging, and comparing. The VMS National Character Set (NCS) provides a set of predefined collating sequences and lets you define collating sequences of your own.

connections

 show-connections =

 ───> 
C

O

N

N

E

C

T

I

O

N

S
──┬──────────────────────────┬───> └┬───> connection-name ──┬─┘ └──────── , <───────────┘ A connection specifies an association between the set of cursors, temporary tables, and procedures in all modules of an application and the database environment currently attached. When you issue a CONNECT statement, SQL creates a new connection from all the procedures in your application and creates a new database environment for the databases named in the CONNECT statement. Procedures execute in the context of a particular connection. The SHOW CONNECTIONS statement shows the names of existing connections.

cursors

 show-cursors =

 ───> 
C

U

R

S

O

R

S
───┬──────────────────────────┬───> └┬───> cursor-name ──────┬─┘ └──────── , <───────────┘ A cursor lets you specify individual rows of a result table specified in the select expression in a DECLARE CURSOR statement. The SHOW CURSORS statement shows the name of each cursor, the type of cursor (TABLE or LIST), and the mode of operation for the cursor (INSERT ONLY, READ ONLY, or UPDATE).

databases

 show-database =

 ──> 
D

A

T

A

B

A

S

E

S
┬────────────────┬──> └─┬─> alias ───┬─┘ └───── , <───┘ Displays information about the specified databases. For each database, SQL displays the alias and the file specification for the database system root file. If the database was declared using a data dictionary path name, SQL also displays that path name.

default

 show-default =

 SHOW DEFAULT;

 The SHOW DEFAULT statement shows the default schema and catalog
 names.  For example, if user ELLINGSWORTH attached to the sample
 multischema database, he or she would see the following output:

 SQL> ATTACH 'FILENAME CORPORATE_DATA';
 SQL> SHOW DEFAULT
 Default catalog name is RDB$CATALOG
 Default schema name is ELLINGSWORTH

 You can use SET CATALOG and SET SCHEMA statements to change the
 default catalog and schema, respectively.

domains

 show-domains =
 ─┬───────────┬─> 
D

O

M

A

I

N

S
─┬────────────────────────────┬─> ├─> 
S

Y

S

T

E

M
─┤ └┬─┬─┬─────────────┬─> typebox (*) ─┬─┬┘ └─> 
A

L

L
────┘ │ │ └─> alias. ───┘ │ │ │ └─> domain-name ───────┘ │ └─────────── , <───────────┘ Displays the names and data types of specified domains. If you specify SHOW DOMAINS without any arguments, VAX SQL displays definitions of all domains in all attached databases.

indexes

 show-indexes =
 ─┬───────────┬─> 
I

N

D

E

X

E

S
─┬──────────────────────────────┬──> ├─> 
S

Y

S

T

E

M
─┤ ├─┬─┬─┬─────────────┬─> typebox (*) ─┬─┬─┤ └─> 
A

L

L
────┘ │ │ │ └─> alias. ───┘ │ │ │ │ │ └─> index-name ────────┘ │ │ │ └─────────── , <───────────┘ │ └─> 
O

N
─┬─> table-name ─┬──────┘ └────── , <─────┘ Displays information about specified indexes. SQL displays the name of the index, the associated column and table, and whether the definition allows duplicate values for the column. If you specify SHOW INDEXES without any arguments, SQL displays definitions of all indexes in all attached databases.

privileges or protection

 show-protection =
 ──┬─> 
P

R

O

T

E

C

T

I

O

N

O

N
─┬┬─> typebox (T)typebox (A)typebox (B)typebox (L)typebox (E)typebox (S) ─┬─> table-name ─┬─┬──────────┬─> │ ││ └─────── , <─────┘ │ │ └─> 
P

R

I

V

I

L

E

G

E

S

O

N
─┘├─> 
V

I

E

W

S
──┬─> view-name ──┬─┤ │ │ └─────── , <─────┘ │ │ ├─> 
C

O

L

U

M

N
┬─> column-name ─┬─┘ │ │ └─────── , <─────┘ │ └─> 
S

C

H

E

M

A

S
typebox (A)typebox (U)typebox (T)typebox (H)typebox (O)typebox (R)typebox (I)typebox (Z)typebox (A)typebox (T)typebox (I)typebox (O)typebox (N) ─┬─> auth-id ─┬─┘ └───── , <───┘ SHOW PROTECTION displays all the entries in the access privilege set for the specified databases, tables, or columns. SHOW PRIVILEGES displays only your access privilege set entry for the specified databases, tables, or columns. In an ANSI style database, the SHOW USERS GRANTING and SHOW USERS WITH statements display which privileges have the option of being granted to other users and which privileges are without the grant option.

query confirm

 show-query-confirm  =

 ───> 
Q

U

E

R

Y

C

O

N

F

I

R

M
──────> Shows whether the QUERY CONFIRM option is set on. The SET QUERY CONFIRM statement makes SQL display the estimated number of I/O operations each query will cost and offers you an opportunity to cancel each query instead of executing it.

query limit

 show-query-limit  =

 ───> 
Q

U

E

R

Y

L

I

M

I

T
──────> Shows whether the QUERY LIMIT option is set on. The SET QUERY LIMIT statement makes SQL display the estimated number of rows each query will fetch and offers you an opportunity to cancel each query instead of executing it.

schemas

 show-schemas =

 ──> 
S

C

H

E

M

A

S
─┬─────────────────┬──> └┬> schema-name ─┬┘ └──────> , ─────┘ Displays the names of specified schemas. If you do not specify an alias, SQL displays schema information for all of the attached databases. For each multischema database, SQL displays the alias, followed by a list of schemas contained in that database. Each schema name in the list is preceded by the catalog and alias names. For each non-multischema database, SQL displays the message "No schemas found". To show database information, use the SHOW DATABASE statement.

session information

 show-session-information =

 ─┬─> 
A

N

S

I

D

A

T

E
typebox (M)typebox (O)typebox (D)typebox (E) ───────────┬─> ├─> 
A

N

S

I

I

D

E

N

T

I

F

I

E

R

S
typebox (M)typebox (O)typebox (D)typebox (E) ────┤ ├─> 
A

N

S

I

Q

U

O

T

I

N

G
typebox (M)typebox (O)typebox (D)typebox (E) ────────┤ ├─> 
C

O

N

S

T

R

A

I

N

T
typebox (M)typebox (O)typebox (D)typebox (E) ──────────┤ ├─> 
C

U

R

R

E

N

C

Y
typebox (S)typebox (I)typebox (G)typebox (N) ────────────┤ ├─> 
D

A

T

E

F

O

R

M

A

T
──────────────┤ ├─> 
D

I

C

T

I

O

N

A

R

Y
───────────────┤ ├─> 
D

I

G

I

T

S

E

P

A

R

A

T

O

R
──────────┤ ├─> 
E

X

E

C

U

T

I

O

N
typebox (M)typebox (O)typebox (D)typebox (E) ───────────┤ ├─> 
F

L

A

G

G

E

R
typebox (M)typebox (O)typebox (D)typebox (E) ─────────────┤ ├─> 
L

A

N

G

U

A

G

E
─────────────────┤ ├─> 
R

A

D

I

X
typebox (P)typebox (O)typebox (I)typebox (N)typebox (T) ──────────────┤ ├─> 
S

Q

L

C

A
────────────────────┤ ├─> 
T

R

A

N

S

A

C

T

I

O

N
──────────────┤ ├─> 
V

E

R

S

I

O

N

S
─────────────────┤ └─> 
W

A

R

N

I

N

G
typebox (M)typebox (O)typebox (D)typebox (E) ─────────────┘ SHOW ANSI AUTHORIZATION MODE shows whether SQL bases privilege checking on the default authorization identifier, in compliance with the ANSI/ISO standard. If the authorization mode is ON, SQL restricts any user other than the one who compiled a module from invoking that module. SHOW ANSI DATE MODE shows whether the default DATE data type is set to DATE ANSI or DATE VMS. SHOW ANSI RESERVED WORDS MODE shows whether reserved words checking is enabled. You must enclose reserved words from the ANSI 89 standard in double quotation marks in order to supply them as user-supplied names in SQL statements. When you enable the reserved words mode, SQL issues an informational message after statements that misuse reserved words. For a list of the reserved words, see the SQL Reference Manual appendices. SHOW CONSTRAINT MODE shows the initial setting of the constraint mode for any transactions starting after the current transaction. When the constraint mode is ON, SQL evaluates all commit-time constraints at the end of each statement and at commit time, until the transaction completes or the constraint mode set to OFF. When the constraint mode is OFF (the default setting), constraint evaluation is deferred until commit time. SHOW CURRENCY SIGN displays the currency indicator which will be used in output displays. SHOW DATE FORMAT displays the values for the date-number and time-number arguments of the SET DATE FORMAT DATE date-number and SET DATE FORMAT TIME time-number statements. SHOW DICTIONARY displays the current default directory in the data dictionary. SHOW DIGIT SEPARATOR displays the character which will be used as the digit separator in output displays. SHOW EXECUTION MODE shows whether or not SQL will execute the statements that you issue in your interactive SQL session. The default is to execute the statements as you issue them. However, if you have issued a SET NOEXECUTE statement in your session, SQL will not execute subsequent statements. SHOW FLAGGER MODE shows whether or not SQL will flag statements containing syntax that does not conform to the ANSI/ISO standard for SQL. If you specify SET FLAGGER ON, SQL sends you an informational message if you issue a subsequent interactive SQL statement that contains nonstandard syntax. SHOW LANGUAGE displays the language that will be used for month abbreviations in date and time input and display. SHOW RADIX POINT displays the character that will be used as the radix point in output displays. SHOW SQLCA displays the contents of the SQL Communication Area (SQLCA). The SQLCA is a collection of variables that SQL uses to provide information about the execution of SQL statements to application programs. In interactive SQL, you can use the SHOW SQLCA statement to learn about the different variables in the SQLCA. SHOW TRANSACTION displays the characteristics of the current transaction, or, if there is not an active transaction, the characteristics specified in the last DECLARE TRANSACTION statement. SHOW VERSIONS displays the version of SQL and underlying software components. SHOW WARNING MODE displays the default setting for warning messages. If WARNING MODE is set to ON, SQL flags statements containing obsolete SQL syntax. Obsolete syntax is syntax that was allowed in previous versions of SQL but has changed. Digital recommends that you avoid using such syntax, because it may not be supported in future versions. By default, SQL displays a warning message after any statement containing obsolete syntax (WARNING MODE ON). To suppress messages about obsolete syntax, use the SET WARNING NODEPRECATE statement.

storage areas

 show-storage-areas =

 ──> 
S

T

O

R

A

G

E

A

R

E

A

S
───┬────────────────────────────┬──> └┬─┬─┬─────────────┬─> typebox (*) ─┬─┬┘ │ │ └─> alias. ───┘ │ │ │ └─> storage-area-name ─┘ │ └─────────── , <───────────┘ Displays information about the storage areas for the attached databases. The information includes: page format, page size, area file, area allocation, area extent minimum, area extent maximum, area extent percent, snapshot file, snapshot allocation, snapshot extent minimum, snapshot extent maximum, and snapshot extent percent.

storage maps

 show-storage-maps =
 ─┬─────>─────┬─> 
S

T

O

R

A

G

E

M

A

P

S
─┬──────────────>─────────────┬─> ├─> 
S

Y

S

T

E

M
─┤ └┬─┬─┬─────────────┬─> typebox (*) ─┬─┬┘ └─> 
A

L

L
────┘ │ │ └─> alias. ───┘ │ │ │ └─> storage-map-name ──┘ │ └─────────── , <───────────┘ Displays information about the storage maps for the attached databases. The display includes: whether compression is enabled or disabled, and information you specified in the store-clause of the CREATE STORAGE MAP statement.

tables

 show-tables =
 ─┬─────>─────┬─> 
T

A

B

L

E

S
─┬──────────────────>────────────────┬─┐ ├─> 
S

Y

S

T

E

M
─┤ └─> ( ─┬─┬─> 
C

O

L

U

M

N

S
──────┬─┬─> ) ─┘ │ └─> 
A

L

L
────┘ │ ├─> 
C

O

M

M

E

N

T
──────┤ │ │ │ ├─> 
C

O

N

S

T

R

A

I

N

T

S
──┤ │ │ │ ├─> 
I

N

D

E

X

E

S
──────┤ │ │ │ ├─> 
S

T

O

R

A

G

E

M

A

P

S
─┤ │ │ │ └─> 
T

R

I

G

G

E

R

S
─────┘ │ │ └───────── , <────────┘ │ ┌──────────────────────────────<───────────────────────────────┘ └──┬─┬───────────>──────────┬─┬──> │ ├─┬─────────────┬─> typebox (*) ─┤ │ │ │ └─> alias. ───┘ │ │ │ └─> table-name ────────┘ │ └────────── , <────────────┘ Displays information about tables. If you do not specify a wildcard or list of table names, SQL displays the names of all the tables in all attached databases. If you do not specify any of the SHOW TABLES options (COLUMNS, COMMENT, CONSTRAINTS, INDEXES, STORAGE MAPS, or TRIGGERS), by default you will see the display for all of these options.

Additional information available:

COLUMNSCOMMENTCONSTRAINTSINDEXESSTORAGE_MAPS
TRIGGERS

COLUMNS

 Displays each column name, data type, and domain name for the
 specified tables.

COMMENT

 Displays the comments for the specified tables.

CONSTRAINTS

 Displays the constraints for the specified tables and the
 constraints referencing the specified tables.  The display shows
 the name and type of each constraint, its evaluation time, and
 its source definition.

INDEXES

 Displays the indexes for the specified tables.  The display
 shows the name and type of each index and whether duplicates are
 allowed.

STORAGE_MAPS

 Displays the names of the storage maps for the specified tables.

TRIGGERS

 Displays the names and source definitions of triggers for the
 specified tables.

triggers

 show-triggers =
 ─────> 
T

R

I

G

G

E

R

S
─┬─┬──────────────────────┬─┬──> │ ├─┬─────────────┬─> typebox (*) ─┤ │ │ │ └─> alias. ───┘ │ │ │ └─> trigger-name ──────┘ │ └───────── , <─────────────┘ Displays information about triggers. If you do not specify a wildcard or a trigger name, SQL displays the names of all the triggers in all attached databases.

Additional information available:

table nameschema name

table name

 The name of the table definition you want to show.
 table-name =

 ─┬────────────────────────┬─> name-of-table ──┬─>
  ├─┬─> schema-name ─┬> . ─┘                   │
  │ └─> alias ───────┘                         │
  └───> typebox (") alias.name-of-table " ───────────────┘

schema name

 The name of the schema, which may be used to qualify the table
 name in a multischema database.
 schema-name  =
  ─┬────────────────────────────────────────┬─┐
   ├──────> catalog-name ────────────┬─> . ─┘ │
   ├─> typebox (") ─> alias.catalog-name ─> typebox (") ─┘        │
   │   ┌──────────────────────────────────────┘
   │   └──────────────> name-of-schema ────────┬─>
   └─> typebox (") ─> alias.name-of-schema ─> typebox (") ─────────┘

users granting

 show-users-granting =

  ─> 
U

S

E

R

S

G

R

A

N

T

I

N

G
───┐ ┌────────────────────┘ └─┬─> table-privs-ansi ──┬──────────┐ ├─> column-privs-ansi ─┤ │ └─> db-privs-ansi ─────┘ │ ┌───────────────────────────────────┘ └─> 
O

N
─┬─> typebox (T)typebox (A)typebox (B)typebox (L)typebox (E) ─┬─> table-name ─┬─┬──┐ │ └─────── , <─────┘ │ │ ├─> 
C

O

L

U

M

N
─┬─> column-name ─┬─┤ │ │ └─────── , <─────┘ │ │ └─> 
D

A

T

A

B

A

S

E
─┬─> alias ──┬────┘ │ └──── , <───┘ │ ┌────────────────────────────────────┘ └───> 
T

O
─┬─> identifier-ansi-style ──┬──> typebox (;) └─> 
P

U

B

L

I

C
─────────────────┘ Displays information about the users who gave a particular privilege to a particular user. This statement displays the privilege records that need to be revoked to take a privilege away from the user, either directly or indirectly. You can specify a list of tables, columns, or databases but you must specify at least one item to display a table, column, or database list. For lists of privileges, see the column_privs, db_privs, and table_privs subtopics of the Help topic for GRANT_ANSI_style.

Additional information available:

TO

TO

 Specifies the identifiers for the new or modified access
 privilege set entry.  Specifying PUBLIC is equivalent to using
 the user identification code (UIC) identifier [*,*].

users with

 show-users-with =

 ──> 
U

S

E

R

S

W

I

T

H
───────┐ ┌────────────────────┘ └─┬─> table-privs-ansi ──┬──────────┐ ├─> column-privs-ansi ─┤ │ └─> db-privs-ansi ─────┘ │ ┌───────────────────────────────────┘ └─> 
O

N
─┬─> typebox (T)typebox (A)typebox (B)typebox (L)typebox (E) ─┬─> table-name ─┬─┬──┐ │ └─────── , <─────┘ │ │ ├─> 
C

O

L

U

M

N
─┬─> column-name ─┬─┤ │ │ └─────── , <─────┘ │ │ └─> 
D

A

T

A

B

A

S

E
─┬─> alias ──┬────┘ │ └──── , <───┘ │ ┌─────────────────────────────────────────┘ └─> 
F

R

O

M
─┬─> identifier-ansi-style ──┬────> typebox (;) └─> 
P

U

B

L

I

C
─────────────────┘ Displays information about the users who received a particular privilege from a particular user. This is also the list of users who lose a particular privilege when it is taken away from any users who granted the privilege. You can specify a list of tables, columns, or databases but you must specify at least one item to display a table, column, or database list. For lists of privileges, see the column_privs, db_privs, and table_privs subtopics of the Help topic for GRANT_ANSI_style.

Additional information available:

FROM

FROM

 Specifies the identifiers for the new or modified access
 privilege set entry.  Specifying PUBLIC is equivalent to using
 the user identification code (UIC) identifier [*,*].

views

 show-views =
 ──┬─────>─────┬─> 
V

I

E

W

S
─┬───────────────>──────────────┬─┐ ├─> 
S

Y

S

T

E

M
─┤ └─> ( ─┬─┬─> 
C

O

L

U

M

N

S
─┬─┬─> ) ─┘ │ └─> 
A

L

L
────┘ │ ├─> 
C

O

M

M

E

N

T
─┤ │ │ │ └─> 
S

O

U

R

C

E
──┘ │ │ └────── , <──────┘ │ ┌──────────────────────────────<─────────────────────────┘ └──┬─┬────────────>─────────┬─┬──> │ ├─┬──────>──────┬─> typebox (*) ─┤ │ │ │ └─> alias. ───┘ │ │ │ └─> view-name ─────────┘ │ └─────────, <──────────────┘ Displays information about views. If you do not specify a wildcard or list of view names, SQL displays the names of all the views in all attached databases. If you do not specify any of the SHOW VIEWS options (COLUMNS, COMMENT, or SOURCE), by default you will see the display for all of these options.

Additional information available:

COLUMNSCOMMENTSOURCE

COLUMNS

 Displays each column name, data type, and domain name for the
 specified views.

COMMENT

 Displays the comments for the specified views.

SOURCE

 Displays the source definitions for the specified views.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026