Vorgaben für CICS XML Transformation Assistant (XSDBind) festlegen
Um Vorgaben für CICS® XML Transformation Assistant (XSDBind) festzulegen, öffnen Sie die Seite "XML Assistant" (XSDBind) in den Vorgaben von Enterprise Service Tools. Diese Optionen wirken sich auf die generierten XSDBind-Dateien und die Sprachstrukturdateien aus.
Diese Benutzervorgaben wirken sich auf die Generierung von Ressourcen nur aus, wenn Sie Dateien für die Laufzeitumgebung XML Transformation for CICS generieren. Die Vorgaben wirken sich nicht auf die Generierung von Ressourcen für andere Laufzeitumgebungen aus.
- Erweitern Sie im linken Teilfenster des Fensters 'Vorgaben' Enterprise Service Tools und wählen Sie XML-Assistent (XSDBind) aus.
- Ändern Sie die Vorgaben (die Vorgaben werden in den folgenden Abschnitten beschrieben).
- Klicken Sie anschließend auf OK.
XML-Assistent für Umsetzungen
Die Vorgaben auf dieser Seite wirken sich auf die Werte aus, die von Enterprise Service Tools als Eingabeparameter an den XML-Assistenten für Umsetzungen übergeben werden. Der XML-Umsetzungsassistent ist eine Gruppe von Stapeldienstprogrammen, die in CICS Transactions Server V5.2 oder höher bereitgestellt werden , die erforderlich sind, um einen neuen CICS XML-Umsetzungsservice zu erstellen.
- Assistent 'Neue XML-Umsetzung erstellen (Bottom-up)'
- Assistent 'Neue XML-Umsetzung erstellen (Top-down)'
- Befehlszeilen-Batch-Prozessor (siehe Batch-Prozessor )Hinweis: Der Assistent 'Vorhandene Serviceschnittstelle zuordnen (Meet-in-the-middle)' wird nicht unterstützt.
- DFHLS2SC generiert ein XML-Schema und eine XML-Bindungsdatei aus einer HLL-Datenstruktur.
- DFHSC2LS generiert eine oder mehrere HLL-Datenstruktur(en) und eine XML-Bindungsdatei aus (1) einem XML-Schema oder (2) aus dem Abschnitt für Typen einer WSDL-Datei.
- Eine XSDBind-Datei mit nativer Schnittstelle wird generiert, wenn Sie die interpretierende XML-Laufzeitkonvertierung auswählen.
- Eine XSDBind-Datei mit Vendor-Schnittstelle wird generiert, wenn Sie die compilergestützte XML-Laufzeitkonvertierung auswählen.
Vorgaben auf der Registerkarte 'Allgemein'
Die Vorgaben auf der Registerkarte Allgemein werden unabhängig vom ausgewählten Laufzeitszenario (Bottom-up, Meet-in-the-middle, Top-down) und unabhängig vom ausgewählten Typ der XML-Laufzeitkonvertierung (compilergestützt oder interpretierend) an den XML-Assistenten für Umsetzungen übergeben:
- Zuordnungsebene: (Dies wird im XML-Assistenten für Umsetzungen als Parameter MAPPING-LEVEL angezeigt)
- Diese Einstellung gibt die Version der von CICS und der Anwendung gemeinsam genutzten Programmschnittstelle an (siehe CICS® Transaction Server for z/OS®, Version 5 Release 4, IBM® Dokumentation ). Generell empfiehlt es sich, die höchste verfügbare Zuordnungsebene anzugeben:
- Die Zuordnungsebenen 1.0 bis 1.2 werden in CICS TS 3.1 mit angewendetem APAR PK23547 unterstützt.
- Zuordnungsebenen 1.0 bis 2.1 werden in CICS TS 3.2 mit angewendetem APAR PK59794 unterstützt.
- Zuordnungsebenen 1.0 bis 2.2 werden in CICS TS 3.2 mit angewendetem APAR PK69738 unterstützt.
- Die Zuordnungsebenen 1.0 bis 3.0 werden in CICS TS 4.1unterstützt.
- Die Zuordnungsebenen 1.0 bis 4.0 werden in CICS TS 5.2unterstützt.
- Zuordnungsebenen 1.0 bis 4.1 werden in CICS TS 5.3 mit angewendetem APAR PI67641 unterstützt.
Die Verwendung alter Zuordnungsebenen wird nur zum Neugenerieren der XML-Bindungsdateien für XML-Umsetzungsressourcen empfohlen, die zuvor mit einer alten Zuordnungsebene implementiert wurden.
- Mindestversion für Laufzeit: (Dies wird im XML-Assistenten für Umsetzungen als Parameter MINIMUM-RUNTIME-LEVEL angezeigt).
- Diese Vorgabe gibt die CICS -Mindestlaufzeitumgebung an, in der die XML-Bindungsdatei implementiert werden kann. Wenn Sie eine Version auswählen, die nicht mit den anderen von Ihnen angegebenen Parametern übereinstimmt, wird
eine Fehlernachricht angezeigt.
Der Wert, den Sie für diese Vorgabe auswählen, wird nur verwendet, wenn Sie auch die interpretierende XML-Laufzeitkonvertierung auswählen. Wenn Sie die compilergestützte XML-Laufzeitkonvertierung auswählen, wird vom Assistenten oder Dienstprogramm von Enterprise Service Tools stets VENDOR als Mindestversion für die Laufzeit festgelegt.
- MINIMUM
- Die niedrigstmögliche Laufzeitebene von CICS wird anhand der von Ihnen angegebenen Parameter automatisch zugeordnet.
- 3.0
- Die generierte XML-Bindungsdatei wird erfolgreich in CICS TS 4.1 implementiert.
- 4.0
- Die generierte Web-Service-Bindungsdatei wird erfolgreich in einer CICS TS 5.2 -Region oder höher implementiert. Bei dieser Laufzeitebene können Sie die Zuordnungsebene 4.0 oder früher für den Parameter MAPPING-LEVEL verwenden.
- 4.1
- Die generierte Web-Service-Bindungsdatei wird erfolgreich in einer CICS TS 5.3-Region oder höher implementiert. Bei dieser Laufzeitebene können Sie die Zuordnungsebene 4.1 oder eine ältere Version für den Parameter MAPPING-LEVEL verwenden.
- CURRENT
- Die generierte XML-Bindungsdatei wird erfolgreich in einer CICS -Region auf der höchsten verfügbaren Laufzeitebene implementiert, die Sie zum Generieren der XML-Bindungsdatei verwenden.
- CCSID: (Dies wird im XML-Assistenten für Umsetzungen als Parameter CCSID angezeigt)
Gibt die CCSID an, die während der Ausführungszeit für die Codierung von Daten verwendet wird, die zwischen dem Anwendungsprogramm und der XML-Bindungsdatei ausgetauscht werden. Der Wert dieses Parameters setzt den Wert des Systeminitialisierungsparameters LOCALCCSID außer Kraft. Der Wert muss eine EBCDIC-CCSID sein, die von Java™ -und z/OS -Konvertierungsservices unterstützt wird. Falls Sie diesen Parameter nicht angeben, verwendet das Anwendungsprogramm die im Systeminitialisierungsparameter angegebene CCSID, und die XML-Bindungsdatei wird in US EBCDIC (Cp037) codiert.
- Datenverkürzung: (Dies wird im XML-Assistenten für Umsetzungen als Parameter DATA-TRUNCATION angezeigt)
- Durch Auswahl dieser Option wird angegeben, wie der native CICS -Konvertierungsmechanismus abgeschnittene Daten handhabt. Bei der Einstellung ENABLED akzeptiert CICS abgeschnittene Anwendungsdaten und geht davon aus, dass fehlende Daten auf Nullen gesetzt sind. Die Einstellung ENABLED (AKTIVIERT) wird nur auf Zuordnungsebene 3.0 und höher unterstützt. Bei der Einstellung DISABLED weist CICS abgeschnittene Anwendungsdaten zurück und sendet eine Fehlernachricht. Der Standardwert ist DISABLED (INAKTIVIERT).
- Datenscreening: (Dies wird in XML Transformation Assistant als Parameter DATA-SCREENING angezeigt)
- Wählen Sie diese Option aus, um anzugeben, ob von der Anwendung bereitgestellte Daten auf Fehler überprüft werden. Ist sie aktiviert
(ENABLED), werden alle von der Anwendung bereitgestellten Laufzeitdaten, die mit der Sprachstruktur inkonsistent sind,
als Fehler behandelt und es wird die Nachricht
DFHPI1010ausgegeben. Eine Fehlerantwort wird an die Anwendung zurückgegeben. Ist die Option inaktiviert (DISABLED), werden Datenwerte in von der Anwendung bereitgestellten Laufzeitdaten, die mit der Sprachstruktur inkonsistent sind, durch Standardwerte ersetzt.
Vorgaben auf der Registerkarte 'DFHLS2SC'
Die Vorgaben auf der Registerkarte DFHLS2SC werden nur an den XML-Assistenten für Umsetzungen übergeben, wenn als Szenariotyp 'Neue Serviceschnittstelle erstellen (Bottom-up)' und als Typ der XML-Laufzeitkonvertierung 'interpretierend' ausgewählt wurde. (Das Batchprozessor-Äquivalent von 'Neue Serviceschnittstelle erstellen (Bottom-up)' ist das Element EISService.)
Diese Vorgaben sind nicht aktiviert, wenn die im Listenfeld Zuordnungsebene oder Mindestversion für Laufzeit auf der Registerkarte Allgemein ausgewählte Option sie nicht unterstützt.
- Variable Zeichenlänge: (Diese Vorgabe wird im XML-Assistenten für Umsetzungen als Parameter CHAR-VARYING angezeigt)
- Diese Vorgabe gibt an, wie Zeichenarrays in der Sprachstruktur zugeordnet werden, wenn die
Zuordnungsebene Version 1.2 oder höher ist.Hinweis: Diese Präferenz gilt nicht für Enterprise und andere PL/I Sprachstrukturen.
- NEIN
- Zeichenarrays werden einem xsd:string-Feld zugeordnet und als Felder fester Länge verarbeitet. Die maximale Datenlänge ist gleich der Länge des Arrays.
- NULL
- Zeichenarrays werden einem xsd:string-Feld zugeordnet und als auf null endende Arrays verarbeitet. CICS fügt bei der Umsetzung aus einer SOAP-Nachricht ein abschließendes Nullzeichen hinzu. Die maximale Länge der Zeichenfolge beträgt jeweils ein Zeichen weniger als die in der Sprachstruktur angegebene Länge.
- COLLAPSE
- XML-Zeichendatenbeschreibungen werden mit der Einstellung 'collapse' des Attributs whiteSpace generiert. Dieser Wert ist nur in den Zuordnungsebenen 1.2 und höher verfügbar. Dieser Wert ist der Standardwert für die Zuordnungsebenen 2.1 und höher.
- BINARY
- Sämtliche in der Sprachstruktur definierten Zeichenarrays werden in der WSDL xsd:base64Binary-Feldern fester Länge anstatt xsd:string-Feldern zugeordnet.
- Datum/Uhrzeit: (Diese Vorgabe wird im XML-Assistenten für Umsetzungen als Parameter DATETIME angezeigt)
- Diese Vorgabe gibt an, dass XML-Elemente in einem Bottom-up-Szenario zugeordnet werden und gilt nur für den interpretierenden Typ CICS (diese Vorgabe wird für den kompilierten Konvertierungstyp des Anbieters ignoriert). Durch Auswahl dieser Option wird festgelegt, wie die XML-Elemente vom Typ xsd:dateTime in das CICS ASKTIME-Format abgebildet werden. Gültige Wert sind
PACKED15 und UNUSED.Hinweis: Diese Vorgabe ist erst ab Zuordnungsebene 3.0 verfügbar.
- Zeichenvorkommen: (Diese werden in XML Transformation Assistant als Parameter: CHAR-OCCURS angezeigt)
- Diese Vorgabe gibt an, wie Zeichenarrays in der Sprachstruktur zugeordnet werden, wenn die
Zuordnungsebene 4.0 oder höher ist. Beispiel:PIC X OCCURS 20. Dieser Parameter wird nur für die Sprache COBOL verwendet.
- ARRAY
Zeichenarrays werden einem XML-Array zugeordnet, d. h., jedes Zeichen wird als einzelnes XML-Element zugeordnet. Dies gilt auch für das Verhalten auf den Zuordnungsebenen 3.0 und früher.
- ZEICHENFOLGE
Dies ist die Standardoption. Zeichenarrays werden einer XML-Zeichenfolge zugeordnet, d. h., das gesamte COBOL-Array wird als einzelnes XML-Element zugeordnet.
- ARRAY
- Zeichenverwendung: (Diese wird in XML Transformation Assistant als Parameter CHAR-USAGE angezeigt)
- In COBOL kann der nationale Datentyp, PIC N, für UTF-16- oder DBCS-Daten verwendet werden. Diese Einstellung wird
durch die NSYMBOL-Compileroption gesteuert. Sie müssen den Parameter CHAR-USAGE im Assistenten auf denselben
Wert wie die NSYMBOL-Compileroption festlegen, um sicherzustellen, dass die Daten ordnungsgemäß verarbeitet werden. Wenn Sie
UTF-16 verwenden, ist dies typischerweise
CHAR-USAGE=NATIONAL.- DBCS
Daten aus PIC (n)-Feldern werden als DBCS-codierte Daten behandelt.
- NATIONAL
Dies ist der Standardwert. Daten aus PIC (n)-Feldern werden als UTF-16-codierte Daten behandelt.
- DBCS
- Nullfelder abschneiden: (Dies wird in XML Transformation Assistant als Parameter TRUNCATE-NULL-ARRAYS angezeigt)
- Diese Vorgabe gibt an, wie strukturierte Arrays verarbeitet werden. Ist sie aktiviert, versucht CICS, leere Datensätze in einem Array zu erkennen.
- Nullfeldwerte abschneiden: (Dies wird in XML Transformation Assistant als Parameter TRUNCATE-NULL-ARRAY-VALUES angezeigt)
- Diese Vorgabe gibt an, welche Werte für die TRUNCATE-NULL-ARRAYS-Verarbeitung als leer behandelt werden. Wenn alle Speicherbytes in einem Datensatz eines strukturierten Arrays Nullen enthalten, wird angenommen, dass
der gesamte Datensatz leer ist. Mindestens ein NULL-, SPACE- und
ZERO-Wert kann in einer durch Kommas getrennten Liste angegeben werden.
- NULL
'0x00' oder Werte vom Typ LOW-VALUES werden als leer behandelt.
- SPACE
'0x40' wird als leer behandelt.
- ZERO
'0xF0' wird als leer behandelt.
- NULL
Vorgaben auf der Registerkarte 'DFHSC2LS'
Die Vorgaben auf der Registerkarte DFHSC2LS werden nur an den XML-Assistenten für Umsetzungen übergeben, wenn als Szenariotyp Neue XML-Umsetzung erstellen (Top-down) und als Typ der XML-Laufzeitkonvertierung 'interpretierend' ausgewählt wurde. (Das Batchprozessor-Äquivalent von Neue XML-Umsetzung erstellen (Bottom-up) ist das Element EISServiceImplementation.)
Diese Vorgaben sind nicht aktiviert, wenn die im Listenfeld Zuordnungsebene oder Mindestversion für Laufzeit auf der Registerkarte Allgemein ausgewählte Option sie nicht unterstützt.
- Variable Zeichenlänge: (Diese Vorgabe wird im XML-Assistenten für Umsetzungen als Parameter CHAR-VARYING angezeigt)
- Diese Vorgabe gibt an, wie Zeichendaten variabler Länge zugeordnet werden, wenn die Zuordnungsebene Version 1.2 ist. Binäre Datentypen variabler Länge werden stets einem Container oder einer variablen Struktur zugeordnet. Wenn dieser Parameter nicht angegeben wird, hängt die Standardzuordnung von der angegebenen Sprache ab.
- NEIN
- Zeichendaten variabler Länge werden als Zeichenfolgen fester Länge zugeordnet.
- NULL
- Zeichendaten variabler Länge werden auf null endenden Zeichenfolgen zugeordnet.
- JA
- Zeichendaten mit variabler Länge werden in PL/I dem Datentyp Char varying zugeordnet. In den Sprachen COBOL, C und C++ werden Zeichendaten mit variabler Länge einer äquivalenten Darstellung zugeordnet, die sich aus den zwei zusammengehörigen Elementen Datenlänge und Daten zusammensetzt.
- Begrenzung für Zeichenfolgen variabler Länge: (Dies wird im XML-Assistenten für Umsetzungen als Parameter CHAR-VARYING-LIMIT angezeigt)
- Diese Vorgabe gibt die maximale Größe von binären Daten und Zeichendaten variabler Länge an, die der Sprachstruktur
zugeordnet werden, wenn die Zuordnungsebene 1.2 ist. Der Wert kann im Bereich zwischen 0 und 32767 Byte liegen. Der Standardwert ist 32767 Byte.
Sind die Zeichen- oder Binärdaten länger als in diesem Parameter angegeben, werden sie einem Container zugeordnet. Der Containername wird dann in der generierten Sprachstruktur verwendet.
- Standardwert für maximale Zeichenfolgenlänge: (Dies wird im XML-Assistenten für Umsetzungen als Parameter DEFAULT-CHAR-MAXLENGTH angezeigt)
- Diese Vorgabe gibt die Standardarraylänge für Zeichendaten in Zuordnungen an, für die im Web-Service-Beschreibungsdokument keine Länge impliziert ist, wenn die Zuordnungsebene Version 1.2 ist. Der Wert kann eine positive Ganzzahl im Bereich von 1 bis 2147483647 sein.
- Zeichenmultiplikator: (Dies wird im XML-Assistenten für Umsetzungen als Parameter CHAR-MULTIPLIER angezeigt)
- Diese Vorgabe gibt die Anzahl von Byte an, die für jedes Zeichen zulässig ist, wenn die Zuordnungsebene
1.2 ist. Der Wert dieses Parameters kann eine positive Ganzzahl im Bereich von
1 bis 2147483647 sein. Alle nicht numerischen, zeichenbasierten Zuordnungen unterliegen diesem Multiplikator. Binäre, numerische, gezonte und gepackte Dezimalfelder unterliegen nicht diesem Multiplikator.
Dieser Parameter kann hilfreich sein, wenn Sie beispielsweise beabsichtigen, DBCS-Zeichen zu verwenden. In diesem Fall könnten Sie einen Multiplikator von 3 verwenden, um Platz für potenzielle DBCS-Start- und -Endezeichen um jedes Doppelbyte-Zeichen zur Ausführungszeit zu ermöglichen.
- Inline MaxOccurs Limit: (Dies wird im XML-Assistenten für Umsetzungen als Parameter INLINE-MAXOCCURS-LIMIT angezeigt)
- Mit dem über diese Vorgabe angegebenen Wert wird entschieden, ob variabler, wiederkehrender Inhalt basierend auf dem Wert des Attributs 'maxOccurs' aus der Quelle XML-Schema integriert wird. Eine vollständige Beschreibung finden Sie in folgendem Abschnitt:
- Datum/Uhrzeit: (Diese Vorgabe wird im XML-Assistenten für Umsetzungen als Parameter DATETIME angezeigt)
- Diese Vorgabe gibt an, dass XML-Elemente in einem Top-down-Szenario zugeordnet werden und nur für den interpretierenden Typ CICS gültig sind (diese Vorgabe wird für den kompilierten Konvertierungstyp des Anbieters ignoriert). Durch Auswahl dieser Option wird festgelegt, wie die XML-Elemente vom Typ xsd:dateTime in das CICS ASKTIME-Format abgebildet werden. Gültige Wert sind
PACKED15 und UNUSED.Hinweis: Diese Vorgabe ist erst ab Zuordnungsebene 3.0 verfügbar.
- Namensverkürzung: (Dies wird im XML-Assistenten für Umsetzungen als Parameter NAME-TRUNCATION angezeigt)
- Diese Vorgabe gibt an, wie ein generierter Feldname gekürzt wird, wenn er für die Verwendung
in der angegebenen höheren Programmiersprache zu lang ist. Diese Option ist in allen Zuordnungsebenen
verfügbar.
- Rechts
- Dies ist der Standardwert. Der Feldname wird von rechts abgeschnitten und es wird ein numerisches Suffix hinzugefügt, falls erforderlich.
- Links
- Der Feldname wird von links abgeschnitten und es wird ein numerisches Suffix hinzugefügt, falls erforderlich.
- 31-stellige Dezimalunterstützung: (Dies wird im XML-Assistenten für Umsetzungen als Parameter WIDE-COMP3 angezeigt)
- Diese Vorgabe steuert die maximale Größe der variablen Länge von gepackten Dezimalzahlen, die einer COBOL-Sprachstruktur zugeordnet wird. Wenn der Wert auf YES gesetzt ist, werden 31 Stellen für DECIMAL- und INTEGER-Typen verwendet. Ist der Wert auf NO (Standardwert) gesetzt, bleibt die Anzahl der Stellen bei 18. Diese Option ist in allen Zuordnungsebenen verfügbar.
- Weniger doppelte Namen: (Diese Vorgabe wird in XML Transformation Assistant als Parameter LESS-DUP-NAMES angezeigt)
- Nur für PL/I. Dieser Parameter generiert nicht strukturierte Strukturfeldnamen, die mit _value enden, um eine direkte Referenzierung des Feldes zu ermöglichen. Das Suffix _value wird nur angehängt, wenn ein Namenskonflikt zwischen dem strukturierten Namen und dem nicht strukturierten Namen besteht.
- Unterstreichungszeichen als Bindestriche: (Diese Vorgabe wird in XML Transformation Assistant als Parameter UNDERSCORES-AS-HYPHENS angezeigt)
- Nur für COBOL. Dieser Parameter konvertiert alle Unterstreichungszeichen im WSDL-Dokument in Bindestriche und nicht in das Zeichen X, um die Lesbarkeit der generierten COBOL-Sprachstrukturen zu verbessern. Falls Kollisionen bei Feldnamen auftreten, werden die Felder nummeriert, um ihre Eindeutigkeit sicherzustellen.
- Bindestriche als Unterstreichungszeichen: (Dies wird im XML Transformation Assistant als Parameter: HYPHEN-AS-UNDERSCORES angezeigt)
- Nur für PL/I. Dieser Parameter konvertiert alle Bindestriche im
WSDL-Dokument in Unterstreichungszeichen und nicht in das Zeichen
X, um die Lesbarkeit der generierten PL/I-Sprachstrukturen zu verbessern. Diese Option ist standardmäßig nicht ausgewählt. - Standardbruchteilstellen: (Diese werden in XML Transformation Assistant als Parameter: DEFAULT-FRACTGION-DIGITS angezeigt)
- Dieser Parameter gibt die Standardanzahl von Bruchteilstellen an, die im JSON-Dezimalschematyp
verwendet werden. Der Standardwert ist
3. Für COBOL ist der gültige Bereich0bis17oder0bis30, wenn der Parameter WIDE-COMP3 verwendet wird. Für C oder PL/I ist der gültige Bereich0bis30.