Difference between revisions of "LIST PROFILE"

Latest revision as of 10:52, 5 February 2013

Purpose

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

Syntax

LIST PROFILE [TO FILE <.txt filename> | (<expC>) ]

Description

The LIST 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.

Profiler environment settings

The first part of the listing shows current settings (certain are internal and cannot be changed):

cluster
replication
iologging
syslogging
iostats
dcache
fcache
icache
dcache
development
compile
locktype
Preallocated symbols
Preallocated symbols used
Preallocated symbols available

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

Example

profile myapp
list profile to file profile.txt
vi profile.txt

@@ Line 1: / Line 1: @@
 ==Purpose==
 Lists input/output, locking and procedure call statistics for profiled code
 ==Syntax==
-LIST PROFILE [TO FILE <.txt filename> | (<expC>) ] | [TO PRINT]
+LIST PROFILE [TO FILE <.txt filename> | (<expC>) ]
 ==See Also==
-[[CLEAR PROFILE]], [[DB_PRINT]], [[DEBUG]], [[DISPLAY IOSTATS]], [[DISPLAY PROFILE]], [[DO]], [[IOSTATS()]], [[LIST IOSTATS]], [[PROFILE]], [[SET COMPILE]], [[SET DCACHE]], [[SET DEVELOPMENT]], [[SET ICACHE]], [[SET IOLOGGING]], [[SET IOSTATS]], [[SET LOCKTYPE]], [[SET NETWORK]], [[SET PAGELENGTH]], [[SET PAGEWIDTH]], [[SET PRINTER]], [[SET PROFILE]], [[SET REPLICATION]], [[SET SYSLOGGING]]
+[[CLEAR PROFILE]], [[DEBUG]], [[DISPLAY IOSTATS]], [[DISPLAY PROFILE]], [[DO]], [[IOSTATS()]], [[LIST IOSTATS]], [[PROFILE]], [[SET COMPILE]], [[SET DCACHE]], [[SET DEVELOPMENT]], [[SET ICACHE]], [[SET IOLOGGING]], [[SET IOSTATS]], [[SET NETWORK]], [[SET PROFILE]]]
 ==Description==
 The LIST 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.
 ====Profiler environment settings====
-The first part of the listing shows current settings:
+The first part of the listing shows current settings (certain are internal and cannot be changed):
 * [[SET NETWORK|cluster]]
-* [[SET REPLICATION|replication]]
+* replication
 * [[SET IOLOGGING|iologging]]
-* [[SET SYSLOGGING|syslogging]]
+* syslogging
 * [[SET IOSTATS|iostats]]
 * [[SET DCACHE|dcache]]
@@ Line 29: / Line 25: @@
 * [[SET DEVELOPMENT|development]]
 * [[SET COMPILE|compile]]
-* [[SET LOCKTYPE|locktype]]
+* locktype
 * Preallocated symbols
 * Preallocated symbols used
 * Preallocated symbols available
 ====Profiler data====
@@ Line 53: / Line 48: @@
 * procedure calls
 * function calls
 ====Profiler procedure calls====
@@ Line 61: / Line 55: @@
 * Number of times called
 * Time in procedure (second, milliseconds, microseconds)
 ====Output keywords====
+{| class="wikitable" width="100%"
-{| class="wikitable"
+!width="15%"|Keyword||Description
-!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.
+|valign="top"|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.
 |-
 |}
 ==Example==
@@ Line 82: / Line 71: @@
 vi profile.txt
 </code>
-==Products==
-Recital Server, Recital
 [[Category:Documentation]]
 [[Category:Commands]]
 [[Category:Performance and Optimization]]
-[[Category:Performance and Optimization Commands]]