viewmeasurementhistory

Teradata Server Management Web Services User Guide

brand
Hardware
Software
prodname
Server Management
vrm_release
12.07
category
User Guide
featnum
B035-5350-097K

Purpose

The viewmeasurementhistory command displays measurement information for chassis that have measurement history to the screen or outputs to a file.

Invoking this command with a system, collective, or cabinet component retrieves measurement history for all chassis contained in that system, collective, or cabinet that have measurement history.

Syntax

viewmeasurementhistory [components] [TimeParameters] [DisplayParameters] [FilterParameters]

Parameters

components
Unique ID of the component or components whose history records you want to display. The unique ID can be a Component ID, default alias, or user-defined alias. If no Component IDs or aliases are specified, records for the first system display.
Components can only be at the system, collective, cabinet, or chassis level.

Time Parameters

-all
Displays all records in the system. If -all or -max is not specified, the default is 1000 records.
Operation could be lengthy depending on the size of the system.
viewmeasurementhistory -all displays all measurement records in the system.
-desc | asc
Specifies sort order based on create time.
  • Descending displays newest record first (default)
  • Ascending displays oldest record first
-end [mm/dd/yyyy ] [hh:mm:ss]
Selects the end date or time. Default is current date or time 23:59:59.
-max x
Specifies the maximum number of records to retrieve. If -all or -max is not specified, the default is 1000 records.
-sec | -min | -hrs | -days x
Selects records by the specified seconds, minutes, hours, or days since the start time or before the end time; if -start or -end is not specified, the default is since current time.
viewmeasurementhistory -start 10/02/2013 -days 2 displays 2 days of measurement records, starting October 2, 2013 00:00:00 and ending 2 days later, on October 3, 2013 23:59:59.
viewmeasurementhistory -end 10/15/2013 -days 4 displays 4 days of measurement records, starting on October 11, 2013 00:00:00 and ending on October 15, 2013 23:59:59.
viewmeasurementhistory -days 4 displays measurement records starting 4 days earlier up to current time.
viewmeasurementhistory -start 8/19/2013 -days 1 displays measurement records for all records logged on August 19, 2013.
-start [mm/dd/yyyy ] [hh:mm:ss]
Selects the start date and time. Default is current date and time 0.

Display Parameters

-byalias
Displays output using the component alias instead of the ObjectPath. If a user-defined alias has been configured, it displays.
-bycollective
Displays measurement information one collective at a time. You cannot use -bycollective if you designate specific components.
viewmeasurementhistory -all -bycollective lists all measurement records in the system, one collective at a time.
viewmeasurementhistory -all -sys=1 -coll=3-5 -bycollective lists all measurement records from system 1, collectives 3 through 5, one collective at a time.
-csv
Displays the information in CSV (comma-separated value) format on the screen. To redirect the command output to a .csv or .txt file, type one of the following:
  • -csv > myfilename.csv
  • -csv > myfilename.txt
-formNameValue
Displays in AttributeName=Value format.
-nohdr
Suppresses display of format header.
-perform
Displays statistics such as elapsed time and number of records.

Filter Parameters

-cabinetID=cabinetIDNumber[,...]
Selects records associated with the cabinet ID numbers. If you identify multiple cabinet ID numbers, you cannot specify chassis IDs.
-chassisID=chassisIDNumber[,...]
Selects records associated with the chassis ID numbers.
-collectiveID=collectiveIDNumber[,...]
Selects records associated with the collective ID numbers. If you identify multiple collective ID numbers, you cannot specify cabinet IDs or chassis IDs.
-model=modelName[,...]
Selects records with the specified model names.
-objectClass=objectClassName[,...]
Selects records associated with object class names. To determine the class name, see the first part of the component ID.
If the component ID is CMIC_5500J.SystemID=1,CollectiveID=400,CabinetID=1,ID=6 , the class name is CMIC_5500J.
-propname=propertyName[,...]
Selects records with matching property names.
-propunit=propertyUnit[,...]
Selects records with matching property units.
-propvalue=propertyValue[,...]
Selects records with matching property values.
-systemID=systemIDNumber[,...]
Selects records associated with the system ID numbers. If you identify multiple system ID numbers, you cannot specify collective IDs, cabinet IDs, or chassis IDs.
viewmeasurementhistory -sys=1 -cab=300 -chas=203,204 lists measurement records where systemID=1, cabinetID=300, and chassisID=203 or chassisID=204.
-type=chassisType[,...]
Selects records with the specified chassis types.