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