Difference between revisions of "DISPLAY IOSTATS"

From Recital Documentation Wiki
Jump to: navigation, search
 
(Output keywords)
 
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{YLM to do}}
 
 
==Class==
 
Performance and Optimization
 
 
 
 
==Purpose==
 
==Purpose==
 
+
Display logged input/output statistics
  
  
 
==Syntax==
 
==Syntax==
DISPLAY IOSTATS
+
DISPLAY IOSTATS [TO FILE <.txt filename> | (<expC>)] | [TO PRINT]
  
  
 
==See Also==
 
==See Also==
[[CLEAR PROFILE]], [[DEBUG]], [[DISPLAY PROFILE]], [[DO]], [[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]], [[DB_PRINT]], [[DEBUG]], [[DISPLAY PROFILE]], [[DO]], [[IOSTATS()]], [[LIST IOSTATS]], [[LIST PROFILE]], [[PROFILE]], [[SET COMPILE]], [[SET DCACHE]], [[SET DEVELOPMENT]], [[SET ICACHE]], [[SET IOLOGGING]], [[SET IOSTATS]], [[SET LOCKTYPE]], [[SET NETWORK]], [[SET PRINTER]], [[SET PROFILE]], [[SET REPLICATION]], [[SET SYSLOGGING]]
  
  
 
==Description==
 
==Description==
 +
The DISPLAY IOSTATS command is used to display logged input/output statistics.  SET IOSTATS must be ON for I/O statistics to be logged.
  
 +
====Environment settings====
 +
The first part of the display 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]]
 +
 +
====Statistics====
 +
The statistics follow:
 +
 +
* opens
 +
* creates
 +
* closes
 +
* icreates
 +
* iopens
 +
* icloses
 +
* reads
 +
* writes
 +
* deletes
 +
* appends
 +
* dcachereads
 +
* dcachewrites
 +
* icachereads
 +
* icachewrites
 +
* ireads
 +
* iwrites
 +
* gcachereads
 +
* gcachewrites
 +
* gcachehits
 +
* gcacheturns
 +
* readlocks
 +
* writelocks
 +
* unlocks
 +
* fstatfs
 +
* keystrokes
 +
* popens
 +
* pcloses
 +
* doprocs
 +
* dofuncs
 +
* copies
 +
* disk reads
 +
* disk writes
 +
* elapsed time
 +
* disk operations
 +
* locking operations
 +
 +
DISPLAY commands differ from LIST commands in that they pause every screen 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.
 +
 +
====Output keywords====
 +
 +
{| class="wikitable"
 +
!Keyword||Description
 +
|-
 +
|TO FILE <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==
 
==Example==
Line 26: Line 87:
 
</code>
 
</code>
  
==Products==
 
  
 +
==Products==
 +
Recital, Recital Server
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 +
[[Category:Performance and Optimization]]
 +
[[Category:Performance and Optimization Commands]]

Latest revision as of 16:07, 10 April 2012

Purpose

Display logged input/output statistics


Syntax

DISPLAY IOSTATS [TO FILE <.txt filename> | (<expC>)] | [TO PRINT]


See Also

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


Description

The DISPLAY IOSTATS command is used to display logged input/output statistics. SET IOSTATS must be ON for I/O statistics to be logged.

Environment settings

The first part of the display shows current settings:

Statistics

The statistics follow:

  • opens
  • creates
  • closes
  • icreates
  • iopens
  • icloses
  • reads
  • writes
  • deletes
  • appends
  • dcachereads
  • dcachewrites
  • icachereads
  • icachewrites
  • ireads
  • iwrites
  • gcachereads
  • gcachewrites
  • gcachehits
  • gcacheturns
  • readlocks
  • writelocks
  • unlocks
  • fstatfs
  • keystrokes
  • popens
  • pcloses
  • doprocs
  • dofuncs
  • copies
  • disk reads
  • disk writes
  • elapsed time
  • disk operations
  • locking operations

DISPLAY commands differ from LIST commands in that they pause every screen 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.

Output keywords

Keyword Description
TO FILE <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

display iostats


Products

Recital, Recital Server