*BPSD - FILESET LIST
Purpose
This utility inputs a list of file names and masks from the terminal, compares the list with all files on a specified disk, and places all matching file names into a SORT file on the same disk. The SORT file is named *SR + FID(0) in UNIX.
Other utilities, such as the *LPSD utility use *BPSD to gather a list of file names. Whenever the *BPSD Utility is run the SORT file used to hold the list of names is overwritten and any existing information on it is lost. For information on the structure and operation of SORT files, refer to the section on Input/Output Processing.
Procedure
To run this utility from Thoroughbred Basic Console Mode, type:
RUN “*BPSD” and press Enter.
To select this utility from the Thoroughbred Basic Utilities Menu, type one of the following:
B and press Enter.
*B and press Enter.
*BPSD and press Enter.
Menu option # and press Enter.
The system prompts:
DISC NAME OR NUMBER
Type a valid disk name or number. If the directory for the specified disk cannot be opened, the user is asked to enter another disk number or name. When a valid disk name/number is entered, the system prompts:
ENTER FILENAME OR MASK: (@) FOR ALL, (CR) TO END
Type up to 48 file names or masks and press Enter (See Notes on masks below). Type @ and press Enter to copy all the names in the directory into the SORT file. If a specified file does not exist on the disk, or if a specified file does not match the file type selected, the name is rejected. After entering each name or mask, press Enter once. After you have entered all of the names or masks, press Enter again to continue with the procedure. Press F4 to end the utility program without building the SORT file.
Notes
Masks are one to eight character strings used as patterns to match file names. They contain alphanumeric characters plus the “?” and “@” characters. A “?” matches any single character in a file name, including trailing spaces. A “@” matches the remainder of the file name and may only appear as the last character in the mask. For example, the mask “*?PSD@” matches all of the utility programs and their overlays.
| Example: If a directory contains | the following | entries: | |
|---|---|---|---|
| FM012 | UD790 | PM094 | ZP |
| FM117 | UD984 | PM112 | ZP1 |
| FM193 | PM018 | PM193 | ZP117 |
ZP193
The matches shown here would result:
- Mask
- Matches
- FM@
- FM012, FM117, FM193
- ?M0@
- FM012, PM018, PM094
- ZP?
- ZP, ZP1
- ??1@
- FM117, FM193, PM112, PM193, ZP1, ZP117, ZP193
- ??193
- FM193, PM193, ZP193
Error Messages
- CAN'T DEFINE *SRTx, ERROR=xx
- The utility could not create a new SORT file to place file names in. The run is aborted. In UNIX, check the read/write permissions to ensure that you are allowed to create new files. Another reason for this error could be a full directory. If the directory is full, enter to console mode and erase one file to make room.
- ERROR xx HAS OCCURRED, CR TO RETRY
- An unexpected error, probably I/O related, has occurred.
- LIMIT IS 48 NAMES/MASKS
- The maximum number of names has been entered (48). The system begins its directory search.
- PERMISSION DENIED OF DISK xxx
- This utility could not read the specified disk.
- FILE NAME IS TOO BIG, SKIPPING
- The file name contained too many characters. Enter SKIP to prevent redisplay of this message.
From the Thoroughbred Basic Utilities, version 8.9.1. Open this page in the PDF