XML - Statements PARSE XML und REQUEST DOCUMENT aktivieren/deaktivieren

Dieser Natural-Profilparameter dient zum Aktivieren/Deaktivieren der Statements REQUEST DOCUMENT und PARSE XML. Dieser Profilparameter entspricht dem Makro NTXML im Natural-Parametermodul.

Mögliche Werte	Siehe XML-Parameter-Syntax.
Standard-Einstellung	`XML=(OFF)`
Dynamische Angabe	ja	Der Profilparameter `XML` kann nur dynamisch angegeben werden. Im Natural-Parametermodul wird das Makro `NTXML` verwendet.
Angabe innerhalb der Session	nein

Anmerkungen:

Als Voraussetzung für die Benutzung des Profilparameters XML muss der Profilparameter CFICU auf CFICU=ON gesetzt werden.
Siehe auch Statements für den Internet- und XML-Zugriff im Leitfaden zur Programmierung.

Dieses Dokument behandelt folgende Themen:

XML-Parameter-Syntax
NTXML-Makro-Syntax
Schlüsselwort-Subparameter
Beispiel für XML Parameter
Beispiel für NTXML Makro

XML-Parameter-Syntax

Der Profilparameter XML wird wie folgt angegeben:

XML=(ON,keyword-subparameter=value,keyword-subparameter=value,...)

Oder:

XML=(OFF,keyword-subparameter=value,keyword-subparameter=value,...)

Dabei ist:

Syntax-Element / Wert	Erklärung
`ON`	Aktivierung des XML-Supports gemäß der Subparameter-Einstellungen weiter unten. Für die Verwendung der Statements `PARSE XML` und `REQUEST DOCUMENT` müssen auch die Subparameter `RDOC` und `PARSE` auf `ON` gesetzt werden.
`OFF`	Deaktivierung des XML-Supports. Alle `XML`-Subparameter-Einstellungen werden ignoriert. Dies ist der Standardwert.
`keyword-subparameter`	Namen und Werte der Schlüsselwort-Subparameter siehe Schlüsselwort-Subparameter.

NTXML-Makro-Syntax

Das Makro NTXML wird wie folgt angegeben:

         NTXML ON                                                     *
               PARSE=value,                                           *
               RDCP=value,                                            *
               RDIPV6=value,                                          *
               RDNOP=value,                                           *
               RDP=value,                                             *
               RDOC=value,                                            *
               RDPPORT=value,                                         *
               RDPPOV6=value,                                         *
               RDPS=value,                                            *
               RDPSV6=value,                                          *
               RDPV6=value,                                           *
               RDSPORT=value,                                         *
               RDSPOV6=value,                                         *
               RDTOUT=value,                                          *
               RDV4MAP=value

Oder:

         NTXML OFF

Beschreibung der Syntax-Elemente siehe XML-Parameter-Syntax.

Schlüsselwort-Subparameter

Anmerkung:
Die Schlüsselwort-Subparameter RDPS, RDPSV6, RDSPORT und RDSPOV6, sind zurzeit nur für z/OS vorgesehen.

PARSE - Unterstützung des PARSE XML-Statements

PARSE=value aktiviert bzw. deaktviert die Unterstützung des Statements PARSE XML statement.

Wert	Erklärung
`ON`	Die Verwendung des Statements `PARSE XML` wird unterstützt.
`OFF`	Die Verwendung des Statements `PARSE XML` wird nicht unterstützt. Dies ist der Standardwert.

RDCP - Name der Standard-HTML-/XML-Codepage

RDCP=value dient zur Angabe der Standard-Codepage, die verwendet wird, wenn code-page-in im REQUEST DOCUMENT-Statement nur Leerzeichen enthält.

Wert	Erklärung
`code-page-name`	Name der Standard-Codepage.
`ISO 8859-1:1987`	Dies ist der Standardwert.

RDIPV6 - Unterstützung von IPv6 für das REQUEST DOCUMENT-Statement

RDIPV6=value aktiviert bzw. deaktiviert die Unterstützung des Protokolls IPv6 beim REQUEST DOCUMENT-Statement.

Wert	Erklärung
`ON`	Die Verwendung des Protokolls IPv6 wird unterstützt, falls es auf dem lokalen Host zur Verfügung steht.
`OFF`	Die Verwendung des Protokolls IPv6 wird nicht unterstützt. Dies ist der Standardwert.

RDNOP - Name der lokalen Domäne

RDNOP=value dient zur Angabe der lokalen Domäne(n), die direkt, d.h. nicht über den Proxy-Server, angesprochen werden soll(en).

Wert Erklärung

