Anmerkung: Die veraltete Syntax des Start-Konstrukts ist am Ende dieses Dokuments beschrieben. Diese Beschreibung sollte nur noch zum Veständnis bestehender Anweisungen herangezogen werden. Bei der Codierung neuer Start-Anweisungen verwenden Sie bitte nur noch die aktuelle Syntax.
EXEC TAA START [<servicetyp> SERVICE] <servicename> IN <anwendung>][.<operation>] [SUSPEND FOR [DATE] < literal> | <Feldangabe> ] [STARTMODE { REGISTERONLY | DIRECT }] [ATTACH DOCUMENTS] [STATE-ERROR = < literal> ] [STATE-OK = < literal> ] [GEVOID = CONSECUTIVE] [GEVO-PROPERTIES <prop-1> [ = < literal> | <Feldangabe> ] [, <prop-n> [ = < literal> | <Feldangabe>]] ... ] [WITH <parameter1> = <objekt1> [AND <parameter2> = <objekt2>] ... ] END-EXEC <Feldangabe> = {COBOL-Variable | <objektname>.<feldname>[(indices)]}
Mit der Anweisung START können Verarbeitungen asynchron gestartet werden. Die asynchron gestartete Anwendung wird u.U. auf einer anderen Plattform ausgeführt als die startende Anwendung.
Voraussetzungen dafür, dass ein Baustein gestartet werden darf, sind:
Da für einige Angaben der START-Anweisung genaue Formatvorgaben einzuhalten sind, empfiehlt es sich, Start-Anweisungen nicht manuell zu codieren, sondern diese in ein Steuerungsmodul zu verlagern und von Control-Edge generieren zu lassen. Wenn Sie dennoch eine START-Anweisung manuell erstellen, sollten Sie für die formatgebundenen Angaben eine entsprechende Datenstruktur (z.B. „SYSTEMVARIABLEN“) verwenden, da ansonsten Probleme auftreten können, die sich erst beim Anlauf der gestarteten Verarbeitung bemerkbar machen.
Wenn eine Geschäftsvorfall-Steuerung (GSTR; GEVO oder GVTL) gestartet wírd, wird im Rahmen des Start-Konstrukts die Gevo-ID für diesen neuen Gevo ermittelt. Diese kann in dem Feld TC-START-GEVOID abgefragt werden.
Die Angabe des zu startenden Bausteins sowie die Übergabe der Parameterobjekte erfolgen in derselben Syntax wie beim Aufruf eines Bausteins (CALL). Die zu übergebenden Objekte müssen hinter den Gevo-Properties angeben werden, also am Ende der START-Anweisung.
Die Argumente INIT-WFLSTATE, ATTACH DOCUMENTS, STATE-ERROR, STATE-OK, GEVOID SUSPEND FOR und STARTMODE können in beliebiger Reihenfolgen angegeben werden, müssen aber vor der Angabe der Workflow-Eigenschaften stehen.
INIT-WFLSTATE: obsolet, wird ignoriert.
Die mit Fußnote[a] versehenen Argumente sind nicht bei der Hallesche verfügbar.
Anschliessend werden die Workflow-Eigenschaften übergeben, eingeleitet durch das Schlüsselwork GEVO-PROPERTIES. Wird mehr als eine Eigenschaft angegeben, werden die Angaben durch Komma getrennt.
Wird nur <prop> angegeben, so wird der Eigenschaft der zur Laufzeit aktuelle Wert zugewiesen. Diese Angabe ist nur zulässig, wenn diese Eigenschaft auch in der Schnittstelle des aufrufenden Moduls definiert ist.
Einigen Workflow-Properties sind TAA-Systemproperties zugeordnet, die bei der Bearbeitung eines Start-Requests ausgewertet werden. Davon werden wiederum einige bei Ausführung des Start-Konstruktus automatisch mit den Werten bestückt, sofern sich nicht in dem Start-Konstrukt explizit gesetzt sind.
Wflp-Name | automatisch bestückt | Entsprechung in alter Start-Syntax | Name der Systemproperty |
---|---|---|---|
KUNDE | aus aktuellem Modul | CLIENT | $BcCustomer |
ORDNUNGSBEGRIFF | aus aktuellem Modul | CATEGORY | $BcOrdinal |
VERMITTLER | aus aktuellem Modul | - | $BcAgent |
GEVO-VERANTWORTLICHER-OE | aus aktuellem Modul | GEVO-RESP | $BcRespOe |
PRUEFTAGE | - | CHECKDAYS | $BcCheckDays |
GEVONAME | - | GEVO-TYPE | $BcName |
PARTNER-NACHNAME | - | - | $BcCustomerLName |
PARTNER-VORNAME | - | - | $BcCustomerFName |
AKTUELLER-OE | - | CURRENT-RESP OE | $CurUserOE |
INFODATUM | - | - | $BcInfoDate |
Bei der Generierung des START werden für als Parameter zugewiesenen Objekte bestimmte Objektoperationen automatisch erzeugt, und zwar (vor Ausführung des Start):
Rolle (aufg. Modul) | Objektart (aufg. Modul) | Klasse (akt. Modul) | Rolle (akt. Modul) | Operation (akt. Modul) |
---|---|---|---|---|
REF MOD DEL | Parm Global | REC | MOD CRE DEL | PUT |
REF MOD DEL | Lokal | REC | - | PUT |
alle | alle | LST | - | keine |
EXEC TAA START [<servicetyp> SERVICE] <servicename> IN <anwendung>][.<operation>] [WITH <parameter1> = <objekt1> [AND <parameter2> = <objekt2>] ... ] [GEVO-RESP [<literal> | <Feldangabe>] [OE <literal> | <Feldangabe>] ] [CURRENT-RESP [<literal> | <Feldangabe> ] [OE < literal> | <Feldangabe> ] ] [GEVO-TYPE < literal> | <Feldangabe>] [GEVO-TITLE < literal> | <Feldangabe> ] [CLIENT < literal> | <Feldangabe> ] [CATEGORY < literal> | <Feldangabe> ] [INIT-WFLSTATE <literal> ] [CHECKDAYS < num. literal> | <num. cobol-variable >] [SUSPEND FOR [DATE] < literal> | <Feldangabe> ] [STARTMODE { REGISTERONLY | DIRECT }] [ATTACH DOCUMENTS] [STATE-ERROR = < literal>] [STATE-OK = < literal> ] END-EXEC
Die Angabe des zu startenden Bausteins sowie die Übergabe der Parameterobjekte erfolgen in derselben Syntax wie beim Aufruf eines Bausteins (CALL).
Die anderen Angaben sind:
GEVO-RESP OE SYSTVAR-000-OE-K-1 oder GEVO-RESP SYSTVAR-BEN-BEN-ID-1 OE SYSTVAR-000-OE-K-1 oder GEVO-RESP SYSTVAR-BEN-BEN-ID-1
Benutzername und OE können COBOL-Variablen oder Literale sein. Als Inhalt wird im Moment eine ID erwartet, die mit der Definition des Feld BEN-BEN-ID-1 bzw. 000-OE-K-1 in der SYSTEMVARIABLEN-Struktur übereinstimmt. Wird statt der ID ein Name angegeben, wird die Zuordnung zur Zeit noch nicht korrekt erfolgen.