This document describes the steps for installing Natural Review (product code RNM) on z/OS.
For information on the features and functions provided by Natural Review, see the Natural Review documentation.
When used in this document, the notation
vr represents the relevant product
version (see also Version in the
See General Prerequisites and System Support in the section Overview of the Installation Process.
The Natural Review monitoring system requires CICS shared storage for
collecting its monitoring data. For each Natural session, a user account area
of 656 bytes is allocated plus space for a Natural call table (NCT). This table
is used to track the Natural programs and database calls issued within a
transaction. The number of NCT entries is determined by the
parameter in the source member
Step 7: Build the
Natural Review System Control Block). Each table entry is
48 bytes long and the table contains 32 entries (default). This yields a total
amount of 656+32*48=2192 bytes per running session. The storage is reused when
the session terminates.
Each active response time report requires a basic control block that is
400 bytes long. Each detail record is 128 bytes long. The maximum number of
detail records per report is controlled by the
Number of Records
in the report definition. If the
Transaction Summary option is set
in the report definition, a 64 bytes transaction summary area is allocated for
each transaction ID.
After a report has been written to the Natural Review repository file by the history session, all report-depending storage is released.
The installation medium contains the following data sets required for product installation:
|Data Set Name||Contents|
||Source modules and macros|
||Natural system file definition|
||Sample installation jobs|
Copy the data sets into your environment as described in Copying Data Sets to a z/OS Disk in the section Installing Natural.
Be sure to read Installation Process and Major Natural Features before you start the installation procedure.
(Job I005, Step 2211)
Define the following CICS table entries with RDO. You may have to include additional parameters according to your requirements. Natural Review supports transaction isolation (that is, it can run in user key).
Define the Natural Review history session start/stop transaction:
CEDA DEFINE TRANSACTION(RVH1) PROGRAM(RNMHIST3) GROUP(RNMvr)
Define the Natural Review asynchronous Natural history session transaction:
CEDA COPY TRANSACTION(xxxx) GROUP(yyyy) AS(RVH2) TO(RNMvr)
This copies your existing Natural transaction ID
xxxx from your Natural definition group
yyyy as an alias transaction for
Natural Review. This definition is optional and you may use the online Natural
xxxx as well, but it
helps the administrator identify the Natural Review asynchronous history
The transaction codes
RVH2 can be
chosen freely (that is, you may change them if required). The Natural session
transaction code must be the same as defined with the parameter
NATTRAN (in this example,
See Step 7: Build the
Natural Review System Control Block and
Installation Verification (Step 3).
Define the Natural Review history session start/stop program:
CEDA DEFINE PROGRAM(RNMHIST3) LANGUAGE(ASSEMBLER) GROUP(RNMvr)
Define the Natural Review system control block:
CEDA DEFINE PROGRAM(RNMSCB3) LANGUAGE(ASSEMBLER) RESIDENT(YES) GROUP(RNMvr)
After entering the online definitions, activate them by using
CEDA INSTALL GROUP(RNMvr). The new
GROUP should be added to the
GRPLIST defined for CICS
This table entry is optional. You can use it for automatic start and termination of the Natural Review history session during CICS startup and shutdown.
Define the Natural Review history session start/stop program:
Insert the table entry in your assembled PLTPI and/or PLTSD CICS table. This avoids manual starting and stopping of the Natural Review history session (see Step 7: Build the Natural Review System Control Block).
(Job I050, Step 2620)
You can skip this step if you have already installed a Natural Review repository file and want to continue using it. The format of the repository file is compatible with previous versions.
The repository file is an Adabas file used for storing response time reports and history data. It is possible to share the repository file across several CICS regions. Any Adabas file can be used to contain the Natural Review repository file. The corresponding file number must be defined to Natural as a logical system file (see Step 3: Build the Natural Parameter Module). The repository file has to be initialized via Natural (see Step 10: Initialize the Natural Review Repository File).
Modify the job as follows before submitting it:
Change the data set definitions according to your requirements.
DB=dbid in the
ADARUN statements to the correct database ID.
SVC=nnn to the
correct Adabas SVC number.
Change the Adabas
ADALOD statement to the file number
fnr of the Adabas file that will
contain the Natural Review repository file, and the Natural Review version
vrs you are running:
ADALOD LOAD FILE=fnr,NAME='REPOS-RNMvrs'
(Job I060, Steps 0010, 0015)
Modify the settings of the parameters supplied with the Natural parameter module as follows:
RDCSIZE=2 MADIO=5000 MAXCL=0 RCA=NATGWREV NTLFILE 180,dbid,fnr
RDCSIZE is the
Natural profile parameter that determines whether a session is monitored by
Natural Review. If you set
RDCSIZE=0 (this is the default) for a
session, it is not monitored by Natural Review.
RCA is the Natural
profile parameter required if you want to link the Natural Review monitor
interface module separate from the nucleus (see
Step 7: Build the
Natural Review System Control Block) by means of the RCA
parameter) is the macro that determines the Natural Review repository file used
SYSRNM application for retrieving and maintaining report
definitions and storing history report data for the history session. The
currently accessed repository file can be changed using the
LFILE command within Natural Review (see the
dbid is the database ID and
fnr the file number specified in
Step 2: Load the Natural Review
For details about the parameters mentioned above, see the Parameter Reference documentation.
Assemble and link the Natural parameter module.
(Job I060, Step 0020)
Link the nucleus for Natural Review by including the following module
from the Natural Review load library
Natural Review uses the Natural Data Collector exit interface to get
data from Natural. For more information on the
Collector, see the Natural
SYSRDC utility described in the
The Natural Review module
RNMNUC3 supports all different
ways of statically linked Natural subprograms. For more information about
linking the nucleus, see Linking Natural Objects to the Natural
Nucleus in the Natural Operations
If you run an environment-independent nucleus
for multiple environments (for example, CICS and batch), link
RNMNUC3 to the environment-dependent nucleus, because Natural
Review monitoring runs under CICS only. This prevents unnecessary overload in
your non-CICS systems.
RNMNUC3 is not linked to the
nucleus, the following CICS assembler command level stub from the
CICS load library must be linked to
Instead of linking
RNMNUC3 to the nucleus, you can link
it as a separate module defined with the Natural profile parameter
(described in the Parameter Reference documentation). The
following linkage editor statements are then required:
MODE RMODE(ANY) INCLUDE CICSLIB(DFHEAI) INCLUDE RNMLIB(RNMNUC3) ENTRY NATGWREV NAME NATGWREV
MODE statement is optional. A CICS PPT entry is
required for the module
NATGWREV. It must be specified with the
Step 3: Build the
Natural Parameter Module). The module can be shared
between multiple Natural nuclei.
(Job I061, Step 2661)
If you want to continue using a profile text object
DEFAULT you modified according to your requirements, rename your
DEFAULT object in the
SYSRNM library before you start
loading the new Natural objects.
Load the Natural objects specific to Natural Review from the
RNMvrs.INPL data set into your
FNAT system file by using the Natural
It is sufficient to load the Natural objects only into one
FNAT system file even if you want to monitor other
FNAT system files as well.
The Natural Review User Profile Subsystem is initialized when the
profile text object
DEFAULT is copied to the
If you renamed the profile text object
DEFAULT in the
first step, replace the newly loaded
DEFAULT by this object.
This step only applies if Natural Security is installed.
Define the Natural Review library
SYSRNM in Natural
You can define a startup menu for the
SYSRNM library. If
the library is
People-protected, each user of this library must be
linked to it.
REVHIST as a user of type
with a default application of
REVHIST is used
as the user ID by the Natural Review history session.
(Job I070, Steps 2622, 2623)
The Natural Review System Control Block
RNMSCB3 is defined
as a program in CICS.
RNMSCB3 is not an executable program. Its
storage is used by Natural Review as the common anchor and control point for
all monitored Natural sessions and reports within one CICS address space. There
are some installation-specific generation parameters you can specify in object
RNMSCB3 in the Natural Review source library.
Set the following parameters in
RNMSCB3 according to
||This is the Natural/CICS transaction code for the Natural Review history session. You must specify this parameter to set the correct Natural transaction code (see Step 1: Add CICS Control Table Entries for Natural Review).|
||Additional dynamic Natural parameters for the Natural Review history session. This parameter is optional.|
||This parameter determines the number of entries in the
Natural Call Table (NCT) of Natural Review. The NCT is allocated in CICS shared
storage and is used to track the usage of the Natural programs per session.
The default setting is
Modify and run the job
RNMI070 to generate the Natural
Review System Control Block. The module must be linked with the
NORENT option. The target link library can be any library defined
(Job I070, Step 2625)
Natural Review history data is written to the Natural Review repository file by an asynchronous (that is, not terminal-bound) Natural session.
Modify and run job
RNMLINK in the Natural Review source
It links the CICS-dependent history session startup module
RNMHIST3. The target link library can be any library defined to
There can be only one history session within one CICS address space.
The Natural objects specific to Natural Review (see
Step 5: Load New Natural
Objects) must be loaded to the
file running with the history session.
Use the following
CEMT transaction to activate the
nucleus module to which
RNMNUC3 and the modified Natural parameter
module are linked:
CEMT SET PROGRAM(. . . .) NEWCOPY
Restart CICS if you cannot activate the nucleus module.
Skip this step if your Natural Review repository file is already initialized.
Initialize the repository file after loading it in Step 2: Load the Natural Review Repository File:
Logon to the
SYSRNM library and enter the following at
The following messages will then appear:
Now creating sample report system response time Now creating sample report highest response Natural Review repository initialization complete. Press <ENTER> to continue
During the initialization process, two default (
response time reports are added as shown above.
You can verify the successful installation of Natural Review by performing the following steps:
At any Natural command prompt, enter the following:
Natural Review is started and a Natural Review logo screen similar to the example below appears:
17:30:01 ***** REVIEW NM UTILITY ***** date RRRRRRRR EEEEEEE VVV VVV III EEEEEEE WWW WWW RRRRRRRRR EEEEEEE VVV VVV III EEEEEEE WWW WWW RRR RRR EEE VVV VVV III EEE WWW WWW RRR RRR EEE VVV VVV III EEE WWW WWW RRRRRRRR EEEEEE VVV VVV III EEEEEE WWW W WWW RRRRRRRR EEEEEE VVV VVV III EEEEEE WWW WW WWW RRR RRR EEE VVV VVV III EEE WWW WWWW WWW RRR RRR EEE VVV VVV III EEE WWW WWWWWW WWW RRR RRR EEEEEEE VVVVVV III EEEEEEE WWWWW WWWWW RRR RRR EEEEEEE VVVV III EEEEEEE WWW WWW N A T U R A L M O N I T O R A P R O D U C T O F S O F T W A R E A G
(You can suppress this screen by specifying
the text object
CONFIG in the library
Press ENTER to invoke the Natural Review Main Menu screen:
17:30:17 ***** REVIEW NM UTILITY ***** date - Main Menu - Code Function NM Natural Monitor System UP User Profile System Command ===> REV00001 - Welcome to Review NM running under CICS Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Fin
Alternatively, you can invoke this menu by logging on to the Natural
SYSRNM and then entering the following command:
In the command line of the Natural Review Main Menu screen, enter either of the following commands:
Depending on the command entered, the main screen of the requested subsystem appears. You can then check your installation parameters and the status of the history session. For detailed information on the functions provided by the subsystems, see the Natural Review documentation.
If you want to run history reports, start the history session. It runs as an asynchronous (non-terminal) Natural session and writes the collected report data to the repository file each time a report time interval has expired.
You can start and stop the history session either automatically by
using the CICS PLTPI/PLTSD (see Step 1: Add CICS Control Table Entries for
Natural Review), or manually outside Natural by using the
RVH1 transaction (see Step 1: Add CICS Control Table Entries for
Natural Review) in the following ways:
||Start the Natural Review history session with the transaction
The history session can also be started with the
||Terminate the Natural Review history session.
The history session can also be terminated with the
||Start the Natural Review history session on the current
This option can be used for debugging purposes, for example, to debug the history session with CEDF (the CICS debugging facility).
Note that no Natural terminal I/O operations are supported during the normal processing of the history session. Therefore, you have to terminate the history session from another terminal.
Check the Natural Review initialization messages on the console log of
your CICS system to find out whether the history session has started
successfully. The following message should appear:
REV20200 - REVIEW
NM HISTORY SESSION STARTED.
For more detailed explanations of the messages in Natural Review,
MSG followed by the message number (for example,
1) in the command line of Natural Review.