This document describes the installation steps for enabling the use of
the Natural statements REQUEST DOCUMENT
and PARSE XML
on BS2000.
For information on the functions provided by REQUEST
DOCUMENT
and PARSE XML
, see the following documents:
Statements for Internet and XML Access in the Programming Guide
REQUEST
DOCUMENT
in the Statements
documentation
PARSE XML
in
the Statements documentation
The following requirements must be met to execute the REQUEST
DOCUMENT
and PARSE XML
statements:
The ICU library must be installed to convert data from one encoding to another (at least internally). For details, see the relevant section in the Unicode and Code Page Support documentation.
A TCP/IP stack must be available and enabled for the execution environment.
A DNS (Domain Name System) server or DNS services must be available in
the execution environment to resolve internet addresses
(gethostbyname
function).
For Internet Protocol Version 6 (IPv6) support, the following additional prerequisites apply:
An activated IPv6 stack must be available on the local host.
The local network must support IPv6.
An accessible and IPv6-capable DNS server must be available.
For IPv6 internet communication, an IPv6 connection from the service provider must be available.
If both IPv4 and IPv6 are used, a dual stack must be supported.
IPv6 support must be configured with the appropriate keyword
subparameters of the Natural profile parameter
XML
described in the Parameter Reference documentation.
See also General Prerequisites and System Support in the section Overview of the Installation Process.
Be sure to read Installation Process and Major Natural Features before you start the installation procedure.
The installation procedure comprises the following:
The module NATXML
is required to execute
the statements REQUEST DOCUMENT
and PARSE XML
.
The NATXML
module is then linked to the
environment-independent
nucleus by using the following INCLUDE
statement:
INCLUDE NATLIB(NATXML)
The REQUEST DOCUMENT
and PARSE XML
statements
require CRTE (Common Run-Time Environment) functions for
execution.
Set the parameter ILCS=CRTE
for the
environment-dependent
nucleus.
For the assembly step of the reentrant part of the
environment-dependent
nucleus, set the parameter ILCS=CRTE
in the
following macros:
NAMBS2
for batch Natural,
|
|
NAMTIAM for TIAM and
|
|
NURENT for
openUTM.
|
This applies to all batch and TP monitor system environments.
Link the modules indicated in this section to the nucleus.
Add the statement RESOLVE-BY-AUTOLINK
LIB=($TSOS.SYSLNK.CRTE)
to the link step for the
environment-dependent
nucleus.
Link the following modules to the environment-dependent nucleus by
using the appropriate INCLUDE
statements:
INCLUDE NAT2LE |
CRTE access module |
INCLUDE NAT2TCP |
TCP/IP access module
Since |
INCLUDE IT0SL# |
CRTE initialization module |
Copy the LLM and the
NCFIP4vr
to the load libraries of the
Natural Development Server and the Natural Web I/O Interface.
After the last step of the installation procedure has been completed, proceed as follows:
Activate the statements in the runtime environment; see Activation/Deactivation in the section Statements for Internet and XML Access in the Programming Guide.
For information on the profile settings that enable the support of the
REQUEST DOCUMENT
and/or PARSE XML
statement, see the following documents:
Profile Settings in the section Statements for Internet and XML Access in the Programming Guide
Profile parameter XML
in the
Parameter Reference documentation
Try the example programs contained in the Natural system library
SYSEXV
.