show_hst_data

Purpose:

Print the contents of a /data/compressed/split/[variable_name] file to the screen within certain time range.

Enter:

show_hst_data <variable_name> [n=number_of_samples] [sa=start_hours] [ea=end_hours] [start_date=start_date] [start_time=start_time] [end_date=end_date] [end_time=end_time] [v=verbosity]

Where:

variable_name

Required. Specify the variable to be listed on the screen.

n

Optional. Specify the number of samples to perform.

sa

Optional. Specify the number of hours in the past to start your search.

ea

Optional. Specify the number of hours in the past to end your search..

start_date

Optional. Specify the date to start samples. Use this format;  Month-day-year or Month/day/year. The month is either a single or two-digit number (e.g. 01 or 1 for January) or a three-letter abbreviation (e.g. Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep Oct, Nov, Dec). The year is a four-digit number (e.g. 2016).
Default is the starting date in the file.

start_time

Optional. Specify the time of day to start sampling for the specified start_date. Use the format: Hour:minute:second. The hour, minute, and second are each two-digit number, separated by colon “:” or “-” (e.g. 00:30:00 for 30 minutes after the hour). Default is 00:00:00.

end_date

Optional. Specify the date to end sampling. Use the same format as start_date. Default is current date.

end_time

Optional. Specify the time of day to end sampling. Use the same format as start_time. Default is current time.

v

Optional. Specify whether to turn on or off more verbose output for the records. Default is ON. Options are, ON, OFF, TRUE, FALSE, 1, or 0

Example:

show_hst_data RPM
The above command lists all the contents of the /data/compressed/split/RPM file to the screen.

show_hst_data ch_199 n=100 start_date=May-6-2016 start_time=12:59:56 end_date=05/10/2016 end_time=12:59:59
This version of the command line execution lists 100 records of the /data/compressed6/split/ch_199 file starting at May 6 2016 at 12:59:56 and ending at May 10 2016 at 12:59:59.

show_hst_data ch_9 start_date=Jun-21-2016
This version of the command line execution lists all records from the /data/compressed6/split/ch_199 file starting at June 21 2016 until now.

show_hst_data RPM end_date=Sep-21-2016 end_time=13:30:59
This version of the command line execution lists all records from the /data/compressed6/split/RPM file starting from the first entry until September 21 2016 at 13:30:59.

show_hst_data Speed n=50 sa=30 ea=25
This lists 50 records from the /data/compressed6/split/Speed file starting 30 hours ago and list records up to 25 hours ago.

show_hst_data Speed sa=10
This lists all records from the /data/compressed6/split/Speed file starting 10 hours ago to now.

show_hst_data Speed ea=20
This lists all records from the /data/compressed6/split/Speed file starting at the beginning of the file until 20 hours ago.

Notes:

The start date/time and end date/time overrides the sa and ea arguments. The start_time and end_time should not be used alone, specify them with a start_date and end_date. When using the number of samples argument, the oldest records are always displayed first.

See Also: