Version 8.2.3 for Mainframes SEARCH   CONTENTS   |   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. It corresponds to the NTXML macro in the parameter module NATPARM.

Possible settings See XML Parameter Syntax.
Default setting XML=(OFF)  
Dynamic specification yes The parameter XML can only be specified dynamically. In NATPARM, use the macro NTXML.
Specification within session no  

Notes:

  1. As a prerequisite for using the XML profile parameter, the profile parameter CFICU must be set to CFICU=ON.
  2. See also Statements for Internet and XML Access in the Programming Guide.

The following topics are covered below:

XML Parameter Syntax

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 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.

This is the default value.
keyword-subparameter Names and values of possible keyword subparameters; see Keyword Subparameters.

Top of page

NTXML Macro Syntax

The NTXML macro is specified as follows: 

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

Or:

         NTXML OFF

For a description of the syntax elements, see XML Parameter Syntax.

Top of page

Keyword Subparameters

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

Note:
The keyword subparameters RDPS, RDPSV6, RDSPORT and RDSPOV6 are currently for z/OS only.

PARSE - Support of PARSE XML Statement

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

RDCP=value specifies the default code page which is assumed if operand15 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 - Support of IPv6 for the REQUEST DOCUMENT Statement

RDIPV6=value enables/disables the support of 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 - Name of Local Domain

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:

  1. Blanks are not allowed.
  2. Wildcard notation for prefixes can only be used in the form *.xxx and not in the form .xxx.
  3. Multiple name entries must be separated by a semicolon.
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 - Support of REQUEST DOCUMENT Statement

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 - URL of Proxy Server

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.

RDPV6 - URL of IPv6 Proxy Server

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.

RDPPORT - Proxy Port Number

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 - IPv6 Proxy Port Number

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 - URL of SSL Proxy Server

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 - URL of IPv6 SSL Proxy Server

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:

  1. This keyword subparameter is currently for z/OS only.
  2. Specification of an IPv6 address is possible.

RDSPORT – SSL Proxy Port Number

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 – IPv6 SSL Proxy Port Number

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.

Top of page

Examples of 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)

Note:
The keyword subparameters RDSPORT, RDSPOV6, RDPSV6 and RDPS are currently for z/OS only.

Top of page

Examples of NTXML Macro

         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.

Top of page

 www.softwareag.com  Copyright © 1979-2013 Software AG, Darmstadt, Germany.   SEARCH   CONTENTS   |   PDF BOOKS   |   HOME   UP   PREV   NEXT