Pour plateformes z/OS

Configuration de l'utilitaire client batchManagerZos

Vous pouvez gérer des travaux par lots qui s'exécutent sous Liberty on z/OS à l'aide de l'utilitaire client batchManagerZos.

Pourquoi et quand exécuter cette tâche

L'utilitaire client batchManagerZos est une version compilée en natif de l'utilitaire de ligne de commande batchManager pour la gestion de travaux par lots qui s'exécutent sous Liberty for z/OS. Il s'agit d'un programme natif et qui ne nécessite pas une machine virtuelle Java. Cet utilitaire est fourni avec la fonction batchManagement-1.0.

L'utilitaire client batchManagerZos prend en charge un sosu-ensemble de commandes et d'options qui sont pris en charge par l'utilitaire de ligne de commande batchManager. Utilisez la commande $ batchManagerZos help pour afficher la liste des commandes et options.

L'utilitaire client batchManagerZos utilise des adaptateurs locaux optimisés pour se connecter à un serveur Liberty qui s'exécute dans un environnement local. L'utilitaire client batchManagerZos ne peut pas se connecter à des serveurs distants.

Remarques sur la sécurité
Le comportement de sécurité de l'utilitaire client batchManagerZos varie selon que le serveur Liberty utilise ou non un registre SAF.
  • Si le serveur utilise un registre d'utilisateurs SAF, l'identité de l'utilitaire client batchManagerZos est définie en tant qu'identité du demandeur (sujet RunAs JEE) pour la demande de travail par lots.
  • Si le serveur n'utilise pas de registre d'utilisateurs SAF, l'identité de l'utilitaire client batchManagerZos est ignorée. Dans ce cas, le sujet spécial EVERYONE est défini en tant qu'identité du demandeur pour la demande de travail par lots.
Autorisation par rôle par lots

Si appSecurity est activé sur le serveur, vous devez affecter l'identité du demandeur au rôle de sécurité approprié requis par la demande. Les rôles de sécurité par lots valides sont batchAdmin, batchSubmitter et batchMonitor. Si l'identity n'est pas attribuée au rôle qui est requis, la demande échoue avec une exception de sécurité.

L'autorisation est gérée par le fournisseur d'autorisations de sécurité. Si le serveur utilise l'autorisation SAF, le fournisseur détezrmine l'autorisation de l'identité du demandeur en vérifiant l'accès de l'identité aux profils de ressource SAF définis dans la classe EJBROLE. Par défaut, les profils de ressource suivants sont associés aux rôles par lots.
    batchAdmin:     BBGZDFLT.com.ibm.ws.batch.batchAdmin
    batchSubmitter: BBGZDFLT.com.ibm.ws.batch.batchSubmitter
    batchMonitor:   BBGZDFLT.com.ibm.ws.batch.batchMonitor
L'identité du demandeur doit disposer de l'accès READ au profil de ressource approprié afin d'être autorisé sur le rôle par lots correspondant.

L'exemple ci-après illustre les commandes RACF pour accorder à l'identité du client, bob, l'autorisation sur le rôle batchAdmin.

    RDEFINE EJBROLE BBGZDFLT.com.ibm.ws.batch.batchAdmin UACC(NONE)
    PERMIT BBGZDFLT.com.ibm.ws.batch.batchAdmin CLASS(EJBROLE) ID(bob) ACCESS(READ)
Codes retour
L'utilitaire client batchManagerZos client produit les codes retour suivants :
Code Description
0 La tâche s'est terminée normalement.
20 Un argument obligatoire n'a pas été spécifié.
21 Un argument non reconnu a été spécifié.
22 Un argument non valide a été spécifié.
255 Une erreur inattendue est survenue.
Remarque : Si vous indiquez l'argument --wait, l'utilitaire produit les codes retour suivants concernant l'état du travail que vous attendez.
Code Description
33 Le travail s'est arrêté.
34 Le travail n'a pas abouti.
35 Le travail a abouti.
36 Le travail a été abandonné.
Remarque : Si vous exécutez batchManagerZos via BPXBATCH, le code retour de BPXBATCH ne correspond pas à celui de batchManagerZos. BPXBATCH prend le code retour de batchManagerZos et le décale d'un octet vers le haut. par exemple, si batchManagerZos retourne 1, BPXBATCH retourne 256, qui la valeur hexadécimale 0x01, décalée d'un à 0x100.

Si vous appelez BPXBATCH depuis une étape JCL STEP, le code retour de celle-ci est tronqué aux trois caractères hexadécimaux inférieurs du code retour de BPXBATCH. Par example, si batchManagerZos retourne 35, qui correspond à 0x23 hex, BPXBATCH retourne 0x2300. L'étape JCL STEP tronque le code retour à 0x0300 (ou 768).

Limitations

