.. _set_up_a_command_builder:

Set up a Command Builder
------------------------

Use this procedure to set up a Command Builder that contains an IOS Commands
template for an event.

.. note::

   One event can trigger multiple Command Builders.

Procedure
.........

1. Log in as provider, reseller, or customer administrator.
2. Set the hierarchy path to the level where you want to define your Command Builder.
3. Choose **Device Management > IOS > Command Builder**.
4. Click **Add**.
5. Provide the following information:

   +------------------------+------------------------------------------+
   | Field                  | Description                              |
   +========================+==========================================+
   | Name                   | Enter a unique name for the builder.     |
   |                        | This field is mandatory.                 |
   +------------------------+------------------------------------------+
   | Event Name             | Select the event that triggers the       |
   |                        | builder. This field is mandatory         |
   +------------------------+------------------------------------------+
   | Description            | Enter a description for the builder.     |
   +------------------------+------------------------------------------+
   |                        | Enter the IOS Commands template for the  |
   | Command Template       | event, one command per line. You can use |
   |                        | macros in the IOS Commands template for  |
   |                        | variable substitution.                   |
   +------------------------+------------------------------------------+
   |                        | Clear the **Enabled** check box to create|
   | Enabled                | a builder but not have it available to   |
   |                        | run.                                     |
   +------------------------+------------------------------------------+
   | Applicable Device Type | Select the device type that the commands |
   |                        | can run on. This field is mandatory.     |
   +------------------------+------------------------------------------+

6. Click **Save**.