Validate performance equation syntax with pipetest
- Last UpdatedJul 15, 2025
- 1 minute read
- PI System
- PI Server
Use the pipetest utility to check the syntax of a performance equation. Run the pipetest utility from the ..\PI\adm directory. The utility can operate interactively, take its input from a file, or check the extended descriptor of a point.
To start pipetest, open a command window, change to the ..\PI\adm directory, and type a pipetest command. For a complete list of pipetest commands, type:
pipetest -?
The pipetest utility is limited to equations that are 4,095 characters or less, and you cannot use the utility to test dynamic response functions.
To run the pipetest utility interactively from a command prompt window, open a command window, change to the ..\PI\adm directory and type:
pipetest
At the pipetest equation prompt, type in the equation you want to test. If the equation syntax is not valid, pipetest displays a syntax error. If the syntax is valid, pipetest displays the result of the equation.
You can also put one or more performance equations in a simple text file, and pass the entire file to pipetest using the -f switch. In the text file, you put each equation on a single line. You can include comment lines by beginning the line with an exclamation mark ().
Here is the text from an example pipetest file, called peTestEquations.txt:
! test calculation for point A
if BadVal('sinusoid') then 0 else ('sinusoid')/25
! test calculation for point B
TimeLT('sinusoid', 'y' , 't', TagVal('sinusoid', '*'))
To test the equations in the file, type:
pipetest -f peTestEquations.txt
Each input line in turn is echoed and the evaluated result is displayed.