Version 4.2.6 for Mainframes
 —  Installation  —

Installation Steps for REQUEST DOCUMENT and PARSE XML

This document describes the installation steps required to enable the use of the Natural statements REQUEST DOCUMENT and PARSE XML.

The following topics are covered:

See also


Platforms Supported

For a list of mainframe computer platforms on which the Natural statements REQUEST DOCUMENT and PARSE XML are supported, see the following sections in Statements for Internet and XML Access in the Natural Programming Guide.

Top of page

Prerequisites

See General Prerequisites, Installation Prerequisites in the section Statements for Internet and XML Access in the Natural Programming Guide

Top of page

Building the Natural Nucleus

The runtime for the statements REQUEST DOCUMENT and PARSE XML is provided in the module NATXML.

To enable the runtime, the module NATXML has to be linked to the Natural shared nucleus.

For further information, refer to the appropriate installation step of your environment.

Top of page

Building the Natural Front-End

Preliminary Remarks

Concerning all batch and TP-system drivers besides Com-plete on z/OS, z/VSE and VM/CMS

Concerning BS2000/OSD

Linking the Natural Front-End Modules

Under z/OS:

Batch and TSO Add INCLUDEs for the modules NAT2LE and NAT2TCP to the link step of the Natural front-end module.

Resolve unresolved external references from the LE library (usually hlq.SCEELKED), that is, add this library to the SYSLIB definition of your link job and do not specify the NCAL parameter for the link.

CICS Add an INCLUDE for the CICS socket module EZACIC17 contained in the CICS socket library (usually hlq.SEZARNT1, hlq.SEZATCP or hlq.SEZACMTX).

Resolve unresolved external references from the CICS socket library and the current LE library (usually hlq.SCEELKED), that is, add these libraries to the SYSLIB definition of your link job and do not specify the NCAL parameter for the link.

Configure the CICS TCP/IP environment as described in the IP CICS Socket Guide by IBM.

Com-plete Link the module NAT2LE to the Natural Com-plete front-end module.

Copy the module NCFTCP42 to the Com-plete load library.

The TCPIP CDI driver and the POSIX SERVER statement in the Com-plete parameter module SYSPARM are required.

IMS TM Add INCLUDEs for the modules NAT2LE and NAT2TCP to the link step of all NII front-end modules.

Resolve unresolved external references from the LE library (usually hlq.SCEELKED), that is, add this library to the SYSLIB definition of your link job and do not specify the NCAL parameter for the link.

Under z/VSE:

Batch and CICS Add INCLUDEs for the modules NAT2LE and NAT2TCP to the link steps of the batch front-end module and the NCI front-end module.

Resolve unresolved external references from the LE library (usually PRD2.SCEEBASE), that is, add this library to the OBJ-SEARCH definition of your link job and do not specify the NOAUTO parameter in the ACTION statement for the link.

Com-plete/NDV-SMARTS Link the module NAT2LE to the Natural Com-plete front-end module.

Copy the phase NCFTCP42 to the Com-plete/SMARTS load-library.

The TCPIP CDI driver and the POSIX SERVER statement in the Com-plete parameter module SYSPARM are required.

Under VM/CMS:

VM/CMS Xedit NAT$LOAD EXEC and append NAT2LE and NAT2TCP to the variable loadlist.

For enabling the access to TCP/IP, refer to Using TCP/IP Communication in the Operations documentation.

Under BS2000/OSD:

Batch, TIAM and openUTM Add INCLUDEs for the module NAT2LE and the LLM NAT2TCP to the front-end link steps for batch mode and TIAM.

Add an INCLUDE for the CRTE initialization routine IT0SL#, if IT0SL# is not already included into the front-end module.

Add a RESOLVE-BY-AUTOLINK LIB=($TSOS.SYSLNK.CRTE) statement to the link step for the Natural front-end module.

Note:
Since NAT2TCP is delivered in LLM format, the front-end has to be linked with the binder!

NDV The REQUEST DOCUMENT statement is not currently supported by the Natural Development Server for BS2000/OSD.

Top of page

Installation Verification

Activate the statements in the runtime environment; see Activation/Deactivation in General Prerequisites in the section Statements for Internet and XML Access in the Natural Programming Guide.

Try the sample programs contained in library SYSEXV.

For information on profile settings to enable the support of the REQUEST DOCUMENT and/or PARSE XML statement, see the following documents:

Top of page