Lock - Programmschnittstelle (API)

Lock

	$lock->LetProperty( 'max_non_exclusive', int )	Begrenzung der nicht-exklusiven Belegungen
int	$lock->max_non_exclusive

	$lock->LetProperty( 'name', String )	Name der Sperre
String	$lock->name

	$lock->remove()	Entfernt die Sperre

Beispiel in javascript

var locks = spooler.locks;
var lock = locks.create_lock();
lock.name = "my_lock";
locks.add_lock( lock );

Siehe auch <lock name="…">.

max_non_exclusive

Begrenzung der nicht-exklusiven Belegungen

	$lock->LetProperty( 'max_non_exclusive', int )
int	$lock->max_non_exclusive

Die Voreinstellung ist unbegrenzt (2³¹-1), es können also mit <lock.use exclusive="no"> beliebig viele nicht-exklusive Tasks gestartet werden (aber nur eine exklusive).

Die Zahl kann nicht kleiner sein als die Zahl der nicht-exklusiven Belegungen.

Siehe auch <lock max_non_exclusive="…">.

Parameter

int

Meldungen

[warn] SCHEDULER-887 More lock holders than new max_non_exclusive=(1) : holders(2)

name

Name der Sperre

	$lock->LetProperty( 'name', String )
String	$lock->name

Der Name kann nur einmal gesetzt und nicht geändert werden.

Siehe auch <lock name="…">.

Parameter

String

Exceptions

`SCHEDULER-243`	Property (1) is fixed and is no longer modifiable
`SCHEDULER-417`	Invalid name: '(1) '

remove

Entfernt die Sperre

$lock->remove()

Beispiel in javascript

spooler.locks.lock( "my_lock" ).remove();

Die Sperre kann nur gelöscht werden, wenn sie von keiner Task belegt und von keinem Job gebraucht (<lock.use>) wird.

Siehe auch <lock.remove>.

Exceptions

SCHEDULER-161 There is no objecttype(1) '(2) '

Meldungen

`[info]`	`SCHEDULER-861`	'object(1) ' has been removed
`[info]`	`SCHEDULER-886`	Lock will be removed later, it is held by '(1) '

Software- und Organisations-Service GmbH

Zuletzt geändert von Joacim Zschimmer, 2007-01-23