Using the system
On these pages we collect tips for everyday usage of the systems.
How to check the contents of a disk
Situation: You have inserted a disk and wonder how to find out which files are stored on it and whether there is free space.
The disk directory is a pseudo data file and must be opened and read with the usual disk operations.
There are three ways to do that:
- You have to write a BASIC program that reads this pseudo file record by record. Each record is a file entry in the directory. There are ready-to-use BASIC programs around, and the BASIC manuals also explain how to do that.
- Plug in a Disk Manager cartridge. There is one function called CATALOG DISK that you use to view the directory contents.
- Use the subroutines offered by certain disk controllers. Disk controllers like the Myarc HFDC have built-in routines that are accessible from TI BASIC or Extended Basic. In this case, the DIR subprogram is available to read and show the disk directory.
lists the contents of the disk in drive 1. Analogously, drive 2 or 3 can be queried, and you can also provide full pathnames like
which would attempt to list the contents of the BASIC subdirectory on a device called WDS1 which is usually the first hard disk attached to a suitable controller like the HFDC.
Option 1 is preferred when you write a BASIC program that should also be able to process the disk directory contents. It is not recommended for quickly checking the contents while you already have another BASIC program in memory since you would lose that program when you load the directory reader program.
Option 2 was the standard way until more sophisticated disk controllers became available which also offered those subprograms. For instance, the original TI Disk Controller did not offer these convenience routines, so you only had option 1 or this option.
Option 3 is the preferred way if you have a suitable disk controller. Just try the call shown above to check out.
Note: Do not mix up this command with CALL FILES which is used to allocate memory for operations on more than one opened file.
How to run an unknown program
Situation: You have inserted a disk and wonder how to get the programs running which you find on it.
As with most systems there are two types of files:
- files containing data, and
- files containing executable code.
In most cases, executable code is stored in PROGRAM files.
- PROGRAM files are plain memory dumps
They must be loaded at the exact same positions in memory. Apart from them, there are files with other formats, also containing executable code:
- DIS/FIX 80 files are record-oriented files containing relocatable machine code.
That is, these files must be loaded by a special loader (which is part of the Editor/Assembler cartridge, but also of the Extended Basic cartridge). This loader is able to place the contents in almost any memory location, automatically adjusting references to addresses.
- DIS/FIX 163 files are MERGE files.
These files may be created in Extended Basic. They are used when you want to merge several files to one single BASIC program. For instance, you can store subroutines in MERGE files and select those that you need when running some application.
If you find a PROGRAM file it is either BASIC or Extended BASIC or a memory image machine language file.
BASIC: Get into BASIC, type
If you don't get an error message, do a LIST and see whether there are strange characters in the listing and whether the BASIC interpreter outputs very sluggishly. This means it's actually Extended Basic. Do the same with Extended Basic plugged in and selected.
If you get an error message, it is likely that this is no BASIC program. Plug in the Editor/Assembler, select
5 RUN PROGRAM FILE
If it is a DIS/FIX 80 file you need to load it in Editor/Assembler, select
3 LOAD AND RUN
Sometimes the file contains an autostart tag. If not, you will need to provide a name by which the machine language program has been registered. This can be a bit difficult to find out. If you look at the file in an editor, you can find some names near the end of the file. One of them may be the proper program name.