Maintain Common Variables
|
|
 |
Common Variables provide an alternative method of accessing and storing values in the PROIV’s Common Block. They offer an alternative to the @$COM1..10 and @#COM1…10 system variables and are system-wide variables that facilitate transfer of data from one function to another. Once defined, values can be written to or retrieved from the Common Block through use of four Global Logics: @PUTVAL, @GETVAL, @PUTNVAL, and @GETNVAL. The developer creates a new variable in a Screen function and uses @PUTVAL and @GETVAL logics to pass values between non-Global Logics, or those that are not linked together with Interface Maps.
To view Common Variable information, follow these steps:
-
Click
icon. The Menu screen appears. -
Select the Security option.
-
Select the Maintain Common Variables option.
-
The Maintain Common Variable screen appears.
Field Descriptions
|
Fields |
Description |
|
Column Headers |
|
|
Common Variable Name |
Displays the Common Variable name. |
|
Type |
Displays the type of the Common Variable, either Numeric or Alpha. |
|
Cleared? |
Displays whether the variable is cleared when the @PUTVAL(“CLEAR“,““) statement is used in logic. |
|
Common Description |
Displays the Common Variable description. |
|
Buttons |
|
|
Exit |
Click the Exit to close the Maintain Common Variables screen. |
|
Save |
Click the Save to save the changes to the Common Variables. |
|
Cancel |
Click the Cancel to cancel any changes to the Common Variables. |
|
View |
Displays View Common Variable Values for a selected Terminal Id window, which details the values for the selected Terminal ID. You can change the terminal by selecting the appropriate Terminal ID from the Terminal ID drop-down list. You can also view all of the variables regardless if there are values held against them by selecting the All Variables check box. |
|
New |
Click to display the Add a new Common Variable window. Enter the details of the variable and click the OK . |
|
Amend |
Click to display the Amend selected Common Variable window. Amend the details of the variable and click the OK . |
|
Delete |
Click to delete the selected Common Variable, click either Yes or No to delete or cancel the process. |
-
To view more information about a particular Common Variable, select the variable’s row and double click the row.
-
The Amend selected Common Variable window appears.
-
Amend the Common Variable using the following table as a guide.
Field Descriptions
|
Fields |
Description |
|
Name |
Enter a name for the Common Variable in the Name field. |
|
Description |
Enter a description for the Common Variable in the Description field. |
|
Alpha /Numeric |
Select whether the variable is alpha or numeric. Default is Alpha |
|
Variable cleared indicator |
Click the check box to clear the variable when the @PUTVAL(“CLEAR“,““) statement is used in logic. |
|
OK |
Click to save the changes. |
|
Cancel |
Click to exit the screen without saving the changes. |
-
Click OK to save the changes to the Common Variable.
Adding a Common Variable
To add a new Common Variable, follow these steps:
-
Follow steps from 1- 4 in the Viewing a Common Variable procedure.
-
Click New to display the Add a new Common Variable window.
-
Enter a name for the Common Variable in the Name field.
-
Enter a description for the Common Variable in the Description field.
-
Select whether the variable is alpha or numeric.
-
Click Variable cleared indicator check box to clear the variable when the @PUTVAL(“CLEAR“,““) statement is used in logic.
-
Click OK to save the Common Variable and to close the screen.
Deleting a Common Variable
To delete a Common Variable, follow these steps:
-
Follow steps from 1- 4 in the Viewing a Common Variable procedure.
-
Click Delete .
-
Click Yes to delete the variable, or click the No to cancel the deletion process.
-
The Common Variable is deleted from the Maintain Common Variables screen.
Viewing a Common Variable by Terminal ID
To view a Common Variable by Terminal ID, follow these steps:
-
Follow steps from 1- 4 in the Viewing a Common Variable procedure.
-
Click View .
-
The View Common Variable Values for a Terminal Id window appears.
-
Select the appropriate Terminal ID from the Terminal ID drop-down list.
-
The values are displayed for the selected terminal.
Field Descriptions
|
Fields |
Description |
|
Terminal ID |
Select the terminal from the Terminal ID drop-down list. |
|
All Variables |
Click the check box to display all of the variables used on the Terminal regardless of whether they have a current value. |
|
Common Name |
Displays the name of the Common Variable. |
|
Type |
Displays the type of the Common Variable. |
|
Value |
Displays the value of the Common Variable. |
|
OK |
Click to close the View Common Variable Values for a Terminal Id screen. |
-
Click OK to close the View Common Variable Values for a Terminal Id screen.
Topic ID: 810091