Mit dem Tool „wrksbmjob“ (work submitted batch job) führen Sie bestimmte Aktionen (z. B. Anhalten, Freigeben, Löschen etc.) für einen oder mehrere Verarbeitungsaufträge aus.
1 Zielgruppe
- System-Administratoren
- Technische Berater
2 Begriffsbestimmung
Verarbeitungsauftrag
Ein Verarbeitungsauftrag umfasst die notwendigen Informationen für die verzögerte Ausführung einer Hintergrund-Anwendung durch eine Verarbeitungs-Warteschlange.
Verarbeitungs-Warteschlange
Warteschlange, in der mehrere oder ein Verarbeitungsauftrag bis zur Abarbeitung eingereiht wird.
Hintergrundverarbeitung
Die Hintergrundverarbeitung beschreibt die asynchrone Abarbeitung von Verarbeitungsaufträgen, die in eine Verarbeitungs-Warteschlange eingereiht sind. Die Hintergrundverarbeitung wird für lang laufende, nicht interaktive Aufgaben genutzt, die mit niedriger Priorität abgearbeitet werden können.
Hintergrundanwendung
Eine Hintergrundanwendung ist eine Anwendung, die ohne Interaktion mit einem Benutzer ausgeführt wird. In Semiramis kann eine Hintergrundanwendung entweder durch einen Verarbeitungsauftrag, durch einen CORBA-Aufruf oder durch eine andere Anwendung geöffnet werden.
3 Beschreibung
Das Tool dient zur Verwaltung von Verarbeitungsaufträgen und der Steuerung der Abläufe der betriebswirtschaftlichen bzw. technischen Daten-Bearbeitung mithilfe zugehöriger Hintergrund-Anwendungen.
3.1 Befehl
Nachfolgend finden Sie den Befehl inklusive aller möglichen Parameter.
| wrksbmjob | [-display] [-release] [-hold] [-rerelease]
[-suspend] [-reactivate] [-abort] [-delete] [-remove] [-all] [-state] [-submitter:<str-1> … -submitter:<str-n>*] [-jobQueue:<str-1> … -jobQueue:<str-n>*] [-database:<str-1> … -database:<str-n>*] [-job:<str-1> … -job:<str-n>*] [-guid:<text-1> … -guid:<text-n>] [-startMode:<vs>] [-deleted] [-local] [-verbose] |
3.2 Parameter
Die Parameter des Befehls werden in der folgenden Tabelle erläutert. Die in eckigen Klammern gesetzten Parameter sind optional, die anderen hingegen sind Pflichtparameter. Für einige Parameter kann ein Stern (*) als Platzhalter angegeben werden, um damit alle möglichen Werte ausgeben zu können. Nicht alle Parameter können mehrfach genannt werden; nur die, die folgenden Zusatz an den Parametervariablen aufweisen, sind für die Mehrfachnennung zugelassen: „<str-1> … <str–n>“.
| Parameter | Erläuterung |
| [-display] | Ausgewählte Verarbeitungsaufträge anzeigen, die kein Löschkennzeichen haben. Mit dem Parameter -deleted werden auch Verarbeitungsaufträge angezeigt, die ein Löschkennzeichen haben. |
| [-release] | Ausgewählte Verarbeitungsaufträge im Status „Angehalten“ freigeben. Wenn die Verarbeitungs-Warteschlange über einen freien Thread verfügt, wird der freigegebene Verarbeitungsauftrag unmittelbar aktiv. |
| [-hold] | Ausgewählte Verarbeitungsaufträge im Status „Freigegeben“ oder „Aktiv“ anhalten. |
| [-rerelease] | Ausgewählte Verarbeitungsaufträge im Status „Angehalten“ erneut freigeben. |
| [-suspend] | Ausgewählte Verarbeitungsaufträge im Status „In Bearbeitung“ aussetzen. |
| [-reactivate] | Ausgewählte Verarbeitungsaufträge im Status „In Bearbeitung angehalten“ wieder aktivieren. |
| [-abort] | Ausgewählte Verarbeitungsaufträge im Status „In Bearbeitung“ abbrechen. Beim Abbrechen wird nur der Status des Verarbeitungsauftrages geändert. Falls die zugehörige Hintergrund-Anwendung noch ausgeführt wird, dann wird diese nicht beendet. Der sicherste Weg einen aktiven Verarbeitungsauftrag kontrolliert zu beenden, ist das Beenden der Hintergrund-Anwendung oder der Hintergrund-Session in der Anwendung „Systemcockpit“. In diesem Fall wird, wenn die Hintergrund-Anwendung dies unterstützt, die Verarbeitung kontrolliert beendet, und der Verarbeitungsauftrag wechselt automatisch in den Status „Abgebrochen“. |
| [-delete] | Setzt für alle ausgewählten Verarbeitungsaufträge das Löschkennzeichen. Die physikalische Löschung kann danach mit dem Parameter –remove erfolgen. |
| [-remove] | Alle Verarbeitungsaufträge mit gesetztem Löschkennzeichen werden gelöscht. Der Parameter „-deleted“ muss hierbei nicht angegeben werden, da automatisch nur Verarbeitungsaufträge mit gesetztem Löschkennzeichen ausgewählt werden. |
| [-all] | Alle Verarbeitungsaufträge auswählen. |
| [-state:<vs>] | Verarbeitungsaufträge auswählen, die sich in diesem Status befinden. Die möglichen Werte sind:
· 1 = Abgeschlossen · 2 = In Bearbeitung, · 3 = Freigegeben · 4 = Gesperrt · 5 = Abgebrochen · 6 = In Bearbeitung angehalten |
| [-submitter:<str-1> …
-submitter:<str-n>] |
Verarbeitungsaufträge auswählen, die von diesem Benutzer erfasst oder erzeugt wurden. |
| [-jobQueue:<str-1> …
-jobQueue:<str-n>] |
Verarbeitungsaufträge auswählen, die in diese Verarbeitungs-Warteschlange eingereiht sind. |
| [-database:<str-1 … -database:<str-n>] | Verarbeitungsaufträge auswählen, die sich auf diese OLTP-Datenbank beziehen. Wenn dieser Parameter angegeben wird, werden nur Verarbeitungsaufträge ausgewählt, bei denen eine OLTP-Datenbank eingetragen ist. |
| [-job:<str-1> …
-job:<str-n>] |
Verarbeitungsaufträge auswählen, die diese Bezeichnung tragen. |
| [-guid:<text-1> …
-guid:<text-n>] |
Verarbeitungsauftrag auswählen, der diese GUID besitzt. Die GUID kann beim Auflisten mithilfe des Parameters –display oder im Eigenschaften-Dialog eines Verarbeitungsauftrages in der Anwendung „Verarbeitungsaufträge“ angezeigt werden. Empfehlenswert ist, bei der Freigabe von Verarbeitungsaufträgen der Startart „Zeitgesteuert, extern“ den entsprechenden Verarbeitungsauftrag durch die Angabe der GUID auszuwählen. |
| [-startMode:<vs>] | Verarbeitungsaufträge auswählen, die mit dieser Startart erfasst oder erzeugt wurden. |
| [-deleted] | Verarbeitungsaufträge auswählen, die ein Löschkennzeichen haben |
| [-local] | Status des Verarbeitungsauftrags ändern, ohne die Benachrichtigung der Verarbeitungs-Warteschlange zu ändern. Das ist erforderlich, wenn der Application-Server die Verarbeitungs-Warteschlange des Verarbeitungsauftrages nicht aktiv oder nicht erreichbar ist. |
| [-verbose] | Aktiviert die Ausgabe von zusätzlichen Informationen während der Verarbeitung. |
3.3 Berechtigungen
Das Berechtigungskonzept sowie die generellen anwendungsbezogenen und Entity-bezogenen Berechtigungen können Sie in der Technischen Dokumentation im Dokument Berechtigungen nachlesen.
Um Verarbeitungsaufträge, die von anderen Benutzern erfasst oder erzeugt wurden, anzuzeigen oder zu ändern, benötigen Sie folgende spezielle Fähigkeiten:
- cisag.sys.services.batch.DisplayOtherUsersJobs
„Verarbeitungsaufträge anderer Benutzer anzeigen“
- cisag.sys.services.batch.ChangeOtherUsersJobs
„Verarbeitungsaufträge anderer Benutzer ändern“