L'utilitaire client batchManagerZos ne prend actuellement pas en charge la récupération ou la diffusion en flux des journaux de travail.

Les commandes stop de l'utilitaire client batchManagerZos doivent être adressées au programme d'exécution par lots où le travail est exécuté. Les commandes Stop en environnement multi-serveur peuvent échouer avec une exception BatchJobNotLocalException si l'utilitaire client batchManagerZos se connecte à un répartiteur par lots désignés plutôt qu'au programme d'exécution par lots où le travail s'exécute. Les répartiteurs par lots reçoivent généralement des demandes de soumission et les distribuent aux programmes d'exécution par lots en aval.

Procédure

  1. Activez les fonctions batchManagement-1.0 et zosLocalAdapters-1.0 dans votre fichier server.xml.
    <featureManager>
    	<feature>batchManagement-1.0</feature>
    	<feature>zosLocalAdapters-1.0</feature>
    </featureManager>
  2. Configurez un noeud final zosLocalAdapters-1.0. L'exemple ci-après illustre une configuration de noeud final zosLocalAdapters-1.0.
    <zosLocalAdapters wolaGroup="LIBERTY" wolaName2="BATCH" wolaName3="MANAGER"/>
  3. Autorisez l'utilitaire client batchManagerZos à se connecter au noeud final zosLocalAdapters. Pour que le client batchManagerZos se connecte au serveur sur des adaptateurs locaux optimisés, l'élément userId du client doit être autorisé sur la ressource CBIND SAF associée au noeud final zosLocalAdapters. La ressource qui est associée au noeud final se nomme BBG.WOLA.{wolaGroup}.{wolaName2}.{wolaName3} dans la classe CBIND. Pour lier le noeud final zosLocalAdapters nommé LIBERTY BATCH MANAGER, vous devez accorder l'accès en lecture à la ressource BBG.WOLA.LIBERTY.BATCH.MANAGER dans la classe CBIND pour l'ID utilisateur batchManagerZos. L'exemple ci-après illustre les commandes RACF que vous devez utiliser pour accorder un accès en lecture à la ressource.
        RDEFINE CBIND BBG.WOLA.LIBERTY.BATCH.MANAGER UACC(NONE)   
        PERMIT BBG.WOLA.LIBERTY.BATCH.MANAGER CLASS(CBIND) ACCESS(READ) ID(bob)
    Remarque : Dans cet exemple, bob est l'utilisateur qui exécute batchManagerZos.
  4. Si vous voulez que les demandes batchManagerZos s'exécutent sur le serveur sous l'identité du client, vous devez autoriser le serveur à utiliser les ressources autorisées SAFCRED z/OS. L'exemple ci-après illustre les commandes RACF que vous devez utiliser pour permettre au serveur d'utiliser les ressources autorisées SAFCRED z/OS.
        RDEFINE SERVER BBG.AUTHMOD.BBGZSAFM.SAFCRED UACC(NONE)   
        PERMIT BBG.AUTHMOD.BBGZSAFM.SAFCRED CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
  5. Démarrez l'espace adresse Angel.
  6. Démarrez le serveur Liberty.
  7. Utilisez la commande ping pour tester la connectivité entre le client batchManagerZos et le serveur Liberty.
    $ batchManagerZos ping '--batchManager=LIBERTY BATCH MANAGER'

    Si la commande ping aboutit, le client sort avec le code retour 0. Dans le cas contraire, un message d'erreur est émis.

  8. Pour remédier à cela, vous pouvez activer un traçage supplémentaire dans le client en définissant la variable d'environnement $ export batchManagerZosTrace=1.
  9. Facultatif : Configurez l'utilitaire du client batchManagerZos afin d'attendre qu'un événement de travail par lots existe au lieu d'attendre à l'aide d'interrogations.

    Vous devez configurer le serveur de traitement par lots pour permettre la publication des événements associés à un travail utilisant le fournisseur de messagerie WebSphere MQ. Voir Enabling batch job events publishing

    L'exemple suivant montre comment soumettre un travail et attendre qu'il soit terminé par un événement de fin de travail :
    $ batchManagerZos submit  
    --batchManager=LIBERTY+BATCH+MANAGER  
    --applicationName=[nom d'application utilisé lors de la création du package de l'application par lots]  
    --jobXMLName=[nom de base du fichier XML du travail dans le répertoire batch-jobs de l'application]  
    --wait  
    --queueManagerName=[nom du gestionnaire de file d'attente MQ]
    Le client batchManagerZos attend de recevoir 1 des 3 événements représentant un état de fin d'instance de travail :
    batch/jobs/instance/stopped 
    batch/jobs/instance/failed 
    batch/jobs/instance/completed

Icône indiquant le type de rubrique Rubrique Tâche



Icône d'horodatage Dernière mise à jour: 7 juin 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_batchManagerZos
Nom du fichier : twlp_batchManagerZos.html