This document describes the steps for installing Natural CICS Interface Version 8.2.8 (product code NCI) on z/OS.
For information on how to operate Natural in a CICS environment, see Using Natural with TP Monitors and Natural under CICS in the TP Monitor Interfaces documentation and the following topics:
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 the following product must be installed before you can install the Natural CICS Interface:
Adabas CICS Interface (product code ACI), version as specified under Software AG Product Versions Supported by Natural in the current Natural Release Notes for Mainframes.
See also General Prerequisites and System Support in the section Overview of the Installation Process.
The installation medium contains the following data sets required for product installation:
| Data Set Name | Contents |
|---|---|
NCIvrs.LOAD |
Load modules |
NCIvrs.SRCE |
Source modules and macros |
NCIvrs.OBJS |
Object modules |
Copy the data sets into your environment as described in Copying Data Sets to a z/OS Disk in the section Installing Natural.
Sample installation jobs are contained in the NATvrs.JOBS data set
and are prefixed with the product code. The data set is provided on the
installation medium supplied for base Natural.
When used in this document,
prefix denotes a common Natural CICS
Interface prefix of 1 to 5 characters, for example, NCI43. This
prefix is determined by the value of the parameter
PREFIX in the Natural CICS Interface parameter module,
for example in Step 4
of the Installation Procedure.
PREFIX is
described in the TP Monitor Interfaces documentation.
prefix is followed by
specific characters to make up the names of the following objects:
Before you start the installation procedure for the Natural CICS Interface, be sure to read the following:
System Control under CICS in the TP Monitor Interfaces documentation
The installation procedure comprises the following:
Step 2: Allocate the VSAM RRDS Roll Files for the Natural CICS Interface
Step 5: Build the Natural CICS Interface Starter Module NCISTART
Step 6: Build the Natural CICS Interface Root Module NCIROOT
Step 7: Build the Natural CICS Interface System Directory Module
Step 8: Build the Natural CICS Interface External CALLNAT Interface Module
Step 11: Build the Natural CICS Interface Front-End Driver NCISFED
Step 16: Link the Natural CICS Interface External CALLNAT Interface Module
(Job I005, Steps 2211 - 2216, 2230 - 2235, 2240)
Steps 2211 - 2216 and 2230 - 2235:
Create CICS RDO entries as described in CICS Resource Definitions and apply the batch resource definitions with the DFHCSDUP utility program.
Step 2240 (optional):
This step is only required if you want to dynamically load an ICU data item without using the SVC instruction on request during a Natural session instead of an entire ICU data library:
Set CFICU=(DATITEM=NONE)
and add one PPT entry for each ICU data item.
See also the corresponding step in Installing International Components for Unicode for Software AG.
ICU data items and ICU data libraries are described in the Unicode and Code Page Support documentation.
(Job I008, Step 2200)
This step must be performed only if VSAM roll files are used as CICS roll facility.
Allocate the VSAM RRDS roll files for the Natural CICS Interface.
The Natural CICS Interface uses VSAM RRDS roll files for optimum performance, which means without CI/CA splits.
(Job I070, Step 2205)
This step must be performed only if VSAM roll files are used as roll facility.
Assemble and link the NCISCPRI batch program of the
Natural CICS Interface to initialize a roll file.
This step creates an executable batch module which is used in Step 15: Link the VSAM Roll-File Initialization Module.
(Job I070, Steps 2220, 2225)
Edit, assemble and link the Natural CICS Interface parameter module
NCIPARM.
The Natural CICS Interface parameter
module NCIPARM contains a macro named
NCMPRM
which contains parameters specific to the Natural CICS Interface.
You can generally use the default values for all parameters. Modify only the values of those parameters whose default values do not suit your requirements. The only mandatory parameter without a default value is the common Natural CICS Interface prefix.
To simplify the Natural CICS Interface parameter module
installation process, the source module NCIPARM contains the
NCMPRM macro request with parameter
PREFIX=&SYSPARM. Thus, when generating a Natural CICS
Interface parameter module, assemble the NCIPARM source module
with assembler option SYSPARM=prefix
rather than editing the source module.
The individual parameters are described in the section NCMPRM Macro Parameters in the TP Monitor Interfaces documentation.
Note:
The specified parameters are copied into the Natural CICS
Interface system directory module NCISCPCB (linked as described in
Step 7) when this module is
initialized with your first Natural session. To ascertain that parameter
changes become effective immediately:
build the Natural parameter module.
link the environment-dependent nucleus as described in Step 13.
issue CECI RELEASE PROGRAM(...) for the Natural
CICS Interface system directory module.
issue CEMT SET PROGRAM(...) NEWCOPY for both the
environment-dependent nucleus and the Natural CICS Interface system directory
module.
(Job I070, Step 2230)
Set the CICS translator option LEASM to enable
support for the IBM Language Environment (LE); see also
Natural CICS Interface and IBM
Language Environment (LE).
Make sure that the IBM Language Environment macro library is
available in the SYSLIB chain in the assembler step.
Translate, assemble and link the Natural CICS Interface starter module
NCISTART. Repeat these steps after you have installed a new CICS
version.
If you are not using the most recent CICS version, the translate step may result in a non-zero return code (4 - 16, depending on your CICS version) because of CICS commands being used that are unknown to your CICS translator. This return code can be ignored as long as the subsequent assembly step will end with a return code of 0 by using conditional assemblies to bypass potential CICS translator messages.
When linking NCISTART, the following
modules receive an IEW0461 or
IEW2454W error message: NCIROOT,
DFHEAI0, DFHEI1 and some IBM LE modules
(CEE...). This is normal and is resolved in the final link
step.
(Job I070, Step 2235)
Translate, assemble and link the Natural CICS Interface module
NCIROOT. Repeat these steps after you have installed a new CICS
version.
If you are not using the most recent CICS version, the translate step may result in a non-zero return code (4 - 16, depending on your CICS version) because of CICS commands being used that are unknown to your CICS translator. This return code can be ignored as long as the subsequent assembly step will end with a return code of 0 by using conditional assemblies to bypass potential CICS translator messages.
When linking NCIROOT, the following
modules receive an IEW0461 or
IEW2454W error message: NCIPARM,
NCISERV, DFHEAI0 and DFHEI1. This is
normal and is resolved in the final link.
(Job I070, Steps 2245, 2250)
Edit, assemble and link the NCISCPCB module.
The Natural CICS Interface system directory is generated by
assembling and linking the source module NCISCPCB.
A sample job is contained in the
NATvrs.JOBS data set and a
comprehensive sample source in the
NCIvrs.SRCE data set.
For descriptions of the individual macros and parameters
contained in NCISCPCB, see
NCISCPCB
Generation Parameters in the TP Monitor
Interfaces documentation.
(Job I070, Step 2270)
This step must be performed only if you want to use the external
CALLNAT interface module of the Natural CICS Interface. See also
Environment
Dependencies in
Natural
3GL CALLNAT Interface - Purpose, Prerequisites,
Restrictions in the Operations
documentation.
Translate, assemble and link the external CALLNAT interface module
NCIXCALL. See also NCIXCALL as described for the
CALLNAT in
Environment
Dependencies in the Operations
documentation.
Repeat these steps after you have installed a new CICS version.
If you have an NCIXCALL module from a previous
Natural version, specify a new name for this module (for example,
NCIXCIOV) by using the SYSPARM parameter
contained in NCIXCALL. The NCIXCALL module from the
previous Natural version must be linked (see
Step 16: Link the
Natural CICS Interface External CALLNAT Interface Module)
to assign it the new name.
If you are not using the most recent CICS version, the translate step may result in a non-zero return code (4 - 16, depending on your CICS version) because of CICS commands being used that are unknown to your CICS translator. This return code can be ignored as long as the subsequent assembly step will end with a return code of 0 by using conditional assemblies to bypass potential CICS translator messages.
When linking NCIXCALL, the following
modules receive an IEW0461 or
IEW2454W error message: DFHEAI0 and
DFHEI1. This is normal and is resolved in the final link step.
(Job I070, Step 2275)
This step must be performed only if you want to use the node error program (NEP) of the Natural CICS Interface.
Translate, assemble and link the Natural CICS Interface module
NCIZNEP. Repeat these steps after you have installed a new CICS
version.
For information on NCIZNEP, see
NCIZNEP
Functionality in the TP Monitor
Interfaces documentation.
If you are not using the most recent CICS version, the translate step may result in a non-zero return code (4 - 16, depending on your CICS version) because of CICS commands being used that are unknown to your CICS translator. This return code can be ignored as long as the subsequent assembly step will end with a return code of 0 by using conditional assemblies to bypass potential CICS translator messages.
When linking NCIZNEP, the following
modules receive an IEW0461 or
IEW2454W error message: DFHEAI0 and
DFHEI1.This is normal and is resolved in the final link step.
(Job I070, Step 2280)
This step must be performed only if you want to use Natural via the CICS 3270 Bridge.
Translate, assemble and link the Natural CICS Interface module
NCIXFATU. Repeat these steps after you have installed a new CICS
version.
If you are not using the most recent CICS version, the translate step may result in a non-zero return code (4 - 16, depending on your CICS version) because of CICS commands being used that are unknown to your CICS translator. This return code can be ignored as long as the subsequent assembly step will end with a return code of 0 by using conditional assemblies to bypass potential CICS translator messages.
When linking NCIXFATU, the following
modules receive an IEW0461 or IEW2454W error message:
DFHEAI0 and DFHEI1. This is normal and is resolved in
the final link step.
(Job I070, Step 2290)
This step must be performed only if you want to use the Natural
RPC server front-end under CICS. This step is only generated if the
System Maintenance Aid
(SMA) parameter NAT-RPC is set to
Y (Yes). NAT-RPC is used in connection with the SMA
parameter NCI-RPC-FRONT.
Set the CICS translator option LEASM for
enablement of the IBM Language Environment (LE); see also
Natural CICS Interface and
IBM Language Environment (LE) in the TP Monitor
Interfaces documentation.
Make sure that the IBM Language Environment (LE) macro library
is available in the SYSLIB chain in the assembler step.
Translate, assemble and link the Natural CICS Interface front-end driver
NCISFED. Repeat these steps after you have installed a new CICS
version.
If you are not using the most recent CICS version, the translate step may result in a non-zero return code (4 - 16, depending on your CICS version) because of CICS commands being used that are unknown to your CICS translator. This return code can be ignored as long as the subsequent assembly step will end with a return code of 0 by using conditional assemblies to bypass potential CICS translator messages.
When linking NCISFED, the following
modules receive an IEW0461 or
IEW2454W error message: DFHEAI0,
DFHEI1 and some IBM LE modules (CEE...). This is
normal and is resolved in the final link step.
(Job I080, Steps 2210, 2220)
Build the Natural parameter module for the Natural CICS Interface:
Modify the settings of the supplied Natural profile parameters as required and in accordance with the settings you specified when building the Natural parameter module for batch mode during the Installation Procedure for base Natural.
Make sure that the profile parameters
FNAT and
FUSER are
set to the same values you specified when loading the system file. The
parameters and corresponding macros (if applicable) are described in the
Parameter
Reference documentation.
Assemble and link the Natural parameter module.
(Job I080, Step 2230)
Link the environment-dependent nucleus for the Natural CICS Interface with the following modules:
NCIPARM built in
Step 4,
NCISTART built in
Step 5,
NCIROOT built in
Step 6, and
the Natural parameter module built in
Step 12.
Include the CICS stub module DFHELII (do not use
DFHEAI).
When linking the environment-dependent nucleus or its
subcomponents, you may receive IEW2646I or IEW2660W
messages, which can be ignored.
(Job I080, Step 2250)
Link the Natural CICS Interface system directory into your
CICS user library under the module name prefixCB
(see Prefix Used for
Natural CICS Interface Components).
The Natural CICS Interface system directory must be
linked with the NORENT option.
(Job I080, Step 2265)
This step must be performed only if VSAM roll files are used as CICS roll facility.
Link the VSAM roll-file initialization module
NCISCPRI into your CICS user library.
(Job I080, Steps 2270, 2271)
This step must be performed only if you want to use the external
CALLNAT interface module of the Natural CICS Interface.
Link the external CALLNAT interface module
NCIXCALL.
Step 2270 is needed if the NCIXCALL module has
been installed in the same CICS region with a previous Natural version. The previous Natural
version NCIXCALL module must then be assigned a new name, for
example NCIXCIOV. Thus, you can preserve the name of the
NCIXCALL module used in the previous version and need not link it
to all your 3GL programs using it.
Step 2271 links the module NCIXCALL for the
current Natural version.
(Job I080, Step 2275)
This step must be performed only if you want to use the node error program (NEP) of the Natural CICS Interface. See also CICS Node Error Program Considerations for Natural in the TP Monitor Interfaces documentation.
Link the Natural CICS Interface module
NCIZNEP.
(Job I080, Step 2280)
This step must be performed only if you want to use Natural with the CICS 3270 Bridge. See also CICS 3270 Bridge Support in the TP Monitor Interfaces documentation.
Link the Natural CICS Interface module NCIXFATU
under the name
prefixXFA; see
Prefix Used for Natural
CICS Interface Components.
(Job I080, Step 2290)
This step must be performed only if you want to use the Natural
RPC server front-end under CICS. This step is only generated if the
System Maintenance Aid
(SMA) parameter NAT-RPC is set to
Y (Yes). NAT-RPC is used in connection with the SMA
parameter NCI-RPC-FRONT.
Define the name of the Natural RPC server front-end with the
SMA parameter NCI-RPC-FRONT.
(Job I081, Step 2200)
This step must be performed only if VSAM roll files are used as CICS roll facility.
Initialize the VSAM roll files.
This step must be repeated for all roll files used if roll files are the primary roll facility.
A VSAM RRDS file is a direct (random) access type file that must be formatted.
For the Natural CICS Interface VSAM roll files, formatting is
done by the NCISCPRI batch program. To execute
NCISCPRI, the Natural roll file to be initialized has to be
assigned the file name ROLL in the JCL DD statement. No other
parameter input is required for NCISCPRI; all data required for
file initialization is obtained by SHOWCB VSAM macro calls.
For descriptions of the messages that can be output during this step, see NCISCPRI Warnings and Error Messages in the TP Monitor Interfaces documentation.
This section describes resource definitions required or recommended for customizing your CICS system.
Note:
We generally recommend that you keep all
Natural version-dependent components such as programs, transactions and files in a
separate resource group. Such a group is represented by
natgroup in this section.
To take full advantage of the CICS storage protection and transaction isolation
facilities, it is strongly recommended that you specify EXECKEY(USER) as
the default value for all programs. This section explains if
EXECKEY(CICS) is required for a definition. In all other cases, use
EXECKEY(USER).
The following table provides information about the value combinations of the
API and CONCURRENCY program attributes. The appropriate
value combination must be specified consistently for all programs that call one
another using direct branch (BASR) instructions:
| Program attributes | Remarks |
|---|---|
API(CICSAPI)
|
Use these attributes if not all affected programs are threadsafe. |
API(OPENAPI)
|
Use these attributes if you want to take advantage of the CICS open
transaction environment (OTE) and can confirm that all affected programs are
threadsafe.
For using the CICS OTE, adapt the program definitions as described in the following section. For general information on using Natural in the CICS OTE, see CICS Open Transaction Environment Considerations in the TP Monitor Interfaces documentation. For further information, see also Threadsafe Considerations in the TP Monitor Interfaces documentation. |
API(OPENAPI)
|
Same as API(OPENAPI)
CONCURRENCY(REQUIRED).
|
API(CICSAPI)
|
This attribute combination is not supported by the Natural CICS Interface. |
API(CICSAPI)
|
This attribute combination is not supported by the Natural CICS Interface. |
API(OPENAPI)
|
This attribute combination is prohibited by CICS. |
The value combination affects all user-written 3GL programs, as well as front-end programs that call the environment-dependent nucleus of Natural. The front-end programs can be delivered with Natural add-on products or be user-written. Examples of affected programs include NCIRSFE (Natural RPC server front-end), NATCNRFE (Natural Web I/O Interface Server CICS Adapter and Natural Development Server CICS Adapter), and the programs supplied with the Natural CICS Interface listed in the following section.
Add a program definition for the environment-dependent nucleus:
DEFINE PROGRAM(dep-nuc) GROUP(natgroup) LANGUAGE(ASSEMBLER) * DESCRIPTION(ENVIRONMENT-DEPENDENT NUCLEUS)
where
dep-nuc is the Natural CICS Interface
module built during the link
step.
The following attribute settings for the program definition are mandatory when using the CICS OTE and recommended otherwise:
DATALOCATION(ANY)
API(OPENAPI)
CONCURRENCY(REQUIRED)
Program attributes (for example,
EXECKEY or DATALOCATION) are inherited from NCISTART because
standard linkage conventions (BASR 14,15) are used for the program calls. Examples
are calls for the environment-independent nucleus, the Adabas CICS Interface or
Natural calls (SET CONTROL 'P=S') for external programs.
Note:
If
you use the CICS OTE and your application issues many Db2 requests, using
EXECKEY(CICS) may improve performance because it prevents CICS from
switching from an L9 to an L8 open TCB and back again for every SQL
call.
This definition is optional.
Add a program definition for the environment-independent nucleus:
DEFINE PROGRAM(ind-nuc) GROUP(natgroup) LANGUAGE(ASSEMBLER) * DESCRIPTION(NATURAL ENVIRONMENT-INDEPENDENT NUCLEUS)
where ind-nuc is the name of the
environment-independent
nucleus specified with the Natural profile parameter NUCNAME. The
default name is INDNUCvr. You need not
specify EXECKEY or DATALOCATION for the
environment-independent nucleus as all attributes of the NCISTART program are
inherited since standard linkage conventions (BALR 14,15) are used.
To access the environment-independent nucleus in the ELPA, specify
USELPACOPY(YES) for this program definition and
LPA=YES in the CICS startup parameters.
This definition is optional.
This definition is only required if you want to use Natural features supplied as
selectable units
(see the Operations documentation) with the NATSUPGM
load module. NATSUPGM is loaded dynamically as an external module that is
called during program execution.
Add a program definition to load the selectable units module
NATSUPGM:
DEFINE PROGRAM(NATSUPGM) GROUP(natgroup) LANGUAGE(ASSEMBLER) * DESCRIPTION(NATURAL SELECTABLE UNITS MODULE)
Add a program definition for the Natural CICS Interface system directory:
DEFINE PROGRAM(prefixCB) GROUP(natgroup) LANGUAGE(ASSEMBLER) * DESCRIPTION(NATURAL CICS INTERFACE SYSTEM DIRECTORY)
This definition is optional.
Add a program definition for the external CALLNAT interface module:
DEFINE PROGRAM(ncixcall) GROUP(natgroup) LANGUAGE(ASSEMBLER) * DESCRIPTION(NATURAL CICS INTERFACE EXTERNAL CALLNAT MODULE)
where ncixcall is the name of the
NCIXCALL module specified in Step 8: Build the Natural CICS
Interface External CALLNAT Interface Module.
The following attribute settings for the program definition are mandatory when using the CICS OTE and recommended otherwise:
DATALOCATION(ANY)
API(OPENAPI)
CONCURRENCY(REQUIRED)
The values of EXECKEY, CONCURRENCY and API
for ncixcall must be the same as for the
environment-dependent
nucleus because Natural is called by
ncixcall using standard linkage
conventions (direct branch using a BASR instruction) instead of the
EXEC CICS LINK command.
This definition is optional.
Add a program definition for the node error program (NEP) of the Natural CICS Interface:
DEFINE PROGRAM(nciznep) GROUP(natgroup) LANGUAGE(ASSEMBLER) * EXECKEY(CICS) * DESCRIPTION(NATURAL CICS INTERFACE NODE ERROR PROGRAM)
where nciznep is the NEP name specified
in Step 9: Build the
Natural CICS Interface Node Error Program.
This definition is optional.
Add a program definition for the XFAINTU global user exit:
DEFINE PROGRAM(prefixXFA) GROUP(natgroup) LANGUAGE(ASSEMBLER) * EXECKEY(CICS) * DESCRIPTION(NATURAL CICS INTERFACE XFAINTU GLUE)
This definition is optional.
This definition is only required if you want to use the Natural RPC server front-end
ncisfe. This definition is only generated
if the System Maintenance Aid
(SMA) parameter NCI-RPC-FRONT is set.
Add a program definition for the Natural RPC server front-end:
DEFINE PROGRAM(ncisfe) GROUP(natgroup) LANGUAGE(ASSEMBLER) * DESCRIPTION(NATURAL RPC SERVER FRONT-END)
The name of the Natural RPC server front-end
ncisfe must be identical to the name
specified in Step 19: Link the
Natural RPC Server Front-End.
The following attribute settings for the program definition are mandatory when using the CICS OTE and recommended otherwise:
DATALOCATION(ANY)
API(OPENAPI)
CONCURRENCY(REQUIRED)
The values of EXECKEY, CONCURRENCY and API
for ncirsfe must be the same as for the
environment-dependent
nucleus because Natural is called by
ncirsfe using standard linkage
conventions (direct branch using a BASR instruction) instead of the
EXEC CICS LINK command.
We recommend that you define or choose a CICS profile for the Natural transactions similar to the following:
DEFINE PROFILE(natprof) GROUP(natgroup) * DESCRIPTION(CICS PROFILE FOR NATURAL TRANSACTIONS) * SCRNSIZE(ALTERNATE) INBFMH(ALL)
where natprof is the name of the CICS profile
assigned to the Natural transactions.
We also recommend that you define a CICS transaction class for the Natural transactions similar to the following:
DEFINE TRANCLASS(natclass) GROUP(natgroup) MAXACTIVE(999) * DESCRIPTION(CLASS FOR NATURAL TRANSACTIONS)
where natclass is the name of the CICS
transaction class assigned to the Natural transactions.
A CICS transaction class dedicated to Natural helps control storage usage by Natural (see also Controlling Storage Usage in the TP Monitor Interfaces documentation). Assign this transaction class to the definitions of all transactions that directly or indirectly call Natural.
You can define the following:
Add a definition for the Natural transaction:
DEFINE TRANSACTION(ncitransact) GROUP(natgroup) * PROGRAM(dep-nuc) TWASIZE(128) DUMP(NO) SPURGE (YES) * PROFILE(natprof) TRANCLASS(natclass)
where:
ncitransact is the name of the Natural
CICS Interface user transaction ID.
dep-nuc is the Natural CICS
Interface module built during the link
step.
We recommend that you set the following parameter values in the CICS transaction definitions:
TASKDATALOC(ANY)
ISOLATE(YES)
TASKDATALOC(ANY) can have an impact on non-Natural programs called
by Natural; for details, see the relevant IBM literature on CICS.
For the impact of transaction isolation, see also THRDSZE - Thread Size in the TP Monitor Interfaces documentation.
Add a definition for the Natural internal message switching transaction:
DEFINE TRANSACTION(nmsg) GROUP(natgroup) * PROGRAM(dep-nuc) TWASIZE(128) DUMP(NO) SPURGE (YES) * PROFILE(natprof) TRANCLASS(natclass)
where:
dep-nuc is the Natural CICS Interface
module built during the link
step.
nmsg is the name of the Natural CICS
Interface message switching transaction ID as defined with the MSGTRAN
parameter described in Parameters in Macro NCMPRM in the TP
Monitor Interfaces documentation. The default name is
NMSG.
We recommend that you set the following parameter values in the CICS transaction definitions:
TASKDATALOC(ANY)
ISOLATE(YES)
TASKDATALOC(ANY) can have an impact on non-Natural programs called
by Natural; for details, see the relevant IBM literature on CICS.
For the impact of transaction isolation, see also THRDSZE - Thread Size in the TP Monitor Interfaces documentation.
This definition is optional.
Add a definition for the node error program (NEP) of the Natural CICS Interface:
DEFINE TRANSACTION(neptran) GROUP(natgroup) * PROGRAM(nciznep) DUMP(NO) PRIORITY(255) * TASKDATAKEY(CICS) TASKDATALOC(ANY) * PROFILE(natprof)
where:
neptran is the NEP transaction code
defined with the NEPTRAN generation parameter in the
SYSPARM specification in the NCIZNEP module built in
Step 9: Build the
Natural CICS Interface Node Error Program.
nciznep is the NEP name specified in
Step 9: Build the
Natural CICS Interface Node Error Program.
NCIZNEP and NEPTRAN are described in the
TP Monitor Interfaces documentation.
Add a definition for the Natural RPC server front-end transaction:
DEFINE TRANSACTION(ncisfetransact) GROUP(natgroup) * PROGRAM(ncisfe) TWASIZE(128) DUMP(NO) SPURGE (YES) * PROFILE(natprof) TRANCLASS(natclass)
where:
ncisfetransact is the name of the
Natural RPC server front-end transaction ID.
ncisfe is the name of the Natural RPC
server front-end specified in Step 19: Link the Natural RPC Server
Front-End.
These definitions are only required if VSAM roll files are to be used.
Add one entry in the FCT for each Natural CICS Interface VSAM roll file:
DEFINE FILE(prefixR1) GROUP(natgroup) * BROWSE(YES) ADD(YES) DELETE(YES) UPDATE(YES) READ(YES) * RECORDFORMAT(F) STRINGS(3) DATABUFFERS(5)
Local shared resources (LSR) should be used whenever possible. If multiple LSR pools are supported, one pool should be dedicated exclusively to Natural CICS Interface roll files.
This definition is optional but highly recommended to log Natural CICS Interface informational messages and Natural abend codes and corresponding error messages.
Add entries in the DCT for the Natural CICS Interface error message logging facility. For Natural error messages, you can use:
A destination that is already defined in CICS (for example, CSSL); in this case, no extra DCT entry is required.
An extra partition destination as a synonym for an existing CICS message destination:
DEFINE TDQUEUE(nerr) GROUP(natgroup) TYPE(INDIRECT) * INDIRECTNAME(name)
where:
nerr is the name of the Natural CICS
Interface error message destination as defined with the MSGDEST
parameter described in NCMPRM
Macro Parameters in the TP Monitor
Interfaces documentation. The default name is NERR.
name is the name of the corresponding
indirect destination.
An extra file:
DEFINE TDQUEUE(nerr) GROUP(natgroup) TYPE(EXTRA) *
DDNAME(NATMSG) OPEN(INITIAL) TYPEFILE(OUTPUT) *
RECORDFORMAT(VARIABLE) BLOCKFORMAT(UNBLOCKED) *
RECORDSIZE(nnn)
where nerr is the name of the Natural
CICS Interface error message destination as defined with the MSGDEST
parameter described in NCMPRM
Macro Parameters in the TP Monitor
Interfaces documentation. The default name is NERR.
You can, for example, change the BLOCKFORMAT format from
UNBLOCKED to BLOCKED. Natural and the Natural CICS
Interface messages have a length of up to 120 bytes. Therefore, the record size
(RECORDSIZE (nnn)) should be at least
124 bytes for variable record format or 120 bytes for fixed record format.
Sufficient disk space must be reserved for this data set; a DD statement must be added to the CICS startup JCL.
Add one entry in the DCT for the Natural NATRJE utility (described in the
Utilities documentation). When submitting a job to JES with
the following entry, the internal reader is started on CLOSE of the
destination:
DEFINE TDQUEUE(nrje) GROUP(natgroup) TYPE(EXTRA) * DDNAME(NATRJE) OPEN(DEFERRED) TYPEFILE(OUTPUT) * RECORDFORMAT(FIXED) BLOCKFORMAT(UNBLOCKED) RECORDSIZE(80)
where nrje is the name of the Natural
CICS Interface submit destination as defined with the RJEDEST
parameter described in NCMPRM
Macro Parameters in the TP Monitor
Interfaces documentation. The default name is NRJE.
Additionally, add the following DD statement to the CICS startup JCL:
//NATRJE DD SYSOUT=(*,INTRDR)
When submitting a job to JES with the following two entries, the Natural CICS Interface deals with an indirect destination that will not be closed:
DEFINE TDQUEUE (nrje) GROUP(natgroup) TYPE(INDIRECT) * INDIRECTNAME(name) DEFINE TDQUEUE(name) GROUP(natgroup) TYPE(EXTRA) * DDNAME(NATRJE) OPEN(DEFERRED) TYPEFILE(OUTPUT) * RECORDFORMAT(FIXED) BLOCKFORMAT(UNBLOCKED) RECORDSIZE(80)
where:
nrje is the name of the Natural CICS
Interface submit destination as defined with the RJEDEST
parameter described in NCMPRM
Macro Parameters in the TP Monitor
Interfaces documentation. The default name is NRJE.
name is the name of the corresponding
indirect destination.
You can use either a /*EOF card as the very last card in the job
stream or the corresponding NATRJE exit. When detecting the
/*EOF card, JES submits the previous job stream.
This definition is optional.
Add one entry in the DCT for the Natural CICS Interface session statistics:
DEFINE TDQUEUE(nlog) GROUP(natgroup) TYPE(EXTRA) * DDNAME(NATLOG) OPEN(INITIAL) TYPEFILE(OUTPUT) * RECORDFORMAT(VARIABLE) BLOCKFORMAT(BLOCKED) * RECORDSIZE(4624) BLOCKSIZE(4628)
where nlog is the name of the Natural
CICS Interface logging destination as defined with the parameter LOGDEST
described in the TP Monitor Interfaces documentation. The
default name is NLOG.
Sufficient disk space must be reserved for this data set; a DD statement must be added to the CICS startup JCL.
This definition is optional.
Add one entry in the DCT for the Natural CICS Interface profile parameter file:
DEFINE TDQUEUE(nprm) GROUP(natgroup) TYPE(EXTRA) * DDNAME(CMPRMIN) OPEN(DEFERRED) TYPEFILE(INPUT) * RECORDFORMAT(FIXED) BLOCKFORMAT(BLOCKED) * RECORDSIZE(80) BLOCKSIZE(nnn)
where:
nprm is the name of the Natural CICS
Interface profile parameter input destination as defined with the PRMDEST
parameter described in NCMPRM Macro Parameters in the
TP Monitor Interfaces documentation. The default name is
NPRM.
nnn is a multiple of 80.
A DD statement must be added to the CICS startup JCL.
Add the following system abend codes to a CICS System Recovery Table (SRT):
0D6 |
Protects CICS against failing Natural Roll Server and Natural Authorized Services Manager requests (using PC instructions) by Natural. |
01D |
Protects CICS against failing data space cache requests by Natural. |
DC2 |
Protects CICS against failing memory object cache requests by Natural. |
You can verify the successful installation of the Natural CICS Interface by performing the following steps:
From a CICS session, type in the Natural transaction ID to start a Natural session.
Proceed with the steps described in the section Test Online Natural.