Commands Reference, Volume 2

emstat Command

Purpose

Shows emulation exception statistics.

Syntax

emstat [ -a | -v ] [ Interval ] [ Count ]

Description

The emstat command displays emulation exception statistics. Emulation exceptions can occur when some legacy applications or libraries, which contain instructions that have been deleted from older processor architectures, are executed on newer processors. These instructions may cause
illegal instruction program exceptions. The operating system catches these exceptions and emulates
the older instruction(s) to maintain program functionality, potentially at the expense of program performance.

The emulation exception count since the last time the machine was rebooted and the count in the current interval are displayed. The user can optionally display alignment exception statistics or individual processor emulation statistics.

The default output displays statistics every second. The sampling interval and number of iterations
can also be specified.

Implementation Specifics

This command is valid only on the POWER-based platform.

Parameters

Flags

Examples

1. To display the emulation statistics every second, type:

   emstat
   

   This produces the following output:

     Emulation  Emulation
     SinceBoot      Delta
       8845591          0
       8845591          0
       8845591          0
       8845591          0
       8845591          0
       8845591          0
     ...
   

2. To display emulation and alignment exception statistics every two seconds, a total of 5 times, type:

   emstat -a 2 5
   

   This produces the following output:

     Alignment  Alignment  Emulation  Emulation
     SinceBoot      Delta  SinceBoot      Delta
      21260604          0   70091846          0
      23423104    2162500   72193861    2102015
      25609796    2186692   74292759    2098898
      27772897    2163101   76392234    2099475
      29958509    2185612   78490284    2098050
   

3. To display emulation statistics, every 5 seconds, for each processor, type:

   emstat -v 5
   

   This produces the following output:

     Emulation  Emulation  Emulation  Emulation
     SinceBoot      Delta    Delta00    Delta01
      88406295          0          0          0
      93697825    5291530          0    5291530
      98930330    5232505    5232505          0
     102595591    3665261     232697    3432564
     102595591          0          0          0
   

Related Information

The alstat command.