To run Export Tool, you must write scripts for exporting monitoring data. When writing scripts, you must write several subcommands in a command file. When you run Export Tool, the subcommands in the command file run sequentially, and then the monitoring data is saved in files.

When you install Export Tool, the command.txt file is stored in the installation directory. This file contains sample scripts for your command file. You should customize scripts in command.txt according to your needs. For detailed information about subcommand syntax, see Export Tool command reference.

A semicolon (;) indicates the beginning of a comment. Characters from a semicolon to the end of the line are comments.

Example of a command file

ip 158.214.135.57:1099          ; Specifies the IP address of
                                 ; the SVP and the connection port number
dkcsn 123456                     ; Specifies the target DKC 
                                 ; serial number
login expusr                     ; Logs the user into the storage system
show                             ; Outputs the storing period in 
                                 ; the storage system to standard output
group PhyPG                      ; Specifies the type of data to 
                                 ; be exported and the storing 
                                 ; period 
group RemoteCopy                 ; Specifies the type of data to 
                                 ; be exported 
range 200610010850:200610010910  ; Specifies the range in 
                                 ; which files will be saved
outpath out                      ; Specifies the directory in
                                 ; which files will be saved
option compress                  ; Specifies whether to
                                 ; compress files
apply                            ; Executes processing for 
                                 ; saving monitoring data in 
                                 ; files

The scripts in this command file are explained as follows:

• ip 158.214.135.57:1099

  This script specifies that you are logging into the SVP whose IP address is 158.214.135.57 and that 1099 (the default port of RMIIFRegist) is the port number to connect to the SVP. You must log on to the storage system connected to the SVP when using Export Tool.

  The ip subcommand specifies the SVP to which you wish to connect. You must include the ip subcommand in your command file.

  For detailed information about the ip subcommand, see ip .

  For Export Tool, a directory is created with a value name specified by the ip subcommand under the following directory:

  • For Windows: export\lib
  • For UNIX: export\lib

  When the value specified by the ip subcommand is an IP address, a hexadecimal value is specified as the directory name. Periods (.) and colons (:) are not included. When it is a host name, the IP address of the specified server is specified as the directory name. The following table provides examples of the directory names.

  Value specified by the ip subcommand	Directory name
  Value for the ip subcommand is ip 158.214.135.57 (for IPv4)	9ED68739
  Value for the ip subcommand is ip 0000:0000:0020:00B4:0000:0000:9ED6:874 (for IPv6)	00000000002000B4000000009ED68740
  Value for the ip subcommand is ip host01 (when the IP address of host01 is 158.214.135.57)	9ED68739

• dkcsn 123456

  This script specifies the serial number of the system from which monitored data will be acquired. This subcommand specifies the system to provide the monitored data. Make sure to notate the dkcsn subcommand in the command file. For detailed information about the dkcsn subcommand, see in dkcsn .

• login expusr passwd

  This script specifies that you provide the user ID expusr and the password passwd to log in to the storage system.

  The login subcommand logs the specified user into the storage system. You must include the login subcommand in your command file. For detailed information about the login subcommand, see login.

  CautionWhen you write the login subcommand in your command file, you must specify a user ID that is used exclusively for running Export Tool. See Requirements for Export Tool for reference.
• show

  The show subcommand checks the SVP to find the period of monitoring data stored in the SVP and the data collection interval (called sampling interval in Performance Monitor), and then outputs them to the standard output (for example, the command prompt) and the log file.

  • The following is an example of information that the show subcommand outputs:

    Range From: 2006/10/01 01:00  -  To: 2006/10/01 15:00
     Interval: 1min.

    In this example, the monitoring data is stored every 1 minute in the term of 1:00 - 15:00 on October 1, 2006. When you run Export Tool, you can export monitoring data into the file.

  The use of the show subcommand is not mandatory, but you should include the show subcommand in your command file. If an error occurs when you run Export Tool, you might be able to find the error cause by checking the log file for information issued by the show subcommand. For detailed information about the show subcommand, see show.

• group PhyPG Long and group RemoteCopy

  The group subcommand specifies the type of data that you want to export. Specify an operand following group to define the type of data to be exported.

  The example script group PhyPG specifies to export usage statistics about parity groups. Also, the script group RemoteCopy specifies to export statistics about remote copy operations by TrueCopy and global-active device. You can describe multiple lines of the group subcommand to export multiple monitoring items at the same time.

  For detailed information about the group subcommand, see group.

• range 200610010850:200610010910

  The range subcommand specifies the term of monitoring data to be exported. Use these subcommands when you want to narrow the export-target term within the stored data.

  You can use this subcommand to narrow the export-target term for all of the monitoring items you can specify by the group subcommand.

  Specify a term within Range From XXX To XXX which is output by the show subcommand.

  In the sample file given above, the script range 200610010850:200610010910 specifies the term 8:50-9:10 on October 1, 2006. This script is applied to the group RemoteCopy subcommand in this example. When you run Export Tool, it will export the statistics about remote copy operations by TrueCopy and global-active device in the term specified by the range subcommand.

  If you run Export Tool without specifying the range subcommand, the monitoring data in the whole storing period (data in the period displayed by the show subcommand) will be exported. For detailed information about the range subcommand, see range .

• outpath out

  This script specifies that files will be saved in the directory named out in the current directory.

  The outpath subcommand specifies the directory in which files will be saved. For detailed information about the outpath subcommand, see outpath.

• option compress

  This script specifies that Export Tool will compress monitoring data in ZIP files.

  The option subcommand specifies whether to save files in ZIP format or in CSV format. For more information, see option.

• apply

  The apply subcommand saves monitoring data in files. For detailed information about the apply command, see apply.