Version 4.2.6 for Mainframes (Update)
 —  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

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.

Top of page

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.

Top of page

Keyword Subparameters

RDOC | PARSE | RDCP | RDP | RDPPORT | RDPS | RDSPORT | RDNOP

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.

Top of page

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.

Top of page

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.

Top of page