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.

Comment on this topic

Topic ID: 810091