The Entire System Server Interface is required if the Entire System Server or Natural ISPF is to be used.
This document describes the steps for installing the Entire System Server Interface on z/OS. You can choose between default installation (recommended) and customized installation.
For information on installing and using the Entire System Server or Natural ISPF, refer to the relevant product documentation.
When used in this document, the notation
vrs or
vr represents the relevant product
version (see also Version in the
Glossary).
A supported version of either of the following products must be installed before you can install the Entire System Server Interface:
Entire System Server or Natural ISPF, version as specified under Software AG Product Versions Required with Natural in the current Natural Release Notes for Mainframes.
See also General Prerequisites and System Support in the section Overview of the Installation Process.
If you want to use the default value settings in the modules
ESYNODTB and NATPNIP (used by the Entire System
Server and Natural ISPF), proceed with
Link the Entire System
Server Interface to the Nucleus.
If you do not want to use the default value
settings, edit the modules NATPNIP and ESYNODTB
described in this section.
The NATPNIP module contains the following parameters and
default values:
NAMVIEWP BUFLEN=12288,NUMREQ=5,MAXCBL=3000,MAXEDL=6000,EXTUSER=INIT-USER
The parameters are explained below:
BUFLEN |
Length of all Adabas buffers in bytes |
NUMREQ |
Number of possible nested FIND loops in Natural
calling the Entire System Server
|
MAXCBL |
Complex FIND buffer length
|
MAXEDL |
Editor session buffer length |
EXTUSER |
External user ID passed to the Entire System Server for security checks |
A recommended value for EXTUSER is:
EXTUSER=INIT-USER |
The value of the Natural system variable
*INIT-USER
is transferred via the Entire System Server to an external security system, for
example, RACF, ACF2, TOP-SECRET, and all calls to security restricted resources
are handled under this user ID.
|
A recommended value for MAXEDL is:
MAXEDL |
The default value is 6000, which should be sufficient for an NSPF
editor session and typical incore database applications. However, for large
layouts within an incore database file that value might not be large enough and
the following message is issued:
In this case, the value of |
The Natural system variables mentioned above are described in the System Variables documentation.
The ESYNODTB module contains the following parameters and
default values:
NAMXNOD ID=148,NAME=PRODUCTION-1 NAMXNOD ID=149,NAME=PRODUCTION-2 NAMXNOD ID=1490,NAME=DBID-ABOVE-255,LAST=Y END
The parameters and default values are explained below:
ID |
Entire System Server node number (also known as DBID) |
NAME |
Entire System Server node name |
LAST |
Indicator for last entry in table |
Calls to the Entire System Server from Natural are usually handled with
the NODE parameter which specifies the node number to be used for
the call, for example:
FIND ACTIVE-JOBS WITH JOB-NAME = 'ADA*' AND NODE = 148
If the node number is defined in the ESYNODTB module,
alternatively, you can specify the logical name of the required Entire System
Server with the NODE-NAME parameter, for example:
FIND ACTIVE-JOBS WITH JOB-NAME = 'ADA*' AND NODE-NAME = 'PRODUCTION-2'
If Natural ISPF is used as the INCORE database:
(Job I055, Step 1106)
Link the parameter module NATPNIP. In this case, the
module ESYNODTB is not required.
If the Entire System Server is used:
(Job I055, Steps 1106, 1107)
Assemble and link the modules NATPNIP (Step 1106), and,
optionally ESYNODTB (Step 1107).
(Job I060, Step 3720)
Link the following Entire System Server Interface modules to either
the environment-independent
nucleus or the environment-dependent nucleus by
using the corresponding INCLUDE statements:
INCLUDE NATLIB(NATPNIP) |
Entire System Server Interface parameters |
INCLUDE NATLIB(ESXNUC) |
Entire System Server Interface module |
INCLUDE NATLIB(ESYNODTB) |
Optional, node table |
If you want to use the Write-to-Spool feature, either link the access
method to your nucleus or load the method dynamically. See also the Natural
parameters RCA and RCALIAS.
You can define and assemble the defaults for your nucleus by using the
source member NATPWSDF before linking the defaults to the nucleus.
You can find the source member NATPWSDF in the source library of
Natural.
The default settings of source member NATPWSDF are as
follows:
NAMPWSPL NODE=148, PROGRAM=, CLASS=A, HOLD=YES, CNTL=A, FORM=, RMT=, FORMDEF=, PAGEDEF=
The table below shows the modifiable parameters of source member
NATPWSDF and a detailed description of these parameters:
| Parameter | Description | ||||||
|---|---|---|---|---|---|---|---|
Node
|
NPR target node.
The node number can consist of up to 5 digits. It addresses the destination started task of the Entire System Server and where the output is written. |
||||||
Program
|
JES Writer which can contain up to
8 characters.
JES provides control to the Writer program. If JES does not find it, it is ignored. Possible value: |
||||||
Class
|
SYSOUT class within
JES where the output has to be written. It can contain only one character or
digit.
It is a descriptor for further software (for example, Entire Output Management) to detect the output stream for processing. |
||||||
Hold = yes/no
|
Specifies whether the output stream is to be held within the JES spool in case the task previously started by the Entire System Server terminates. | ||||||
CNTL |
|
||||||
FormRMT
|
Describes the form control buffer
for JES. This value is transferred to JES which handles the processing.
You can find the name of the JES system in the destination field
within the |
||||||
|
|
Can contain up to 6 characters. | ||||||
After editing the NATPWSDF source member with customized
values, you can assemble and link it. If you want to use the default settings,
you can omit this step.
If you want to use the Write-to-Spool feature with statically linked access method at your site, relink the Natural module as follows:
INCLUDE NATLIB(NATPWSPL) The Write-to-Spool access method for Natural
INCLUDE NATLIB(NATPWSDF) The Write-to-Spool defaults
(your adapted parameter module)
If you want to use dynamic load, you can either use the delivered
module NATPWSAM with default parameters or you can link your
adapted parameter module:
INCLUDE NATLIB(NATPWSPL)
INCLUDE USRLIB(NATPWSPA) Your adapted module
NAME NATWSPvr(R) Your adapted Write-to-Spool module.
This name must be used in RCALIAS=(NATAM11,NATWSPvr).
For further information, see System Spool Access in the Operations documentation.
(Optional installation for only batch mode or TSO.)
This section describes the advantages of Entire System Server in single-user mode and the steps required for installation.
Running the Entire System Server in single-user mode is advantageous, for example, in the following cases:
Executing long running batch jobs comprising a large number of calls to the Entire System Server.
Performing test scenarios using a Natural session under TSO performing many calls to the Entire System Server, without disturbing the production environment.
Exploring new Entire System Server functionality or versions.
From a Natural point of view, the Entire System Server single-user mode is accessible as Entire System Server node 148, irrespective of whether such a node does already exist on your machine or network.
The following is an example of a Natural program that is running in a single-user environment:
FIND ACTIVE-JOBS WITH NODE = 148 AND JOB-NAME = 'XCOM*'
This statement calls a single-user Entire System Server that runs within the same address-space. Calling a different Entire System Server node that runs elsewhere in the network is possible by using a different node number, as shown in the following example:
FIND ACTIVE-JOBS WITH NODE = 53 AND JOB-NAME = 'NUC*'
This statement calls a multi-user Entire System Server with node number 53 out of the same Natural program which called the single-user Entire System Server session.
Create a new PDS load library, which must be APF-authorized.
Copy all members of the Entire System Server load library into the new load library.
Link the module NATPSNGL, which handles Entire System
Server single-user features, to the
environment-dependent
nucleus for batch Natural.
Alternatively, you can use the RCA parameter
to dynamically load this module by setting RCA=NATPSNGL.
In both cases, the environment-dependent nucleus must be authorized
by parameter AC=1 and linked into the new load library.
Add the mandatory cards PARMS and SYSPRINT
to your JCL to handle the Entire System Server-relevant steps. In addition, you
can add the optional cards ESYTRACE and CLOG.
//ESYTRACE DD SYSOUT=* Internal trace //SYSPRINT DD SYSOUT=* Modules/Zap directory of Entire System Server //CLOG DD DISP=SHR,DSN=xxx Command log data set //PARMS DD DISP=SHR,DSN=xxx Entire System Server parameter
Add an Adabas load library to your JCL, which also has to be APF-authorized.
Edit your Entire System Server parameter member. Here, the parameter
NODE will be ignored, since Natural routes any calls to node
number 148 through to the single-user Entire System Server node.
Add the name of the nucleus as AUTHPGM in the TSO
definition member named IKJTSO00. Usually, this member is in
data set SYS1.PARMLIB.
Proceed analogously as described in the batch mode installation above.