ReleaseMutex

Syntax

ReleaseMutex MutexName=<name>

Description

Releases a previously acquired mutex.

Parameters

<name>

The name of the mutex to release. The mutex must have been previously acquired by a WaitForMutex statement.

Remarks

A mutex is a synchronization mechanism designed to ensure mutually exclusive access to a single resource shared among a set of cooperating processes. A mutex is created when the first process names it in a WaitForMutex statement. Thereafter, other processes naming the mutex access the one created by the first process. If WaitForMutex succeeds (i.e. does not time out), then the calling process "owns" the mutex and no other WaitForMutex requests on that mutex will return sucess until the owning process releases it using the ReleaseMutex statement. A mutex should be closed using CloseMutex when the script has no plans to use it again.

Example

          WaitForMutex MutexName="FileAccess" Timeout=60
          If Not TimedOut Then
             LoadFile buffer "SharedFile.dat"
             ... change file contents ...
             SaveFile "SharedFile.dat" buffer
             ReleaseMutex MutexName="FileAccess"
          Else
             ... perform error actions ...
          Endif
          ... all done ...
          CloseMutex MutexName="FileAccess"

The example allows cooperating processes to arrange that one and only one of the process has access to the file SharedFile.dat at a time by synchronizing on the FileAccess mutex.