RELEASE MUTEX Command

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.

Command Definition:

RELEASE {scope} MUTEX mutex-name
	{,ON ERROR GOTO err-label}

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 "USERMUT"