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.