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 a symbol.

A small, simple shape that supports a fill color is recommended.

3. Display the Properties dialog for the object.
4. On the Appearance | General tab, select Filled.
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 6 – 9, based to the following states:

6 = On and Unacknowledged

7 = Off and Unacknowledged

8 = On and Acknowledged

9 = Disabled/Shelved.

If required, you can configure flashing colors for a state via the Edit Favorite Colors Dialog Box, which is accessible via the Edit button on the drop-down Color Picker.

Note: Array colors 1 - 4 are reserved for use with the flag on an Alarm Indicator.

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

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.

To add a Priority and State column to an alarms list, you need to add the display field "{PriorityAndState}" to the alarm format used by the list.

For example, in a project created from a Situational Awareness Starter Project, the parameter [Format]FormatName is used as a project database parameter to define the following alarm formats:

Format Name	Display Fields
Alarm	{PriorityAndState,50}{Date,80}{Time,90}{Name,250}{Cluster,100}{State,40}{Type,70}{UserName,100}{Tag,250}{AlmComment,250}{Priority,60}{Quality,60}
Top5Alarm	{PriorityAndState,24}{Date,90}{Time,90}{Name,220}{Desc,300}{State,50}
SOE	{PriorityAndState,50}{Date,160}{Time,160}{Tag,100}{Message,640}{State,160}{Classification,130}{UserName,160}{UserLocation,160}
TopActiveAlarms_UHD4K	{PriorityAndState,24}{Date,120}{Time,130}{Name,190}{Desc,180}{State,50}
InfoAlarm_HD1080	{PriorityandState,24}{Time,90}{Item,160}{Name,180}

This places the Priority and State symbol in the first column of these alarm lists.

You can edit the alarm formats for a Situational Awareness project in the Setup activity (see Project Database Parameters).

For other projects, see Format an Alarm Display.