Customizing the Process History View

Specifying the time interval for Process History View

Parameter: /span (recommended), /hour, or /hours

The time interval is treated differently for Event displays than it is for Charts and E+Charts.

In Event displays, specifying the time interval results in the most recent specified interval of events to be displayed. The default is for no time filtering. Also, do not use the time span with the starttime parameter. By design, parameters display only the most recent events, and the end time is always the current time. Therefore, provide either a start time or a time interval to specify a smaller time span. If you provide both a start time and a time span, the start time is ignored.

For Charts and E+Charts, you must specify the time interval with the span parameter. For any new chart, the default time range is 8 hours, ending at the current time. If creating a new Chart or E+Chart with the /new qualifier, use the span parameter to modify the value from its default 8 hours. If opening an existing file, you can use this parameter to change the configured value in the file. If using the Process History View application, this is the same as clicking ChartConfigure Chart, clicking the Time Scale tab, and entering the value in the Span field.

For Charts and E+Charts, you can use the span parameter used with the other time specification parameters, starttime and endtime.

Type: Time span specification

Applies to: Events, Chart, and E+Chart

Format:
  • If span: #days #hours:#minutes
  • If hour or hours: #hours

Value: If using the span parameter, the day must be a positive integer (it is not required for spans of less than one day). For example, specify two days as "2 00:00" . The hour is an integer between 0 and 23. The minute is an integer between 0 and 59. If just a single integer is supplied, it is considered that number of hours. For example, specify five hours as either "5" or "5:00".

Note

The hour (and hours) parameters support previous versions but are not recommended.

Examples:

In this example, the Process History View application opens a new events document that displays events that occurred four hours prior to the current time.

CHS /new events /span 4

In this example, the Process History View application opens an existing file, and modifies the time span to 2 hours.

CHS motor.phvc /span "2:00"