Lock - Programmschnittstelle (API)

Lock

	lock.max_non_exclusive = int	Begrenzung der nicht-exklusiven Belegungen
int	lock.max_non_exclusive

	lock.name = string	Name der Sperre
string	lock.name

	lock.remove()	Entfernt die Sperre

Beispiel

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.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.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

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