Inhaltsverzeichnis

Technische Beschreibung der Request-Struktur

Verwendet z.B. für den Datenstrom des START-Konstrukts.

Versionen

Request-Blobs können in den Versionen 1-5 verarbeitet werden. Die nur für eine bestimmte Version geltenden Inhalte sind durch Fußnoten gekennzeichnet.

Version 4 enthält keine Änderungen im Format. Allerdings wird ab Version 4 die EnvVersionID unverändert als Bezeichnung der Config-Unit übernommen. Bis Version 4 wird sie umformatiert in <Anwendung>_<EnvVersionID>, außer EnvVersionID= „A“, was ignoriert wird.

Version 5 betrifft nur die Speicherung von Objekten.

Datenstrom

Der Datenstrom ist aufgebaut aus

Strings werden dargestellt durch ein vorangestelltes Wort (2 Byte) welches die Länge des Strings angibt. Es folgen dann exakt soviele Bytes wie angegeben. Ein Nullterminator wird nicht mittransferiert und ist somit in der Länge nicht berücksichtigt.

Listen werden in Form von TAA-Collections übergeben. Diese beginnen immer mit einen TAA-Collection Header.

Alternative Darstellung als XML: Requeststruktur als XML

Allgemeine Informationen

Version 2 ff.
LängeDatentypNameBedeutungUrsprung/Cobol: Feld in TXTAA
1ByteKompressionEBCDIC Space [0x40] = Keine Kompression,
EBCDIC „C“ [0xC3) = Kompression
Konstante
4Dword1)CodepageCodepage-Indikator ist im Big-Endian Format gespeichert. Falls die Codepage mit 273 angegeben ist, sind alle mit Datentyp Long angegebenen Zahlen in Big-Endian Format gespeichert. Alle Character-Daten sind in der EBCDIC Codepage 273 Deutsch dargestellt. Andernfalls liegen Zahlen im Little-Endian Format, Character in ANSI vor. Die Differenzierung beginnt ab dem Feld welches dem Codepage-Indikator folgt. Konstante
4 2)Dwordkomprimierte LängeLänge des folgenden, komprimierten Datenblobserrechnet von Komprimierungsroutine
4LongVersionVersion des RequestKonstante
2+nStringOriginSystem, wo der Request erstellt wurde, z.B. 'TAAIM-MVS'Konstante
2+nStringEnvironment VersionKonfigurationseinheitKonstante
2+nTimestampString im Format JJJJ-MM-DD-HH.MM.SS.MMMNNNTX-TAA-TIMESTAMP
2+nModulnameLangname des auszuführenden ModulsTX-IM-MODL-NAME
2+nModultypTyp des auszuführenden ModulsTX-IM-BSTN
2+nApplicationAnwendungdes auszuführenden ModulsTX-IM-APPL
2+nOperationOperation, die in dem Modul ausgeführt werden sollTX-IM-EVENT
2+nsTRINGMDateÄnderungsdatum des aufrufenden ModulsTX-IM-START-MDATE
4LongRegisterOnly0 = nur registrieren, 1 = Ausführung direkt anstoßen
in TX-IM-STARTMODE 'R' (registeronly) oder 'D' (direct)
TX-IM-START-STARTMODE
4LongWorkflowstateWorkflowstate des zu initiierenden Gevos, entfällt ab Version 6TX-IM-START-WFLSTATE

Es folgen: Start-Properties

Version 1 (obsolet)

Version 1 enthält div. Informationen, die ab Version 2 in Form von Start-Properties übergeben werden:

