The LISTFILES command can be used to view a list of the files available in an account. This command generates an INFO/ACCESS statement that selects a set of related items, sorts them alphabetically by name, and displays the contents of various attributes.
The LISTFILES report is usually too long to be displayed all at once on a terminal screen. The system will pause after displaying one page of output and wait for you to press a key before displaying the next page.
An example of the LISTFILES report follows, shown as two screens.
|
>LISTFILES |
|||
|
|
|
|
|
|
PAGE 1 *** M/DICT *** FILE DEFINING ITEMS DD MMM YYYY |
|||
|
|
|
|
|
|
M/DICT................. |
CODE |
F/BASE........ |
F/MOD........ |
|
|
|
|
|
|
AUD |
D |
6838 |
7 |
|
AUDIT |
D |
6828 |
7 |
|
BACKGROUND |
D |
6708 |
7 |
|
BOOK-CATAL |
DG |
6872 |
3 |
|
BP |
DC |
6768 |
21 |
|
CUST-TAPE |
D |
6698 |
7 |
|
CUSTNAMES |
D |
6760 |
1 |
|
CUSTOMERS |
D |
6762 |
3 |
|
CUSTOMERS |
DNACTIVE |
9548 |
1 |
|
ME |
D |
6823 |
3 |
|
MEME |
D |
6856 |
1 |
|
NEWORDERS |
D |
6858 |
3 |
|
ORDERS |
D |
6850 |
3 |
|
ORDERS2 |
D |
9537 |
3 |
|
PAYROLL |
D |
6718 |
3 |
|
PHONE-LIST |
D |
6848 |
CUSTOMERS |
|
ACC |
Q |
ACC |
ACC |
|
BASICLIB |
Q |
BASICLIB |
BASICLIB |
|
BLOCK-CONV |
QRT |
BLOCK-CONVERT |
|
|
CU |
Q |
DALE |
CUSTOMERS |
|
|
|
|
|
|
PAGE 2 *** M/DICT *** FILE DEFINING ITEMS DD MMM YYYY |
|||
|
|
|
|
|
|
M/DICT............ |
CODE |
F/BASE........ |
F/MOD........ |
|
|
|
|
|
|
ERRMSG |
Q |
ERRMSG |
ERRMSG |
|
M/DICT |
Q |
|
|
|
MD |
Q |
|
|
|
POINTER-FI |
QE |
SYSPROG |
POINTER-FILE |
|
PROCLIB |
Q |
PROCLIB |
|
|
QFILE |
Q |
CU |
CUSTOMERS |
|
|
|
|
|
|
> |
|
|
|
Consider the summarized report produced by LISTFILES. The report lists information in four columns and displays a row of data for each File Definition item in the Master Dictionary. The first column contains the names of files. The file name is the item-ID of a File Definition item. The next three columns correspond to the first three attributes of a File Definition item.
The column labelled CODE lists a Definition Code that identifies what kind of item it is. A value of D indicates a D-pointer to a file located in the account. The second attribute (F/BASE) of a D-pointer specifies the base frame ID used to locate the first group on disk for the file. The third attribute (F/MOD) specifies the modulo of the file or the number of groups occupied by the file.
In the sections that follow, many examples make use of the CUSTOMERS file. It contains basic information such as names, addresses, and phone numbers for a group of individual customers. Find the File Definition item in our example for CUSTOMERS; it has a base of 6762 and consists of 3 groups.
This report also lists Q-pointers. Q-pointers reference files that are located in this and other accounts on the system. The second attribute of a Q-pointer identifies the account in which the file is located. If null, then the file can be found in the same account. The third attribute identifies the name of the file in that account. If null, the file is the Master Dictionary. MD and M/DICT are Q-pointers that refer to the Master Dictionary itself.
Enter LISTFILES at the TCL prompt to display a listing of the files defined in your account. You can also try LISTVERBS which displays a listing of the commands that are defined in your account. It shows the first five attributes of Command Definition items in the Master Dictionary. The output from this report is less meaningful to a new user; you will understand it better when examining the format of Command Definition items presented in Using the Terminal Control Language.
See Also