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:

  1. Click New Task Selection Icon icon. The Menu screen appears.

  2. Select the Security option.

  3. Select the Maintain Common Variables option.

  4. 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.

  1. To view more information about a particular Common Variable, select the variable’s row and double click the row.

  2. The Amend selected Common Variable window appears.

  3. 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.

  1. Click OK to save the changes to the Common Variable.

Adding a Common Variable

To add a new Common Variable, follow these steps:

  1. Follow steps from 1- 4 in the Viewing a Common Variable procedure.

  2. Click New to display the Add a new Common Variable window.

  3. Enter a name for the Common Variable in the Name field.

  4. Enter a description for the Common Variable in the Description field.

  5. Select whether the variable is alpha or numeric.

  6. Click Variable cleared indicator check box to clear the variable when the @PUTVAL(“CLEAR“,““) statement is used in logic.

  7. Click OK to save the Common Variable and to close the screen.

Deleting a Common Variable

To delete a Common Variable, follow these steps:

  1. Follow steps from 1- 4 in the Viewing a Common Variable procedure.

  2. Click Delete .

  3. Click Yes to delete the variable, or click the No to cancel the deletion process.

  4. 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:

  1. Follow steps from 1- 4 in the Viewing a Common Variable procedure.

  2. Click View .

  3. The View Common Variable Values for a Terminal Id window appears.

  4. Select the appropriate Terminal ID from the Terminal ID drop-down list.

  5. 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.

  1. Click OK to close the View Common Variable Values for a Terminal Id screen.

Comment on this topic

Topic ID: 810091

Table of Contents

Index

Glossary

-Search-

Back