Purpose

.DisplayProgessTime allows you to specify or retrieve, for the Application object, the time interval (in seconds) in which the count of records processed so far is updated.
 

Object Type

Application

Syntax

Setting:          ObjectReference.DisplayProgessTime = Value

Retrieving:       Variable = ObjectReference.DisplayProgessTime
 

Operation

ObjectReference is the Tag Name of the Application object.
Value
is a numeric variable specifying the refresh time interval.
Variable
is a numeric variable.
 

Remarks

This feature can be used in cycles and during all sorts.  As it is an Application property, once enabled, it remains in effect for all functions until it is explicitly disabled.

Refresh time interval is a number representing the number of seconds between updates.  If zero or a negative number is used, the feature is disabled.

The count appears as a number of up to six digits, placed in a field to the right of the Client's message (status) box. The message box is shortened by the corresponding amount, so some long status messages may no longer fit in the remaining space. To display the full status message, the user can extend the size of the window by dragging the right side of the box to the right.

When the number changes, this indicates that the record count is occurring. When it remains static, the record count is not occurring. The counter is reset every time there is screen entry, and the number does not change during screen execution.  

It provides an approximate indication of how many records are being processed, it does not display the actual total, and it does not report the number of primary records, but the number of file accesses, both read and write.

Counting begins at zero when the user returns input to the PROIV Virtual Machine.
 

Example

To set the display interval to fifteen seconds:

 

Application.DisplayProgressTime = 15

 

To turn off the display of records processed:

 

Application.DisplayProgressTime = 0
 

Comment on this topic

Topic ID: 510052