Professional Documents
Culture Documents
4
The help subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
The java command for exporting data In files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Troubleshooting the Export Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Figures
1 Network A (one-to-one connections between HBAs and ports) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2 Priority specified in the Performance Control pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3 Traffic at ports on network A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4 Network B (many-to-many connections between HBAs and ports). . . . . . . . . . . . . . . . . . . . . . . . . . . 14
5 Specifying host bus adapters to be monitored . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
6 Priority specified in the Performance Control pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
7 Traffic at ports on network B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
8 Setting upper limits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
9 Graphs indicating changes in port traffic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
10 Port tab in the Performance Control pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
11 WWN tab in the Performance Control pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
12 Add WWN dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
13 Change WWN and PFC Name dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
14 Add New PFC Group dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
15 Change Upper Limit dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
16 Change PFC Group Name dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
17 Sample text file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
18 Sample command file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
19 Scripts in batch files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
20 Scripts in batch files (when specifying the proxy host’s host name) . . . . . . . . . . . . . . . . . . . . . . . . . . 50
21 Scripts in batch files (when specifying the IP address of a proxy host). . . . . . . . . . . . . . . . . . . . . . . . 51
22 An example of executing a batch file (on a Windows computer) . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
23 Sample command prompt outputs when the Export Tool runs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
24 Sample batch file including a reference to termination code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
25 Examples of comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
26 Information output by the show subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
27 Starting and ending times for collecting monitoring data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
28 Starting and ending time for collecting monitoring data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
29 An example of a text file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Tables
1 Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
2 Auto LUN XP panes and monitoring data that can be saved by the Export Tool . . . . . . . . . . . . . . . . . 32
3 Files containing statistics about resource usage and write pending rates . . . . . . . . . . . . . . . . . . . . . . . 33
4 Files containing statistics about parity, external volume, and V-VOL groups . . . . . . . . . . . . . . . . . . . . 35
5 Files containing statistics about logical volumes in parity, external volume, or V-VOL groups . . . . . . . . 36
6 Files containing statistics about ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
7 Files containing statistics about host bus adapters connected to ports . . . . . . . . . . . . . . . . . . . . . . . . 37
8 Files containing statistics about LU paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
9 Files containing statistics about SPM groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
10 Files containing statistics about host bus adapters belonging to SPM groups . . . . . . . . . . . . . . . . . . . 38
11 Files containing statistics about remote copy operations by Continuous Access XP and TrueCopy
6
About this guide
This guide provides information about:
• Understanding Performance Control XP
• Starting Performance Control XP
• Using the Performance Control pane
• Managing traffic between HBAs and ports
• Grouping host bus adapters
• Troubleshooting Auto LUN/Performance Control Base Monitor and Performance Control XP
• Using the Performance Export Tool to export monitoring data to files
• Troubleshooting the Performance Export Tool
• Understanding limitations for storage partition administrators
Intended audience
This guide is intended for customers and HP-authorized service providers with knowledge of:
• Disk array hardware and software
• Data processing and RAID storage subsystems and their basic functions
NOTE: The functions described in this manual may be limited, depending on your assigned level of user
access. Some users will have read-only access while others will have limited or full array access. For
additional information on users and user groups, please see the HP StorageWorks XP Remote Web
Console user guide for XP12000/XP10000/SVS200.
Prerequisites
Prerequisites for using this product include:
• Installing the HP StorageWorks disk array(s)
• Installing the license key for this product
Related documentation
The following documents provide related information:
• HP StorageWorks XP glossary
• HP StorageWorks XP Remote Web Console user guide for XP12000/XP10000/SVS200
• HP StorageWorks Auto LUN XP user guide for the XP12000/XP10000
• HP StorageWorks Auto LUN XP user guide for the XP1024/XP128
• HP StorageWorks LUN Configuration and Security Manager XP user guide for the
XP12000/XP10000/SVS200
• HP StorageWorks LUN Configuration and Security Manager XP user guide for the XP1024/XP128
Convention Element
Blue text: Table 1 Cross-reference links and e-mail addresses
CAUTION: Indicates that failure to follow directions could result in damage to equipment or data.
HP technical support
Telephone numbers for worldwide technical support are listed on the HP support web site:
http://www.hp.com/support/.
Collect the following information before calling:
• Technical support registration number (if applicable)
• Product serial numbers
• Product model names and numbers
• Error messages
• Operating system type and revision level
• Detailed, specific questions
For continuous quality improvement, calls may be recorded or monitored.
8
Subscription service
HP recommends that you register your product at the Subscriber’s Choice for Business web site:
http://www.hp.com/go/e-updates.
After registering, you will receive e-mail notification of product enhancements, new driver versions,
firmware updates, and other product resources.
HP web sites
For additional information, see the following HP web sites:
• http://www.hp.com
• http://www.hp.com/go/storage
• http://www.hp.com/service_locator
• http://www.hp.com/support/manuals
• http://www.hp.com/support/downloads
• http://www.hp.com/support/rwc/manuals
Documentation feedback
HP welcomes your feedback.
To make comments and suggestions about product documentation, please send a message to
storagedocs.feedback@hp.com. All submissions become the property of HP.
NOTE: Throughout this chapter, prioritized port refers to a high-priority port and non-prioritized
port refers to a low-priority port.
12 Performance Control XP
For detailed information about monitoring traffic, see ”Setting the priority of ports on arrays” on
page 22 and ”Measuring traffic between host bus adapters and ports for many-to-many connections”
on page 23.
14 Performance Control XP
NOTE: Performance Control XP cannot monitor and control the performance of hosts that have
host bus adapters placed below the Non-Monitor icon.
3. Set the priority of host bus adapters. In the WWN tab of the Performance Control pane, specify the
priority of each host bus adapter.
In network B, the production server is given high priority and the development server is given low
priority. If your network is configured as in Figure 5, you must give high priority to wwn01 and low
priority to wwn02 and wwn03.
To set the priority of host bus adapters, take the following steps (see Figure 6):
a. In the WWN tab, click one of the four ports to which the HBAs are connected (1A, 1C, 3A, or 3C).
b. Set wwn01 to Prio., and set wwn02 and wwn03 to Non-Prio.
NOTE: Throughout this chapter, prioritized WWN refers to a high-priority host bus adapter (such
as wwn01) and non-prioritized port refers to a low-priority host bus adapter (such as wwn02 or
wwn03).
4. Monitor traffic between host bus adapter and ports. Obtain statistics about traffic between host bus
adapter and ports.
There are two types of traffic statistics: I/O rate (number of I/Os per second) and transfer rate (amount
of data transferred between a host and array). When viewing traffic statistics in the Performance
Control pane, select I/O or transfer rate.
If your network is configured like network B, measure the traffic between the three host bus adapters
(wwn01, wwn02, and wwn03) and the four ports (1A, 1C, 2A, and 2C).
Figure 7 illustrates the I/O rate at the paths between port 1A and the host bus adapters. Initially the
I/O rate on the path between 1A and the prioritized WWN (wwn01) was approximately 400 IO/s,
while the I/O rate on the path between 1A and the non-prioritized WWNs (wwn02 and wwn03) was
approximately 100 IO/s. However, the I/O rate for non-prioritized WWNs gradually increased,
while the I/O rate of the prioritized WWN gradually decreased, causing performance of the
high-priority production server to suffer. As network administrator, you might want to maintain the I/O
rate for the prioritized WWN (wwn01) at 400 IO/s.
For detailed information, see ”Measuring traffic between host bus adapters and ports for many-to-many
connections” on page 23 and ”Analyzing traffic statistics” on page 24.
16 Performance Control XP
minute), if you set an upper limit of 150 IO/s to port 1A, the highest data point in the line CL1-A in
Graph 2 and the line Ave.(1 min) in Graph 3 is around 150 IO/s. The lines Max (1 min.) and Min (1
min.) in Graph 3 might exceed the upper limit.
NOTE: When using continuous access functions, Performance Control XP monitors write I/O
requests issued from initiator ports to the array.
If you specify an RCU target port as a prioritized port, I/O requests from the initiator port will be a
target of threshold control. If you specify an RCU target port as a non-prioritized port, I/O requests
from the initiator port will not be a target of upper limit control.
18 Performance Control XP
2 Using Performance Control XP
Starting Performance Control XP
1. In the Auto LUN pane, click WWN or Port-LUN.
2. Click the PFC button. The Performance Control pane appears.
Pane contents
The Port and WWN tabs contain several sections:
Top section
• Current Control Status at the top of the pane displays one of the following values:
• Port Control: System performance is controlled by the upper limits and threshold specified in the
Port tab
• WWN Control: System performance is controlled by the upper limits and threshold specified in the
WWN tab
• No Control: System performance is not controlled by Performance Control XP
If WWN Control appears when the Port tab is active, click Apply to switch control so that Port Control
appears. Conversely, if Port Control appears when the WWN tab is active, click Apply to switch
control so that WWN Control appears.
• Use Control List near the upper right corner of the tab to limit the number of ports or WWNs shown in
the table:
• All: Shows all the ports or WWNs
• Prio.: Shows only prioritized ports or WWNs
• Non-Prio.: Shows only non-prioritized ports or WWNs
If you change a port’s settings, the port remains in the table regardless of the selection in the list.
Tree section (WWN tab only)
• The tree in the upper-left of the WWN tab lists ports and host bus adaptors connected to the array’s
ports.
• Icons representing ports on the array appear below the Subsystem folder.
NOTE: The list to the right of the tree changes depending on the item selected.
NOTE: If a host bus adapter’s WWN is displayed in red in the tree view, the host bus adapter is
connected to two or more ports, but upper limits and/or thresholds do not control traffic between
the HBA and some ports. If many-to-many connections are established between host bus adapters
(HBAs) and array ports, ensure that all connected HBAs are monitored. For information about
controlling the traffic between the HBA and connected ports, see ”Troubleshooting Auto
LUN/Performance Control Base Monitor and Performance Control XP” on page 29.
• The tree in the lower-left of the WWN tab lists PFC groups and host bus adapters (WWNs) in each
PFC group.
• PFC groups, which contain one or more WWNs, appear below the Subsystem folder. For details
about PFC groups, see ”Grouping host bus adapters” on page 26.
• If you double-click a PFC group ( ), host bus adapters in the PFC group appear. WWNs and
nicknames appear to the right of the host bus adapter icon ( ). WWNs uniquely identify host
bus adapters. The system administrator can assign nicknames, so users can easily identify each
host bus adapter.
• The Add WWN button between the trees adds a host bus adapter to a PFC group. Before using this
button, select a host bus adapter ( ) from the upper-left tree view and a PFC group ( ) from the
lower-left tree view.
Table section
• Use the list at the top left of the tables to change the type of performance statistics displayed in the
table:
• IOPS (I/Os per second) displays I/O rates for ports or WWNs (host bus adapters). The I/O rate
indicates number of I/Os per second.
• MB/s (megabytes per second) displays transfer rates for ports. The transfer rate indicates amount
of data transferred via a port in one second.
• 100KB/s (100 kilobytes per second) displays transfer rates for WWNs (host bus adapters). The
transfer rate indicates amount of data transferred via a port in one second.
• The table displays a list of ports or WWNs and indicates the I/O or transfer rate for each. The
measurement unit for the values in the table are specified by the list at the upper-left corner of the tab.
The table can display the following columns:
• Port: In the Port tab, indicates ports on the array.
• Port: In the WWN tab, indicates the port to which the HBA is connected.
• Group: In the WWN tab, indicates the PFC group to which the host bus adapter belongs. This
column appears when a port is selected in the upper-left tree view, and does not appear when a
PFC group is selected in the lower-left tree view.
• Ave.: Average I/O or transfer rate for the specified period.
• Max.: Maximum I/O or transfer rate for the specified period.
• Attribute: Priority of each port or WWN. Prio. indicates a prioritized port or WWN. Non-Prio.
indicates a non-prioritized port or WWN.
NOTE: The Upper columns are not displayed in the WWN tab if a PFC group is selected in the
lower-left tree view.
Bottom section
• If you click the All Thresholds check box and enter a threshold value in the text box, the threshold value
is applied to the entire array. To specify the threshold for I/O rates, select IOPS from the list on the
right of the text box. To specify the threshold for transfer rates, select MB/s (or 100KB/s in the WWN
tab) from the list. For example, if you specify 128 IOPS in All Thresholds, the upper limits on
non-prioritized ports are disabled when the sum of I/O rates for all the prioritized ports is below 128
IOPS.
• The Delete ports if CHA is removed check box deletes settings on ports in channel adapters that have
been removed.
Buttons
• Apply: Applies settings in this pane to the array.
• Reset: Restores original settings in the pane.
• Initialize: Changes settings in this pane as explained below, and applies the resulting settings to the
array:
• All ports or WWNs become prioritized ports or WWNs.
• The threshold value for all ports in the Port tab becomes 0 (zero).
• If you check the All Thresholds check box, the check mark disappears.
• Close: Closes the Performance Control pane.
Measuring traffic between host bus adapters and ports for many-to-many
connections
If a many-to-many connection is established between host bus adapters (HBAs) and ports, you must
measure traffic between each HBA and the port to which the HBA is connected.
1. Start Performance Control XP (”Starting Performance Control XP” on page 19). The Performance
Control pane appears.
2. Click WWN.
3. Select All from the list at the top right corner of the pane.
4. In the upper-left tree view, double-click a port.
5. Double-click Non-Monitor below the specified port. Host adapters that are not being monitored are
displayed under Non-Monitor.
6. Right-click Monitor, and select Add WWN. The Add WWN dialog box where you can add a
prioritized or non-prioritized WWN to the Monitor branch appears.
NOTE: To simplify managing HBAs, use the same name for the PFC name and HBA nickname.
NOTE: Performance Control XP does not monitor HBAs below Non-Monitor. You cannot set upper
limits and thresholds to HBAs that are not monitored. To move an HBA (WWN) from Monitor to
Non-Monitor, select an HBA from below Monitor, right-click Monitor, and select Delete WWN. You
can monitor up to 32 HBAs (WWNs) for each port.
8. Click Monitor. The table on the right lists HBAs that are displayed below Monitor.
9. Right-click a prioritized WWN, and select Non-Prio. ->> Prioritized. If there is more than one
high-priority port, repeat this operation.
Prio. appears in the Attribute column.
10.Right-click a non-prioritized WWN, and select Prio. ->> Non-Prio. If there is more than one
non-prioritized WWN, repeat this operation.
Non-Prio. appears in the Attribute column.
11.Repeat step 4 through step 10 for all ports except the one selected in step 4.
12.Click Apply in the Performance Control pane. Settings on the pane are applied to the array.
Setting thresholds
If threshold control is used, upper limit control is automatically disabled when traffic between production
servers and the array is reduced to a specified level. For details, see ”Automatically disabling upper limit
control” on page 11, and ”Procedure for one-to-one connections between HBAs and ports” on page 12
or ”Procedure for many-to-many connections between HBAs and ports” on page 13.
1. Start Performance Control XP (”Starting Performance Control XP” on page 19). The Performance
Control pane appears.
2. Click Port (for one-to-one connection) or WWN (for many-to-many connection).
3. Do either of the following:
• To disable the upper limit on I/O rates, select IOPS from the list at the upper-left corner of the table.
• To disable the upper limit on transfer rates, select MB/s (or 100KB/s for WWNs) from the list at the
upper-left corner of the table.
4. To set a threshold for a WWN, skip to step 7.
5. Do either of the following:
• To set a threshold for a prioritized port, locate the desired prioritized port, which is indicated by
Prio. in the Attribute column. Double-click the cell in the IOPS or MB/s column in Threshold, and
enter the threshold value.
CAUTION: If you enter 0 (zero) in a cell, the cell displays a hyphen (-) and the threshold for the
prioritized port becomes ineffective. If the threshold for any prioritized port is ineffective, threshold
control will not be performed, but upper limit control will be performed.
• To set a threshold to the entire array, click the All Thresholds check box, enter the threshold value
in the text box, and select IOPS or MB/s from the list in All Thresholds.
6. Skip to step 10.
7. Select the All Thresholds check box.
8. Do either of the following:
• To disable the upper limit on I/O rates, select IOPS from the list below the check box.
• To disable the upper limit on transfer rates, select 100KB/s from the list below the check box.
9. Enter the threshold in the text box.
10.Click Apply. Settings in the pane are applied to the array.
NOTE: Select a host bus adapter from below the Monitor branch. You cannot add HBAs from
below the Non-Monitor branch to PFC groups.
NOTE: If you cannot see the IOPS or 100KB/s column, scroll to the left. The column is located at
the right side of the table.
NOTE:
• When running the Export Tool, text files are usually compressed in a ZIP-format archive file. To open a
text file, you must decompress the ZIP file to extract the text files.
• Text files are in CSV (comma-separated value) format, in which values are delimited by commas. You
can use many spreadsheet applications to open CSV files.
• Do not run multiple instances of the Export Tool simultaneously. If you run multiple instances, the SVP
might be overloaded and a timeout error might occur.
Files to be exported
You can use the Export Tool to save monitoring data in the Auto LUN XP pane into files (see Table 3
through Table 10). You can also use the Export Tool to save monitoring data about remote copy
operations into files (see Table 11 through Table 18). The Export Tool usually compresses monitoring data
in ZIP files. To use a text editor or spreadsheet software to view or edit the monitoring data, you usually
need to decompress the ZIP files to extract CSV files. However, if you want the Export Tool to save
monitoring data in CSV files instead of ZIP files, you can force the Export Tool to do so.
Table 2 shows the correspondence between the Auto LUN XP panes and the monitoring data that the
Export Tool can save. For details on the ZIP files and CSV files that are saved, see the tables indicated in
the See column.
Table 2 Auto LUN XP panes and monitoring data that can be saved by the Export Tool
CA Monitor pane and Statistics about remote copy operations by Continuous Access XP Table 11
TCz Monitor pane and TrueCopy for z/OS (in the whole array)
CAXJ Monitor pane Statistics about remote copy operations by Continuous Access XP Table 15
and URz Monitor pane Journal and Universal Replicator for z/OS (at CLPR)
Statistics about remote copy operations by Continuous Access XP Table 16
Journal and Universal Replicator for z/OS (at journal groups)
Table 3 Files containing statistics about resource usage and write pending rates
Table 4 Files containing statistics about parity, external volume, and V-VOL groups
NOTE: The letters x-y in the CSV filenames indicate a parity group. For example, if the filename is
LDEV_IOPS_1-2.csv, the file contains the I/O rate for each logical volume in the parity group 1-2.
Table 7 Files containing statistics about host bus adapters connected to ports
NOTE:
• The letters xx in the CSV filename indicate a port name. For example, if the filename is
PortWWN_1A_IOPS.csv, the file contains the I/O rate for each host bus adapter connected to the
CL1-A port.
• If files are exported to a Windows computer, CSV filenames may end with numbers (for example,
PortWWN_1A_IOPS-1.csv and PortWWN_1a_IOPS-2.csv).
Table 10 Files containing statistics about host bus adapters belonging to SPM groups
NOTE:
• The letters xx in the CSV filename indicate the name of an SPM group.
• If files are exported to a Windows computer, CSV filenames may end with numbers (for example,
PPCGWWN_mygroup_IOPS-1.csv and PPCGWWN_MyGroup_IOPS-2.csv).
RCLDEV_Out_of_Tracks RCLDEV_Out_of_Tracks_xx Number of tracks that have not yet been copied by
.ZIP .csv the initial copy or resync copy operation
1. 1 millisecond is one-thousandth of 1 second
NOTE: The letters xx in the CSV filenames indicate a CU image number. For example, if the filename is
RCLDEV_All_RIO_10.csv, the file contains the total number of remote I/Os of the logical volumes
controlled by the CU that has an image number of 10.
Table 14 Files containing statistics about remote copy operations by Continuous Access XP and
.
Table 15 Files containing statistics about remote copy operations by Continuous Access XP Journal and
Universal Replicator for z/OS (in the whole array)
Table 18 Files containing statistics about remote copy operations by Continuous Access XP Journal and
Universal Replicator for z/OS (at logical volumes controlled by a particular CU)
NOTE: The letters xx in CSV filenames indicate a CU image number. For example, if the filename is
URLDEV_Read_Record_10.csv, the file contains the number of read I/Os (per second) of the logical
volumes controlled by the CU that has an image number of 10.
NOTE: The JRE version required for running the Export Tool is the same as the JRE version
required for running Command View XP or XP Remote Web Console. For detailed information
about the JRE version required for running Command View XP or XP Remote Web Console, see the
HP StorageWorks Command View XP user guide for XP Disk Arrays or the HP StorageWorks XP
Remote Web Console user guide for the specific arrays.
NOTE:
• The export directory contains a couple of files, which includes runUnix.bat. HP recommends
deleting runUnix.bat because this file is no longer needed.
NOTE:
• The export directory contains a couple of files, which include runWin.bat. HP recommends
deleting runWin.bat because this file is no longer needed.
• The Export Tool program is a Java class file and is located in the export/lib directory.
NOTE: In this file, a semicolon (;) indicates the beginning of a comment. Characters from a semicolon to
the end of the line are regarded as a comment.
CAUTION: When writing the login subcommand in your command file, you must specify a user
ID that should be used exclusively for running the Export Tool. See ”Files to be exported” on
page 32 for reference.
CAUTION: Secure files containing user IDs and password to prevent the information from being
compromised and used for access by unauthorized people.
• show
Checks the SVP to find the period of monitoring data stored in the SVP and data collection interval
(called the gathering interval in Auto LUN XP), and then outputs them to the standard output (for
example, the command prompt) and log file.
Auto LUN XP collects statistics by the two types of storing periods: in short range and in long range.
The show subcommand displays the storing periods and the gathering intervals for these types of
monitoring data.
The following is an example of information that the show subcommand outputs:
Short Range indicates the storing period and gathering interval for monitoring data stored in short
range. Long Range indicates monitoring data stored in long range. In this example, monitoring data
in short range is stored every 1 minute in the term of 1:00-15:00 on Oct. 1, 2004. Also, monitoring
data in long range is stored every 15 minutes from Sep. 1, 2004, 0:00 through Oct. 1, 2004,
15:00. When running the Export Tool, you can export monitoring data within these periods into files.
All monitoring items are stored in short range, but part of the monitoring items is stored in the short
range and long range. For details on monitoring items that can be stored in long range, see ”The
longrange subcommand” on page 70.
Using the show subcommand is not mandatory, but HP recommends you include the show
subcommand in your command file. If an error occurs when running the 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, see ”The show subcommand” on page 57.
• group PhyPG Long and group RemoteCopy
Specifies the type of data you want to export. Specify an operand following group to define the type
of data to be exported. Basically, monitoring data stored in short range is exported, but you can
export monitoring data stored in long range when specifying some of the operands.
The group PhyPG Long subcommand in Figure 18 specifies to export usage statistics about parity
groups in long range. Also, the group RemoteCopy subcommand specifies to export statistics about
remote copy operations by Continuous Access XP and TrueCopy for z/OS in short range. You can
specify multiple lines of the group subcommand to export multiple monitoring items at the same time.
#! /bin/sh ↵
java -classpath "./lib/JSanExport.jar:./lib/JSanRmiServer.jar"
-Dmd.command=command.txt -Dmd.logpath=log sanproject.getmondat.RJMdMain ↵
If the computer that runs the Export Tool communicates directly with the SVP, you usually do not need to
change scripts in runWin.bat and runUnix.bat. However, you might need to edit the java command
script in your text editor in some circumstances, for example:
• If your command file name is not command.txt
• If you moved your command file to a different directory
• If you do not want to save log files in the log directory
• If you want to name log files as you like
If the computer that runs the Export Tool communicates with the SVP via a proxy host, you must edit the
java command script in your text editor. When editing the java command script, you must specify the
proxy host’s host name (or IP address) and port number. For example, if the host name is Jupiter and
the port number is 8080, the resulting command script is as follows:
Batch file for Windows computers (runWin.bat)
#! /bin/sh ↵
java -classpath "./lib/JSanExport.jar:./lib/JSanRmiServer.jar"
-Dhttp.proxyHost=Jupiter -Dhttp.proxyPort=8080 -Dmd.command=command.txt
-Dmd.logpath=log sanproject.getmondat.RJMdMain ↵
Figure 20 Scripts in batch files (when specifying the proxy host’s host name)
If the proxy host’s IP address is 158.211.122.124 and the port number is 8080, the resulting command
script is as follows:
#! /bin/sh ↵
java -classpath "./lib/JSanExport.jar:./lib/JSanRmiServer.jar"
-Dhttp.proxyHost=158.211.122.124 -Dhttp.proxyPort=8080 -Dmd.command=command.txt
-Dmd.logpath=log sanproject.getmondat.RJMdMain ↵
Figure 21 Scripts in batch files (when specifying the IP address of a proxy host)
For detailed information about syntax of the java command, see ”The java command for exporting data
In files” on page 75.
Running the Export Tool
To run the Export Tool and save monitoring data in files, you must execute your batch file. To execute your
batch file, you must enter the name of the batch file at the command prompt, and press Enter (see
Figure 22 for reference). If you are using a Windows computer, you can double-click the batch file to
execute the batch file.
[ 2] svpip 158.214.135.57
[ 3] login User = expusr, Passwd = [****************]
:
:
[ 6] group Port
:
:
[20] apply
Start gathering port data
Target = 16, Total = 16
+----+----+----+----+----+----+----+----+----+----+
...........................!
.................................
End gathering port data
Figure 23 Sample command prompt outputs when the Export Tool runs
When the Export Tool successfully finishes, monitoring data is usually compressed in ZIP-format archive
files. To obtain CSV files, you must decompress ZIP files and extract CSV files out of the ZIP files. If the
operating system on your computer does not include a feature for decompressing ZIP files, you must
obtain software for decompressing files.
0001 5400 Since the server is busy, monitoring data cannot be obtained.
0003 2033 Server is not ready yet, or internal processing is being executed.
• If you specify the nocompress operand for the option subcommand, the Export Tool saves files in
CSV format instead of ZIP format (for detailed information, see ”The option subcommand” on
page 72). Note that, when files are saved in CSV format instead of ZIP format, the file-saving process
would take longer and the resulting files would be larger.
• Files the Export Tool saves are often very large. The total file size for all files can be as large as
approximately 2 GB. For this reason, the export process might take a long time (see Table 20). To
export statistics spanning a long time period, HP recommends using the Export Tool more than one
time, rather than using the tool only one time to export the whole statistics. For example, to export
statistics spanning 24 hours, you could run the Export Tool eight times; each time the Export Tool runs,
the tool should export statistics spanning three hours.
Table 20 Estimate examples of time required for exporting files
PortWWN 5 minutes Assumes the Export Tool should save statistics about 128 ports within a
24-hour period.
LU 60 minutes Assumes:
• The Export Tool should save statistics about 12,288 LUs within a
24-hour period.
• The Export Tool is used eight times. Each time the Export Tool is used,
the tool obtains statistics within a 3-hour period.
• Whenever the Export Tool runs, it creates a new log file on your computer. Therefore, if you run the
Export Tool repeatedly, the size of free space on your computer is reduced. To secure free space on
your computer, HP strongly recommends deleting log files regularly. For information about the
directory containing log files, see ”The java command for exporting data In files” on page 75.
• For information about solving errors with the Export Tool, see ”Troubleshooting the Export Tool” on
page 76.
• The Export Tool returns a termination code when the Export Tool finishes (see Table 21).
Table 21 Termination codes that the Export Tool returns
1 An error occurred when the set subcommand (see ”The set subcommand” on page 73)
executed, because an attempt to switch to Modify mode failed. Some other user might
have been logged on in Modify mode.
2 An error occurred due to some reason unrelated to SVP modes (that is, View mode and
Modify mode).
3 An error occurred due to more than one reason. One of the reasons is that an attempt to
switch to Modify mode failed when the set subcommand (see ”The set subcommand” on
page 73) executed. Some other user might have been logged on in Modify mode.
4 The user ID has no permissions for Auto LUN XP, Continuous Access XP, and TrueCopy for
z/OS.
If you want to use a reference to a termination code in your batch file, do the following:
• In a Windows batch file, write %errorlevel% in the batch file.
• In a UNIX Bourne shell script, write %? in the shell script.
• In a UNIX C shell script, write %status in the shell script.
Command reference
This section explains details about subcommands you can write in your command file and the java
command you should use in your batch file. Table 22 lists the subcommands explained in this section. The
java command is explained in ”The java command for exporting data In files” on page 75.
login Logs the specified user into the SVP. ”The login subcommand” on
page 57
show Checks the SVP to find the period of monitoring data ”The show subcommand” on
stored in the SVP and the data collection interval (called page 57
the gathering interval), and then outputs them to the
standard output and log file.
shortrange Specifies the term of monitoring data to be exported for ”The shortrange subcommand”
short range monitoring data. on page 67
longrange Specifies the term of monitoring data to be exported for ”The longrange subcommand”
long range monitoring data. on page 70
outpath Specifies the directory in which files should be saved. ”The outpath subcommand” on
page 72
option Specifies whether to save files in ZIP or CSV format. ”The option subcommand” on
page 72
set Starts or ends monitoring an array and also specifies the ”The set subcommand” on
gathering interval in short range monitoring. page 73
help Displays the online Help for subcommands. ”The help subcommand” on
page 74
Command syntax
This section explains the syntax of subcommands you can write in the command file. This section also
explains the syntax of the java command you should use in the batch file.
Syntax The syntax indicates that you can write the following script
connectΔip-address connect 123.01.22.33
destinationΔ[directory] • destination
• destination c:\temp
compressΔ[yes|no] • compress
• compress yes
• compress no
portsΔ[name][Δ...] • ports
• ports port-1
• ports port-1 port-2
;;;;;;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;; COMMAND FILE: command.txt ;;;;
;;;;;;;;;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
svpip 158.214.135.57 ; IP address of SVP
login expusr "passwd" ; Log onto SVP
svpip 158.214.127.170
svpip 158.214.135.57
retry time=5 count=10
login expusr passwd
show
group Port
shortrange 200404010850:200404010910
outpath out
option compress
apply
NOTE: Be sure to specify a user ID that should be used exclusively with the Export Tool. For
detailed information, see ”Requirements for using the Export Tool” on page 45.
password
Specifies the password of the user.
If the password includes any non-alphanumeric character, the password ID must be enclosed by
double quotation marks (").
Example
This example logs the user expusr into the SVP whose IP address is 158.214.127.170. The password
is pswd.
svpip 158.214.127.170
login expuser pswd
Short Range indicates the storing period and gathering interval of monitoring data stored in short
range. Long Range indicates those of monitoring data stored in long range. When running the Export
Tool, you can export monitoring data within these periods into files. If you use the shortrange or
longrange subcommand, you can also narrow the term of data to be exported (see ”The shortrange
subcommand” on page 67 or ”The longrange subcommand” on page 70).
From indicates the starting time for collecting monitoring data. To indicates the ending time for collecting
monitoring data.
Interval indicates the interval at which the monitoring data was collected (gathering interval. For
example, Interval : 15 min. indicates that monitoring data was collected at 15-minute intervals.
Storing periods output by the show subcommand is the same as the information displayed in the
Monitoring Term area of the Auto LUN XP pane (see Figure 26).
Operand Pane of Auto Monitoring data saved in Saved ZIP file See
LUN XP the file
PhyPG Physical tab in the Usage statistics about parity PhyPG_dat.ZIP1 Table 3
Auto LUN XP pane groups
Operand Pane of Auto Monitoring data saved in Saved ZIP file See
LUN XP the file
PPCG WWN tab in the Statistics about SPM groups PPCG_dat.ZIP Table 9
Auto LUN XP pane
PPCGWWN Statistics about host bus PPCGWWN_dat.ZIP Table 10
adapters belonging to SPM
groups
If an operand is used more than one time in a command file, the last operand takes effect. In the following
example, the first group subcommand does not take effect, but the second group subcommand takes
effect:
Operands
PhyPGr[Short|Long]Δ[[parity-group-id]:[parity-group-id]][Δ...]
Use this operand to export statistics about parity group usage rates, which appear in the Physical tab
of the Auto LUN XP pane. When statistics are exported to a ZIP file, the file name is PhyPG_dat.ZIP.
For details on statistics exported by this operand, see Table 3.
You can use the Short or Long option to select the storing period of monitoring data to be exported.
If you specify Short, the exported file contains statistics in short range for up to 15 days. If you
specify Long, the exported file contains statistics in long range for up to three months (that is, up to 93
days). If neither Short nor Long is specified, statistics both in the short and long ranges are
exported.
When specifying the parity-group-id variable, you can narrow the range of parity groups whose
monitoring data is exported. parity-group-id is a parity group ID. The colon (:) indicates a
range. For example, 1-1:1-5 indicates parity groups from 1-1 to 1-5.
Ensure that the parity-group-id value on the left of the colon is smaller than the
parity-group-id value on the right of the colon. For example, you can specify PhyPG 1-1:1-5,
but you cannot specify PhyPG 1-5:1-1. Also, you can specify PhyPG 1-5:2-1, but you cannot
specify PhyPG 2-1:1-5.
If parity-group-id is not specified, monitoring data for all parity groups is exported.
PhyLDEVΔ[Short|Long]Δ[[parity-group-id]:[parity-group-id]][Δ...]
Use this operand to export statistics about logical volume usage rates, which appear in the Physical
tab of the Auto LUN XP pane. When statistics are exported to a ZIP file, the file name is
PhyLDEV_dat.ZIP. For details on statistics exported by this operand, see Table 3.
You can use the Short or Long option to select the storing period of monitoring data to be exported.
If you specify Short, the exported file contains statistics in short range for up to 15 days. If you
specify Long, the exported file contains statistics in long range for up to three months (that is, up to 93
days). If neither Short nor Long is specified, statistics both in the short and long range are exported.
When specifying the parity-group-id variable, you can narrow the range of parity groups whose
monitoring data is exported. parity-group-id is a parity group ID. The colon (:) indicates a
range. For example, 1-1:1-5 indicates parity groups from 1-1 to 1-5.
Ensure that the parity-group-id value on the left of the colon is smaller than the
parity-group-id value on the right of the colon. For example, you can specify
PhyLDEV 1-1:1-5, but you cannot specify PhyLDEV 1-5:1-1. Also, you can specify
PhyLDEV 1-5:2-1, but you cannot specify PhyLDEV 2-1:1-5.
If parity-group-id is not specified, monitoring data for all logical volumes is exported.
PhyExGΔ[[exg-id]:[exg-id]][Δ...]
Use this operand to export statistics about external LU groups, which appear in the Physical tab of the
Auto LUN XP pane. When statistics are exported to a ZIP file, the file name is PhyExG_dat.ZIP. For
details on statistics exported by this operand, see Table 3.
NOTE: Monitoring data is grouped by SLPR, and is exported per CLPR. If there are two SLPRs that are
SLPR0 (corresponding to CLPR0 and CLPR2) and SLPR1 (corresponding to CLPR1), those CLPRs are
arranged as follows: CLPR0,CLPR2,CLPR1.
group PortWWN
group PPCG
group Physical
The following example exports statistics about three ports (CL1-A, CL1-B, and CL1-C):
The following example exports statistics about six ports (CL1-A to CL1-C, and CL2-A to CL2-C)
The following example exports statistics about the parity group 1-3:
group PG 1-3:1-3
The following example exports statistics about the parity group 1-3 and other parity groups whose ID is
larger than 1-3 (for example, 1-4 and 1-5):
group PG 1-3:
The following example exports statistics about the external LU groups E1-1 to E1-5:
group PG E1-1:E1-5
The following example exports statistics about the parity group 1-3 and other parity groups whose ID is
smaller than 1-3 (for example, 1-1 and 1-2):
The following example exports statistics about LU paths for the host group (host storage domain) ID 01 for
the port CL1-A:
group LU CL1-A.01:CL1-A.01
NOTE: If the last two digits of the time on the left or right of the colon (:) are not a multiple of the
sampling interval, the time automatically changes so the last two digits are a multiple of the sampling
interval. If this change occurs to the time on the left of the colon, the time is smaller than the original time.
If this change occurs to the time on the right of the colon, the time is larger than the original time. The
following are examples:
• If the time on the left is 10:15, the time on the right is 20:30, and the sampling interval is 10 minutes:
The time on the left changes to 10:10 because the last two digits of the time are not a multiple of 10
minutes. The time on the right remains unchanged because the last two digits of the time are a multiple
of 10 minutes.
The time on the left changes to 10:14 because the last two digits of the time are not a multiple of 7
minutes. The time on the right changes to 20:35 because of the same reason.
Example
The following examples assume that:
• Starting time for collecting monitoring data is Jan. 1, 2004, 00:00
• Ending time for collecting monitoring data is Jan. 2, 2004, 00:00
shortrange 200401010930:200401011730
The Export Tool saves monitoring data within the range of Jan. 1, 9:30-17:30.
shortrange 200401010930:
The Export Tool saves monitoring data within the range of Jan. 1, 9:30 to Jan. 2, 00:00.
shortrange :200401011730
The Export Tool saves monitoring data within the range of Jan. 1, 0:00-17:30.
shortrange +0001:
The Export Tool saves monitoring data within the range of Jan. 1, 0:01 to Jan. 2, 00:00.
shortrange -0001:
The Export Tool saves monitoring data within the range of Jan. 1, 23:59 to Jan. 2, 00:00.
shortrange :+0001
The Export Tool saves monitoring data within the range of Jan. 1, 0:00-00:01.
shortrange :-0001
The Export Tool saves monitoring data within the range of Jan. 1, 0:00-23:59.
shortrange +0101:-0101
The Export Tool saves monitoring data within the range of Jan. 1, 1:01-22:59.
shortrange 200401010900+0130:200401011700-0130
The Export Tool saves monitoring data within the range of Jan. 1, 10:30-15:30.
shortrange 200401010900-0130:200401011700+0130
The Export Tool saves monitoring data within the range of Jan. 1, 7:30-18:30.
shortrange 200401010900-0130:
The Export Tool saves monitoring data within the range of Jan. 1, 7:30 to Jan. 2, 00:00.
Usage statistics about channel processors, disk processors, and data PhyProc Long
recovery and reconstruction processors
Usage statistics about access paths and write pending rate PhyCSW Long
If you run the Export Tool without specifying the longrange subcommand, data stored in the whole
monitoring term is exported.
The login subcommand must execute before the longrange subcommand executes.
Operands
The value on the left of the colon (:) specifies the starting time period. The value on the right of the colon
specifies the ending time period. Specify the term within Long Range From XXX To XXX which is
output by the show subcommand.
If no value is specified on the left of the colon, the starting time for collecting monitoring data is assumed.
If no value is specified on the right of the colon, the ending time for collecting monitoring data is assumed.
The starting and ending times for collecting monitoring data appear in the Monitoring Term area in the
Auto LUN XP pane (see Figure 28).
NOTE: Ensure that mm is 00, 15, 30, or 45. If you do not specify mm in this way, the value on the left of
the colon (:) is rounded down to one of the four values. Also, the value on the right of the colon is
rounded up to one of the four values. For example, if you specify 200401010013:200401010048, the
specified value is regarded as 200401010015:200401010100.
Example
The following examples assume:
• Starting time for collecting monitoring data is Jan. 1, 2004, 00:00
• Ending time for collecting monitoring data is Jan. 2, 2004, 00:00
longrange 200401010930:200401011730
The Export Tool saves monitoring data within the range of Jan. 1, 9:30-17:30.
longrange 200401010930:
The Export Tool saves monitoring data within the range of Jan. 1, 9:30 to Jan. 2, 00:00.
longrange :200401011730
The Export Tool saves monitoring data within the range of Jan. 1, 0:00-17:30.
longrange +000015:
The Export Tool saves monitoring data within the range of Jan. 1, 0:15 to Jan. 2, 00:00.
longrange -000015:
The Export Tool saves monitoring data within the range of Jan. 1, 23:45 to Jan. 2, 00:00.
longrange :+000015
The Export Tool saves monitoring data within the range of Jan. 1, 0:00-00:15.
longrange :-000015
The Export Tool saves monitoring data within the range of Jan. 1, 0:00-23:45.
longrange +000115:-000115
The Export Tool saves monitoring data within the range of Jan. 1, 1:15-22:45.
longrange 200401010900+000130:200401011700-000130
The Export Tool saves monitoring data within the range of Jan. 1, 10:30-15:30.
longrange 200401010900-000130:200401011700+000130
longrange 200401010900-000130:
The Export Tool saves monitoring data within the range of Jan. 1, 7:30 to Jan. 2, 00:00.
outpath "C:\\Project\\out"
The following example saves files in the out directory in the current directory:
outpath out
option nocompress
NOTE:
• The batch files can include script that execute when an error occurs. For information about writing
such a script in the batch file, see ”Notes” on page 52.
• When the set subcommand starts or ends the monitoring or changes the gathering interval after the
Auto LUN XP pane is started, the contents displayed in the Auto LUN XP pane does not automatically
change with the set subcommand operation. To display the current monitoring status in the Auto LUN
XP pane, click the Refresh button.
svpip 158.214.135.57
login expusr passwd
show
group Port
shortrange 200404010850:200404010910
apply
set switch=off
The following command file starts monitoring remote copy operations. The sampling time interval is 10
minutes.
svpip 158.214.135.57
login expusr passwd
set switch=10
help
NOTE: The ↵ symbol in this batch file example indicates the end of a command line.
In this example, you must do either of the following to view the online Help:
• Double-click runHelp.bat.
In the following example, a log file named export.log is created in the log directory below the current
directory when the Export Tool executes.
The Export Tool stops and processing does not continue. The command prompt window might be in pause mode.
The command prompt window was displaying the The command prompt window is in pause mode if you
export processing progress, but the window stopped click the command prompt window when the Export
displaying the progress before processing stopped. The Tool is running.
progress information does not seem to be updated To cancel pause mode, you must activate the command
anymore. prompt window, and press ESC.
If a timeout of RMI occurs during pause mode, the login
is canceled and an error occurs when you cancel pause
mode after the timeout. The error message ID is
(0001, 4011).
An error occurs and processing stops. If the error message ID is (0001 4011), the user is
forcibly logged off and processing stops because the
Export Tool did not issue any request to the SVP. The
computer running the Export Tool could be slow.
Confirm whether you are using a computer that is not
supported, or whether the computer is slow. Run the
Export Tool again. If the error persists, contact your
HP account support representative.
If the error message ID is (0002, 5510), probable
error causes and solutions are:
• An internal process is being performed in the array.
Alternatively, another user is changing
configurations. Wait for a while, and run the Export
Tool again.
• Maintenance operations are being performed on
the array. Wait until the maintenance operations
finish, and run the Export Tool again.
If the error message ID is none of the above, see
Table 27.
The Check License row in the log file says The Export Tool terminated abnormally due to an error.
UnmarshalException. The versions of the DKCMAIN/SVP program and the
export tool are not compatible. Verify that you are using
the correct versions.
If an error occurs when running the Export Tool, error messages are issued to the standard output (for
example, the command prompt) and the log file. Table 27 lists the Export Tool messages and
recommended actions against errors.
Invalid length: token The length is invalid. Specify a value that has a correct
length.
Invalid range: range The specified range is invalid. Specify the correct range.
Invalid value: "value" The specified value is invalid. Specify a correct value.
Login failed An attempt to log into the SVP failed. Probable causes
are:
1. An incorrect operand is used for the svpip
subcommand.
2. An incorrect operand is used for the login
subcommand.
3. The specified user ID is used by another person, and
the person is being logged in.
4. Two users are currently displaying the Auto LUN XP
pane.
5. Two users are currently executing the Export Tool.
Missing command file The command file is not specified. Specify the name of
the command file correctly.
Missing host name No host name is specified. Please specify a host name.
Missing password The Export Tool cannot find the user ID, which is used to
log into the SVP. Specify the password.
Missing svpip The svpip subcommand is not used. Use the svpip
command.
Missing user ID The Export Tool cannot find the user ID, which is used to
log into the SVP. Specify the user ID.
Permission Denied. The user ID does not have the required permission.
The user ID must have at least one of the permissions for
Auto LUN XP, TrueCopy for z/OS, Continuous Access XP
Journal, and Universal Replicator for z/OS.
RMI server error (part-code, error-number) An error occurs at the RMI server. For detailed
information, contact your HP account support
representative.
Unable to display help message The Export Tool cannot display the online Help due to a
system error.
Unable to get serial number The Export Tool cannot obtain the serial number due to
a system error.
Unable to get time range for monitoring The SVP does not contain monitoring data.
Unable to read command file: file The Export Tool cannot read the command file. Specify
the name of the command file correctly.
Unable to use the command: command The specified subcommand is unavailable because you
logged in as a storage partition administrator.
Unable to use the group name: operand The specified subcommand of the group subcommand
is unavailable because you logged in as a storage
partition administrator.
Unknown host: host The Export Tool cannot resolve the host name. Specify
the correct host name.
Unsupported command: command The Export Tool does not support the specified
command. Specify a correct command.
Unsupported option: option The specified option is not supported. Correct the
specified option.
Specify the following subcommand before login The retry subcommand is written in an incorrect
subcommand: retry position in the command file.
Write the retry subcommand before the login
subcommand.
Start gathering group data The Export Tool starts collecting data specified by the
Target = xxx, Total = yyy group subcommand.
End gathering group data
The number of targets is xxx and the total number is
yyy (see Note below).
The Export Tool ends collecting data.
LDEV tab in the Auto LUN XP pane The tree and list display only information in the SLPR allocated to the user
ID.
Port-LUN tab in the Auto LUN XP pane • The tree and list display only information in the SLPR allocated to the
user ID.
• The SPM button is not displayed (see Figure 29). Therefore, the user
cannot start Performance Control XP.
WWN tab in the Auto LUN XP pane The WWN tab is not displayed (see Figure 29). The user cannot view
traffics between host bus adapters and ports.
CA Monitor pane These panes are not displayed (see Figure 29). The user cannot view
TCz Monitor pane information about remote copy operations performed by Continuous
CA Journal Monitor pane Access XP, TrueCopy for z/OS, Continuous Access XP Journal, and
URz Monitor pane Universal Replicator for z/OS.
Monitoring Options pane The Monitoring Options pane is not displayed (see Figure 29). The user
cannot start or stop monitoring, or change the gathering interval.
A outpath subcommand 72
apply subcommand 73 retry subcommand 56
audience, documentation 7 running 51
Auto LUN XP 31, 32, 81 semicolons 47
set subcommand 73
B shortrange subcommand 67
show subcommand 57
batch files
svpip subcommand 56
preparing 49
syntax 54
running 51
system requirements 45
syntax 54
termination codes 53
troubleshooting 76
time required 52
troubleshooting 76
C
user IDs 46
command files, preparing 47 ZIP files 32
commands, Export Tool external volume statistics 35
54 extracting ZIP files 32
comma-separated value files 32
comments, inserting 47 F
Continuous Access XP 31, 40
feedback, documentation 9
Continuous Access XP Journal 31
firmware, supported 7
conventions
document 8
G
text symbols 8
CSV files 32 group subcommand 58
customer support 8
H
D HBAs
deleting PFC groups 28 grouping 26
development servers 11 many-to-many port connections 13
document one-to-one port connections 12
conventions 8 PFC names 25
feedback 9 prioritizing PFC groups 27
prerequisites 7 replacing 26
related documentation 7 SPM group statistics 38
statistics 37
E traffic management 22
traffic statistics 24
errors, Export Tool 52, 76
upper limit values 27
Export Tool
help subcommand 74
about 31
help, obtaining 8, 9
apply subcommand 73
host bus adapters (HBAs)
batch files 49
grouping 26
command files, preparing 47
many-to-many port connections 13
commands 54
one-to-one port connections 12
errors 52, 76
PFC names 25
group subcommand 58
prioritizing PFC groups 27
help subcommand 74
replacing 26
installing on UNIX 47
SPM group statistics 38
installing on Windows 46
statistics 37
java command for exporting data 75
traffic management 22
limitations 81, 82
traffic statistics 24
login subcommand 57
upper limit values 27
longrange subcommand 70
option subcommand 72
I R
I/O rate 12, 16 related documentation 7
installing Export Tool remote copy operations statistics 40
UNIX 47 requirements, Export Tool 45
Windows 46 resource usage statistics 33
restrictions 17
J retry subcommand 56
java command for exporting data in files 75
S
L semicolons 47
limitations 81 servers, production and development 11
logical volumes, statistics 36 set subcommand 73
login subcommand 57 shortrange subcommand 67
longrange subcommand 70 show subcommand 57
LU path statistics 38 SPM group statistics 38
spreadsheets, exporting to 31
M starting Performance Control 19
monitoring data. See statistics statistics
Auto LUN XP 32
N exporting 31
external volume 35
non-prioritized port 12, 15
host bus adapters (HBAs) 37, 38
logical volumes 36
O
LU paths 38
option subcommand 72 parity 35
outpath subcommand 72 ports 37
remote copy operations 40
P resource usage 33
parity statistics 35 SPM groups 38
partition administrators 81, 82 traffic 24
Performance Control pane 19 Universal Replicator for z/OS 43
PFC groups V-VOL groups statistics 35
adding HBAs 26 write pending rates 33
deleting 28
prioritizing 27
renaming 28
upper limit values 27
PFC names 25
Port tab, Performance Control pane 19
ports
many-to-many HBA connections 13
one-to-one HBA connections 12
statistics 37
threshold control 25
traffic management 22
traffic statistics 24
upper limit values 24
84
storage partition administrators 81, 82
storage platforms, supported 7
Subscriber’s Choice for Business, HP 9
supported storage platforms and firmware 7
svpip subcommand 56
symbols in text 8
syntax, command 54
system requirements, Export Tool 45
T
technical support, HP 8
termination codes, Export Tool 53
text files, exporting to 31
text symbols 8
threshold control 11, 25
time required for exporting files 52
traffic management 22
traffic statistics 24
transfer rate 12, 16
troubleshooting
Export Tool 76
Performance Control XP 29
TrueCopy for z/OS 31, 40
U
Universal Replicator for z/OS 31, 43
UNIX, installing Export Tool 47
upper limit control 11
user IDs
creating 46
limitations 81, 82
V
V-VOL groups statistics 35
W
web sites
HP documentation 9
HP storage 9
HP Subscriber’s Choice for Business 9
Windows, installing Export Tool 46
write pending rates 33
WWN tab, Performance Control pane 20
WWNs
threshold control 25
upper limit values 24
Z
ZIP-format files 32