Wert	Erklärung
`domain-name(s)`	Name(n) der lokalen Domäne(n). Anmerkungen: Leerzeichen sind nicht zulässig. Stern-Notation für Präfixe kann nur in der Form `*.xxx` und nicht in der Form `.xxx` verwendet werden. Mehrere Namenseinträge müssen durch ein Semikolon (;) voneinander abgetrennt werden.
`OFF`	`RDNOP=OFF` bedeutet, dass keine URL definiert ist. Dies ist der Standardwert.

domain-name(s)

Name(n) der lokalen Domäne(n).

Anmerkungen:

Leerzeichen sind nicht zulässig.
Stern-Notation für Präfixe kann nur in der Form *.xxx und nicht in der Form .xxx verwendet werden.
Mehrere Namenseinträge müssen durch ein Semikolon (;) voneinander abgetrennt werden.

OFF

RDNOP=OFF bedeutet, dass keine URL definiert ist.

Dies ist der Standardwert.

Anmerkung:
Die Angabe einer IPv6-Adresse oder von IPv6-Adresspräfixen ist möglich.

RDOC - Unterstützung des REQUEST DOCUMENT-Statements

RDOC=value aktiviert bzw. deaktiviert die Unterstützung des Statements REQUEST DOCUMENT.

Wert	Erklärung
`ON`	Die Verwendung des Statements `REQUEST DOCUMENT` wird unterstützt.
`OFF`	Die Verwendung des Statements `REQUEST DOCUMENT` wird nicht unterstützt. Dies ist der Standardwert.

RDP - URL des Proxy-Servers

RDP=value dient zur Angabe der URL des Proxy-Servers, über den alle Internet-(nicht Intranet-)HTTP-Anfragen geleitet werden müssen.

Wert	Erklärung
`url`	URL des Proxy-Servers. Leerzeichen sind nicht zulässig.
`OFF`	`RDP=OFF` bedeutet, dass keine URL definiert ist. Dies ist der Standardwert.

RDPPORT - Proxy-Port-Nummer

RDPPORT=value dient zur Angabe der Proxy-Port-Nummer, falls gesetzt.

Value	Explanation
`0` oder `1 - 65535`	Port-Nummer.
`80`	Dies ist der Standardwert.

RDPPOV6 - IPv6-Proxy-Port-Nummer

RDPPOV6=value dient zur Angabe der Port-Nummer des IPv6-Proxy-Servers, falls gesetzt.

Wert	Erklärung
`0` oder `1 - 65535`	Port-Nummer.
`80`	Dies ist der Standardwert.

RDPS - URL des SSL-Proxy-Server

RDPS=value dient zur Angabe der URL des SSL-Proxy Servers, über den alle Internet-(nicht Intranet-)HTTP-Anfragen geleitet werden müssen.

Wert	Erklärung
`url`	URL des SSL-Proxy-Server. Leerzeichen sind nicht zulässig.
`OFF`	`RDPS=OFF` bedeutet, dass keine URL definiert ist. Dies ist der Standardwert.

Anmerkung:
Dieser Schlüsselwort-Subparameter ist zurzeit nur für z/OS verfügbar.

RDPSV6 - URL des IPv6-SSL-Proxy-Servers

RDPSV6=value dient zur Angabe der URL des IPv6-SSL-Proxy Servers, über den alle Internet-(nicht Intranet-)HTTP-Anfragen geleitet werden müssen.

Wert	Erklärung
`url`	URL des IPv6-SSL-Proxy-Servers. Leerzeichen sind nicht zulässig.
`OFF`	`RDPSV6=OFF` bedeutet, dass keine URL definiert ist. Dies ist der Standardwert.

Anmerkungen:

Dieser Schlüsselwort-Subparameter ist zurzeit nur für z/OS verfügbar.
Die Angabe einer nativen IPv6-Adresse in der URL-Notation ist möglich.

RDPV6 - URL des IPv6-Proxy-Servers

RDPV6=value dient zur Angabe der URL des IPv6-Proxy-Servers, über den alle Internet-(nicht Intranet-)HTTP-Anfragen geleitet werden müssen.

Wert	Erklärung
`url`	URL des IPv6-Proxy-Servers. Leerzeichen sind nicht zulässig.
`OFF`	`RDPV6=OFF` bedeutet, dass keine URL definiert ist. Dies ist der Standardwert.

Anmerkung:
Die Angabe einer IPv6-Adresse ist möglich.

RDSPORT – SSL Proxy Port-Nummer

RDSPORT=value dient zur Angabe der Port-Nummer des SSL-Proxy-Servers, falls gesetzt.

Wert	Erklärung
`0 - 65535`	Port-Nummer des SSL Proxy Server.
`443`	Dies ist der Standardwert.

Anmerkung:
Dieser Schlüsselwort-Subparameter ist zurzeit nur für z/OS verfügbar.

RDSPOV6 – IPv6-SSL-Proxy-Port-Nummer

