|
|
Creates or removes a lock file for the filename specified. This can be used to synchronise operations between multiple instances of SIMetrix.
| Number | Type | Compulsory | Default | Description |
|---|---|---|---|---|
|
1 |
string |
Yes |
|
filename |
|
2 |
string |
Yes |
|
operation |
Filename to lock. The lock file created will have the same name with the suffix .lck. The lock file itself will be locked for write and other applications will not be able to delete or write to the file.
One or two element string array. First element is the operation to be performed. This is either 'lock' or 'unlock'. If 'lock' is specified, an attempt will be made to create a lock file. The operation will fail if the file has already been locked - perhaps by another instance of SIMetrix. If 'unlock' is specified the file will be removed provided that this instance of SIMetrix created the file in the first place.
A second element may be specified and set to 'autodelete'. In this case the file will automatically be unlocked when control is returned to the command line.
Return type: string
May be one of the following values:
| success | Operation successful |
| failed | Lock failed because the file has already been locked |
| notexist | Attempt made to unlock a file that was not locked by this instance or has not been locked at all |
| locked | File has already been locked by this instance |
|
|
||