3.1  Object Handles

PowerScript identifies each network object by a unique number, called a “handle.” You must use one of the following functions to obtain a handle before you can read or update the object’s parameters.

GetEquipment     returns the handle of the next piece of network equipment of the given type.

GetRelay          returns the handle of the next protective device in a relay group.

GetBusEquipment  returns the handle of the next piece of equipment of a given type at a bus.

FindBusByName    returns the handle of the bus having a given name and nominal kV.

NextBusByName    returns the handle of the next bus in sorted bus list.

NextBusByNumber  returns the handle of the next bus in sorted bus list.

GetData          returns handle as part of an object data, e.g., the end buses of a line.

A detailed description of these functions is given in Section 4.

The handle is an identification tag. When you provide the object handle as an input to a PowerScript function, the function will know which object you are referring to.

In addition to handles returned by the functions listed above, there are several pre-defined handles that give PowerScript access to general system data:

Table 3.1. List of predefined PowerScript handles