The Genie requires a root level object named "Shape".

1. In Graphics Builder, create a new Genie.
2. Add the object you would like use as an alarm flag.
3. Display the Properties dialog for the object.
4. On the Appearance | General tab, select Filled.

Note: If you are configuring a Genie for the Disabled/Shelved alarm mode, set the fill color you would like to use on the Appearance | General tab. You can then skip step 5 as the Genie will not need to change color.

5. On the Fill|Color tab, configure the following:
• Set the Type to Array.
• Enter the following Array Expression:

dspAnGetMetaData(dspGetAnCur(), "State")

• Specify the Array Colors you want to use for 1 – 3, based to the following states:

1 = On and Unacknowledged

2 = Off and Unacknowledged

3 = On and Acknowledged

You can configure flashing colors via the Edit Favorite Colors Dialog Box, which is accessible via the Edit button on the Color Picker.

6. On the Access | General tab, enter the Name "Shape".
7. On the Metadata | General tab, enter the following items:
• Name: Equipment; Value: <blank>
• Name: Label; Value: <blank>
• Name: State; Value: 0

Note: If you are configuring a Genie for the Disabled/Shelved alarm mode, replace "Name: State; Value: 0" with "Name: Priority; Value: <blank>".

8. Click OK.

Alarm flag Genies use functionality provided by the Cicode function DspSym. You need to perform the remaining steps to enable DspSym support for the Genie.

1. Display the Page Properties for the Genie. To do this:

On the File menu, select Properties.

Or:

Right-click on the Genie background and select Page Properties.

2. On the Page Properties dialog, select I want to use this Genie with the Cicode function DspSym.
3. Click OK.
4. Save the Genie to a library.

Note: When saving an alarm flag Genie, use a name that is unique across all included projects that share the same primary project.

The Genie can also include an optional text label. The procedure described below adds a text label that displays the Short Name specified for an Alarm Priority.

1. Add a text object to an alarm flag Genie.
2. Display the Text Properties dialog.
3. On the Appearance | Display Value tab, configure the following:
• Set the Type to Numeric. This will allow you to specify the number of characters used for the text label.
• Select the required Format for the label.

This should reflect the number of characters used for the Short Name specified in the Alarm Priority properties.

• Enter the following Numeric Expression:

dspGetMetaDataFromName(".Shape", "Label")

4. On the Fill|Color tab, configure the following:
• Set the Type to Array.
• Enter the following Array Expression:

dspGetMetaDataFromName(".Shape", "State")

• Specify the Array Colors you want to use for 1 – 3, based to the following states:

1 = On and Unacknowledged

2 = Off and Unacknowledged

3 = On and Acknowledged

5. Click OK.
6. Save the Genie.

1. In Citect Studio's Setup activity, select Alarming.
2. On the menu below the Command Bar, select Alarm Priorities.
3. Locate the Alarm Priority you would like to associate with a Genie.
4. In the Genie Name field, enter the name of the Genie you would like to associate with the alarm priority.
5. In the Library Name field, enter the name of the library that includes the Genie.
6. Click Save.

1. In Citect Studio's Setup activity, select Alarming.
2. On the menu below the Command Bar, select Alarm Modes.
3. Locate the Shelved/Disabled mode in the Display Name column.
4. In the Genie Name field, enter the name of the Genie you would like to associate with the alarm mode.
5. In the Library Name field, enter the name of the library that includes the Genie.
6. Click Save.