Open topic with navigation

TIBCO iProcess® Engine 11.10.0

# Issue an Event

To issue an event, with or without associated case data, use the following command:

## Syntax

    EVENT [e[p][r|R]|-a[D][p][r|R] datafile] [-P priority] <node|-> procname casenum eventname

where:

| • | `-e` indicates that case data is embedded in the command file or input stream. See Command File Format. The following options can also be used when `-e` is specified:

Option | Description
`r` | Any deadlines for the case and case steps will be recalculated using the new field values supplied. See "Dynamically Recalculating Deadlines" in TIBCO iProcess Modeler Basic Design for more information about using this option on a step. See "Case Deadline Setting" in TIBCO iProcess Modeler Procedure Management for more information about using this option on a case.
`R` | Any deadlines for the case, sub-cases, case steps, and sub-case steps will be recalculated using the new field values supplied. See "Dynamically Recalculating Deadlines" in TIBCO iProcess Modeler Basic Design for more information about using this option on a step. See "Case Deadline Setting" in TIBCO iProcess Modeler Procedure Management for more information about using this option on a case.
`p` | The new field values supplied will also be copied to all outstanding work items. This is analogous to using the `-p` `datafile` flag with the `swutil EVENT` command. See Issue an Event for more information about the effect of this flag.

| • | `-a` indicates that case data is supplied in `abox` format in `datafile`. For more information about `abox` format, see "Using iProcess Abox Files" in TIBCO iProcess Modeler Integration Techniques. The following options can also be used when `-a` is specified:

Option | Description
`D` | The `datafile` is deleted after it has been processed.
`p` | The new field values supplied in the `datafile` will also be copied to all outstanding work items. This is analogous to using the `-p` `datafile` flag with the `swutil EVENT` command. See Issue an Event for more information about the effect of this flag.
`r` | Any deadlines for the case and case steps will be recalculated using the new field values supplied in the `datafile`.
`R` | Any deadlines for the case, sub-cases, case steps, and sub-case steps will be recalculated using the new field values supplied in the `datafile`. Note: Only the sub-case data is updated with `-p` option in the `swutil EVENT` command, the deadlines of sub-case and sub-case steps are recalculated.

| • | `-P` `priority` specifies the internal message queue priorities. For more information about message priorities, see "Message Prioritizing" in the appropriate TIBCO iProcess Engine (Database) Administrator’s Guide.

| • | `node` is the name of the host node, if the procedure is hosted remotely. Enter a hyphen (`–`) if the procedure is hosted locally.

| • | `procname` is the name of the procedure, including sub-procedures.

| • | `casenum` is the case number.

| • | `eventname` is the name of the event.

## Example

This example issues an event called `trigger` for case `1` of procedure `HIRING`, hosted on the local node.

    EVENT - hiring 1 trigger

This example similarly issues an event called `trigger` for case `1` of procedure `HIRING`, but it also:

| • | copies the new field values supplied in file `NewData1` to all outstanding work items.

| • | forces the recalculation of deadlines for the case and any sub-cases based on the new field values supplied in file `NewData1`.

    EVENT -apR NewData1 - hiring 1 trigger

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO iProcess® Engine

Copyright © 1994-2025. Cloud Software Group, Inc. All Rights Reserved.