exportgmdata

Edit online

Use the exportgmdata command to export data for a Global Mirror role pair to a comma-separated value (CSV) file. You can then use the data in the CSV file to analyze trends in your storage environment that affect your recovery point objective (RPO).

Attention: Because historical data is purged when you delete a session or set the management server as the standby server, export data before you complete these actions.

This command can create two types of CSV files: a file that contains data about the RPO and a file that contains data about logical subsystem (LSS) out-of-sync tracks. You can use both files to better analyze trends.

For example, the file that contains data for the RPO might show that the RPO threshold is often exceeded on a particular day and time. You can then view the file that contains data for LSS out-of-sync tracks to see whether a particular LSS or set of LSSs have high out-of-sync track values for that day and time.

Syntax

This command is available for the following storage systems:

Model 800
IBM® DS8000®

Parameters

-help | -h | -?: Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.
-rpohistory: Specifies that the CSV file contains data for the RPO. The data includes the average RPO for the dates that you select and information that is related to the formation of consistency groups.; RPO data is only available for DS8000 sessions using Global Mirror and Global Mirror with Change Volume sessions.
-rpo_start startdate: Specifies the start date for the RPO data that is in the CSV file. The format is yyyy-mm-dd.; By default, the date range maximum is 31 days of data.; This parameter is required if the -rpohistory parameter is present.
-rpo_end enddate: Specifies the end date for the RPO data that is in the CSV file. The format is yyyy-mm-dd.; This parameter is required if the -rpohistory parameter is present.
-lssoos: Specifies that the export file contains data for the out-of-sync tracks in that are in the LSSs.; Data for LSS out-of-sync tracks is only available for DS8000 storage systems.
-lssoos_start startdate: Specifies the start date for the LSS out-of-sync track data that is in the CSV file. The format is yyyy-mm-dd.; By default, the date range maximum is seven days of data.; This parameter is required if the -lssoos parameter is present.
-lssoos_end enddate: Specifies the end date for the LSS out-of-sync track data that is in the CSV file. The format is yyyy-mm-dd.; This parameter is required if the -lssoos parameter is present.
-rolepair rolepair: Specifies the role pair for which you are exporting the data.
-dir directory: Specifies the output directory for the CSV files on the system from which exportgmdata is run. This parameter is optional and if not provided, the files will be created on the server.
session_name | -: Specifies the name of the session for which you are exporting the data.

Example: Exporting RPO data to an export file

The following command exports RPO data to the file gmsession1H1-J2rpo2012-02-28-16-18-25.csv. The confirmation message contains the path to the file.

csmcli> exportgmdata -rpohistory -rpo_start 2012-02-01 -rpo_end 2012-02-28 
-rolepair h1-j2 gmsession1

The following output is returned:

IWNR1262I The data for session gmsession1 was exported. 
The CSV file is located on the server at: C:\Program Files\IBM\CSM\
\wlp\usr\servers\csmServer\exportdir\
gmsession1H1-J2rpo2012-02-28-16-18-25.csv

Example: Exporting LSS out-of-sync track data to an export file

The following command exports LSS out-of-sync track data to the file gmsession1H1-J2lssoos2012-02-28-16-45-46.csv. The confirmation message contains the path to the file.

csmcli> exportgmdata -lssoos -lssoos_start 2012-02-01 -lssoos_end 2012-02-08
-rolepair h1-j2 gmsession1

The following output is returned:

IWNR1262I The data for session gmsession1 was exported. 
The CSV file is located on the server at: C:\Program Files\IBM\CSM\
\wlp\usr\servers\csmServer\exportdir\
gmsession1H1-J2lssoos2012-02-28-16-45-46.csv