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.
To invoke the call statistics maintenance function
In the Debug Main Menu enter function code C.
Or:
Enter the following direct command:
CS
The Call Statistics Maintenance menu is displayed.
The functions provided in the Call Statistics Maintenance menu are explained in the following section whereas all print functions are described in Print Objects.
See the section Switch Test Mode On and 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.
To set call statistics to ON or OFF
In the Call Statistics Maintenance menu, enter function code
C to activate or deactivate call statistics.
Or:
Enter one of the following direct commands:
SET CALL ON
or
SET CALL OFF
Note
If the 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.
This function provides an overview of the call frequency of all objects contained in a library.
To display the call frequency of all objects in a library
In the Call Statistics Maintenance menu, enter function code
1 and a library name.
Or:
Enter the following direct command:
DISPLAY OBJECT library
See also the syntax of DISPLAY in Command Summary and
Syntax.
If you do not specify a library name, the library where you are currently logged on is assumed by default.
A Display Call Statistics screen similar to the example screen shown in Display Called Objects appears.
The Display Call Statistics screen lists all objects in the
specified library and indicates their call frequency in the
Calls column on the right-hand side. For each call statement,
such as FETCH or CALLNAT, an entry with the name of the
object and a counter variable is written into the debug buffer. The counter is then
increased for each call of the corresponding object.
The screen invoked by this function corresponds to the Display Call Statistics screen, but only the objects that have been invoked are displayed.
To display called objects of a library
In the Call Statistics Maintenance menu,
enter function code 2 and a library name.
Or:
Enter the following direct command:
DISPLAY CALL library
See also the syntax of DISPLAY in Command Summary and
Syntax.
The Display Called Objects screen appears:
16:06:53 ***** NATURAL TEST UTILITIES ***** 2002-02-15
Test mode ON - Display Called Objects - Object
All
Object Library Type DBID FNR S/C Ver Cat Date Time Calls
*_______ SAG_____
MAINPGM SAG Program 10 32 S/C 3.1 2002-02-15 11:51 1
SUBPGM SAG Subprogram 10 32 S/C 3.1 2002-02-15 11:50 3
EMP-PGM SAG Program 10 32 S/C 3.1 2002-01-22 11:49 2
EMPLIND SAG Program 10 32 S/C 3.1 2001-08-13 11:18 1 |
If you do not specify a library name, the library where you are currently logged on is assumed by default.
The screen invoked by this function corresponds to the Display Call Statistics screen, but only the objects that have not been invoked are displayed.
To display non-called objects
In the Call Statistics Maintenance menu, enter function code
3 and a library name.
Or:
Enter the following direct command:
DISPLAY NOCALL library
See also the syntax of DISPLAY in Command Summary and
Syntax.
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.
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 enter either a function code in the Statement Execution Statistics Maintenance menu, a line command on the Display Statement Lines screen, or a direct command at the command prompt.
| Print Function | Function Code | Direct Command |
|---|---|---|
| All Objects | PRINT OBJECT library
|
|
| Called Objects | PRINT CALL library
|
|
| Non-Called Objects | PRINT NOCALL
library
|
See also the syntax of PRINT in Command Summary and
Syntax.
Example of Generating and Printing Statistics in Batch in the section Batch Processing
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.
To download a list to a PC
At session start, specify the profile parameter PRINT as
follows:
PRINT=((1),AM=PC)
After session start, activate the PC connection using the following terminal command:
%+
Invoke and activate the debugger.
Invoke the User Profile screen by entering the debugger
command PROFILE
(see Navigation and Information Commands).
On the User Profile screen, in the Output
device field, replace the current entry by PCPRNT01 and
choose PF3 (Exit) to save the settings.
Activate the function and execute the application for which you want the debugger to collect statistics data.
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.
