PercentUtil

---

General System Function

The PercentUtil function returns the cumulative utilization percentage for the specified Location or Resource. If a Resource is specified without the optional unit number, the function returns the average percent utilization of all units.

The value returned by this function represents the cumulative percentage of capacity occupied (if a Location) or units captured (if a Resource), on average, at the time the function was called.

(Cumulative Occupancy or In Use Time x 100) / (Capacity or Unit(s) x Scheduled Time)

Cumulative Occupancy Time in this equation refers to the sum of the clock time each Entity spends at a Location for processing.

Cumulative In Use time in this equation refers to the sum of the clock time all Resource units are captured for use by an Entity or downtime. If the optional Resource unit number is specified in the function, only the Cumulative In Use time for that unit is calculated.

Syntax

PercentUtil (<loc or res name> {, <res unit})

Examples

PercentUtil (Lathe)

PercentUtil (Operator)

PercentUtil (Operator, 3)

Parameters

<loc or res name>

The Location or Resource name to examine.

{, <res unit}

The Resource's optional unit number. If omitted, the function returns the average of all units.

Remarks

The method used to calculate utilization percentage for this function is the same method used in the output statistics.

PercentUtil may be called to return percent utilization for both multi- and single-capacity Locations, all Resource units, or an individual Resource unit.