Using REVIEW Commands to Display Information about the Database [ DBChange Plus User's Guide ] MPE/iX 5.0 Documentation
DBChange Plus User's Guide
Using REVIEW Commands to Display Information about the Database
The DBCPLUS program has several REVIEW commands that display information
about the database structure with the changes stored in a change file.
The remainder of this chapter provides an example for each REVIEW
command.
Displaying User Classes and Passwords
To display one or more user classes and associated passwords in the
database, use the REVIEW PASSWORDS command. In the following example, @
is the parameter used to display all user classes and associated
passwords in the ORDERS database:
>review passwords @
REVIEW PASSWORDS:
User Class Password
-----------------------
11 CREDIT
12 BUYER
13 SHIP-REC
14 CLERK
18 DO-ALL
>
Refer to "REVIEW PASSWORDS" in chapter 10, "DBChange Plus Commands," for
a detailed description of the command.
Displaying Data Items
To display information about one or more data items in the database, use
the REVIEW ITEMS command. The REVIEW ITEMS command displays item numbers
as they appear in the schema, along with their item name, attributes, and
security information. In the following example, @ is the parameter used
to display all the items in the ORDERS database. Because the database
has more than 20 data items, the DBCPLUS program asks if you want to
continue, that is, review more data items.
>review items @
REVIEW ITEMS:
Itm No. Item Name Attrib Security
------------------------------------------
1 ACCOUNT I4 (11,12,13,14,18/)
2 BINNUM Z2 (/13)
3 CITY X12 (12,13,14/11)
4 CREDIT-RATING R2 (/14)
5 DATE X6 (11,12,13,14,18/)
6 DELIV-DATE X6 (/14)
7 DESCRIPTION X20 (11,12,13,14,18/)
8 FIRST-NAME X10 (14/11)
9 INITIAL U2 (14/11)
10 LAST-NAME X16 (14/11)
11 LASTSHIPDATE X6 (12/)
12 ONHANDQTY J2 (14/12)
13 PRICE J2 (14/)
14 PURCH-DATE X6 (11/14)
15 QUANTITY I1 (/14)
16 STATE X2 (12,13,14/11)
17 STOCK# U8 (11,12,14,18/)
18 STREET-ADD X26 (12,13,14/11)
19 SUPPLIER X16 (12,13/)
20 TAX J2 (14/)
CONTINUE [y/N] ? Return
>
Refer to "REVIEW ITEMS" in chapter 10, "DBChange Plus Commands," for a
detailed description of the command.
Displaying Information about Data Sets
This section describes the REVIEW commands used to display information
about data sets.
Displaying Data Sets.
To display information about one or more data sets in the database, use
either the REVIEW SETS or REVIEW BLOCKS command. Both the REVIEW SETS
and REVIEW BLOCKS commands display the data set name, the data set type,
capacity, blocking factor and maximum block length. The REVIEW SETS
command also displays the data set number as it appears in the schema,
the device class, and the security information; while the REVIEW BLOCKS
command displays field count, path count, data entry length with and
without chain counters and pointers, media records, and block length.
Note that the information displayed in the REVIEW BLOCKS command is
similar to the data set summary table printed by the schema processor.
In the following example, REVIEW SETS is used to display information
about the data set PRODUCT in the ORDERS database:
>review sets product
REVIEW SETS:
Set Blk Blk Dev
No. Data Set Name Type Capacity Fac Max Class Security
--------------------------------------------------------------
2 PRODUCT M 307 16 498 (13,14/12,18)
>
In the example below, the REVIEW BLOCKS command is used to display
information about the data set PRODUCT in the ORDERS database:
>review blocks product
REVIEW BLOCKS:
Fld Pth Entr Med Blk Blk Blk
Data Set Name Type Cnt Cnt Len Rec Capacity Fac Len Max
-----------------------------------------------------------------
PRODUCT M 2 2 14 31 307 16 498 498
>
Refer to "REVIEW SETS" and "REVIEW BLOCKS" in chapter 10, "DBChange Plus
Commands," for a detailed description of the commands.
Displaying Fields.
To display one or more fields in a data set, use the REVIEW FIELDS
command. For both master and detail data sets, the REVIEW FIELDS command
displays the data set number, as it appears in the schema, and the data
set name and type. However, the master data set output differs from the
detail data set output in that the master data set output displays the
detail data set associated with the master data set and the search item
linking that detail data set to the master data set. In the detail data
set output, the REVIEW FIELDS command flags the primary path, search
items, and sort item; it also displays the names of the master data set
to which the detail data set is linked and the sort item name.
In the following example, the REVIEW FIELDS command is used to display
the fields in the master data set CUSTOMER in the ORDERS database:
>review fields customer
REVIEW FIELDS (MASTER SET):
Data Set No.: 2 Name: CUSTOMER Type: M
Fld No. Field Name Detail Set Name Path's Search Item
---------------------------------------------------------------
1 ACCOUNT SALES ACCOUNT
2 LAST-NAME
3 FIRST-NAME
4 INITIAL
5 STREET-ADD
6 CITY
7 STATE
8 ZIP
9 CREDIT-RATING
>
In the example below, the REVIEW FIELDS command is used to display the
fields in the detail data set SALES:
>review fields sales
REVIEW FIELDS (DETAIL SET):
Data Set No.: 6 Name: SALES Type: D
Fld No. Field Name Pr Sr So Master Set Name Sort Item Name
--------------------------------------------------------------------
1 ACCOUNT Y CUSTOMER PURCH-DATE
2 STOCK# Y Y PRODUCT
3 QUANTITY
4 PRICE
5 TAX
6 TOTAL
7 PURCH-DATE Y Y DATE-MASTER
8 DELIV-DATE Y DATE-MASTER
>
Refer to "REVIEW FIELDS" in chapter 10, "DBChange Plus Commands," for a
detailed description of the command.
Displaying Paths.
To display information about the paths in one or more data sets, use the
REVIEW PATHS command. For both master and detail data sets, the REVIEW
PATHS command displays the data set number, as it appears in the schema,
and the data set name and type. However, the master data set output
differs from the detail data set output in that the master data set
output displays the key item, the detail data set linked to the master
data set, and the sort item name. In the detail data set output, the
REVIEW PATHS command displays the search item name linking the detail
data set to the master data set, the master data set to which the detail
data set is linked, the sort item name, and the primary path.
In the following example, CUSTOMER is the name of a master data set in
the ORDERS database:
>review paths customer
REVIEW PATHS (MASTER SET):
Data Set No.: 1 Name: CUSTOMER Type: M
Key(Search) Item Detail Set Name Sort Item Name
------------------------------------------------------
ACCOUNT SALES PURCH-DATE
>
In the example below, SALES is the name of a detail data set in the
ORDERS database:
>review paths sales
REVIEW PATHS (DETAIL SET):
Data Set No.: 3 Name: SALES Type: D
Search Item Name Master Set Name Sort Item Name Primary
----------------------------------------------------------------
ACCOUNT CUSTOMER PURCH-DATE
STOCK# PRODUCT Y
>
Refer to "REVIEW PATHS" in chapter 10, "DBChange Plus Commands," for a
detailed description of the command.
MPE/iX 5.0 Documentation