This Natural profile parameter is used to activate/deactivate the
statements REQUEST
DOCUMENT
and PARSE
XML
. It corresponds to the
NTXML
macro
in the Natural parameter module.
Possible settings | See XML Parameter Syntax. | |
---|---|---|
Default setting | XML=(OFF) |
|
Dynamic specification | yes | The parameter XML can only be
specified dynamically. In the
Natural
parameter module, use the macro
NTXML .
|
Specification within session | no |
Notes:
XML
profile parameter, the profile parameter CFICU
must be set to
CFICU=ON
.
The following topics are covered below:
The XML
parameter is specified as
follows:
XML=(ON,keyword-subparameter=value,keyword-subparameter=value,...) |
Or:
XML=(OFF,keyword-subparameter=value,keyword-subparameter=value,...) |
Where:
Syntax Element / Value | Explanation |
---|---|
ON |
Enable XML support according to the
keyword subparameter
settings.
For the |
OFF |
Disable XML support. Any subparameter
settings are ignored.
This is the default value. |
keyword-subparameter |
Names and values of possible keyword subparameters; see Keyword Subparameters. |
The NTXML
macro is specified as follows:
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
Or:
NTXML OFF
For a description of the syntax elements, see XML Parameter Syntax.
PARSE
|
RDCP
|
RDIPV6
|
RDNOP
|
RDOC
|
RDP
|
RDPPORT
|
RDPPOV6
|
RDPS
|
RDPSV6
|
RDPV6
|
RDSPORT
|
RDSPOV6
|
RDTOUT
|
RDV4MAP
|
PARSE=value
enables/disables the support of the PARSE
XML
statement.
Value | Explanation |
---|---|
ON |
Use of the
PARSE XML statement is
supported.
|
OFF |
Use of the PARSE XML
statement is not supported.
This is the default value. |
RDCP=value
specifies the
default code page which is assumed if
code-page-in
in the REQUEST
DOCUMENT
statement contains only spaces.
Value | Explanation |
---|---|
code-page-name |
Name of the default code page. |
ISO 8859-1:1987 |
This is the default value. |
RDIPV6=value
enables/disables the support for IPv6 for the REQUEST DOCUMENT
statement.
Value | Explanation |
---|---|
ON |
Use of the IPv6 protocol is enabled, if available on the local host. |
OFF |
Use of the IPv6 protocol is disabled.
This is the default value. |
RDNOP=value
specifies
local domain(s) which are to be addressed directly, not via the proxy.
Value | Explanation |
---|---|
domain-name(s) |
Name(s) of local domains.
Notes:
|
OFF |
RDNOP=OFF means that no
URL is defined.
This is the default value. |
Note:
Specification of IPv6 address or IPv6 address prefixes is
possible.
RDOC=value
enables/disables the support of the REQUEST DOCUMENT
statement.
Value | Explanation |
---|---|
ON |
Use of the
REQUEST DOCUMENT
statement is supported.
|
OFF |
Use of the REQUEST
DOCUMENT statement is not supported.
This is the default value. |
RDP=value
specifies the
URL of the proxy server through which all internet (not intranet) HTTP requests
have to be routed.
Value | Explanation |
---|---|
url |
URL of the proxy server. Blanks are not allowed. |
OFF |
RDP=OFF means that no URL
is defined.
This is the default value. |
RDPPORT=value
specifies
the port number of the proxy, if any is set.
Value | Explanation |
---|---|
0 or 1 -
65535 |
Port number. |
80 |
This is the default value. |
RDPPOV6=value
specifies
the port number of the IPv6 proxy, if any is set.
Value | Explanation |
---|---|
0 or 1 -
65535 |
Port number. |
80 |
This is the default value. |
RDPS=value
specifies the
URL of the SSL proxy server through which all internet (not intranet) HTTPS
requests have to be routed.
Value | Explanation |
---|---|
url |
URL of the SSL proxy server. Blanks are not allowed. |
OFF |
RDPS=OFF means that no URL
is defined.
This is the default value. |
Note:
This keyword subparameter is currently for z/OS only.
RDPSV6=value
specifies the
URL of the IPv6 SSL proxy server through which all internet (not intranet)
HTTPS requests have to be routed.
Value | Explanation |
---|---|
url |
URL of the IPv6 SSL proxy server. Blanks are not allowed. |
OFF |
RDPSV6=OFF means that no
URL is defined.
This is the default value. |
Notes:
RDPV6=value
specifies the
URL of the IPv6 proxy server through which all internet (not intranet) HTTP
requests have to be routed.
Value | Explanation |
---|---|
url |
URL of the IPv6 proxy server. Blanks are not allowed. |
OFF |
RDPV6=OFF means that no
URL is defined.
This is the default value. |
Note:
Specification of an IPv6 address is possible.
RDSPORT=value
specifies
the port number of the SSL proxy, if any is set.
Value | Explanation |
---|---|
0 or 1 -
65535 |
Port number of the SSL proxy. |
443 |
This is the default value. |
Note:
This keyword subparameter is currently for z/OS only.
RDSPOV6=value
specifies
the port number of the IPv6 SSL proxy, if any is set.
Value | Explanation |
---|---|
0 or 1 -
65535 |
Port number of the IPv6 SSL proxy. |
443 |
This is the default value. |
Note:
This keyword subparameter is currently for z/OS only.
RDTOUT=value
specifies the
timeout (in seconds) for HTTP requests that are in progress.
This keyword subparameter is not supported by the IPv4-only load
modules NAT2TCP4
(z/OS) and NCFIP482
(z/VSE).
Value | Explanation |
---|---|
0 |
No timeout control provided by Natural,
the default settings apply.
This is the default value. |
1-32767 |
Time in seconds after which a timeout error is issued if one of the following socket functions cannot be completed within the specified interval: connect, send or receive. |
RDV4MAP=value
enables or
disables the use of IPv4-mapped IPv6 addresses for URLs in symbolic notation.
Numeric IPv4-mapped IPv6 addresses are always enabled in IPv6 mode.
This keyword subparameter is not supported by the IPv4-only load
modules NAT2TCP4
(z/OS) and NCFIP482
(z/VSE).
Value | Explanation |
---|---|
ON |
Enabled: IPv4-mapped addresses are allowed within the IPv6 protocol. |
OFF |
Disabled: IPv4-mapped addresses are not
allowed within the IPv6 protocol.
This is the default value. |
Use IPv4-mapped addresses only in IPv6 environments where no IPv4 TCP/IP stack (or dual stacking mode) is available to access IPv4-based HTTP servers. For detailed information on IPv4-mapped IPv6 addresses, refer to the appropriate IPv6 documentation.
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)
Note:
The keyword subparameters RDSPORT
,
RDSPOV6
, RDPSV6
and
RDPS
are currently for z/OS only.
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
Note:
The keyword subparameters RDSPORT
,
RDSPOV6
, RDPSV6
and
RDPS
are currently for z/OS only.