Für z/OS-Plattformen

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.
    batchAdmin:     BBGZDFLT.com.ibm.ws.batch.batchAdmin
    batchSubmitter: BBGZDFLT.com.ibm.ws.batch.batchSubmitter
    batchMonitor:   BBGZDFLT.com.ibm.ws.batch.batchMonitor
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.

Das 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.

Vorgehensweise

  1. Aktivieren Sie die Features batchManagement-1.0 und zosLocalAdapters-1.0 in Ihrer Datei server.xml.
    <featureManager>
    	<feature>batchManagement-1.0</feature>
    	<feature>zosLocalAdapters-1.0</feature>
    </featureManager>
  2. Konfigurieren Sie den Endpunkt für zosLocalAdapters-1.0. Im folgenden Beispiel sehen Sie die Endpunktkonfiguration für zosLocalAdapters-1.0.
    <zosLocalAdapters wolaGroup="LIBERTY" wolaName2="BATCH" wolaName3="MANAGER"/>
  3. Ermöglichen Sie dem Clientdienstprogramm "batchManagerZos", eine Verbindung mit dem zosLocalAdapters-Endpunkt herzustellen. Damit der Client "batchManagerZos" über optimierte lokale Adapter eine Verbindung zum Server herstellen kann, muss die Benutzer-ID (userId) des Clients für die CBIND-SAF-Ressource des Endpunkts zosLocalAdapters berechtigt sein. Diese dem Endpunkt zugeordnete Ressource hat den Namen BBG.WOLA.{wolaGroup}.{wolaName2}.{wolaName3} in der Klasse CBIND. Zum Binden des zosLocalAdapters-Endpunkts mit dem Namen LIBERTY BATCH MANAGER benötigt die Ressource BBG.WOLA.LIBERTY.BATCH.MANAGER in der Klasse CBIND für die batchManagerZos-Benutzer-ID Lesezugriff (READ). Das folgende Beispiel zeigt die RACF-Befehle, mit denen der Ressource der Lesezugriff erteilt wird.
        RDEFINE CBIND BBG.WOLA.LIBERTY.BATCH.MANAGER UACC(NONE)   
        PERMIT BBG.WOLA.LIBERTY.BATCH.MANAGER CLASS(CBIND) ACCESS(READ) ID(bob)
    Anmerkung: In diesem Beispiel ist bob der Benutzer, der "batchManagerZos" ausführt.
  4. Wenn batchManagerZos-Anforderungen auf dem Server unter der Clientidentität ausgeführt werden sollen, müssen Sie den Server dazu autorisieren, die berechtigten SAFCRED-z/OS-Ressourcen zu verwenden. Im folgenden Beispiel sind die RACF-Befehle aufgeführt, die es dem Server ermöglichen, die berechtigten SAFCRED-z/OS-Ressourcen zu verwenden.
        RDEFINE SERVER BBG.AUTHMOD.BBGZSAFM.SAFCRED UACC(NONE)   
        PERMIT BBG.AUTHMOD.BBGZSAFM.SAFCRED CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
  5. Starten Sie den Angel-Adressraum.
  6. Starten Sie den Liberty-Server.
  7. Führen Sie den Befehl ping aus, um die Konnektivität zwischen dem batchManagerZos-Client und dem Liberty-Server zu testen.
    $ batchManagerZos ping '--batchManager=LIBERTY BATCH MANAGER'

    Wenn der Pingbefehl erfolgreich war, wird der Client mit dem Rückgabecode 0 beendet. Andernfalls wird eine Fehlernachricht ausgegeben.

  8. Zur Fehlerbehebung können Sie zusätzliches Tracing im Client einstellen, indem Sie die Umgebungsvariable $ export batchManagerZosTrace=1 festlegen.
  9. Optional: Konfigurieren Sie das Clientdienstprogramm "batchManagerZos" so, dass es wartet, bis es eine Benachrichtigung über den Abschluss eines Stapeljobereignisses empfängt, anstatt während der Wartezeit fortlaufend Abfragen zu senden.

    Sie müssen den Stapelserver so konfigurieren, dass die Veröffentlichung jobbezogener Ereignisse, die den WebSphere MQ-Messaging-Provider verwenden, ermöglicht wird. Weitere Informationen finden Sie unter Enabling batch job events publishing.

    Das folgende Beispiel zeigt, wie ein Job übergeben wird und auf seine Fertigstellung wartet, die durch ein Jobenendereignis mitgeteilt wird:
    $ batchManagerZos submit  
    --batchManager=LIBERTY+BATCH+MANAGER  
    --applicationName=[Anwendungsname, der beim Packen der Stapelanwendung verwendet wird]
    --jobXMLName=[XML-Basisdateiname des Jobs im Anwendungsverzeichnis für Stapeljobs]
    --wait
    --queueManagerName=[Name des MQ-Warteschlangenmanagers]
    Der batchManagerZos-Client wartet auf den Empfang eines von drei Ereignissen, das den Endestatus einer Jobinstanz darstellt:
    batch/jobs/instance/stopped 
    batch/jobs/instance/failed 
    batch/jobs/instance/completed

Symbol das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 16.06.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_batchManagerZos
Dateiname: twlp_batchManagerZos.html