View source for Introductory Tutorial - General Controller and PGMs

[[Category:Tutorial]]
{{Tutorial Videos Header}}
{{Navigation|[[User Guide]]|[[Tutorial Overview|Tutorial]]|[[Tutorial Videos]]|altname=General Controller and PGMs}}
{{Tutorial Videos Header Table|currentpage=7}}

'''Related Links:''' [[General Controller]], [[PGM Programming and Conventions]], [[Declaring Variables]], [[Tag Functions|PGMs: Tag Functions]]
----

== Section 8 Overview ==

Please use these videos together with Section 8 of the SysCAD Introductory Tutorial, which is distributed with the SysCAD full install.

We will continue to use the project that we have constructed and modified in the previous sections of the Tutorial.

In this section we will look at how to insert a General Controller into a SysCAD project and then write a simple pgm control file:
 Cobalt reaction Extent = 90 + 0.012 * Autoclave Temperature
 where:
 Cobalt reaction Extent is the extent of the Cobalt reaction in the Autoclave (Reaction 2); and
 Autoclave Temperature is the final temperature of the Autoclave, measured in Kelvin.

# We will initially write the pgm file with the equation as shown above with 'hard-wired' values of 90 and 0.012;
# We will then add visibility to the pgm to allow the user to see the measured (Autoclave Temperature) and set (Cobalt Reaction Extent) values in the General Controller access window.
# Next we will the change the equation in the pgm file to:
#: Cobalt reaction Extent = A + B * Autoclave Temperature
#: and allow the user to enter the values for A and B from the Access Window of the General Controller.
# We will then add maximum and minimum values when declaring A and B so that the user cannot enter a value outside of a defined range.
# Lastly, we will move the variables onto a new Access Window of the General Controller and add some text to the Access Window.

=== Text Editor for Writing pgm Files ===

We strongly recommend that you use VS Code or Notepad++ for editing pgm files, as it has a number of advantages over Notepad and Textpad.  

The examples provided here are demonstrated using Notepad++. Please see [[Using Notepad++]] for more information on installing this software, which is distributed with SysCAD.

{{Tutorial document update note}}

== Step 1: Insert a General Controller and write a Simple pgm File ==

{| border="0" cellpadding="5" cellspacing="0" 
|-
| valign="top" | {{#ev:youtube|RbPf772I8Ac}} || valign="top" | 
* '''Section 8.4''':
*# This is the first video in the series.
*# This video shows you how to insert a General Controller into a SysCAD project and then write a simple pgm control file.
* [http://www.youtube.com/watch?v=RbPf772I8Ac YouTube link] (Allows you to watch in Full Screen mode)
* Build 136.19571
|}

== Step 2: Display Calculated Variables in the General Controller Access Window ==

{| border="0" cellpadding="5" cellspacing="0" 
|-
| valign="top" | {{#ev:youtube|UMsiT1ttbQc}} || valign="top" | 
* '''Section 8.4.1''':
*# This is the second video in the series - you must have already inserted the controller and added the text as shown in the video above.
*# This video then shows you how to display calculated variables from the pgm file on the Access Window of the General Controller.
* [http://www.youtube.com/watch?v=UMsiT1ttbQc YouTube link] (Allows you to watch in Full Screen mode)
* Build 136.19571
|}

== Step 3: Allow Users to Enter Values in the General Controller Access Window ==

{| border="0" cellpadding="5" cellspacing="0" 
|-
| valign="top" | {{#ev:youtube|37tzPZMdJNM}} || valign="top" | 
* '''Section 8.4.2''':
*# This is the third video in the series.  You must have already completed the steps shown in videos 1 and 2.
*# This video shows you how to display variables from the pgm file on the Access Window of the General Controller so that users may enter the values.
* [http://www.youtube.com/watch?v=37tzPZMdJNM YouTube link] (Allows you to watch in Full Screen mode)
* Build 135.15600
|}

== Step 4: Add a Range to an Input Variable ==

{| border="0" cellpadding="5" cellspacing="0" 
|-
| valign="top" | {{#ev:youtube|BHJYZB0qBRw}} || valign="top" | 
* '''Section 8.4.2''':
*# This is  the fourth video in the series.  You must have already completed the steps in the above 3 videos.
*# This video shows you how to add a range when declaring a user variable in a pgm file.
* [http://www.youtube.com/watch?v=BHJYZB0qBRw YouTube link] (Allows you to watch in Full Screen mode)
* Build 135.15600
|}

== Step 5: Add Page and Text Labels on the General Controller Access Window ==

{| border="0" cellpadding="5" cellspacing="0" 
|-
| valign="top" | {{#ev:youtube|K0jq2PNV-1Q}} || valign="top" | 
* '''Section 8.4.2''':
*# This is the fifth video in the series. You must have already completed the steps shown in the above 4 videos.
*# This video shows you how to add a new Page to the Access Window of the General Controller and also how to add Text to the Access Window.
* [http://www.youtube.com/watch?v=K0jq2PNV-1Q YouTube link] (Allows you to watch in Full Screen mode)
* Build 135.15600

<br>
NOTE: Since {{Available139|32335||y}}, 
*The syntax for page label is: <syntaxhighlight lang="pgm" inline>PageLabel "TabName" </syntaxhighlight>.   
*The syntax for text label is: <syntaxhighlight lang="pgm" inline>TextLabel "Text" </syntaxhighlight>.
|}

== Optional - Finding and Fixing Common pgm Errors ==

{| border="0" cellpadding="5" cellspacing="0" 
|-
| valign="top" | {{#ev:youtube|PEfeELlLvSQ}} || valign="top" | 
* '''Section 8.4''': Shows you some common pgm errors - how find and fix them.
* [http://www.youtube.com/watch?v=PEfeELlLvSQ YouTube link] (Allows you to watch in Full Screen mode)
* Build 135.15600
|}