Starting a Case

You can start a case of a procedure from the swutil menu (see Using swutil) using either of the following options:

• 8 - Start a Case (without supplying any data)
• 9 - Start a Case with Data

Alternatively, you can use the following commands:

• to start a case without data:

swutil CSTART [version] [-sN] [-c] [-V] procname casedesc[startstep] [-P priority]

• to start a case with data:

swutil DCSTART [version] [-sN] [-c] [-V] procname casedescdatafile [startstep] [-P priority]

where:

• version (optional) specifies the version of the procedure that you want to start a case of. Specify one of the following flags:

Flag

Description

-r

Start a (live) case of the Released version.

-u

Start a (test) case of the Unreleased version.

-m

Start a (test) case of the Model version.

-vX.Y

Start a case of Version X.Y, where X is the major version number and Y is the minor version number.

If version is not specified, the following default precedence order is used to select the version to use:

Released > Unreleased > Model

Using a Released version starts a live case. Using an Unreleased or Model version starts a test case.

• -sN (optional) specifies the precedence order to be used to select the version of any sub-procedure started by the case.

Value

Precedence

1

Released version only

2

Unreleased > Released version

3

Model > Released version

4

Unreleased > Model > Released version

5

Model > Unreleased > Released version

If the -sN flag is not specified, only Released versions are used.

Using a Released version starts a live sub-case. Using an Unreleased or Model version starts a test sub-case.

Note 

For more information about procedure versions, see "Using Version Control" in TIBCO iProcess Modeler Procedure Management.
• -c (optional) specifies that the command returns the case number of the started case.
• -V (optional) specifies verbose operation.
• procname is the name of the procedure that you want to start a case of.
• casedesc is the case description to use for the started case.
• datafile is the name of a file in abox format (See "Using iProcess Abox Files" in TIBCO iProcess Modeler Integration Techniques), containing data for field initialization.
• startstep (optional) specifies the stepname at which to start the case; if omitted the start step in the procedure definition is used.
• -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.