Open topic with navigation

TIBCO iProcess® Engine 11.10.0

# 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).

Warning | 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

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO iProcess® Engine

Copyright © 1994-2025. Cloud Software Group, Inc. All Rights Reserved.