LängeDatentypNameBedeutungUrsprung/Cobol: Feld in TXTAA
1ByteKompressionEBCDIC Space [0x40] = Keine Kompression,
EBCDIC „C“ [0xC3) = Kompression
Konstante
4DwordCodepageCodepage-Indikator ist im Big-Endian Format gespeichert. Falls die Codepage mit 273 angegeben ist, sind alle mit Datentyp Long angegebenen Zahlen in Big-Endian Format gespeichert. Alle Character-Daten sind in der EBCDIC Codepage 273 Deutsch dargestellt. Andernfalls liegen Zahlen im Little-Endian Format, Character in ANSI vor. Die Differenzierung beginnt ab dem Feld welches dem Codepage-Indikator folgt. Konstante
4 3)Dwordkomprimierte LängeLänge des folgenden, komprimierten Datenblobserrechnet von Komprimierungsroutine
4LongVersionVersion des RequestKonstante
2+nStringOriginSystem, wo der Request erstellt wurde, z.B. 'TAAIM-MVS'Konstante
2+nStringEnvironment VersionKonfigurationseinheitKonstante
2+nTimestampString im Format JJJJ-MM-DD-HH.MM.SS.MMMNNNTX-TAA-TIMESTAMP
2+nModulnameLangname des auszuführenden ModulsTX-IM-MODL-NAME
2+nModultypTyp des auszuführenden ModulsTX-IM-BSTN
2+nApplicationAnwendungdes auszuführenden ModulsTX-IM-APPL
2+nOperationOperation, die in dem Modul ausgeführt werden sollTX-IM-EVENT
2+nsTRINGMDateÄnderungsdatum des aufrufenden ModulsTX-IM-START-MDATE
2+nStringNur V1: Gevo KurznameGevokurzbezeichnungTX-IM-START-GEVOT-ANW-KURZ/TX-IM-START-GVT-GEVOT-KURZ
2+nStringNur V1: Gevo LangnameGevolangbezeichnungTX-IM-START-GEVOTITLE
2+nStringNur V1: Gevo IDGevo-ID des zu startenden GevosTX-IM-START-GEVOID
2+nStringNur V1: Parent Gevo IDGevo-ID des rufenden GevosTX-IM-START-PARENTID
4LongRegisterOnly0 = nur registrieren, 1 = Ausführung direkt anstoßen
in TX-IM-STARTMODE 'R' (registeronly) oder 'D' (direct)
TX-IM-START-STARTMODE
4LongWorkflowstateWorkflowstate des zu initiierenden GevosTX-IM-START-WFLSTATE
2+nStringNur V1: ClientPartnernummerTX-IM-START-CLIENT
Wflp: $BcCustomer
2+nStringNur V1: CategoryOrdnungsbegriffTX-IM-START-CATEGORY
Wflp: $BcOrdinal
2+nStringNur V1: AgentVermittlernummerTX-IM-START-AGENT
Wflp: $BcAgent
2+nStringNur V1: Gevo OEOrganisationseinheit, mit der der Gevo registriert werden sollTX-IM-START-GEVORESP-OE
Wflp: $BcRespOe
2+nStringNur V1: Gevo UserBentzer, mit dem der Gevo registriert werden sollTX-IM-START-GEVORESP-BID
Wflp: $BcRespOeUser
2+nStringNur V1: Current OEAktuelle OrganisationseinheitTX-IM-START-CURRRESP-OE
Wflp: $CurUserOE
2+nStringNur V1: Gevo UserAktueller BentzerTX-IM-START-CURRRESP-BID
Wflp: $CurUserOE
2+nStringNur V1: CheckdateWiedervorlagedatumTX-IM-START-SUSPENDDATE
4LongNur V1: CheckdaysPrüfdatumWflp: $BcCheckDays

START-Properties

Dieser Abschnitt ist in Request-Blobs ab Version 2 enthalten.

