Open topic with navigation

TIBCO iProcess® Engine 11.10.0

# Issue an Event

Use this command to issue an event from the command line. There is no equivalent menu option. Only users with administration access to a procedure can issue an EVENT on an iProcess case.

Note | If you want to issue a large number of events you should consider using the `swbatch` utility instead. see Batch Processing Cases.

    swutil EVENT [-hostnode] procname[R]casenumeventname [-P priority] [datafile [-[r|R][p]]

where:

| • | `hostnode` is optional and, if included, should be the nodename of the node where the procedure is hosted. If the parameter is omitted the current node is assumed.

| • | `procname` is the short name of the procedure (including sub-procedures), for example: `QUOTA`.

| • | `casenum` is a single case number, for example: `23`. You can only issue an event to a single case.

An `R` preceding the case number can be used to restart a closed case. For example, `R23` restarts case number 23.

Note | After a case is closed, all the deadlines of the case are removed. If the case is reopened, you can reset the deadlines by running the `CreateCaseDeadline` function. For more information about the `CreateCaseDeadline` function, see TIBCO iProcess Expressions and Functions Reference Guide.

| • | `eventname` is the short name of the step you are issuing the event for, for example: `TREV`. (This may be an event step, or an ordinary step.)

Note | If you issue an event for an ordinary step only the actions which follow the step are triggered; the ordinary step itself is not re-run.

| • | `-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.

| • | datafile is optional and, if included, should be the full pathname of a file in `abox` format containing the new field values for the case. See "Using iProcess Abox Files" in TIBCO iProcess Modeler Integration Techniques for more information about `abox` format.) These values will be used to update the central case data (in the `case_data` database table).

The following options can be used when a `datafile` is specified:

Option | Description
`-r` | Any deadlines for the case and case steps will be recalculated using the new field values supplied in the `datafile`. If the case is being restarted (using the `R` option before the case number) then deadlines for the case and any sub-cases will be recalculated. See "Dynamically Recalculating Deadlines" in TIBCO iProcess Modeler Basic Design for more information about setting deadlines on a step. See "Case Deadline Setting" in TIBCO iProcess Modeler Procedure Management for more information about setting deadlines 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 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. See "Dynamically Recalculating Deadlines" in TIBCO iProcess Modeler Basic Design for more information about setting deadlines on a step. See "Case Deadline Setting" in TIBCO iProcess Modeler Procedure Management for more information about setting deadlines on a case.
`-p` | The new field values supplied in the `datafile` will also be copied to all outstanding work items (via the `pack_data` database table). You can propagate these `pack_data` changes into sub-cases as described in "Propagation of New Field Values" in TIBCO iProcess Modeler Integration Techniques. For more information about updating field values, see "Externally Updating Field Data in a Case" in TIBCO iProcess Modeler Integration Techniques.

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.