Difference between revisions of "LIST PROFILE"
From Recital Documentation Wiki
Yvonnemilne (Talk | contribs) |
Yvonnemilne (Talk | contribs) |
||
| (12 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
==Purpose== | ==Purpose== | ||
| − | + | Lists input/output, locking and procedure call statistics for profiled code | |
| Line 14: | Line 8: | ||
==See Also== | ==See Also== | ||
| − | [[CLEAR PROFILE]], [[DB_PRINT]], [[DEBUG]], [[DISPLAY PROFILE]], [[DO]], [[ | + | [[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]] |
==Description== | ==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: | ||
| + | |||
| + | * [[SET NETWORK|cluster]] | ||
| + | * [[SET REPLICATION|replication]] | ||
| + | * [[SET IOLOGGING|iologging]] | ||
| + | * [[SET SYSLOGGING|syslogging]] | ||
| + | * [[SET IOSTATS|iostats]] | ||
| + | * [[SET DCACHE|dcache]] | ||
| + | * [[SET FCACHE|fcache]] | ||
| + | * [[SET ICACHE|icache]] | ||
| + | * [[SET DCACHE|dcache]] | ||
| + | * [[SET DEVELOPMENT|development]] | ||
| + | * [[SET COMPILE|compile]] | ||
| + | * [[SET LOCKTYPE|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==== | ||
| Line 36: | Line 82: | ||
vi profile.txt | vi profile.txt | ||
</code> | </code> | ||
| + | |||
==Products== | ==Products== | ||
| + | Recital Server, Recital | ||
[[Category:Documentation]] | [[Category:Documentation]] | ||
[[Category:Commands]] | [[Category:Commands]] | ||
| + | [[Category:Performance and Optimization]] | ||
| + | [[Category:Performance and Optimization Commands]] | ||
Latest revision as of 14:42, 13 January 2010
Contents
Purpose
Lists input/output, locking and procedure call statistics for profiled code
Syntax
LIST PROFILE [TO FILE <.txt filename> | (<expC>) ] | [TO PRINT]
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
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:
- 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. 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 myapp list profile to file profile.txt vi profile.txt
Products
Recital Server, Recital
