
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.
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.batchAdmin: BBGZDFLT.com.ibm.ws.batch.batchAdmin batchSubmitter: BBGZDFLT.com.ibm.ws.batch.batchSubmitter batchMonitor: BBGZDFLT.com.ibm.ws.batch.batchMonitorL'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.
Rubrique Tâche