*OPSD - Define Files
Purpose
This utility creates and allocates space for new programs and files.
Procedure
To run this utility from Thoroughbred Basic Console Mode, type:
RUN “*OPSD” and press Enter.
To select this utility from the Thoroughbred Basic Utilities Menu, type one of the following:
O and press Enter.
*O and press Enter.
*OPSD and press Enter.
Menu option # and press Enter.
The system prompts:
ENTER FILE TYPE (I=IND, D=DIR, S=SRT, R=SER, P=PGM, T=TEXT)
Enter the type of file you are creating. The following list outlines the prompts generated by the system based on the file type selected:
- KEY SIZE
- SORT and DIRECT files only. Enter the length of the file Key. The range is 2 to 144.
- RECORD SIZE
- For INDEXED, SERIAL, and DIRECT files only. Enter the record length, in bytes.
- NUMBER OF PAGES
- For program files only. Enter the number of 256-byte pages needed.
- NUMBER OF RECORDS
- Enter the number of records needed. For SORT files, enter the number of keys needed. Enter 0 for autoexpanding DIRECT or SORT files.
When the applicable entries have been made, the system prompts:
DISC NAME/NUMBER
Type the number of the disk where the file will reside. The system prompts:
FILE NAME
Enter the name of the new file. If all specifications are valid, the system responds with the following message:
FILE XXXXXXXX DEFINED (HIT CR)
Press Enter once to return the “<F2M>ENTER FILE TYPE” prompt, twice to exit to the Thoroughbred Basic Utilities Menu.
DO YOU WANT TO NULL FILE (Y/N)?
This prompt only applies to index files only. Type Y and press Enter to fill the data area with null characters ($00$). This removes any old data from the file.
Error Messages
- ERROR xx OCCURRED DEFINING FILE
- This message indicates an unexpected error occurred while trying to define the file.
- FILE ALREADY DEFINED
- This message indicates that a file with this name already exists. Type a new file name.
FILE ALREADY EXISTS ON DISK xx.
This message indicates a file with the same name already exists on the specified disk. Type another name.
- ILLEGAL FILE NAME
- This message indicates that the name given is longer than 8 characters or contains an invalid special character (the list of invalid special characters varies by system). Type another file name.
- INVALID DISK NUMBER
- This message indicates that the disk number specified either does not exist, is not configured, or is disabled.
- INVALID KEY SIZE. RANGE 2 TO 144
- This message indicates that a key size was entered out of the allowable range. Type a value between 2 and 144.
- INVALID NUMBER OF PAGES. RANGE 1 TO 127
- This message indicates that a value for number of pages was entered that is out of the allowable range. Type a value from 1 to 127.
- INVALID NUMBER OF RECORDS. RANGE 1 TO 16777215
- This message indicates that an invalid value was entered for the number of records. Type a value from 1 to 16777215.
- INVALID PARAMETER IN DEFINE STATEMENT
- This message indicates that the file was not created because an invalid entry was made and went undetected.
- INVALID RECORD SIZE. RANGE 1 TO 32767
- This message indicates that a record size was entered out of the allowable range. Type a value from 1 to 32767.
INVALID SECTOR. RANGE 0 TO XXXX (where: xxxx is highest sector on disk)
This message indicates the sector value entered is out of range. Type a valid sector number.
- NOT ENOUGH ROOM ON DISK
- This message indicates that the file could not be created because a block large enough to contain it could not be found on the requested disk. Delete unnecessary files to make room and try again.
- SECTORS xxxx TO yyyy NOT AVAILABLE
- This message indicates the file could not be created because all or part of the requested sectors on the disk, have already been allocated to another file. Type another sector number.
From the Thoroughbred Basic Utilities, version 8.9.1. Open this page in the PDF