Monkeybread Software - MBS FileMaker Plugin: Mutex.Create

Topics All MacOS (Only) Windows (Only) Linux (Only, Not) iOS (Only, Not)
Components Crossplatform Mac & Win Server Client Old Deprecated Guides Examples Videos
New in version: 9.3 9.4 9.5 10.0 10.1 10.2 10.3 10.4 10.5 10.6 Statistic FMM Blog

Mutex.Create

Creates a new mutex with given name.

Component	Version	macOS	Windows	Linux	Server	FileMaker iOS SDK
Mutex	10.2	Yes	Yes	Yes	Yes	Yes

MBS( "Mutex.Create"; Name ) More

Parameters

Parameter Description Example

Name The name to use for the mutex.
Name should be a simple text, but unique, so we recommend reverse domain notation.
The name should not contain a slash. "test"

Parameter	Description	Example
Name	The name to use for the mutex. Name should be a simple text, but unique, so we recommend reverse domain notation. The name should not contain a slash.	"test"

Result

Returns OK or error.

Description

Creates a new mutex with given name.
If mutex exists already, we open it. The mutex lives until the last application closed it.
Please call Mutex.Free later.

If name matches the name of an existing event, semaphore, waitable timer, job, or file-mapping object, the function fails.
You can open the same mutex twice and get different reference numbers from the plugin.

Examples

Create a mutex

MBS( "Mutex.Create"; "com.monkeybreadsoftware.test" )

Create the mutex and use it:

# create a mutex
Set Variable [ $mutex ; Value: MBS( "Mutex.Create"; "de.monkeybreadsoftware.test" ) ]
# lock it
Set Variable [ $r ; Value: MBS( "Mutex.TryLock"; $Mutex ) ]
If [ $r = 1 ]
# do something
#
# finally unlock
Set Variable [ $r ; Value: MBS( "Mutex.Unlock"; $Mutex ) ]
End If
# free it mutex
Set Variable [ $r ; Value: MBS( "Mutex.Free"; $Mutex ) ]

Blog Entries

News about the MBS FileMaker Plugin 10.2

Created 5th April 2020, last changed 5th April 2020

Msgbox - Mutex.Free