jobs()

Gibt alle vom Server angebotenen Jobs gruppiert nach Namespace (Engine) zurück. Kombiniert krn.EnumNameSpaces (Liste der implementierten Engines) mit je einem krn.EnumJobs-Aufruf pro Engine. Es entstehen 1 + N Server-Roundtrips, wobei N die Anzahl der Engines ist; in der Async-Variante laufen die krn.EnumJobs-Aufrufe nebenläufig.

1. Signatur

  • Sync

  • Async

ecm.system.jobs() -> dict[str, list[str]]
await ecm.system.jobs() -> dict[str, list[str]]

2. Parameter

Keine.

3. Rückgabewert

Ein dict[str, list[str]]:

Element Beschreibung

Schlüssel

Kurzbezeichnung des Namespace bzw. der Engine (z.B. "krn", "dms").

Wert

Liste der Jobs dieses Namespace inklusive Namespace-Präfix (z.B. "krn.EnumJobs").

Sowohl die Schlüssel des dict als auch jede Job-Liste sind alphabetisch sortiert.

Welche Namespaces und Jobs zurückgegeben werden, hängt von der konkreten Serverinstallation und -konfiguration ab und kann zwischen Systemen abweichen.

4. Beispiele

4.1. Alle Jobs auflisten

  • Sync

  • Async

all_jobs = ecm.system.jobs()

print(sorted(all_jobs))
# z.B.: ['abn', 'adm', 'ado', 'cnv', 'dbp', 'dms', 'dtr', 'krn', 'lic', 'mng', 'std', 'vtx', 'wfm']

print(all_jobs["krn"][:3])
# z.B.: ['krn.AppsEventsEnum', 'krn.AppsEventsSubscribe', 'krn.AslogGeneralFlags']
all_jobs = await ecm.system.jobs()

print(sorted(all_jobs))
print(all_jobs["krn"][:3])

4.2. Prüfen, ob ein bestimmter Job verfügbar ist

all_jobs = ecm.system.jobs()
if "dms.GetResultList" in all_jobs.get("dms", []):
    ...

5. Siehe auch

  • info() — Statistik der aktuell offenen Pool-Verbindungen