Using the system - Revision history

Mizapf at 19:02, 20 November 2012

2012-11-20T19:02:20Z

← Older revision		Revision as of 19:02, 20 November 2012
Line 6:		Line 6:
	* [[MDOS usage\|Geneve in MDOS mode]]		* [[MDOS usage\|Geneve in MDOS mode]]
	* [[GPL mode usage\|Geneve in GPL mode]]		* [[GPL mode usage\|Geneve in GPL mode]]
	* [[~~GRAM~~ Kracker usage\|~~GRAM~~ Kracker]]		* [[Gram Kracker usage\|Gram Kracker]]

Mizapf at 18:46, 20 November 2012

2012-11-20T18:46:57Z

← Older revision		Revision as of 18:46, 20 November 2012
Line 6:		Line 6:
	* [[MDOS usage\|Geneve in MDOS mode]]		* [[MDOS usage\|Geneve in MDOS mode]]
	* [[GPL mode usage\|Geneve in GPL mode]]		* [[GPL mode usage\|Geneve in GPL mode]]
			* [[GRAM Kracker usage\|GRAM Kracker]]

Mizapf: Replaced content with "On these pages we collect tips for everyday usage of the systems. Using the * TI-99/4A system * Geneve in MDOS mode * [[GPL mode..."

2011-11-05T17:18:17Z

Replaced content with "On these pages we collect tips for everyday usage of the systems. Using the * TI-99/4A system * Geneve in MDOS mode * [[GPL mode..."

@@ Line 1: / Line 1: @@
 On these pages we collect tips for everyday usage of the systems.
-== Starting up the system ==
+Using the
-If the console is working correctly, power is attached, and the console is connected to a TV set, you can simply move the front switch and be greeted with the Master Title Screen
+* [[TI-99/4A system usage | TI-99/4A system]]
+* [[MDOS usage|Geneve in MDOS mode]]
-[[File:Master_title_screen.png]]
+* [[GPL mode usage|Geneve in GPL mode]]

Mizapf: /* How to check the contents of a disk */

2011-07-01T08:21:19Z

How to check the contents of a disk

← Older revision		Revision as of 08:21, 1 July 2011
Line 61:		Line 61:
	There are three ways to do that:		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.		# You have to write a [[Disk directory reader in BASIC\|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.		# 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.		# 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.

Mizapf: /* Loading */

2011-04-01T20:26:48Z

← Older revision		Revision as of 20:26, 1 April 2011
Line 118:		Line 118:
	If you get an error message, it is likely that this is no BASIC program. Plug in the [[Editor/Assembler]] and load the program via [[Editor/Assembler#Run_Program_File\|option 5]] by providing the file name DSK1.SAMPLEFILE		If you get an error message, it is likely that this is no BASIC program. Plug in the [[Editor/Assembler]] and load the program via [[Editor/Assembler#Run_Program_File\|option 5]] by providing the file name DSK1.SAMPLEFILE

	If it is a DIS/FIX 80 file you need to load it in Editor/Assembler, use [[Editor/Assembler#~~Load_And_Run~~\|option 3]].		If it is a DIS/FIX 80 file you need to load it in Editor/Assembler, use [[Editor/Assembler#Load_and_Run\|option 3]].

	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.		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.

Mizapf: /* Loading */

2011-04-01T20:26:21Z

← Older revision		Revision as of 20:26, 1 April 2011
Line 116:		Line 116:
	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 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~~		If you get an error message, it is likely that this is no BASIC program. Plug in the [[Editor/Assembler]] and load the program via [[Editor/Assembler#Run_Program_File\|option 5]] by providing the file name DSK1.SAMPLEFILE
	5 ~~RUN PROGRAM FILE~~
	~~and enter~~
	DSK1.SAMPLEFILE

	If it is a DIS/FIX 80 file you need to load it in Editor/Assembler, ~~select~~		If it is a DIS/FIX 80 file you need to load it in Editor/Assembler, use [[Editor/Assembler#Load_And_Run\|option 3]].
	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.		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.

Mizapf at 20:24, 1 April 2011

2011-04-01T20:24:01Z

← Older revision		Revision as of 20:24, 1 April 2011
Line 1:		Line 1:
	On these pages we collect tips for everyday usage of the systems.		On these pages we collect tips for everyday usage of the systems.

			== Starting up the system ==

			If the console is working correctly, power is attached, and the console is connected to a TV set, you can simply move the front switch and be greeted with the Master Title Screen

			[[File:Master_title_screen.png]]

			As the screen says, press any key to proceed to the cartridge selection. In this case here, we have started the system with the [[Editor/Assembler]] cartridge plugged in, so it appears in position 2, right after the console built-in TI BASIC.

			[[File:Cartridge_select.png]]

			== Using TI BASIC ==

			We proceed directly to TI BASIC by pressing 1.

			[[File:Ti_basic.png]]

			This is the TI BASIC command mode. You can type in any BASIC command like

			PRINT "HELLO"

			or you can start to enter a BASIC program just by writing a line number before your BASIC command.

			10 PRINT "HELLO"

			All BASIC lines will be arranged by their line number. You can run the BASIC program at any time by using the RUN command

			RUN

			Clear your program space with

			NEW

			You call clear the screen without losing the program by

			CALL CLEAR

			This is one of the numerous [[CALL subroutines]] of TI BASIC.

			If you want to leave TI BASIC, use

			BYE

			This command closes all open files and returns you to the Master Title Screen. You can also press QUIT (FCTN-=) which will not close files and thus may lead to data loss (if there are open files). Keep in mind that your BASIC program will always be lost when exiting BASIC unless you save it to cassette or to floppy disk:

			SAVE CS1
			SAVE DSK1.MYPROGRAM

			If you want to retrieve your program from the data storage (cassette or disk), use the OLD command:

			OLD CS1
			OLD DSK1.MYPROGRAM

	== How to check the contents of a disk ==		== How to check the contents of a disk ==

Mizapf at 09:24, 14 June 2010

2010-06-14T09:24:50Z

New page

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.

CALL DIR(1)

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

CALL DIR("WDS1.BASIC")

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.

=== Types ===

* 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.

=== Loading ===

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

OLD DSK1.SAMPLEFILE

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
and enter
DSK1.SAMPLEFILE

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.