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.
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.
- -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.
- -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.
- -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.
- -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.
- -type=chassisType[,...]
- Selects records with the specified chassis types.