Release a Procedure Version

Copyright © Cloud Software Group, Inc. All Rights Reserved

Chapter 9 Procedure Versions : Release a Procedure Version

Release a Procedure Version

Use this command to release a given version of a procedure.

swutil PROC RELEASE name version comment [-m|-M [ALL|LIVE]]

where:

•

name is the procedure (or sub-procedure) name.

•

version is the version number of the procedure.

•

comment is a text string which is displayed in the version control history for the procedure.

The comment string can be used to supply version-specific information, such as a description of the version, or any other desired information. It can be a maximum of 24 characters. If the string includes spaces, it should be enclosed in quotation marks.

•

- m|-M [ALL|LIVE] (optional) migrates active cases associated with previously released versions of the procedure to the current version that you are releasing. (This option is case sensitive).

Before using the -m or -M options, TIBCO recommends that you perform a full system backup. This is because there is no undo feature after running this command.

If you use:

−

the -m or -M parameter on its own, only cases that use the currently released version, that is, the version that will be automatically withdrawn by the Release operation, are migrated to the new version.

−

the -m or -M parameter with the ALL option, all cases are migrated to the new version, no matter what previous version of the procedure they are using.

−

the -m or -M parameter with the LIVE option, only the live cases are migrated to the new version.

The -M option operates in the same way as -m but does not interact with the iProcess background process (BG). Therefore, only use -M when iProcess Engine is not running.

Make sure that all existing cases are compatible with the new version of the procedure before you migrate them.

Examples

This example releases version 1.1 of a procedure called myproc and adds the "This is released" comment.

swutil PROC RELEASE myproc 1.1 "This is released"

This example releases version 1.2 of a procedure called myproc and migrates all existing cases from previous versions to this new version:

swutil PROC RELEASE myproc 1.2 "Migrated cases" -m ALL