startsvccollection

Use the startsvccollection command to start a named data collection task on the Performance Manager server for the SAN Volume Controller (SVC).

Syntax

Read syntax diagramSkip visual syntax diagram>>-perfcli-- --startsvccollection-- ---devid--device_id-- ------>

>---devip--device_ip-- ---devuser--device_user-- --------------->

>---freq--frequency-- ---length--hours-- ----------------------->

>--collection_name | ------------------------------------------><

Parameters

-devid device_id
Specifies the nickname or manufacturer, model, and serial number (for example, ESS2105-123123-IBM) of the device to be included in the performance data collection task. Multiple devices must be separated by commas with no white space before or after each comma. All devices must be of the same device type.
-devip device_ip
Specifies the device IP address to be included in performance data collection task. Multiple devices must be separated by commas with no white space before or after each comma.
-devuser device_user
Specifies the device user names for the performance data collection task.
-freq frequency
Specifies how often the performance data is to be collected in increments of 5 minutes. For ESS devices, options are 5, 10, 15, ..., 60.
-length hours
Specifies how long, in increments of 1 hour, the collection task is to run. Valid values are between 1 hour and 720 hours.
collection_name | -
Specifies the name of the collection task. Alternatively, use the dash (-) to specify that input for this parameter comes from an input stream (stdin). The name cannot be > 64 characters.

Description

You can use the startsvccollection command to collect data. After you create and name a data collection task for an SVC, you can start the data collection task in one of these ways:

Return values

success
Collection collection_name was successfully executed.

Possible failures

Examples

The following example starts a collection against two SVC devices to run every 10 minutes for 5 hours.

perfcli startsvccollection -dev 1234.12345,6789.67890 -devip 
  192.168.0.10,192,168.0.11 -devuser bob,susie -freq 10 -length 5
  collection1

The following example starts a collection against a single SVC device to run every hour for 24 hours.

perfcli startsvccollection -devid 1237.12348 -devip 195.178.0.20
  -freq 60 -length 24 collectiona

Related topics

(C) Copyright International Business Machines Corporation 2004