Version 8.2.2 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                                                      *
               PARSE=value,                                            *
               RDCP=value,                                             *
               RDNOP=value,                                            *
               RDOC=value,                                             *
               RDP=value,                                              *
               RDPPORT=value,                                          *
               RDPS=value,                                             *
               RDSPORT=value

Or:

         NTXML OFF                                                     *
               PARSE=value,                                            *
               RDCP=value,                                             *
               RDNOP=value,                                            *
               RDOC=value,                                             *
               RDP=value,                                              *
               RDPPORT=value,                                          *
               RDPS=value,                                             *
               RDSPORT=value

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

Top of page

Keyword Subparameters

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

Note:
The keyword subparameters RDPPORT and RDPS 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.

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.

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.

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.

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.

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.

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

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

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