Lock - Programmschnittstelle (API)

Lock

void	lock.set_max_non_exclusive( int )	Begrenzung der nicht-exklusiven Belegungen
int	lock.max_non_exclusive()

void	lock.set_name( String )	Name der Sperre
String	lock.name()

void	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

void	lock.set_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

void	lock.set_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

void	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