
Clientdienstprogramm "batchManagerZos" konfigurieren
Sie können Stapeljobs, die in Liberty unter z/OS ausgeführt werden, mit dem Clientdienstprogramm "batchManagerZos" verwalten.
Informationen zu diesem Vorgang
Das Clientdienstprogramm ist eine nativ kompilierte Version des Befehlszeilendienstprogramms "batchManager" zur Verwaltung von Stapeljobs, die in Liberty for z/OS ausgeführt werden. Es ist ein natives Programm und benötigt keine JVM. Das Dienstprogramm wird mit dem Feature batchManagement-1.0 bereitgestellt.
Das Clientdienstprogramm "batchManagerZos" unterstützt eine Untermenge der vom Befehlszeilendienstprogramm "batchManager" unterstützten Befehle und Optionen. Verwenden Sie den Befehl $ batchManagerZos help, um die Liste der Befehle und Optionen anzuzeigen.
Das Clientdienstprogramm "batchManagerZos" verwendet optimierte lokale Adapter, um eine Verbindung mit einem Liberty-Server herzustellen, der in einer lokalen Umgebung ausgeführt wird. Das Clientdienstprogramm "batchManagerZos" kann keine Verbindung zu fernen Servern herstellen.
- Sicherheitsaspekte
- Das Sicherheitsverhalten des Clientdienstprogramms "batchManagerZos" ist davon abhängig, ob der Liberty-Server eine SAF-Registry verwendet.
- Wenn der Server eine SAF-Benutzerregistry verwendet, wird die Identität des Clientdienstprogramms "batchManagerZos" als Identität des Anfordernden (JEE-RunAs-Subjekt) für die Stapelanforderung gesetzt.
- Wenn der Server keine SAF-Benutzerregistry verwendet, wird die ID des Clientdienstprogramms "batchManagerZos" ignoriert. In diesem Fall wird das Sondersubjekt EVERYONE als ID des Anforderers für die Stapelanforderung gesetzt.
- Stapelrollenbasierte Berechtigung
-
Wenn appSecurity (Anwendungssicherheit) im Server aktiviert ist, muss der Identität des Anforderers die Stapelsicherheitsrolle zugewiesen werden, die von der Anforderung vorausgesetzt wird. Gültige Stapelsicherheitsrollen sind batchAdmin, batchSubmitter und batchMonitor. Wird der Identität nicht die erforderlichen Rolle zugewiesen, scheitert die Anforderung mit einer Sicherheitsausnahmebedingung.
Die Berechtigung wird vom Sicherheitsberechtigungsprovider verwaltet. Wenn der Server die SAF-Berechtigung verwendet, bestimmt der SAF-Berechtigungsprovider die Berechtigung der Identität des Anforderers, indem er den Zugriff der Identität auf die von der Klasse EJBROLE definierten SAF-Ressourcenprofile überprüft. Standardmäßig sind den Stapelrollen folgende Ressourcenprofile zugeordnet.
Der Identität des Anforderers muss über Lesezugriff (READ) auf das entsprechende Ressourcenprofil verfügen, damit sie für die zugehörige Stapelrolle berechtigt wird.batchAdmin: BBGZDFLT.com.ibm.ws.batch.batchAdmin batchSubmitter: BBGZDFLT.com.ibm.ws.batch.batchSubmitter batchMonitor: BBGZDFLT.com.ibm.ws.batch.batchMonitorDas folgende Beispiel zeigt die RACF-Befehle, mit denen der Clientidentität bob die Berechtigung für die Rolle batchAdmin erteilt wird.
RDEFINE EJBROLE BBGZDFLT.com.ibm.ws.batch.batchAdmin UACC(NONE) PERMIT BBGZDFLT.com.ibm.ws.batch.batchAdmin CLASS(EJBROLE) ID(bob) ACCESS(READ)
- Rückgabecodes
- Das Clientdienstprogramm "batchManagerZos" gibt die folgenden Rückgabecodes zurück:
Code Beschreibung 0 Die Task wurde normal beendet. 20 Ein erforderliches Argument wurde nicht angegeben. 21 Es wurde ein nicht erkanntes Argument angegeben. 22 Es wurde ein ungültiges Argument angegeben. 255 Es ist ein unbekannter Fehler aufgetreten. Anmerkung: Wenn Sie das Argument --wait angeben, gibt das Dienstprogramm die folgenden Rückkehrcodes zum Status des Jobs aus, auf den Sie warten.Code Beschreibung 33 Der Job wurde gestoppt. 34 Der Job wurde nicht erfolgreich ausgeführt. 35 Der Job wurde erfolgreich ausgeführt. 36 Der Job wurde abgebrochen. Anmerkung: Wenn Sie "batchManagerZos" mit BPXBATCH ausführen, stimmt der von BPXBATCH zurückgegebene Rückgabecode nicht mit dem Rückgabecode von "batchManagerZos" überein. BPXBATCH verschiebt den von "batchManagerZos" zurückgegebenen Rückgabecode um ein Byte nach oben. Wenn "batchManagerZos" z. B. 1 zurückgibt, gibt BPXBATCH 256 zurück. Dies entspricht dem Hexadezimalwert 0x01, um ein Byte nach oben auf 0x100 verschoben.Wenn Sie BPXBATCH aus einem JCL STEP aufrufen, wird der Rückgabecode auf die drei unteren Hexadezimalzeichen des von BPXBATCH zurückgegbenen Rückgabecodes abgeschnitten. Wenn "batchManagerZos" beispielsweise 35 zurückgibt, was dem Hexadezimalwert 0x23 entspricht, gibt BPXBATCH 0x2300 zurück. Der JCL STEP schneidet den Rückgabecode auf 0x0300, d. h. 768, ab.
- Einschränkungen
-
Das Clientdienstprogramm "batchManagerZos" bietet momentan keine Unterstützung für den Abruf und das Streaming von Jobprotokollen.
Die stop-Befehle des Clientdienstprogramms "batchManagerZos" müssen an das Stapelsteuerprogramm, in dem der Job ausgeführt wird, übertragen werden. Stop-Befehle in einer Mehrserverumgebung können mit einer Ausnahme des Typs BatchJobNotLocalException fehlschlagen, wenn das Clientdienstprogramm "batchManagerZos" eine Verbindung zu einem designierten Stapeldispatcher und nicht zu dem Stapelsteuerprogramm herstellt, in dem der Job ausgeführt wird. Stapeldispatchers empfangen gewöhnlich Übergabeanforderungen und verteilen sie an die nachgeordneten Stapelausführungsprogramme.
Taskartikel