Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

Recording measurement data with openSM2

The Software Monitor openSM2 in BS2000 systems records statistical data on performance and the utilization of resources.

openUTM can supply openSM2 with UTM application data which is important for an initial evaluation of performance. The set of data is independent of the size of the configuration. The data indicates the behavior of the entire application.

The measurement data recorded by openSM2 is evaluated by the openSM2 component SM2R1, as well as the openSM2 component SM2-PA for evaluating user-specific measurement files. openSM2 collects measured values and, on request, outputs them directly to the terminal for realtime monitoring (online). openSM2 also collects the measurement data in a file, and the stored data can be evaluated at a later stage on request (offline).

Other openSM2 functions are also available for checking the performance of a UTM application, e.g. global process evaluation or measuring the processes of a UTM application and program analysis by SM2-PA.

Prerequisites for recording UTM measurement data by openSM2

To enable openUTM to supply data to openSM2 and to enable openSM2 to collect, store and edit UTM data, the following requirements must be fulfilled.

  • The UTM-SM2 subsystem must be installed and loaded.

    In order for openUTM to supply data to openSM2, the UTM-SM2 subsystem is required. UTM-SM2 acts as a communication component between the tasks of the UTM application and openSM2. It is implemented as a separate subsystem and is included in BS2000-GA (basic configuration). For a description of how the BS2000 system administrator is to install the UTM-SM2 subsystem, see "UTM-SM2 subsystem" of the Appendix.

    UTM-SM2 can be loaded as follows:

    1. By the BS2000 system administrator with the command:

      /START-SUBSYSTEM SUBSYSTEM-NAME=UTM-SM2

    2. Automatically at the start of the application if the application is generated with MAX SM2=ON.

    3. When activating the supply of data via the administration (see below). The application must be generated with MAX SM2=OFF or MAX SM2=ON.

    If required, the UTM-SM2 subsystem can be unloaded during operation using the STOP-SUBSYSTEM command. This is necessary when exchanging the subsystem, for example. openSM2 and the UTM applications then automatically terminate their cooperation with UTM-SM2.

    After the subsystem has been loaded dynamically, data supply must be reactivated explicitly for each UTM application.

  • Data supply from openUTM to openSM2 must be generated in the UTM application.

    In order that openUTM can supply UTM application data to openSM2, this function must be specified when generating the application. In this case, specify the value ON or OFF in the SM2 operand of the MAX statement.

    If you specify MAX...,SM2=ON, data supply to openSM2 is automatically activated when the application starts. If required, it can then be deactivated and reactivated again during operation using UTM administration functions.

    If you specify MAX...,SM2=OFF, data supply to openSM2 is permitted for this application. However, it must be explicitly activated during operation using UTM administration functions.

    If MAX ...,SM2=NO is generated, UTM does not supply data to openSM2 for this application. In this case, data supply cannot be activated by UTM administration either.

     

  • Data supply to openSM2 is activated by UTM administration functions.

    The UTM administrator can use the command KDCAPPL SM2=ON to activate data supply to openSM2 if this was allowed for in the UTM generation. Data supply is deactivated with KDCAPPL SM2=OFF.

    Using the KDCINF SYSPARM command, the UTM administrator can define whether or not the application is permitted to supply data to openSM2 and whether it is currently supplying data.

    Data supply to openSM2 can also be activated and deactivated using the “program interface for administration” or using the graphical administration tools WinAdmin/WebAdmin.

  • The openSM2 administrator (privileged openSM2 user) must initiate the collection of UTM data by openSM2.

    The openSM2 administrator must use the command

    START-MEASUREMENT-PROGRAM TYPE=UTM

    to instruct openSM2 to collect and evaluate data on UTM applications. The STOP-MEASUREMENT-PROGRAM command is used to deactivate the function. If the UTM-SM2 subsystem is loaded, the collection of UTM data can be activated at any time on the openSM2 side, regardless of whether or not data supply is activated on the UTM side. However, openSM2 cannot begin to process the data until data supply is activated by openUTM.

Output and evaluation of measurement data

The openSM2 user can display the data supplied by openUTM on an openSM2 screen in online mode (UTM report or UTM application report). openSM2 also stores the data in a global system measurement file. This means that the data can also be evaluated by SM2R1 at a later stage.

The openSM2 screen “UTM-REPORT” contains a tabular overview of data for all UTM applications currently supplying data to openSM2. One line is output for each UTM application.

The openSM2 screen “UTM-REPORT” can be output periodically with the command:

REPORT UTM

Current measured values for one or more selected UTM applications are supplied in the openSM2 screen “UTM-APPLICATION-REPORT”.

The openSM2 screen “UTM-APPLICATION-REPORT” can be output periodically with the command:

SELECT-UTM-APPLICATION (application1,application2,...)

For application1,application2,... specify the names of the UTM applications whose behavior you want to monitor in online mode. For application1,.. you must specify the application name generated in the MAX statement.

The meaning of the data output is explained in the “openSM2” User Guide; the terms used are consistent with openUTM usage.

In addition to the option of monitoring the measurement data online, the following evaluations of data from UTM applications are possible with SM2R1:

  • reports 128 through 133

  • SUMMARY UTM

See also the “openSM2” User Guide.