Configure - Trigger Service Details

On the Configure - Services: Triggers page, click Add or double-click an existing trigger, and then the Trigger Service Details page is displayed.

Note: This page is only available when privileges are granted by the master user.

The following table describes the items that are available on the Trigger Service Details page:

Item Description
Name Type a trigger service name.
Description Type a short description for this trigger.
Connection Type a connection, or click the icon to select one.
Output Conversion (Required) Type the name of the conversion rule used for output conversion, or click the icon to select one.
Field Name for Conversionless Message Type a field name to be displayed in the output message if the Output Conversion is not specified.

The default value is DATA.

Disable on Error (#) Enter the number of errors which must occur before the trigger is disabled.
Disable on Error (%) Enter the percentage of errors used before the trigger is disabled.
Trace Level Enter the trace debug level used for an individual trigger process. The trace level must be 0 or 1 unless TIBCO Support requires the output.
Note: A certain amount of overhead and many lines of output are produced when this value is greater than 1.
Output Method Select whether data is expected to be output from the transaction processing application.
In the Service Key Locator area, the following three items are available:
Service Key Locator Start Enter the starting offset in the buffer that contains the text to be used for the search criteria in a trigger process (valid numbers 0-size of buffer). Remember that the first character in the buffer is offset 0 (not 1).
Length Type the size of the search text in the buffer of a TDQ record.
Value Type the string value that is associated with the transformation.
Requeue on Error If you want to requeue messages to the dead message queue when the delivery fails, select this check box.
Connection Extension Depending on the connection you specified, one of the following panels is available:
  • EMS Details

    For more information about the items in this panel, see EMS Details.

  • RV Details

    For more information about the items in this panel, see RV Details.

EMS Details

The following table describes the items that are available in the EMS Details panel:

Item Description
Publish Destination (Required) Type the outbound destination on which a message is published for a given trigger transaction. This field is necessary when you use the trigger method of invocation.
Type Select a type for the publish destination, that is TOPIC or QUEUE.
Dynamic Destination suffix In Length field, enter the number of bytes in the buffer to be used for a dynamic publish destination name.

In Start field, enter the starting offset in the buffer for the dynamic publish destination name.

Publish Destination (Secondary) Type the optional second outbound destination on which a message is published for a given trigger transaction.
Type (Not Editable) Displays the type of the secondary publish destination. Same with the primary publish destination type.
Reply-to Destination Specify the outbound destination name that Substation ES uses to publish the reply message for this trigger process.
Type Select the type for the reply-to destination, that is TOPIC or QUEUE.
Error Message Destination Type the destination in which an error message is published if Transformer conversion or BES encounters errors.
Type Select the error destination type, that is TOPIC or QUEUE.
SMSL Mode Select the SMSL mode.
Delivery Mode Select the delivery mode.
In the Output Message Properties area, the following items are available:
Priority

In the Value field, enter the priority value for the EMS message.

Valid values are in the range 0 - 9, and the default value is 4.

Expiration In the Value field, enter the expiration value for the EMS message, and then from the Unit list, select the unit for the EMS message expiration value.
Compression If you want to compress the EMS message for storage on the server, select this check box.
Preserve If a message is removed from its queue by the EMS server for reasons other than being consumed, the server checks whether this value is selected. If this check box is selected, the message is placed in the undelivered message queue of the server.
Body Trace If you select this check box, tracing for this destination generates trace messages that include the message body.
Message Type Select the type of the EMS output message, that is Bytes, Map, Stream, or Text.
In the EMS Properties area, the following items are available:
Add Click this button to add a new EMS property.
Delete Click this button to delete a selected EMS property.
Type Select the type of the EMS property, that is Value, Buffer, or System.
Property Name Type a name for the new added EMS property.
Value
  • For Value type property, type a value in this field.
  • For Buffer type property, the value for this field is selected from the buffer fields list of output conversion.
  • For System type property, the value is not editable.

RV Details

The following table describes the items that are available in the RV Details panel:

Item Description
Publish Subject (Required) Type the outbound subject on which a message is published for a given trigger transaction. This field is necessary when you use the trigger method of invocation.
Dynamic Subject suffix In Length field, enter the number of bytes in the buffer to be used for a dynamic publish subject name.

In the Start field, enter the starting offset in the buffer for the dynamic publish subject name.

Publish Subject (Secondary) Type the optional second outbound subject on which a message is published for a given trigger transaction.
Reply-to Subject

Specify the outbound subject name that Substation ES uses to publish the reply message for this trigger process.

Error Message Subject Type the subject in which an error message is published if Transformer conversion or BES encounters errors.