> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/alarm-instructions/creating-a-new-alarm-instruction.md).

# Creating a new Alarm Instruction

### Introduction

This procedure details how to create an Alarm Instruction.

### Procedure

1. Click **Configure** from the menu bar, then **Alarm Instructions**.

   The **Alarm Instruction** List Window opens (in [grid view](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/list-windows/grid-view.md)).
2. **Right click** and select **New\...Alarm Instruction**.

   By default the **General** tab displays.
3. Complete the fields as required.

   For further detail see [General tab](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/generic-properties-configuration/general-tab.md).
4. Click the **Instructions** tab.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-a392cc18c34163c5a1278d9b42900bc3989762ff%2Falminst_alminsttab.png?alt=media)
5. Enter the appropriate text for the instruction an operator is to undertake when an alarm occurs.

   Use the Formatting Toolbar on this window as necessary.

   **Notes:**

   * You can enter your text in any application that supports RTF, (e.g. Word, WordPad), and then paste it into the entry field on this screen with formatting.
   * Image files can be added to Alarm Instructions, however they can have a negative impact on performance. Therefore, it is recommended that images are **not** embedded in Alarm Instructions.
6. Add any applicable insertion tags for this Alarm Instruction.

   (See [Adding an Insertion Tag to an Alarm Instruction](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/insertion-tags/adding-an-insertion-tag-to-an-alarm-instruction.md) for the procedure.)

   **Note:**

   Use the toggle ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-4eb8022e4b4ebe954728d28581b4878ee27afaed%2Fitbutton.png?alt=media) button to view the alarm instruction as it would appear in the Alarm Properties.
7. Click the **URL** tab.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-4c74f0757c8a93595e55e69d225d78fe9c90840a%2Falminst_urltab.png?alt=media)

   This tab supports the "Related URL" mode available when configuring URL Tiles in Command Centre Client. It provides the ability to specify a related URL against Alarm Instructions.
8. Specify a related URL for this Alarm Instruction if required.
9. Click the **Alarm Notes** tab.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-8f020cc251ae3c03b762513af56eff1601dc4a42%2Falminst_alarmnotestab1.png?alt=media)

   This tab allows you to select specific alarm notes to be displayed for every alarm that has this Alarm Instruction assigned. By default, the **Alarm Notes** listbox is populated with whatever pre-defined alarm notes are configured in the server settings.
10. To use specific alarm notes, check the **Use specific alarm notes** checkbox.

    The pre-defined alarm notes disappear from the list.

    <table><thead><tr><th width="276">To...</th><th>either...</th></tr></thead><tbody><tr><td>add new alarm note(s),</td><td><ul><li><strong>right click</strong> anywhere within the <strong>Alarm Notes</strong> field, and select <strong>Insert</strong> from the context menu, or</li><li>click the <strong>New</strong> button.</li></ul></td></tr><tr><td>delete an alarm note, select the alarm note to be deleted, and</td><td><ul><li><strong>right click</strong> and select <strong>Remove from list</strong> from the context menu, or</li><li>press the &#x3C;<strong>Delete</strong>> key on your keyboard.</li></ul></td></tr></tbody></table>

    **Notes:**

    * Unchecking the **Use specific alarm notes** checkbox and clicking **Apply** restores whatever alarm notes are configured in the server settings. Rechecking the checkbox restores the previously configured specific alarm notes.
    * For alarm notes that are too long to fit within the listbox, a tooltip displays when you move the mouse over them.
    * The **Alarm Notes** list can be sorted by selecting an alarm note you want to move up or down the list, and clicking the appropriate arrow button to the right of the list box.
11. Click the **Custom Fields** tab if you want to add and assign a custom field value to this Alarm Instruction.

    For further details regarding the **Custom Fields** tab, see [Custom Fields](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/server-properties/custom-fields.md).
12. Click the **Notes** tab if you want to add a note(s) about this Alarm Instruction.

    For further details regarding the **Notes** tab, see [Notes](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/server-properties/notes.md).
13. Click **OK** to exit and save your changes.

    Click **Cancel** to exit without saving your changes.

    Click **Apply** to save your changes and stay in this window.

### Result

A new Alarm Instruction is created.

### Hint

{% hint style="info" %}
**Editing and Deleting Alarm Instructions**

Refer to [Editing items](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/generic-properties-configuration/editing-items.md) and [Deleting items](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/generic-properties-configuration/deleting-items.md) for procedures on how to edit and delete Alarm Instructions.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/alarm-instructions/creating-a-new-alarm-instruction.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
