home *** CD-ROM | disk | FTP | other *** search
/ ST-Computer Leser 2002 January / STC_CD_01_2002.iso / MPC620 / MPC620 / MOD_APP.TXT < prev    next >
Text File  |  1999-03-31  |  4KB  |  119 lines
  1. Das Dienstprogramm MOD_APP
  2. ==========================
  3.  
  4. Formatierung:    Tabulatorbreite 5
  5.  
  6. Andreas Kromke
  7. 3.5.98
  8. letzte Änderung: 31.3.99
  9.  
  10.  
  11. Wozu?
  12. -----
  13.  
  14. Bei der Installation eines Programms, üblicherweise durch ein 
  15. Installationsprogramm, sollte dieses nicht nur die zugehörigen 
  16. Programmdateien auf die Festplatte kopieren, sondern das neue 
  17. Programm auch dem System "bekannt machen". Dieser Vorgang wird 
  18. unter GEM/TOS traditionell als "Anwendung anmelden" bezeichnet und 
  19. mu₧te bisher von Hand durchgeführt werden.
  20. MOD_APP.TTP ist ein kleines Programm, das diese Arbeit abnimmt. Es 
  21. modifiziert die MagiC-Systemdateien, die die Applikations- 
  22. Informationen inklusive der Icon-Zuordnungen enthalten. Die 
  23. Änderungen werden automatisch beim nächsten Start des AES aktiv.
  24.  
  25.  
  26. Vorgehensweise
  27. --------------
  28.  
  29. Ein Installationsprogramm sollte zunächst die erforderlichen Dateien 
  30. auf die Festplatte kopieren. Dann mu₧ es das Laufwerk bestimmen, auf 
  31. dem MagiC liegt (also i.a. das Bootlaufwerk). Schlie₧lich wird 
  32. "<Boot-Lw>:\GEMSYS\GEMDESK\MOD_APP.TTP" ggf. mehrmals per 
  33. normalem Pexec() aufgerufen, um die Änderungen an den Systemdateien 
  34. vorzunehmen; dabei sollten die Rückgabewerte ausgewertet werden.
  35.  
  36. MOD_APP modifiziert die Systemdateien derart, da₧ beim nächsten Start 
  37. des AES die neuen Einstellungen von MAGXDESK beachtet werden. 
  38. Theoretisch wäre es auch möglich, die Einstellungen sofort zu 
  39. aktivieren, dazu mü₧te lediglich APPLICAT aufgerufen werden. Da 
  40. jedoch APPLICAT nur unter MagiC läuft, wäre der Vorteil von MOD_APP, 
  41. unter jedem TOS-System zu laufen, dahin.
  42.  
  43.  
  44. Anwendung anmelden
  45. ------------------
  46.  
  47. Aufruf:
  48.  
  49.     mod_app -Xia prgname rscname|- iconnr|-1 path|- 1
  50.  
  51. Dabei bedeuten:
  52.  
  53.     X        der Laufwerkbuchstabe für das MagiC-Laufwerk
  54.     prgname    z.B. jinnee.prg
  55.     rscname    z.B. MAGICICN.RSC oder - für das Default-Icon
  56.     iconnr    Nummer des Icons (Objektnummer - 1) bzw. -1
  57.     path        z.B. C:\JINNEE\JINNEE.APP oder "-", wenn kein Pfad 
  58.             eingetragen werden soll. Ein Pfad wird immer dann 
  59.             benötigt, wenn Dateitypen zugewiesen werden.
  60.     1        Hier sollte immer eine 1 stehen für "GEM-Programm"
  61.  
  62. Beispiel:
  63.  
  64.     mod_app -Cia papillon.prg - -1 - 1
  65.  
  66. Trägt das Programm "Papillon" ein, und zwar ohne Pfad und mit dem
  67. Default-Icon für Programme.
  68.  
  69.  
  70. Dateityp für Applikation anmelden und Icon zuweisen
  71. ---------------------------------------------------
  72.  
  73. Aufruf:
  74.  
  75.     mod_app -Xid prgname ftyp rscname|- iconnr|-1
  76.  
  77. Dabei bedeuten:
  78.  
  79.     prgname    z.B. jinnee.prg
  80.     ftyp        z.B. *.JIC oder *.JINC oder ICONS.INF
  81.     rscname    s.o.
  82.     iconnr    s.o.
  83.  
  84. Beispiel:
  85.  
  86.     mod_app -Cid papillon *.x - -1
  87.  
  88. Trägt den Dateityp "*.x" für das Programm "Papillon" ein, und zwar mit
  89. dem Default-Icon für Dateien.
  90.  
  91.  
  92. Rückgabewerte
  93. -------------
  94.  
  95.     0                OK
  96.     < 0                Systemfehler
  97.     1                Syntaxfehler beim Aufruf
  98.     2                Formatfehler in APPLICAT.INF
  99.     3                Kennung schon vergeben
  100.     4                Applikation nicht eingetragen (-Xid)
  101.     5                Pfad für Applikation fehlt (-Xid)
  102.  
  103.  
  104. Bemerkungen
  105. -----------
  106.  
  107. - Wenn Dateitypen angemeldet werden sollen, mu₧ MOD_APP mehrmals 
  108.   aufgerufen werden. Bei jedem Aufruf kann man anhand des 
  109.   Rückgabewerts feststellen, ob der Dateityp schon anderweitig 
  110.   zugewiesen wurde.
  111. - Einige Fehler können von MOD_APP nicht erkannt werden. Beim 
  112.   nächsten Start des AES werden diese Fehler aber automatisch 
  113.   korrigiert (hoffentlich...).
  114. - Alle Änderungen, die MOD_APP durchführen kann, sind ausschlie₧lich 
  115.   konstruktiv. Es können keine Applikationen abgemeldet oder 
  116.   Dateitypen ab- oder umgemeldet werden. Wenn also ein Dateityp schon 
  117.   belegt ist, so sollte eine Fehlermeldung ausgegeben werden, damit 
  118.   der Anwender ggf. den Typ manuell ändern kann.
  119.