Skip to content
Thoroughbred Software InternationalThoroughbred Software InternationalThoroughbred DocumentationDocs

*LPSD - Display Disk Directory

Purpose

This utility lists portions of a disk directory on the terminal, one screen at a time. The directory may be sorted alphabetically or by location on the disk. Portions of the directory may be selected by alphabetical range, location range, or by pattern-matching masks. The following information is provided for each file (where applicable):

  • File name
  • Record length
  • File type
  • Number of records
  • Starting sector
  • Key length

Procedure

To run this utility from Thoroughbred Basic Console Mode, type:

RUN “*LPSD” and press Enter.

To select this utility from the Thoroughbred Basic Utilities Menu, type one of the following:

L and press Enter.

*L and press Enter

*LPSD and press Enter

Menu option # and press Enter

The following message is displayed:

DISC NAME OR NUMBER:

Type the name or number of the directory you wish to list. The system displays the name of the selected directory and the following prompt:

LOCATION, MASKS, OR NAME (L,M,N)

Type L and press Enter to sort the directory in sector order; type M and press Enter to sort the directory by masks; or type N and press Enter to sort in alphabetical order.

If location order is selected, no sort is necessary because the directory already exists in sector order. If masks are selected, refer to the *BPSD Utility for more information on masks. If name is selected, the system sorts the files alphabetically.

TYPES (I=IND, D=DIR, S=SRT, R=SER, P=PGM, M=MKEY, T=TEXT, C=CISAM)

Type up to 2 characters representing the types of files you want displayed and press Enter or press Enter to display all file types. If a character other than I(ndex), D(irect), S(ort), R(Serial), P(rogram), M(KEY), T(EXT), or C(ISAM) is entered, or if more than 2 characters are entered, you will be prompted again.

ENTER FILENAME OR MASK; (@) FOR ALL, (CR) TO END

Type up to 48 file names or masks and press Enter or type @ and press Enter to list all the names in the directory. If a specified file does not exist on the disk, or if a file does not match the selected type, the name is rejected. After entering each name or mask, press Enter once. After you have entered all the names or masks, press Enter again to continue with the procedure. To exit the utility, press F4.

FROM NAME

Type the name of the first file to be displayed and press Enter or press Enter to set this parameter to the first name in alphabetical order.

TO NAME

Type the name of the last file to be displayed and press Enter or press Enter to set this parameter to the last name in alphabetical order.

After all the requested information has been supplied, the system sorts the file (if necessary) and prints the directory information. The following list explains the information provided in the printout.

Heading Explanation
NAME Fourteen-character name
TYPE File type (listed below): IND = INDEXED files SER = SERIAL files SRT = SORT files DIR = DIRECT files PGM = Program files SDR = System directory TXT = TEXT files MKY = MSORT files ISM = TISAM files DRX = Auto-expanding DIRECT files SRX = Auto-expanding SORT files
START SECTOR Location of the beginning of the file on the disk
END SECTOR Last sector used by the file
TOTAL Number of sectors used by this file
KEY For SORT and DIRECT files, the length of the key in bytes. For other file types, this field is 0.
RECORDS Number of logical records in the file. For PROGRAM files this field is 1. For SORT files, it is the number of keys.
RECLEN or BYTES/RECORD Record length in bytes. This field is 0 for SORT files.
IN USE Number of records used. For programs, this is the actual length of the program in bytes.
Comments The contents of the first REM statement in a program or NONE if the first statement is not a REM. If the file is a directory, DIRECTORY appears in this field. If the file is an object library, OBJECT LIBRARY appears in this field.

Notes

If the directory is printed in sector order, an entry consisting of *AVAILABLE* and starting, ending, and total sectors is printed for each unused block on the disk.

When the entries for the applicable prompts have been made, the screen displays the directory information. At the bottom of each screen, the following message is displayed:

HIT (CR) TO CONTINUE

Press Enter to continue with the listing. When the listing is complete, the following prompt will be displayed at the bottom of the screen:

HIT (CR) FOR NEW LISTING

Press Enter to return to the LOCATION, MASKS, or NAME prompt. Select another way of listing the same directory or press F3 to return to the DISC ID field. You may enter another disk directory to list, or press F3 or F4 to return to the Thoroughbred Basic Utilities Menu.

A name that is more than 14 characters long prints the first 13 characters, then the > character.

Error Messages

DISK nn NOT CONFIGURED
The disk number given is invalid or the disk does not have a Basic directory.
INVALID FILE NAME
The requested directory does not exist; enter another.
LIMIT IS 48 NAMES/MASKS
The maximum number of filenames or masks has been entered (48). The utility now begins its directory search.
'xxxxxxxx' NOT A DIRECTORY
The directory name entered is not a valid directory. Enter another name.
PERMISSION DENIED FOR DISK xxx
This utility could not read the specified disk.

From the Thoroughbred Basic Utilities, version 8.9.1. Open this page in the PDF