TaaDo: Ressourcengenerierung

Das Werkzeug TaaDo kennt folgende Aufrufsyntax:

   TaaDo [-a <Anwendung>] [-s <Stufe>] -g[Auftrag] 
         [-lo <LogFile>] 
         [-lr <ResultFile>] 
         [-dl <DocumentDir>] 
         [-ex <Befehlsdatei>] 
         [-n] 
         [-d <SearchOrder>]
         [-u <UpdateResourceAPI erzwingen>
         [<befehl>]
   oder
   TaaDo <befehl> <LogFile> <argumente> [-d <SearchOrder>][-u <UpdateResourceAPI erzwingen>]

Die Ausführung der Befehle wird über die Standardausgabe oder, falls angegeben, in die Log-Datei <LogFile> protokolliert. Falls angegeben, werden Befehle aus der Befehlsdatei zur Ausführung herangezogen. Der Syntax für Befehle aus dieser Datei entspricht dem Syntax der gleichen Befehle auf der Befehlszeile.

Die TaaDo-spezifischen Optionen bedeuten:

• -n: erzwingt die Erstellung einer neuen Resourcen-DLL.
• -d: kann benutzt werden, um die Standard-SearchOrder von 2 (Zuerst EDB, danach DLL) zu ändern.
• -dl: Name eines Verzeichnisses für Fehler-Dateien
• -lr: Name der Ergebnisdatei
• -u: erzwingt (1) oder verhindert (0) die Nutzung der Update-Resource-API. Default ist: UpdateResouceAPI wird benutzt für einzelne Generierungen (genres), sonst nicht.

• GenRes <Name> <Type> <Appl> <Dll>
• GenResKindOf <Type> <Appl> <Dll>
• GenResAll <Appl> <Dll>
• GenResAllOstr <Appl> <Dll>
• GenResAllModl <Appl> <Dll>
• GenResAllSyst <Appl> <Dll>
• GenResAllMldg <Appl> <Dll>
• GenResAllStab <Appl> <Dll>
• GenResAllStbc <Appl> <Dll>
• GenResVersion <Rc-File oder Res-File> <Appl> <Dll>
• GenResMeta ¹⁾

• GenWebs <Name> <Type> <Appl>
• Gen <Name> <Type> <Appl> <Variant> [<Options>]

• GenXmlForStab <StabName> <Appl>

• UpdateResFile <Name> <Type> <Appl> <Dll> <Static-File>

• EdbCheck <Name> <Type> <Appl> [recursive] [force] [<depth>]

Mit '#' beginnende Zeilen in der Befehlsdatei werden als Kommentar behandelt.

Die Argumente dieser Befehle haben folgende Bedeutung:

• Name: Name des Objekts, für das die Ressource generiert werden soll.
• Typ: Typ des Objekts.
• Appl: Anwendung, deren Ressourcen-Dll erstellt oder erweitert werden soll.
• Dll: Name der Sub-Dll, in die die Ressource generiert werden soll.
• Rc-File: Ein mit dem Resourcen-Compiler kompilierbares Resource Script, welches die Versionsinfo enthält.
• Res-File: Eine bereits kompilierte Ressourcen-Datei, die die Versionsinfo enthält.
• Static-File: Neue Datei der im statischen Dokument verwendet werden soll beim UpdateFileRes.

GenRes <Name> <Type> <Appl> <Dll>: generiert eine einzelne Resource.

GenResKindOf <Type> <Appl> <Dll>: generiert alle Ressourcen des genannten Typs zu der Anwendung.

GenResAllSyst <Appl> <Dll>: generiert alle anwendungsübergreifenden Informationen, die als Tabellenresource erzeugt werden und in der EDB mit dem Flag EDB_FLG_GEN_ASRES (0x10) versehen sind, z.B. Anwendung, Zustand, Operation, Globale Objekte, Parmeterobjekte.

GenResAll <Appl> <Dll>: generiert alle EDB-Informationen zu der Anwendung, d.h. alle mit GenResAllSyst erzeugten Daten sowie alle Module, Meldungsgruppen, Datenstrukturen (auch von Schlüsseltabellen), und Masken.

GenResAllStbc <Appl> <Dll>: generiert die Schlüsseltabellen-Inhalte. Abhängig von der Registry-Setting „Config/RefGenResOstr“ werden diese auch für Nutzung durch COBOL-Datenzugriffsmodule, mit zusätzlichen Kontrollinformationen, erzeugt (Typ STBO).

GenResVersion <Rc-File oder Res-File> <Appl> <Dll>: generiert die Versionsinformation aus der übergebenenen Ressourcendatei in die Dll.

GenResAllOstr <Appl> <Dll>
GenResAllModl <Appl> <Dll>
GenResAllMldg <Appl> <Dll>
GenResAllStab <Appl> <Dll>
generieren alle Ressourcen für zu der Anwendung definierte Objekte des im Befehlsnamen enthaltenen Typs.

 Gen <Name> <Type> <Appl> <Variant> [<Options>]   

Dieser Befehl erzeugt die COBOL-Implementierung für Module. Z.Zt. möglich nur für Steuerungen.

Die Argumente sind die gleichen wie bei Gen… (s. oben); zusätzlich kann die zu generierende Variante angegeben werden.

Als Optionen können für den Steuerungsgenerator angegeben werden (hintereinander, durch Leerzeichen getrennt):

• ANSI: Generierung im ANSI-Zeichensatz (Default)
• OEM: Generierung im OEM-Zeichensatz
• CONTINUE: CONTINUE-Anweisung in leeren Paragraphen erzeugen, zur Vermeidung von Compiler-Warnungen
• MINIDOC: Pseudocode-Kommentare erzeugen
• COMPANY²⁾: Company-Spezifischer Code. Zur Zeit sind die Werte „AL“ oder „HN“ bzw. „HKV“ bekannt. Wenn die Option nicht angegeben ist, wird das Company-Setting aus der Registry genutzt.

Beispiel:

  taado gen taado.log pg-gevo-test2 gstr twonly online ansi continue company:al

  GenWebs <Name> <Type> <Appl>

Dieser Befehl erzeugt für einen WebService die Dateitypen WSDL, ASMX, und GCSC. Die Namen der Ausgabedateien werden aus der EDB ermittelt.

  EdbCheck <Name> <Type> <Appl> [recursive] [force] [<depth>]

Die Argumente des Befehls haben folgende Bedeutung:

• Mit dem Literal recursive instruieren Sie den EDBCheck, neben dem Modul, auch alle aufgerufene Module und deren gerufene Module zu überprüfen.
  
• Mit dem Literal force bewirken Sie, dass Änderungen die EDBCheck an ein Modul vornimmt, in der EDB persistent gemacht werden. Ohne diese Angabe bleiben die Module unverändert.
  
• Bei <depth> geben sie eine Zahl an und steuern dabei, wie tief der EDBCheck rekursiv prüfen soll. Geben Sie hier z.B. eine '1' an, wird das Modul und seine gerufenen Module überprüft. Bei '2' werden dann auch noch die gerufenen Module der gerufenen Module überprüft.

 GenXmlForStab <StabName> <Appl>

Erstellt eine xml-Datei mit dem Inhalt der Schlüsseltabelle. Der Pfadname der Ausgabedatei wird aus der EDB ermittelt.

Die Argumente des Befehls haben folgende Bedeutung:

• Mit <STabName> geben Sie in Form eines dreistelligen Kürzels den Namen der Schlüsseltabelle an.
• Mit <Appl> geben Sie die Anwendung an, zu der das Modul gehört (z.B. aarch, levert, … ).

 UpdateResFile <Name> <Type> <Appl> <Dll> <Static-File>

Wenn beim TaaDo nur UpdateResFile-Befehle verarbeitet werden, wird nur den Inhalt der statischen Datei in statischen Dokumenten (SSSD) ersetzt. Es werden keine Anpassungen im internen Mapping und am Timestamp der DLX-Dateien vorgenommen. Dies kann also genutzt werden, um ohne Versionierung bestimmte Inhalte zu aktualisieren. Dies sollte man aber mit großer Vorsicht nutzen, weil in der Entwicklungsdatenbank nicht festgehalten wird, welcher Inhalt in der Resourcen-DLX enthalten ist. Deshalb ist dieses Aktualisieren des Inhalts nur erlaubt für statische Dokumenten, die dafür gekennzeichnet sind. Dieses Aktualisieren funktioniert auch nur, wenn man den UpdateAPI verwendet (also beim Starten von TaaDo die Option -u1 nutzt oder in der Registry mittels „trgCanUseUpdateResource“ die Verwendung der UpdateAPI eingeschaltet hat).

Wenn neben UpdateResFile auch andere Generierungen im TaaDo durchgeführt werden, verhält UpdateResFile sich genau so wie ein GenRes. Es ist deshalb für das Aktualisieren ohne Versionierung zwingend erforderlich, ausschließlich UpdateResFile-Befehle zu verwenden!

Erzeugt ein Makro in COBOL-Datendefinitionsformat mit Informationen über alle definierten globalen Objekte, welches in Ossy-Modulen eingebunden werden kann. Der Pfadname der Ausgabedatei wird aus der EDB ermittelt.

TaaDo erstellt, abhängig von den gesetzten Optionen, folgende Ausgabedateien:

• Ergebnis: Gesetzt mit der Option -lr. Enthält die Informationen darüber, welche Ressourcen erfolgreich generiert werden konnten.
• Fehler-Log: Verzeichnis gesetzt mit der Option -dl. Enthält pro aufgetretenem Fehler eine Datei mit Fehler-Informationen.
• Logfile: Enthält alle Meldungen zum Ablauf der Generierung, die nicht in das Ergebnislog oder die Fehler-Dateien geschrieben werden. Wenn kein Ergebnislog angegeben ist, werden auch die Ergebnisse in das Logfile protokolliert.

So entsteht zum Beispiel beim TaaDo mit einen Resourcengenerierungsauftrag für einen nicht vorhandene Grafik-Baustein eine Fehlerdatei mit diesen Inhalt:

 
   WARNING: taado (E004901)   Die Diagramm-Baustein "GK-SSDB-ERRORFIRST" kann nicht (mehr) geladen werden.

Und ein Verweis in der Ergebnisdatei, der auf diese Datei verweist:

# ResultReport Start
# 0;GK-SSBS-REQ6687;SSBS;TWONLY;;TaaDo;TaaDo/GENRES (DLL=TW, PF=32) Successfully generated;
# 13;GK-SSDB-ERRORFIRST;SSDB;TWONLY;;TaaDo;TaaDo/GENRES (DLL=TW, PF=32) Generatorfailure reported;c:\t\req5504\TWTWONLYSSDBGK-SSDB-ERRORFIRST.log
# 0;GK-SSDB-PIE;SSDB;TWONLY;;TaaDo;TaaDo/GENRES (DLL=TW, PF=32) Successfully generated;
# ResultReport End