EMC Solutions Enabler CLI Command Reference

Chapter 1: SYMCLI Commands

symstat

Displays statistics about Symmetrix arrays, directors, disks, device groups, or devices.

SYNOPSIS symstat -raw [-i <Interval>] symstat -i <Interval> [-c <Count>]

[-type REQUESTS [-g <DgName> [-bcv | -all]]] symstat -i <Interval> [-c <Count>]

-sid <SymmID> -RepType rdfa [-v]

[-type REQUESTS]

[-g ALL|-rdfg <#|ALL>|-cg <CgName|ALL>] symstat -i <Interval> [-c <Count>]

-g <DgName> -RepType rdfa [-v]

[-type REQUESTS] [-hop2] symstat -i <Interval> [-c <Count>]

-sid <SymmID> -RepType rdf

[-type REQUESTS] [-g ALL | -rdfg <#|ALL>] symstat -i <Interval> [-c <Count>]

-g <DgName> -RepType rdf

[-type REQUESTS] [-hop2] symstat -i <Interval> [-c <Count>]

-sid <SymmID> -RepType rcopy

[-type REQUESTS] [-name <sessionName>] symstat -i <Interval> [-c <Count>]

-type REQUESTS -CA <#|ALL> [-sid <SymmID>] symstat -i <Interval> [-c <Count>]

-type REQUESTS -EA <#|ALL> [-sid <SymmID>]

784 EMC Solutions Enabler CLICommand Reference

symstat -i <Interval> [-c <Count>]

-type REQUESTS -EF <#|ALL> [-sid <SymmID>] symstat -i <Interval> [-c <Count>]

-type REQUESTS -RA <#|ALL> [-sid <SymmID>] symstat -i <Interval> [-c <Count>]

-type REQUESTS -SA <#|ALL> [-sid <SymmID>] symstat -i <Interval> [-c <Count>]

-dir <#|ALL> [-sid <SymmID> -RepType rcopy] symstat -i <Interval> [-c <Count>]

-type PREFETCH -DA <#|ALL> [-sid <SymmID>] symstat -i <Interval> [-c <Count>]

-type PREFETCH -DX <#|ALL> [-sid <SymmID>] symstat -i <Interval> [-c <Count>]

-type CACHE [-sid <SymmID>] [-CA <#|ALL>] symstat -i <Interval> [-c <Count>]

-type CACHE [-sid <SymmID>] [-EA <#|ALL>] symstat -i <Interval> [-c <Count>]

-type CACHE [-sid <SymmID>] [-RA <#|ALL>] symstat -i <Interval> [-c <Count>]

-type CACHE [-sid <SymmID>] [-SA <#|ALL>] symstat -i <Interval> [-c <Count>]

-type CACHE [-sid <SymmID>] [-dir <#|ALL>] symstat -i <Interval> [-c <Count>]

-type CACHE -sid <SymmID> -RepType rdfa

[-g ALL | -rdfg <#|ALL> | -cg <CgName|ALL>]


symstat 785

Chapter 1: SYMCLI Commands symstat -i <Interval> [-c <Count>]

-type CACHE -g <DgName> -RepType rdfa [-hop2] symstat -i <Interval> [-c <Count>]

-type CYCLE -sid <SymmID> -RepType rdfa

[-g ALL | -rdfg <#|ALL> | -cg <CgName|ALL>] symstat -i <Interval> [-c <Count>]

-type CYCLE -g <DgName> -RepType rdfa [-hop2] symstat -i <Interval> [-c <Count>]

-type PORT -dir <#|ALL> [-sid <SymmID>]

[-port <#|ALL>] symstat -i <Interval> [-c <Count>]

-type PORT -sid <SymmID> -dir <#|ALL>

-RepType rcopy [-port <#|ALL>] symstat -i <Interval> [-c <Count>]

-type PATH -sid <SymmID> -RepType rcopy

[-by_session | -by_port] symstat -i <Interval> [-c <Count>]

-type DISK -sid <SymmID>

[-spindle [-internal | -external]]

[[-disk <DA|ALL>[,<int|ALL>[,<id|ALL>]]] |

[-spid <SpindleID|ALL>]] symstat -i <Interval> [-c <Count>]

-type DISK -sid <SymmID> -DX <#|ALL> [-spindle] symstat -i <Interval> [-c <Count>]

-type BACKEND -g <DgName> -ld <LdevName> [-mirror <#>] symstat -i <Interval> [-c <Count>]

-type BACKEND -pd <PdevName> [-mirror #]


symstat -i <Interval> [-c <Count>]

-type BACKEND -dev <SymDevname>

[-sid <SymmID>] [-mirror <#>] symstat -i <Interval> [-c <Count>]

-type MEMIO -g <DgName>

[-ld <LdevName> | -bcv | -all] symstat -i <Interval> [-c <Count>]

-type MEMIO -pd <Pdevname> symstat -i <Interval> [-c <Count>]

-type MEMIO -dev <SymDevname> [-sid <SymmID>] symstat -i <Interval> [-c <Count>]

-type DMSP -g <DgName> -ld <LdevName> symstat -i <Interval> [-c <Count>]

-type DMSP -pd <PdevName> symstat -i <Interval> [-c <Count>]

-type DMSP -dev <SymDevname> [-sid <SymmID>] symstat -i <Interval> [-c <Count>]

-type RDF

<-dev SymDevname |

-g <DgName> <-ld LdevName> |

-rdfg <#|ALL> |

-dir <#|ALL> |

-dir <#> -rdflink > symstat -i <Interval> [-c <Count>]

-type ISCSI [-sid <SymmID>] -RE <#>

-ip <remote_ip_addr>

<-rdf_spdlmt | -rdf_nw_comp | -spdlmt_grp> symstat -i <Interval> [-c <Count>]


symstat 787


-type ISCSI [-sid <SymmID>] -DIR <#>

<-tcp_conn | -gige_dir>

DESCRIPTION

The symstat command provides statistics about a Symmetrix array, a director, a device group, a disk, or a device. This command also displays DMSP

(dynamic mirroring service policy) information about a device.

ARGUMENTS

None.

OPTIONS

-all Returns statistics for standard and BCV devices in the device group.

-bcv Returns statistics for BCV devices in the device group. The default behavior excludes

BCV devices.

-by_port Organizes the path output by active

R-Copy port.

-by_session Organizes the path output by remote copy session name.

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

-CA Limits the action to a channel director


number. To select all channel directors, specify ALL.

-cg Specifies the composite group name.

-DA Limits the action to a disk director number. To select all disk directors, specify ALL.

-DX Limits the action to an external disk director number. To select all disk directors, specify ALL.

-dev Applies Symmetrix device names to the action.

-dir Limits the action to a director number.

To select all directors, specify ALL.

-disk Applies the action to a physical disk

(DA, int, id). For example, SCSI ID 4 on interface C of DA 2A would be:

-disk 2A,C,4

The syntax -disk 02A:C4 is also valid.

-EA Limits the action to an ESCON director number. To select all ESCON directors, specify ALL.

-EF Limits the action to a FICON director number. To select all ESCON directors, specify ALL.

-g Limits the action to a device group name.

The -dg option is also valid.


symstat 789


-gige_dir Collects network statistics for an entire director (iSCSI stats).

-h Provides brief online help information.

-hop2 Displays SRDF statistics for the second hop of a cascaded SRDF configuration.

-i Specifies the repeat interval in seconds.

The default interval is 90 seconds.

The minimum interval is 60 seconds.

-ip Specifies the remote IP address

(to gather SRDF network compr stats-iSCSI).

-ld Applies logical device names to the action.

-mirror Requests stats from a specified mirror (1-4).

-name Specifies an optional, user-defined remote copy session name. The name is defined when the session is created.

-pd Applies physical device names to the action.

-port Specifies the director port number.

ALL selects all ports for the specified director.

-RA Limits the action to an SRDF director

(adapter) number. To select all SRDF directors, specify ALL.

-raw Returns raw statistics.


-RE GigE director configured as the SRDF

(adapter) number. To select all SRDF directors, specify ALL.

-rdfg Collects statistics for the SRDF/A sessions by RA group number. To select all RA group numbers, specify ALL.

-rdflink Collects SRDF link-level statistics.

-rdf_nw_comp Collects SRDF network compression statistics

(iSCSI stats).

-rdf_spdlmt Collects RDF speed limit information

(iSCSI stats).

-RepType Specifies the replication type. Currently, rdfa, rdf and rcopy are supported.

-SA Limits the action to a front-end (SCSI or

Fibre) director number. To select all front-end directors, specify ALL.

-sid Supplies the unique Symmetrix ID.

-spdlmt_grp Collects speed limit group statistics

(iSCSI stats).

-tcp_conn Collects TCP connection-based statistics

(iSCSI stats).

-spid Indicates the specific spindle ID of the target disk. To select all spindles, specify

ALL.

-spindle Displays spindle information instead of


symstat 791

Chapter 1: SYMCLI Commands the standard disk address information.

-internal Displays internal spindles of spindle IDs specified.

-external Displays external spindles of spindle IDs specified.

-type Type of performance information to display.

The default is to display REQUESTS information. Individual disk/director subtotals and totals are provided.

Possible statistics type values are:

Type Performance Information

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

BACKEND Back-end I/O requests and throughput for selected device.

CACHE Cache activity for selected front-end or remote link director(s) only.

CYCLE Cycle summary information for active SRDF/A sessions or sessions that have non-zero cache usage.

DISK Back-end I/O requests and throughput for the selected disk.

DMSP DMSP stats for the selected device.

ISCSI GigE network stats.


MEMIO Cache memory to disk activity for selected device(s).

PATH rcopy path information for non-incremental sessions.

Symmetrix arrays that have all or some incremental sessions report an error.

PORT Performance statistics for a director port.

PREFETCH Tracks prefetch disk activity for selected back-end director(s) only.

RDF I/O requests and throughput for selected RDF device(s) or

RA group(s) or RDF director(s).

REQUESTS I/O requests and throughput for selected device(s) or any type of director(s).

This is the default.

-v Provides a more detailed, verbose listing.

PARAMETERS

CgName Composite group name.

DA Disk director (DA) number.

DgName Device group name given by user. The name must be unique to this host.

id Director SCSI number of the specified physical disk to the statistics action.


symstat 793

Chapter 1: SYMCLI Commands int Director interface number to the specified physical disk.

LdevName Logical device name either supplied by the user or automatically assigned when a device is added to a device group.

PdevName Physical (host) name for the device, such as /dev/rdsk/c2t0d2s3.

remote_ip_addr Remote IP address.

sessionName Optional name that can be ascribed to a remote copy session.

SymDevname Symmetrix device name, such as 000C.

SymmID 12-digit ID of the Symmetrix array.

SpindleID The spindle ID of the disk in hex format.

RETURN CODES

Code # Code Symbol

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

0 CLI_C_SUCCESS

1 CLI_C_FAIL

19 CLI_C_GK_IS_LOCKED

All GateKeepers to the Symmetrix unit are currently locked.

EXAMPLES

To display statistics about all Symmetrix devices in


device group ProdDB every 60 seconds, enter: symstat -g ProdDB -i 60

To display statistics about Symmetrix device log1 in device group ProdDB every 2 minutes (120 seconds), enter: symstat -g ProdDB -ld log1 -i 120

To display statistics about all SRDF directors in the specified Symmetrix array every 60 seconds for a count of

10, enter: symstat -i 60 -c 10 -RA ALL -sid 098712341357

To display statistics about all devices in the specified

Symmetrix array every 5 minutes (300 seconds), enter: symstat -sid 098712341357 -i 300

To display MEMIO statistics about all devices in the specified group every 60 seconds 100 times, enter: symstat -g queryDB -i 60 -c 100 -type MEMIO

The following output is returned:

DEVICE Tracks/sec % Dev

H:M:S WP Tracks Prefchd Destgd WPmax

A B C D E

A Time of day.

B Total number of write pending tracks not yet destaged to disk.

C Number of tracks prefetched per second.

D Number of tracks destaged per second.

E Percentage write pending tracks are of device write pending limit.


symstat 795


To display REQUEST statistics about all devices in the specified group every 60 seconds

100 times, enter: symstat -g rdwrDB -i 60 -c 100 -type REQUEST


DEVICE IO/sec KB/sec % Hits %Seq Num WP

H:M:S READ WRITE READ WRITE RD WRT READ Tracks

A B C D E F G H I

A Time of day.

B Number of read requests per second.

C Number of write requests per second.

D Number of kilobytes read per second.

E Number of kilobytes written per second.

F Read cache hit ratio. This field is blank for

5063 SYMMETRIX data.

G Write cache hit ratio. For 5063 data, read+write cache hit ratio.

H Percentage of read requests that are sequential.

I Total number of write pending tracks.

To display REQUEST statistics about all front-end SA directors in the specified Symmetrix every 60 seconds 100 times, enter: symstat -SA ALL -i 60 -c 100 -type REQ -sid 8910


DIRECTOR IO/sec Cache Requests/sec % RW

H:M:S Host READ WRITE RW Hits

A B C D E F

A Time of day.


B For front-end directors, number of CDB requests, including read and write requests per second.

For back-end directors, number of disk reads and/or writes per second.

For remote link directors, number of remote reads and/or writes per second.

C Number of cache read requests per second.

D Number of cache write requests per second.

E Number of cache read and write requests per second.

F Read and write cache hit ratio.

To display CACHE statistics about all front-end SA directors in the specified Symmetrix array every 60 seconds 100 times, enter: symstat -SA ALL -i 60 -c 100 -type cache -sid 8910


DIRECTOR Misses/sec Disconnects/sec

H:M:S Cache Read System Device

A B C D

A Time of day.

B Number of cache read misses per second.

C Number of disconnects per second due to system write pending limit.

D Number of disconnects per second due to device write pending limit.

To display PREFETCH statistics about all back-end DA directors in the specified Symmetrix array every 60 seconds 100 times, enter: symstat -DA ALL -i 60 -c 100 -type prefetch -sid 8910



symstat 797


DIR Preftch Preftch Trk/sec

H:M:S Trk/sec Used Unused

A B C D

A Time of day.

B Number of prefetched tracks per second.

C Number of prefetched tracks used per second.

D Number of prefetched tracks superseded per second.

To display BACKEND statistics for device 068 on the specified Symmetrix every 60 seconds, enter: symstat -i 60 -type backend -dev 68 -sid 8910


DEVICE IO/sec KB/sec Prefetched Tracks

H:M:S READ WRITE READ WRITE Tracks Used

A B C D E F G

A Time of day.

B Number of read requests per second.

C Number of write requests per second.

D Number of kilobytes read per second.

E Number of kilobytes written per second.

F Number of prefetched tracks per second.

G Number of prefetched tracks used per second.

To display DMSP statistics for device 000 on the specified Symmetrix array every 60 seconds, enter: symstat -i 60 -type dmsp -dev 0 -sid 8910


DEVICE Mirror # Pref New Old % I/O Act


H:M:S 1 2 Mirr MSP MSP Seq Wrt Lev

A B C D E F G H I

A Time of day.

B DMSP mirror 1 info (mset element number, DA number, DA interface, and disk SCSI ID).

C DMSP mirror 2 info.

D Preferred DMSP mirror.

E New mirror service policy.

F Old mirror service policy.

G Percent of I/O which is sequential.

H Percent of I/O which is writes.

I Activity level.

To display DISK statistics for the physical drive located at 02A:C5 in the specified Symmetrix array every 60 seconds, enter: symstat -i 60 -disk 2a,c,5 -type disk -sid 8910


DISK IO/sec KB/sec

H:M:S READ WRITE READ WRITE

A B C D E F

A Time of day.

B Specified physical disk output in the format (for example, 02A:C5).

C Number of read requests per second.

D Number of write requests per second.

E Number of kilobytes read per second.

F Number of kilobytes written per second.


symstat 799

EMC Solutions Enabler CLI Command Reference

symstat

Related manuals

Table of contents

EMC Solutions Enabler CLI Command Reference

symstat

Related manuals

Dell

Solutions Enabler

Dell

Solutions Enabler

Dell

Solutions Enabler

Dell

Solutions Enabler

Table of contents