Version 4.2.6 for Mainframes
 —  Debugger  —

Call Statistics Maintenance

This function is used to obtain statistical information on which Natural objects were invoked during the execution of an application, and information on how often an object was invoked. Call statistics are deleted after resetting the debug environment.

Start of instruction set To invoke the call statistics maintenance function

The functions provided in the Call Statistics Maintenance menu are explained in the following section whereas all print functions are described in Print Objects.


Set Test Mode ON/OFF

See the section Switch Test Mode On and Off.

Top of page

Set Call Statistics ON/OFF

When executing a Natural object with call statistics set to ON, all calls made to a specific object are counted and the resulting statistics can afterwards be displayed or printed.

Start of instruction setTo set call statistics to ON or OFF

Note:
If the call statistics function is switched off and no call statistics have been created or call statistics have been deleted by resetting the debug environment, the information stored for statement execution statistics (see Statement Execution Statistics Maintenance) is used for display. This allows you to detect the non-invoked Natural objects during the execution of an application.

Top of page

Display All Objects

This function provides an overview of the call frequency of all objects contained in a library.

Start of instruction setTo display the call frequency of all objects in a library

Top of page

Display Called Objects

The screen invoked by this function corresponds to the Display Call Statistics screen, but only the objects that have been invoked are displayed.

Start of instruction set To display called objects of a library

If you do not specify a library name, the library where you are currently logged on is assumed by default.

Top of page

Display Non-Called Objects

The screen invoked by this function corresponds to the Display Call Statistics screen, but only the objects that have not been invoked are displayed.

Start of instruction setTo display non-called objects

If you do not specify a library name, the library where you are currently logged on is assumed by default.

For an example screen, see Display Called Objects above.

Top of page

Print Objects

With the print functions, you can directly route a generated list of call statistics to a printer or download the list to a PC. You specify a printer as the output device on the User Profile screen of the debugger. Use the debugger command PROFILE (see the section Navigation and Information Commands) to invoke this screen.

If you do not specify a library name, the library where you are currently logged on is assumed by default.

As indicated under Print Options below, to invoke one of the print functions, you can either enter a function code in the Call Statistics Maintenance menu, or enter a direct command.

Print Options

Print Function Function Code Direct Command
All Objects 4 PRINT OBJECT library
Called Objects 5 PRINT CALL library
Non-Called Objects 6 PRINT NOCALL library

See also the syntax of PRINT in Command Summary and Syntax.

Related Topic:

Example of a PC Download

If Entire Connection and Natural Connection are installed at your site, you can download a statistics list to a PC as described in the following instructions.

Start of instruction setTo download a list to a PC

  1. At session start, specify the profile parameter PRINT as follows:

    PRINT=((1),AM=PC)
  2. After session start, activate the PC connection using the following terminal command:

    %+
  3. Invoke and activate the debugger.

  4. Invoke the User Profile screen by entering the debugger command PROFILE (see Navigation and Information Commands).

  5. On the User Profile screen, in the Output device field, replace the current entry by PCPRNT01 and choose PF3 (Exit) to save the settings.

  6. Activate the call statistics function and execute the application for which you want the debugger to collect statistics data.

  7. From the statistics screen, choose a print function.

    In the Entire Connection window that appears, you can specify the output file and the PC directory.

Top of page