XML - Statements PARSE XML und REQUEST DOCUMENT aktivieren/deaktivieren

#### Search Results

Search

# 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:

1. Als Voraussetzung für die Benutzung des Profilparameters `XML` muss der Profilparameter `CFICU` auf `CFICU=ON` gesetzt werden.
2. 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

`PARSE` | `RDCP` | `RDIPV6` | `RDNOP` | `RDOC` | `RDP` | `RDPPORT` | `RDPPOV6` | `RDPS` | `RDPSV6` | `RDPV6` | `RDSPORT` | `RDSPOV6` | `RDTOUT` | `RDV4MAP` |

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
--- | ---
`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:

1. Dieser Schlüsselwort-Subparameter ist zurzeit nur für z/OS verfügbar.
2. 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/OS) unterstützt.

Wert | Erklärung
--- | ---
`0` | Natural leistet keine Zeitüberschreitungskontrolle. Es gelten 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 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/OS) 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`, `RDSPOV6` `RDPSV6` 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`, `RDSPOV6` `RDPSV6` und `RDPS` sind zurzeit nur für z/OS verfügbar.

### On this page

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