Passing multiple arguments

Using CitectSCADA > Defining and Drawing Graphics Pages > Defining Commands and Controls > Passing multiple arguments

Passing multiple arguments

You can pass multiple arguments into a Cicode command by separating each argument with a comma (,). Each argument is passed into the command in sequence, and is referred to in the command field as Arg1, Arg2, Arg3, and so on. For example:

Key Sequence	F3 ###, ### Enter
Command	SP1 = Arg1; SP2 = Arg2;

In this case, an operator can set two variables with the same command, for example:

sets the variables SP1 to 20 and SP2 to 35.

You can use up to eight arguments. However, avoid passing many arguments.

Note: There is no way to check if the input for each argument is valid. If an operator does not enter any data for one of the arguments (i.e. the key sequence:

is used), the value of Arg2 is zero, and the second variable is set to zero. Do not use multiple arguments in a command if invalid input might generate undesired behavior in the project or in the larger system.

UNINTENDED EQUIPMENT OPERATION

Do not use keystroke sequences to pass multiple arguments to Cicode commands unless possible input combinations have been tested and determined to be safe.

Failure to follow these instructions can result in death, serious injury, or equipment damage.