LängeDatentypNameBedeutungUrsprung/Cobol: Feld in TX-STARTPROPS
4LongAnzahl PropertiesAnzahl der Start-PropertiesTX-STARTPROPS-COUNT
4LongGesamtlänge der Daten Länge des Headers und der enhalteten Daten, excl. diesem Längenfeld.
TAA Collection Header , anschließend pro Property ein Collection Item:
4LongLängeLänge des Collection-Itemserrechnet
4 LongVersionVersion des Collection-Items, z.Zt. 1Konstante
2+nStringNameName der PropertyTX-STARTPROP-NAME(n)
4LongSysIDSystem-ID bei System-Property, sonst 0TX-STARTPROP-SYSID(n)
4LongFlagsFlags, z.B. numerisch/alphanumerischTX-STARTPROP-FLAGS(n)
wenn nummerisch:
4LongValueNummerischer Inhalt der PropertyTX-STARTPROP-VAL-N(n)
wenn alphanummerisch:
2+nStringValueAlphanummerischer Inhalt der PropertyTX-STARTPROP-VAL-N(n)

Objekte

Bis Version 4:

LängeDatentypNameBedeutungUrsprung/Cobol: Feld in TX-TAA
4LongAnzahl Anzahl TAA_ObjekteTX-IM-NOF-ASSIGNMENTS
4LongGesamtlänge der Daten Länge des Headers und der enhalteten Daten, excl. diesem Längenfeld.
TAA Collection Header , anschließend pro Property ein Collection Item:
4LongLängeLänge des Collection-Itemserrechnet
4 LongVersionVersion des Objekt-Items, immer = 1Konstante
2+nStringNameName des TAA-ObjektsTX-IM-OBJ-NAME(n)
2+nStringGenDateGenerierungsdatum der Datenstruktur des TAA-ObjektsTX-IM-OBJ-STRUCT-DATE(n)
2+nStringDstrNameName der Datenstruktur des TAA-ObjektsTX-IM-OBJ-STRUCT-NAME(n)
4LongSingle1 = REC-Objekt, 2 = LST/REF-ObjektTX-IM-OBJ-CLASS(n)
wenn LST oder REF:
4LongGesamtlänge der Daten Länge des Headers und der enhalteten Daten, excl. diesem Längenfeld.
TAA Collection Header , anschließend pro Objektsatz ein Collection Item:
4LongItemLengthLänge der Daten in diesem Collectionitem, excl. diesem Längenfeldberechnet
4LongDateLengthLänge des Imhalts dieses Satzes
4ByteDataSatzinhalt
wenn REC:
4LongDateLengthLänge des Imhalts dieses Satzes
4ByteDataSatzinhalt

Ab Version 5:

LängeDatentypNameBedeutungUrsprung/Cobol: Feld in TX-TAA
4LongAnzahl Anzahl TAA_ObjekteTX-IM-NOF-ASSIGNMENTS
4LongGesamtlänge der Daten Länge des Headers und der enhalteten Daten, excl. diesem Längenfeld.
TAA Collection Header , anschließend pro Property ein Collection Item:
4LongLängeLänge des Collection-Itemserrechnet
4 LongVersionVersion des Objekt-Items. 1, 2 oder 3Konstante
2+nStringNameName des TAA-ObjektsTX-IM-OBJ-NAME(n)
2+nStringApplAnwendung des TAA-Objektskann leer sein
2+nStringObjtObjekttyp des TAA-Objekts
2+nStringClassObjektklasse des TAA-Objekts (REC, LST, REF)
2+nStringDstrNameName der Datenstruktur des TAA-ObjektsTX-IM-OBJ-STRUCT-NAME(n)
2+nStringGenDateGenerierungsdatum der Datenstruktur des TAA-ObjektsTX-IM-OBJ-STRUCT-DATE(n)
4LongLängeLänge der Datenstruktur(Length of …-REC)
4LongNoItemsAnzahl Items
pro Objektsatz:
nByteDataObjektdaten in der Länge der Datenstruktur, wie oben angegeben
für das Objekt:
Bei Objektitem-Version >= 2:
Serialisierte Blobs (Länge und Daten), oder Null:
4DwordGesamtlänge aller Blobs
nByte Wenn Länge > 0: Blobs
Bei Objektitem-Version >= 3:
Serialisierte Beschreibung des Objekttyps (Länge und Daten), oder Null:
4DwordLänge der Objekttypsbeschreibung
nByte Wenn Länge > 0: Objekttypbeschreibung
Serialisierte Beschreibung der Datenstruktur (Länge und Daten), oder Null:
4DwordLänge der Datenstrukturbeschreibung
nByte Wenn Länge > 0: Datenstrukturbeschreibung

