# Defining Triggers

You can define a new trigger or modify an existing trigger.

## Prerequisites

Ensure that you have done the following tasks:

- Defining Network Parameters (ESB Endpoint)
- Defining Conversion Rules

## Procedure

1. Select option 7- Define Triggers - Outbound Convert / Destinations to go to the Define Triggers panel.
   For more information about this panel, see Define Triggers Panel.
2. Type any of the following commands:
   - To create a new entry, enter `ADD` on the command line, and then press Enter.
   - To select an existing definition to modify, enter `S` in the Sel field, and then press Enter.
   - To set TIBCO Enterprise Message Service specific settings, enter `E` in the Sel field.
3. In the Sel field, enter `S` next to the ESB definition that you want to use, and then press Enter to continue the process.
   For more information about this panel, see Select ESB Endpoint Panel (Triggers).
4. In the Sel field, enter `S` or `O` next to the conversion rule definition, and then press Enter to continue the process.
   For more information about this panel, see Select Output Conversion Rule Panel (Triggers).
5. Configure the trigger definition in the Trigger Details panel:
   1. In the Trigger Identifier field, enter up to 31 characters to name the trigger.
   2. In the Publish to field, enter the name of the outbound subject on which a message is published for a given trigger transaction.
   3. In the Publish To, Sec field, enter (if applicable) the optional second outbound subject that a message is published on for a given trigger transaction.
   4. In the Reply to field, enter (if applicable) the outbound subject name that Substation ES uses to publish the reply message for this trigger process.
   5. In the Publish To Len (Dyn) field, enter (if applicable) the number of bytes in the buffer to be used for a dynamic reply subject name.
   6. In the Start field, enter (if applicable) the starting offset in the buffer for the dynamic reply subject name.
   7. In the Error Subject field, enter a subject name for error messages.
   8. In the Error Threshold field, enter (if applicable) the number of errors allowed before the trigger is disabled.
   9. In the Error Percent field, enter (if applicable) the percentage of errors allowed before the trigger is disabled.
   10. In the Output Method field, select the option of outbound data process method that is expected for this process.
   11. In the Reply to field, select the option of outbound data that is expected for this process.
   12. In the Start field, enter the starting offset in the buffer that contains the text to be used for the search criteria in a trigger process.
   13. In the Length field, enter the number of bytes of the text to be used for the search criteria in a trigger process.
   14. In the Value field, enter the text to be used for the search criteria in a trigger process.
   15. In the Undelivered Requeue field, enter (if applicable) Y so that the reliable trigger processes will requeue the message if delivery fails. Press Enter.
   For more information about this panel, see Trigger Details Panel.
6. Press Enter before exiting the panel.
7. Set the EMS details for a trigger in the EMS Trigger Details Extension panel:
   1. On the command line, enter (if applicable) `EMS`, and then Press Enter.
   2. In the EMS Trigger Details Extension panel, configure the EMS details, and then press Enter.
   3. Press PFK3 to exit this panel.
   For more information about this panel, see EMS Trigger Details Extension Panel.
8. Set the EMS properties in the EMS Properties panel:
   1. On the command line, enter (if applicable) `PROP`, and then press Enter.
   2. In the EMS Properties panel, configure the EMS properties, and then press Enter.
   3. Press PFK3 to exit this panel.
   For more information about this panel, see EMS Properties (Trigger) Panel.
9. Exit the Define Triggers panels in either of the following ways:
   - Press PFK3.
   - On the command line, enter `END`, and then press Enter.
10. Review the message displayed in the upper-right corner of the Transformer Configuration panel to verify that your changes have been saved.

Copyright © TIBCO Software Inc. All rights reserved.