Technical Information

This section covers the following topics:

Functional Overview

The Technical Information function displays Natural Monitor environmental information and history session information.

Purpose of the Technical Information Function

This function is useful for determining the following:

  • Environmental Information

    • the environment in which Natural Monitor is executing;

    • the version maintenance levels of the Natural Monitor code; and

    • various parameters and statistical information.

  • History Session Control

    • shows details about the Natural Monitor history session definitions and history session status; and

    • allows starting and stopping the history session.

Accessing the Technical Information Function

You can access the Natural Monitor Technical Information function in one of two ways:

  • from any screen outside the Natural Monitor System, type the code NM TE on the command line and press ENTER; or

  • from any screen within the Natural Monitor System, type TE on the command line and press ENTER. 

16:05:44                 ***** REVIEW NM UTILITY *****               2006-03-02
                             - Technical Information -
  
  
                    Code              Description
  
                     EI          Environmental Information
                     HC          History Session Control
  
  
  
  
  
  
  
  
  
  
  Command ===>
  Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
        Help        Exit                                                  Menu

The functions available from this menu are described in the following table:

Code Function Description
EI Environmental Information Gives an overview of the environment.
HC History Session Control Shows details about the history session and allows starting and stopping the history session.

Accessing the Environmental Information

Start of instruction setTo access the Environmental Information screen

  • Type EI on the command line and press ENTER.

The Environmental Information screen appears as shown below: 

16:06:46                 ***** REVIEW NM UTILITY *****               2006-03-02
                          - Environmental Information -
  
  
  TP System .............. CICS/MVS 2.1.0  Reports Currently Active            2
  Natural Code Version ..... SYSRNM 3.6.1  Max. Active Reports ......          2
  Driver Version ......... NATGWREV 3.6.1  Report Start Requests ....          2
  Assembly Date .............. 2000/08/11
  Assembly Time ................ 13:51:00  Session Logons ...........          1
                                           Session Logoffs ..........          0
  Number of RUABs Allocated ....        1  Sessions Logged On .......          1
  Number of Entries per NCT ....       32  Max. Sessions Logged On ..          1
  System Start Date .......... 2000/09/01
  System Start Time ............ 09:48:21  Total Transactions .......         62
                                           Average Response Time ....      0.149
  Shared Storage Allocated .....     7712
  Max. Shared Storage Alloc. ...     7712  Total Database Calls .....       4697
                                           Average Database Time ....      0.001
                                           Average Adabas Cmd Time ..    0.00012
  
  
  Command ===>
  Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
        Help        Exit                          HC                      Canc

The following commands are available:

Command PF Key Description
HC PF8 Go to History Session Control.
RESET   Reset all transaction and database statistic field values to zero and release all unused RUAB storage.

The following fields are displayed for this function:

Field Description
TP System CICS version under which the Natural Monitor is executing.
Natural Code Version The version of the Natural code of Natural Monitor in library SYSRNM.
Driver Version The version of the linked nucleus module of Natural Monitor.
Assembly Date Assembly date of the Natural Monitor system control block RNMSCB.
Assembly Time Assembly time of the Natural Monitor system control block RNMSCB.
Number of RUABs Allocated The number of Natural Monitor user account blocks (RUABs) allocated in CICS shared storage. One RUAB is used to monitor one Natural session. It can be reused after session termination.
Number of Entries per NCT Number of entries in the Natural Call Table (NCT) of Natural Monitor. The NCT is part of each RUAB. It is used to monitor the usage of the Natural objects executed during one session.
System Start Date The date when the first Natural session was monitored by Natural Monitor.
System Start Time The time when the first Natural session was monitored by Natural Monitor.
Shared Storage Allocated The total amount of CICS shared storage in bytes acquired by Natural Monitor.
Max. Shared Storage Alloc. The highest amount of CICS shared storage in bytes acquired by Natural Monitor since system startup.
Reports Curr. Active The number of reports that are currently active.
Report Start Requests The total number of report start requests since system startup.
Session Logons The total number of Natural sessions which were monitored by Natural Monitor since system startup.
Session Logoffs The total number of Natural sessions terminated which were monitored by Natural Monitor.
Session Logged On The number of Natural sessions currently monitored by Natural Monitor.
Max. Sessions Logged On The maximum number of Natural sessions concurrently monitored by Natural Monitor.
Total Transactions The total number of Natural transactions monitored by Natural Monitor. A transaction lasts from screen input time until next screen output.
Average Response Time The average response time in seconds for all transactions monitored by Natural Monitor.
Total Database Calls The total number of database calls for all sessions monitored by Natural Monitor.
Average Database Time The average database call response time for all sessions monitored by Natural Monitor.
Average Adabas Command Time The average Adabas call command time for all sessions monitored by Natural Monitor. The command time value is passed back by Adabas with every Adabas call.

Accessing the History Session Control

Start of instruction setTo access the History Session Control screen:

  • Type HC on the command line and press ENTER.

The History Session Control screen appears as shown below: 

15:00:41                 ***** REVIEW NM UTILITY *****               2010-06-10
                          - History Session Control -                          
                                                                               
                                                                               
Transaction Id ................... QA42  Start Date .............. 2010/06/09  
Current Status ...........   terminated  Start Time ................ 21:40:31  
Natural User Id ..............  REVHIST  End Date ................ 2010/06/09  
Database Id of Repository File .. 19999  End Time .................. 21:40:34  
Database Fnr of Repository File .. 1601                                        
Date Format in Repository File .... OLD                                        
Logging of empty reports ..........  NO                                        
                                                                               
                          Dynamic Profile Parameters                           
                                                                               
PRINTER=OFF,WORK=OFF,PROFILE=RNMQA                                             
AUTO=ON PC=OFF ETID=' ' PROGRAM=RNMHIST3 PSEUDO=OFF TTYPE=PRNT                 
SENDER=CONSOLE ASYNNAME=REVHIST STACK=(LOGON SYSRNM;P-NMHIST)                  
                                                                               
                                                                               
                                                                               
                                                                               
Command ===>                                                                   
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit                    EI                            Canc

The following commands are available:

Command PF Key Description
EI PF7 Go to Environmental Information.
START   Start the Natural Monitor history session.
STOP   Terminate the Natural Monitor history session.

The following fields are displayed for this function:

Field Description
Transaction Id The CICS transaction under which the Natural Monitor history session is running.
Current Status
The current status of the history session. This field can have the following values:
not started No session started
initializing Session initializing
active Processing history data
inactive Waiting for interval time expired
terminating  Session terminating
 
Natural User Id The Natural user ID (*USER) of the Natural Monitor history session.
Database Id of Repository File The database ID number of the Natural Review repository file.
Database Fnr of Repository File The database file number of the Natural Review repository file.
Date Format in Repository File
Indicates the date format for reports written to the repository file. Possible values are:
OLD The date format is YY/MM/DD
NEW  The date format is YYYYMMDD
 
Logging of empty reports Indicates whether empty reports are written to the repository file.

Possible values are: YES or NO.

Start Date The start date of the Natural Monitor history session.
Start Time The start time of the Natural Monitor history session.
End Date The termination date of the Natural Monitor history session.
End Time The termination time of the Natural Monitor history session.
Dynamic Profile Parameters The dynamic profile parameters for the start of the Natural Monitor history session.