Dokumente

Ab Versión 3:

LängeDatentypNameBedeutungInhalt/abgeleitet aus
4LongDokumente?1, wenn Dokumente übergeben werden, sonst 0
TAA Collection Header , anschließend pro Dokument ein Collection Item:
4LongLängeLänge des Collection-Itemserrechnet
4LongVersionVersion des Dokument-Items, z.Zt. = 7Konstante
4LongSgut-HandleHandle auf Schriftgutdarf nicht null sein
4LongSgut-DefDefinition vorhanden (0=nein, 1=ja)?immer 0, da kein CTV-Modul zugrunde liegt
2+nStringNameName des DokumentsDokument-Titel
2+nStringApplAnwendung, zu der das Dokument gehörtzur Laufzeit aktive Anwendung
2+nStringBundleBündel, zu dem das Dokument gehört
4LongFlagsEigenschaften-FlagsCTR_SGUT_ISDOC
CTR_SGUT_DYNAMIC
CTR_SGUT_IMMUTABLE
(~CTR_SGUT_VARISET & ~CTR_SGUT_GNVRSET)
CTR_SGUT_ISDIRTY
4LongIDeindeutige Schriftgut-ID (taaImBcUniqueIDGet)
2+nStringOperationOperationleer
2+nStringTagTagleer
2+nStringUserDataBenutzerdatenleer
8ByteMaskMaskeleer
4LongParentHandle von Parent-Sgut0
4LongCtrNgenHandle auf Ctr-Ngen0
TAA Collection Header für im Schriftgut enthaltenes Schriftgutleer
4LongFlagTxtkTextkonserve vorhanden? hier: 1
Beschreibung der Textkonserve:
4LongVersionRes-Version Textkonservez.Zt. 3
4LongHtxtkHandle auf Textkonservedarf nicht null sein
4LongTxtkDefDefinition der Textkonserve vorhanden?0
4LongParentHandle auf Parentdarf nicht null sein
4LongFlagsFlags zur Textkonserve(CTR_TXTK_FIXED
CTR_TXTK_READONLY
CTR_TXTK_ISDIRTY) &
~CTR_TXTK_TXTPSET &
~CTR_TXTK_TXTFSET
2+nStringTypeDateitypFile Extension aus Pfadnamen
4LongLängeLänge des Textinhalts
nBytesDataTextinhalt, Länge wie oben angegeben
Zum Schriftgut gehörige Symtab:
4LongVersionRes-Version Symtabz.Zt. 2
4LonghSymTabHandle auf Symtabkann null sein
TAA Collection Header für enthaltene Symboleleer
Zum Schriftgut gehörige Zuweisungen:
TAA Collection Header für enthaltene Zuweisungenleer

TAA Collection Header

Der Collection Header steht immer vor eine Aufzählung von Request-Bestandteilen, z.N. Start-Properties oder Objekten. Er wird hier einmalig beschieben:

Länge Datentyp Name Bedeutung / Wert im Requestblob
4 Long Version 1
4 Long Callback Function 1
4 Long User Data 0
4 Long Current Item Index des aktuellen Items
4 Long Itemcount Anzahl Items in der Liste

Alternative Darstellung als XML: TAACollectionHeader als XML

Blobs

Alle Inhalte aus Blob- oder Clob-Feldern in einem Objekt werden direkt hintereinander serialisiert:

Länge Datentyp Bedeutung / Wert im Requestblob
pro Blob:
4 Long Länge des Blobs
n ByteWenn Länge > 0: Blob Data
1)
unsigned Long
2) , 3)
nur bei komprimiertem Blob