Interfaces API de gestionnaire de travaux parallèles
Les interfaces SPI de gestionnaire de travaux parallèles des versions antérieures sont à présent des API. Elles font partie intégrante d'une application.
API de paramétrage
L'objectif de l'API de paramétrage est de scinder le travail de niveau supérieur en plusieurs travaux subordonnés. L'API de paramétrage détermine le nombre de travaux subordonnés à créer, et les propriétés d'entrée transmises à chaque travail subordonné. En règle générale, les propriétés d'entrée contiennent des informations pour lesquelles un bloc de données traite un travail subordonné spécifique. L'implémentation de l'API de paramétrage est obligatoire.
Il existe une API de paramétrage par défaut qui fournit les fonctions de base du paramétreur générique. Pour appeler cette implémentation, affectez la valeur com.ibm.ws.batch.parallel.BuiltInParameterizer à la propriété com.ibm.websphere.batch.parallel.parameterizer dans le fichier xJCL. Pour spécifier le nombre de travaux subordonnés, affectez la valeur N à la propriété d'entrée com.ibm.wsspi.batch.parallel.jobs, N étant le numéro du travail subordonné. Pour spécifier une propriété unique pour une instance de travail subordonné spécifique, utilisez la propriété com.ibm.wsspi.batch.parallel.prop.<nom_propriété>.<travail_subordonné>=<valeur> où travail_subordonné correspond à l'instance de travail subordonné (1< travail subordonné< N). Toutes les autres propriétés au format <nom_propriété>= <valeur> sont visibles pour tous les travaux subordonnés.
API de synchronisation
L'API de synchronisation vous permet de contrôler les différentes étapes du cycle de vie de la transaction logique. Par exemple, les étapes Begin, beforeCompletion et afterCompletion de la vie. Vous pouvez utiliser ces points de contrôle pour annuler la transaction logique, si nécessaire.
API SubJobCollector
L'API SubJobCollector collecte des informations relatives à l'exécution d'un travail subordonné. Dans une implémentation standard, les informations d'avancement relatives à un travail subordonné sont stockées en tant qu'objet externalisable au sein du contexte de travail subordonné. Lorsque le conteneur de lots démarre l'API de collecte, les informations précédemment stockées dans le contexte de travail subordonné sont renvoyées.
API SubJobAnalyzer
L'API SubJobAnalyzer permet d'analyser les informations précédemment collectées à l'aide de l'API SubJobCollector. Dans une implémentation standard, l'API SubJobAnalyzer est utilisée pour agréger les informations obtenues à partir de tous les travaux subordonnés afin de déterminer le code retour consolidé pour le travail de niveau supérieur. L'API SubJobAnalyzer est appelée lors du traitement du point de contrôle et à la fin de l'exécution d'un travail.
Objets de contexte
- ParallelJobManagerContext : existe dans la portée d'un travail parallèle. Les API de paramétrage, SubJobAnalyzer et Synchronization ont toutes accès à ce contexte pour une instance de travail parallèle spécifique.
- SubJobContext : existe dans la portée d'un travail subordonné. L'API SubJobCollector et les artefacts de modèle de programmation d'application par lots, BatchDataStream, BatchJobStepInterface, CheckpointPolicyAlgorithm et ResultsAlgorithm ont toutes accès à ce contexte pour une instance de travail subordonné spécifique.