Technical Information

#### Search Results

Search

# Technical Information

This section covers the following topics:

- Functional Overview

- Accessing the Environmental Information

- Accessing the History Session Control

## Functional Overview

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

- Purpose of the Technical Information Function

- Accessing the Technical Information Function

### 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

To 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 (`RUAB`s) 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

To 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.

### On this page

- Functional Overview
- Accessing the Environmental Information
- Accessing the History Session Control