lic.LicCheckThreshold

Dieser Job prüft für ein Modul, ob die Auslastung seiner Lizenz die Warnschwelle erreicht hat, und liefert die aktuelle und die maximale Anzahl der Nutzungen.

Der Hersteller dokumentiert diesen Job nicht. Die Beschreibung beruht auf Messungen an enaio®-Server 12.0. Unter 10.10 ist der Job ebenfalls vorhanden (krn.EnumJobs listet ihn); geprüft wurde dort nur eine Lizenz vom Typ C ohne Belegung.

1. Eingabeparameter

Name Typ Pflicht Beschreibung

Flags

INT

Ja

0 übergeben. Ob der Parameter tatsächlich Pflicht ist, wurde nicht geprüft.

Modules

STRING

Ja

Kurzbezeichnung eines Moduls. Anders als bei lic.CheckLicense behandelt der Job eine durch Leerzeichen getrennte Liste als einen einzigen Namen.
Fehlt Modules, wird der Aufruf mit -1043332470 („A required parameter was not specified: Modules.") abgewiesen.

2. Ausgabeparameter

Name Typ Abhängigkeit Beschreibung

Modules

STRING

nur bei bekannter Modulbezeichnung

<Bezeichnung>:<aktuell>:<maximal>, z. B. LIS:0:5. Leer, wenn das Modul keinen Lizenzeintrag hat.

Exceeded

STRING

nur bei bekannter Modulbezeichnung

Bezeichnung des Moduls, wenn seine Auslastung die Warnschwelle erreicht hat; sonst leer.

3. Rückgabe

(INT): 0 = Job erfolgreich, sonst Fehlercode.

Auch bei einer unbekannten Modulbezeichnung und bei erreichter Warnschwelle liefert der Job 0. Den Befund tragen die Ausgabeparameter und der Fehlerstack (siehe Diagnoseeinträge bei Rückgabe 0).

4. Beobachtetes Verhalten

Gemessen an enaio®-Server 12.0; die erste Zeile zusätzlich an einer zweiten 12.0-Installation und an 10.10:

Modul Ausgabe Fehlerstack

Lizenz vom Typ C, kein Platz belegt

Modules = LIS:0:5 (12.0) bzw. LIS:0:10 (10.10), Exceeded leer

keine Einträge

Lizenz vom Typ N mit 1 Platz, belegt

Modules = ASS:1:1, Exceeded = ASS

-2115959887 Threshold of 90% reached for module ASS, current count 1, max count 1.
-2115960338 No e-mail can be sent to the administrator, because this feature is switched off in the configuration.

Modul ohne Lizenzeintrag

Modules und Exceeded leer

keine Einträge

Unbekannte Bezeichnung

keine Ausgabeparameter

1105265171 Requested resource <X> is unknown.

Die Warnschwelle lag in der Messung bei 90 % der maximalen Anzahl. Ob sie konfigurierbar ist, ist nicht bekannt.

Erreicht ein Modul die Warnschwelle, versucht der Server, den Administrator per E-Mail zu benachrichtigen. Im gemessenen System war diese Funktion abgeschaltet (-2115960338). Ist sie eingeschaltet, hat der Aufruf eine Nebenwirkung: Ein Aufruf für ein ausgelastetes Modul kann eine E-Mail auslösen.

Der Job wird im laufenden Betrieb aufgerufen: Die Jobstatistik von krn.NameSpaceGetJobsInfo wies auf dem gemessenen System 213 Aufrufe aus. Ob der Server selbst oder die Clients ihn aufrufen, ist nicht untersucht.

Siehe auch: lic.LicGetModuleInfo, lic.LicGetQueueStatus