Return values, Examples – HP Matrix Operating Environment Software User Manual
Page 141

-p
Indicates that the workload whose data is being imported is a non-Matrix
OE workload. This provides an alternative to importing HP Performance
Agent (OVPA) data from non-licensed systems to use in Capacity Advisor
scenarios. If a non-Matrix OE workload already exists in the Capacity Advisor
data, an error message appears. Non-Matrix OE workloads are not
associated with any licensed nodes and are not visible on the Matrix OE
Workload tab.
To import non-Matrix OE workload data, use the following GUI action
sequence starting from the Planning tab: Modify -> Edit Planning Scenario.
The Edit Scenario window opens. Then select What-If Action -> Create
Workloads from the menu. Activate the radio button “Copy Profile” and
choose a non-Matrix OE workload from the “Select Workload” list. You must
know ahead of time the name of the non-Matrix OE workload.
-r profile_ID
Removes all profile data for a specified workload or system from the CMS.
This can be used, for example, to release disk space when a workload is
retired and its performance data is no longer needed. The profileID
names a specific workload. All system name profiles are fully qualified.
-S
Saves the import-compartment attributes. Used in conjunction with -i to import
data. Saves the container attributes specified in the import header as attributes
for the target profile.
-t
Exports data as a table.
-x
Exports utilization data for the specified profile as a sequence of lines. Each
line contains utilization values for a five-minute period. The format is specified
in the capprofile(4) manpage. The exported text is sent to standard-out
(stdout)
.
-y delimiter
Specifies the delimiter character used to separate values in imported and
exported data. The default delimiter is the comma. Valid delimiters, with or
without double quotes, are: comma (,), slash (/), semicolon (;), colon (:)
and vertical bar (|); some of these delimiters may need to be quoted or
escaped.
RETURN VALUES
Exit values are:
0
Successful completion.
3
An error was encountered accessing the database..
8
An invalid command-line option was specified.
9
An invalid argument was specified to an option.
10
An invalid combination of options was specified.
11
An error occurred accessing Systems Insight Manager, or an unhandled exception occurred
during collection.
32
The beginning of the sample date range occurs after the end date.
EXAMPLES
Export profile data from December 14, 2005 at midnight to midnight December 31, 2005 for the
workload with profileID billing3 to the file billing3.txt in the /tmp directory.
capprofile -x -b 20051215 -e 200512312359 billing3 > /tmp/billing3.txt
Import profile data from the file /tmp/billing3.txt for the profile with profileID billing3.
capprofile -i -o billing3 < /tmp/billing3.txt
Mark a range of utilization data as invalid for the workload with profileID prod05_wkld. All
samples between December 15 2005 at 11 a.m. and December 16 2005 at 12 p.m. (inclusive)
are marked invalid.
capprofile -m i -b 2005121511 -e 2005121612 prod05_wkld
141