
	Version 4.2.6 for Mainframes	SEARCH INDEX CONTENTS \| PDF PAGE PDF BOOKS \| HOME UP PREV NEXT

— Parameter Reference —

XML - Activate PARSE XML and REQUEST DOCUMENT Statements

This Natural profile parameter is used to activate/deactivate the statements REQUEST DOCUMENT and PARSE XML.

This profile parameter corresponds to the NTXML macro in the parameter module NATPARM.

Note:
As a prerequisite for using the XML profile parameter, the profile parameter CFICU must be set to CFICU=ON.

See also Statements for Internet and XML Access in the Programming Guide.

Possible settings	`ON`	Enable XML support according to the subparameter settings below. For the `PARSE XML` and `REQUEST DOCUMENT` statement usage, the subparameters `RDOC` and `PARSE` must be set to `ON` as well.
	`OFF`	Disable XML support. Any subparameter settings are ignored.
	See Keyword Subparameters below.	In addition, the following keyword subparameters are available: `RDOC` \| `PARSE` \| `RDCP` \| `RDP` \| `RDPPORT` \| `RDPS` \| `RDSPORT` \| `RDNOP`
Default setting	`OFF`
Dynamic specification	yes	The parameter `XML` can only be specified dynamically. In `NATPARM`, use the macro `NTXML`.
Specification within session	no

The following topics are covered below:

XML Parameter Syntax
NTXML Macro Syntax
Keyword Subparameters
Example of NTXML Macro
Example of XML Parameter

XML Parameter Syntax

The XML parameter is specified as follows:

XML=

(

ON
OFF

,keyword_subparameter1=value,keyword_subparameter2=value,...)

For names and values of keyword_subparameters, see Keyword Subparameters below.

NTXML Macro Syntax

The NTXML macro is specified as follows:

....+....1....+....2....+....3....+....4....+....5....+....6....+....7..
         NTXML ON/OFF                                                  *
               RDOC=ON/OFF,                                            *
               PARSE=ON/OFF,                                           *
               RDCP=code-page-name,                                    *
               RDP=url,                                                *
               RDPPORT=port-number,                                    *
               RDPS=url,                                               *
               RDSPORT=port-number,                                    *
               RDNOP=domain-name

Note:
The keyword subparameters RDPPORT and RDPS are currently for z/OS only.

Keyword Subparameters

RDOC - Support of REQUEST DOCUMENT Statement

Possible values are:

`ON`	Use of the `REQUEST DOCUMENT` statement is supported.
`OFF`	Use of the `REQUEST DOCUMENT` statement is not supported. This is the default value.

PARSE - Support of PARSE XML Statement

Possible values are:

`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 - Name of the Default HTML/XML Code Page

Specifies the default code page which is assumed if operand15 in the REQUEST DOCUMENT statement contains only spaces.

Possible values	`code-page-name`
Default value	`ISO 8859-1:1987`

RDP - URL of Proxy Server

Specifies the URL of the proxy server through which all internet (not intranet) HTTP requests have to be routed.

Possible values	`url`
Default value	`OFF`

Blanks are not allowed. The value OFF means that no URL is defined.

RDPPORT - Proxy Port Number

Specifies the port number of the proxy, if any is set.

Possible values	`0 - 65535`
Default value	`80`

RDPS - URL of SSL Proxy Server

Specifies the URL of the SSL proxy server through which all internet (not intranet) HTTPS requests have to be routed.

Note:
This keyword subparameter is currently for z/OS only.

Possible values	`url`
Default value	`OFF`

Blanks are not allowed. The value OFF means that no URL is defined.

RDSPORT – SSL Proxy Port Number

Specifies the port number of the SSL proxy, if any is set.

Note:
This keyword subparameter is currently for z/OS only.

Possible values	`0 - 65535`
Default value	`443`

RDNOP - Name of Local Domain

Specifies local domain(s) which are to be addressed directly, not via the proxy.

Possible values	`domain-name(s)`
Default value	`OFF`

Blanks are not allowed. The value OFF means that no URL is defined.

Wildcard notation for prefixes can only be used in the form *.xxx and not in the form .xxx.

Multiple entries are separated by a semicolon.

Example of NTXML Macro

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

Note:
The keyword subparameters RDPPORT and RDPS are currently for z/OS only.

Example of XML Parameter

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

Note:
The keyword subparameters RDPPORT and RDPS are currently for z/OS only.

SEARCH INDEX CONTENTS | PDF PAGE PDF BOOKS | HOME UP PREV NEXT