RDSPOV6=value dient zur Angabe der Port-Nummer des IPv6-SSL-Proxy-Port-Servers, falls eine eingestellt ist.

Wert	Erklärung
`0` oder `1 - 65535`	Port-Nummer des IPv6-SSL-Proxy-Port-Servers.
`443`	Dies ist der Standardwert.

Anmerkung:
Dieser Schlüsselwort-Subparameter ist zurzeit nur für z/OS verfügbar.

RDTOUT - Zeitüberschreitungswert für laufende HTTP-Anfragen

RDTOUT=value dient zur Angabe des Zeitüberschreitungswerts (in Sekunden) für in Ausführung befindliche HTTP-Anfragen.

Dieser Schlüsselwort-Subparameter wird nicht durch die nur für IPv4 vorgesehenen Lademodule NAT2TCP4 (z/VSE) und NCFIP482 (BS2000) unterstützt.

Wert	Erklärung
`0`	Natural leistet keine Zeitüberschreitungskontrolle. Es gelten die Standardeinstellungen. Dies ist der Standardwert.
`1-32767`	Zeit in Sekunden, nach der ein Zeitüberschreitungsfehler ausgegeben wird, wenn eine der folgenden Socket-Funktionen nicht innerhalb des angegebenen Zeitintervalls ausgeführt werden kann: Verbinden, Senden oder Empfangen.

RDV4MAP - Unterstützung von in IPv4 abgebildeten Adressen unter IPv6

RDV4MAP=value aktiviert bzw. deaktiviert die Verwendung von in IPv4 abgebildeten IPv6-Adressen für URLs in symbolischer Notation. Numerische, in IPv4 abgebildete IPv6-Adressen werden im IPv6-Modus immer zugelassen.

Dieser Schlüsselwort-Subparameter wird nicht durch die nur für IPv4 vorgesehenen Lademodule NAT2TCP4 (z/VSE) und NCFIP482 (BS2000) unterstützt.

Wert	Erklärung
`ON`	Aktiviert: In IPv4 abgebildete Adressen sind im IPv6-Protokoll zugelassen.
`OFF`	Deaktiviert: In IPv4 abgebildete Adressen sind im IPv6-Protokoll nicht zugelassen. Dies ist der Standardwert.

Aus Sicherheitsgründen:

Verwenden Sie in IPv4 abgebildete nur in IPv6-Umgebungen, in denen kein IPv4 TCP/IP Stack (oder Dual Stacking Mode) zur Verfügung steht, um auf IPv4-basierte HTTP-Server zuzugreifen. Weitere Informationen zu in IPv4 abgebildeten IPv6-Adressen siehe entsprechende IPv6-Dokumentation.

Beispiel für XML Parameter

XML=(ON,RDP='HTTPPROXY.MYCOMPANY.COM',RDPPORT=8080,RDPS='SSLPROXY.MYCOMPANY.COM',RDSPORT=443,RDNOP='*.MYCOMPANY.COM',RDOC=ON,PARSE=ON)

XML=(ON,RDP='HTTPPROXY.MYCOMPANY.COM',RDPPORT=8080,RDPS='SSLPROXY.MYCOMPANY.COM',RDSPORT=443,RDNOP='*.MYCOMPANY.COM;2AE0:4899:200:1E00:',
     RDOC=ON,PARSE=ON,RDIPV6=ON,RDPV6='V6HTTPPROXY.MYCOMPANY.COM',RDPPOV6=888)

Anmerkung:
Die Schlüsselwort-Subparameter RDSPORT, RDSPOV6RDPSV6 und RDPS sind zurzeit nur für z/OS verfügbar.

Beispiel für NTXML Makro

         NTXML ON,RDP=HTTPPROXY.MYCOMPANY.COM,                         *
               RDPPORT=8080,                                           *
               RDPS=SSLPROXY.MYCOMPANY.COM,                            *
               RDSPORT=443,                                            *
               RDNOP=*.MYCOMPANY.COM,                                  *
               RDOC=ON,                                                *
               PARSE=ON

         NTXML ON,RDP=HTTPPROXY.MYCOMPANY.COM,                         *
               RDPPORT=8080,                                           *
               RDPS=SSLPROXY.MYCOMPANY.COM,                            *
               RDSPORT=443,                                            *
               RDNOP=*.MYCOMPANY.COM,                                  *
               RDOC=ON,                                                *
               RDIPV6=ON,                                              *
               RDPV6=V6HTTPPROXY.MYCOMPANY.COM,                        *
               RDPSV6=V6SSLPROXY.MYCOMPANY.COM,                        *
               RDSPOV6=8443

Anmerkung:
Die Schlüsselwort-Subparameter RDSPORT, RDSPOV6RDPSV6 und RDPS sind zurzeit nur für z/OS verfügbar.