Defining Substitutions for Super Genies

You can only use Super Genie substitution in the properties of an object that accepts tags, commands and expressions. You can also use Super Genie substitutions in log messages for object touch and keyboard commands, tool tips, page keyboard commands, or as part of the comment for Trend objects, and Color Floods. However, you cannot use the Super Genie syntax in a report, alarm, trend, or background Cicode function.

To mark a tag as a substitution string, enclose the tag between question mark (?) characters, in the following format:

?<Data Type> <Association>?

where:

• Data Type is optional except in the case of the STRING variable type, which needs to be explicitly specified. When Data_Type is left blank, CitectSCADA will correctly typecast variable types other than STRING at runtime.

• Note: Explicit type casting to BCD, BYTE, LONGBCD, UINT and ULONG types is not supported for the substituted tag. Use typeless substitutions for these types.

• Association - Can be a Number or a Name.
• • Number determines which variable tag (1 to 256) will be substituted when the Super Genie is displayed (using the Super Genie functions). If you use more than one substitution string in your Super Genie, make your numbers sequential. This will make the Super Genie functions easier to use.
  • Name determines which variable tag will be substituted when the Super Genie is displayed. For example, if a substitution is defined with the name SPEED, and explicitly specifies the type as REAL, the substitution would be referenced as ?REAL SPEED? on the graphics page. The page substitution may be referenced as many times as necessary on the Super Genie page.

If you do not specify a data type, it will default to TYPELESS. Typeless substitution allows you to pass tags of BYTE, BCD, DIGITAL, INT, UINT, LONG, LONGBCD, or REAL types, but not STRING. When you make a typeless substitution, CitectSCADA will automatically try to convert the substituted 'data' to the correct type at runtime.

See Also