Das Dienstprogramm MOD_APP
==========================

Formatierung:	Tabulatorbreite 5

Andreas Kromke
3.5.98
letzte nderung: 31.3.99


Wozu?
-----

Bei der Installation eines Programms, blicherweise durch ein 
Installationsprogramm, sollte dieses nicht nur die zugehrigen 
Programmdateien auf die Festplatte kopieren, sondern das neue 
Programm auch dem System "bekannt machen". Dieser Vorgang wird 
unter GEM/TOS traditionell als "Anwendung anmelden" bezeichnet und 
mute bisher von Hand durchgefhrt werden.
MOD_APP.TTP ist ein kleines Programm, das diese Arbeit abnimmt. Es 
modifiziert die MagiC-Systemdateien, die die Applikations- 
Informationen inklusive der Icon-Zuordnungen enthalten. Die 
nderungen werden automatisch beim nchsten Start des AES aktiv.


Vorgehensweise
--------------

Ein Installationsprogramm sollte zunchst die erforderlichen Dateien 
auf die Festplatte kopieren. Dann mu es das Laufwerk bestimmen, auf 
dem MagiC liegt (also i.a. das Bootlaufwerk). Schlielich wird 
"<Boot-Lw>:\GEMSYS\GEMDESK\MOD_APP.TTP" ggf. mehrmals per 
normalem Pexec() aufgerufen, um die nderungen an den Systemdateien 
vorzunehmen; dabei sollten die Rckgabewerte ausgewertet werden.

MOD_APP modifiziert die Systemdateien derart, da beim nchsten Start 
des AES die neuen Einstellungen von MAGXDESK beachtet werden. 
Theoretisch wre es auch mglich, die Einstellungen sofort zu 
aktivieren, dazu mte lediglich APPLICAT aufgerufen werden. Da 
jedoch APPLICAT nur unter MagiC luft, wre der Vorteil von MOD_APP, 
unter jedem TOS-System zu laufen, dahin.


Anwendung anmelden
------------------

Aufruf:

	mod_app -Xia prgname rscname|- iconnr|-1 path|- 1

Dabei bedeuten:

	X		der Laufwerkbuchstabe fr das MagiC-Laufwerk
	prgname	z.B. jinnee.prg
	rscname	z.B. MAGICICN.RSC oder - fr das Default-Icon
	iconnr	Nummer des Icons (Objektnummer - 1) bzw. -1
	path		z.B. C:\JINNEE\JINNEE.APP oder "-", wenn kein Pfad 
			eingetragen werden soll. Ein Pfad wird immer dann 
			bentigt, wenn Dateitypen zugewiesen werden.
	1		Hier sollte immer eine 1 stehen fr "GEM-Programm"

Beispiel:

	mod_app -Cia papillon.prg - -1 - 1

Trgt das Programm "Papillon" ein, und zwar ohne Pfad und mit dem
Default-Icon fr Programme.


Dateityp fr Applikation anmelden und Icon zuweisen
---------------------------------------------------

Aufruf:

	mod_app -Xid prgname ftyp rscname|- iconnr|-1

Dabei bedeuten:

	prgname	z.B. jinnee.prg
	ftyp		z.B. *.JIC oder *.JINC oder ICONS.INF
	rscname	s.o.
	iconnr	s.o.

Beispiel:

	mod_app -Cid papillon *.x - -1

Trgt den Dateityp "*.x" fr das Programm "Papillon" ein, und zwar mit
dem Default-Icon fr Dateien.


Rckgabewerte
-------------

	0				OK
	< 0				Systemfehler
	1				Syntaxfehler beim Aufruf
	2				Formatfehler in APPLICAT.INF
	3				Kennung schon vergeben
	4				Applikation nicht eingetragen (-Xid)
	5				Pfad fr Applikation fehlt (-Xid)


Bemerkungen
-----------

- Wenn Dateitypen angemeldet werden sollen, mu MOD_APP mehrmals 
  aufgerufen werden. Bei jedem Aufruf kann man anhand des 
  Rckgabewerts feststellen, ob der Dateityp schon anderweitig 
  zugewiesen wurde.
- Einige Fehler knnen von MOD_APP nicht erkannt werden. Beim 
  nchsten Start des AES werden diese Fehler aber automatisch 
  korrigiert (hoffentlich...).
- Alle nderungen, die MOD_APP durchfhren kann, sind ausschlielich 
  konstruktiv. Es knnen keine Applikationen abgemeldet oder 
  Dateitypen ab- oder umgemeldet werden. Wenn also ein Dateityp schon 
  belegt ist, so sollte eine Fehlermeldung ausgegeben werden, damit 
  der Anwender ggf. den Typ manuell ndern kann.
