Chapter 1: SYMCLI Commands

symhost

Displays host configuration information and performance statistics.

SYNOPSIS symhost show -config [-h] symhost stats [-h] [-i <Interval>] [-c <Count>]

[-type CPU | MEMORY | DISK | ALL]

DESCRIPTION

The symhost command displays host configuration information and performance statistics. The performance statistics are displayed for CPU, memory, and host devices. Note that not all statistics are available for all hosts.

ARGUMENTS show           Shows detailed configuration information.

stats          Shows performance statistics.

OPTIONS

-c             Indicates the number (count) of times to display statistics. If this option is not specified, and an interval (-i) is specified, stats will be displayed continuously.

-config        Shows detailed configuration information.

-h             Provides brief online help information.

-i             Repeats the interval in seconds.

384 EMC Solutions Enabler CLICommand Reference

The default interval is 30 seconds.

The minimum interval is 5 seconds.

For passive actions the minimum interval is

15 seconds. Passive actions are actions that do not acquire an exclusive lock.

-type          Specifies the type of performance information to display. The default is to display ALL statistics. Individual CPU, memory, and disk statistics can be selected by specifying one of the following:

-type     Description

------- --------------------

CPU       Reports user, system, wait I/O, idle CPU time, interrupts, system calls, and context switch statistics for each processor and overall.

MEMORY    Reports system-wide page inpage out and swap in-swap out statistics.

DISK      Reports read, write, busy, and idle time statistics for each host disk.

PARAMETERS

None.

RETURN CODES

Code #         Code Symbol    

----------------

Chapter 1: SYMCLI Commands

symhost 385

Chapter 1: SYMCLI Commands

0           CLI_C_SUCCESS

1           CLI_C_FAIL

EXAMPLES

To display configuration information for the local host, enter: symhost show -config

To display statistics about all processors, memory, and disk every 60 seconds, enter: symhost stats -i 60

To display statistics about all host processors, every 30 seconds for one hour, enter: symhost stats -i 30 -c 120 -type CPU

H:M:S CPU  %User %Sys  %WIO  %Idle Int/s Calls/s  CtxSw/s

A    B     C     D     E      F    G     H        I

A  Time of day

B  CPU number/id

C  100 * (CPU busy time in user mode / elapsed time)

D  100 * (CPU busy time in system mode / elapsed time)

E  100 * (CPU idle time for wait I/O / elapsed time)

F  100 * (CPU idle time / elapsed time)

G  Interrupts per second

H  System calls per second

I  Process context switches per second

To display statistics about host memory, every

30 seconds for one hour, enter:

386 EMC Solutions Enabler CLICommand Reference

symhost stats -i 30 -c 120 -type MEMORY

H:M:S      Pi/s Ppi/s Po/s Ppo/s Si/s Psi/s So/s Pso/s

A         B     C    D     E    F    G     H     I

A  Time of day

B  Page in requests per second

C  Number of pages paged in per second

D  Page out requests per second

E  Number of pages paged out per second

F  Swap in requests per second

G  Number of pages swapped in per second

H  Swap out requests per second

I  Number of pages swapped out per second

To display statistics about all host disks every 30 seconds for one hour, enter: symhost stats -i 30 -c 120 -type DISK

H:M:S  Disk  RW/s  R/s  W/s  KbRW/s KbR/s KbW/s %Busy %Wait

A     B     C     D    E     F     G     H      I     J

A  Time of day.

B  Disk name

C  Read and write requests per second

D  Read requests per second

E  Write requests per second

F  KB read and written per second

G  KB read per second

H  KB written per second

I  100 * (disk active time / elapsed time)

J  100 * (non-empty wait queue time / elapsed time)

Chapter 1: SYMCLI Commands

symhost 387