Difference between revisions of "DISPLAY PROFILE"

From Recital Documentation Wiki
Jump to: navigation, search
(Class)
 
(One intermediate revision by one user not shown)
Line 1: Line 1:
 
 
 
==Purpose==
 
==Purpose==
 
Displays input/output, locking and procedure call statistics for profiled code
 
Displays input/output, locking and procedure call statistics for profiled code
Line 10: Line 8:
  
 
==See Also==
 
==See Also==
[[CLEAR PROFILE]], [[DEBUG]], [[DISPLAY IOSTATS]], [[DO]], [[Function Keys]], [[IOSTATS()]], [[LIST IOSTATS]], [[LIST PROFILE]], [[PROFILE]], [[SET CLUSTERING]], [[SET COMPILE]], [[SET DCACHE]], [[SET DEVELOPMENT]], [[SET ICACHE]], [[SET IOLOGGING]], [[SET IOSTATS]], [[SET LOCKTYPE]], [[SET PROFILE]], [[SET REPLICATION]], [[SET SYSLOGGING]]
+
[[CLEAR PROFILE]], [[DEBUG]], [[DISPLAY IOSTATS]], [[DO]], [[Function Keys]], [[IOSTATS()]], [[LIST IOSTATS]], [[LIST PROFILE]], [[PROFILE]], [[SET COMPILE]], [[SET DCACHE]], [[SET DEVELOPMENT]], [[SET ICACHE]], [[SET IOLOGGING]], [[SET IOSTATS]], [[SET LOCKTYPE]], [[SET NETWORK]], [[SET PROFILE]], [[SET REPLICATION]], [[SET SYSLOGGING]]
  
  
Line 22: Line 20:
 
The first part of the display shows current settings:
 
The first part of the display shows current settings:
  
* [[SET CLUSTERING|cluster]]
+
* [[SET NETWORK|cluster]]
 
* [[SET REPLICATION|replication]]
 
* [[SET REPLICATION|replication]]
 
* [[SET IOLOGGING|iologging]]
 
* [[SET IOLOGGING|iologging]]
Line 88: Line 86:
  
 
==Products==
 
==Products==
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
+
Recital Server, Recital  
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Latest revision as of 14:44, 13 January 2010

Purpose

Displays input/output, locking and procedure call statistics for profiled code


Syntax

DISPLAY PROFILE


See Also

CLEAR PROFILE, DEBUG, DISPLAY IOSTATS, DO, Function Keys, IOSTATS(), LIST IOSTATS, LIST PROFILE, PROFILE, SET COMPILE, SET DCACHE, SET DEVELOPMENT, SET ICACHE, SET IOLOGGING, SET IOSTATS, SET LOCKTYPE, SET NETWORK, SET PROFILE, SET REPLICATION, SET SYSLOGGING


Description

The DISPLAY PROFILE command works in conjunction with the PROFILE and SET PROFILE commands to list input/output, locking and procedure call statistics for a particular application or part of an application. This information can be used for analysis to enable application optimization and general performance tuning.

DISPLAY differs from the LIST command in that it pauses every 17 lines until a key is pressed. You can cancel any further output at this point by pressing the [ABANDON] key. Where the output is sent to a file or printer, the pause is disabled.


Profiler environment settings

The first part of the display shows current settings:


Profiler data

Profiler data information is then shown for each profiled code section

  • count
  • icachereads
  • icachewrites
  • ireads
  • iwrites
  • readlocks
  • writelocks
  • unlocks
  • disk reads
  • disk writes
  • elapsed time
  • disk operations
  • locking operations
  • procedure calls
  • function calls


Profiler procedure calls

The final part of the display shows procedure call statistics:

  • Name of procedure
  • Number of times called
  • Time in procedure (second, milliseconds, microseconds)


Output keywords

Keyword Description
TO <file> The display output will be sent to the specified file. The filename can be substituted with a <expC>, enclosed in round brackets, which returns a valid filename. If no file extension is specified, then ".txt" will be used. The command SET PAGELENGTH governs the output file pagination and SET PAGEWIDTH defines the width of each page. Page numbers are centered on the bottom of the page according to width.
TO PRINT The display output will be sent to a printer. The TO PRINT option will default to a local printer unless the command SET PRINTER TO \\SPOOLER is issued. The print request will then be spooled to the system printer, which is defined by the environment variable DB_PRINT.


Example

profile do myapp
display profile


Products

Recital Server, Recital