RELEASE MUTEX Command

Description:

This command releases a named mutex. The mutex to be released is identified by its name and scope, which must correspond to the values specified on the corresponding ACQUIRE MUTEX command.

The "ON ERROR GOTO err_label" clause can be specified to define a label to which control should be transferred in the event of an error. Note that an error always occurs if the script that issues the RELEASE MUTEX request has not previously acquired it.

Format:

 RELEASE {scope} MUTEX mutex_name {,ON ERROR GOTO err_label}

Parameters:

scope

The scope of the mutex to release. This must be either "LOCAL" or "TEST-WIDE", and defaults to "LOCAL".

mutex-name

A character variable, or quoted character string, containing the name of the mutex to release.

err_label

A label defined within the current scope of the script, to which control branches if an error occurs.

Example:

 RELEASE LOCAL MUTEX "MUMPS-SERVER"

See also:

Synchronization Commands