To run a function when you click on a page in PowerLogic SCADA v7.20 (PLS), add the function to the Page Properties of the current page in Citect Graphics Builder. Select the Events tab, check the On page shown box and enter the desired function in the On page shown command box.

If you add the function to the While Page Shown, the function will not run if it contains a blocking function.

For example, consider the following function where cnt1 has been defined as a Local Variable.

FUNCTIONTest()
IF cnt1<1000THEN
cnt1=cnt1+1;
END
// cnt1=TagRead("MyPM870\MMXU1\Hz");
END



Calling this function from the "While page shown command" box will work because there is no blocking function inside Test().

Alternatively, consider the following modified Cicode with TagRead added, which is blocking function:

FUNCTIONTest()
// IF cnt1<1000 THEN
// cnt1=cnt1+1;
// END
cnt1=TagRead("MyPM870\MMXU1\Hz");
END

This will NOT work and until the tag will be available from the cache, it will generate a hardware alarm (System Alarms page)--"Foreground Cicode cannot block"--and the execution of the function will be cancelled. The alarm will disappear after the code execution has stopped.

In the following screen capture of the Client Kernel, we can see that PageFG (page foreground cicode) is in the Stop state since Test() contained a blocking function.

---

Legacy KB System (APS) Data: RESL208839 V2.0, Originally authored by AnVa on 08/10/2012, Last Edited by AnVa on 10/08/2012
Related ranges: PowerSCADA Expert 7.2, PowerLogic SCADA 7.1