Copyright © Cloud Software Group, Inc. All Rights Reserved

Starting a Case

You can start a case of a procedure from the swutil menu (see page 2) 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 casedesc datafile [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.

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.

Copyright © Cloud Software Group, Inc. All Rights Reserved