Configuration de gestionnaires de travaux

Un gestionnaire de travaux agit en tant que pool d'unités d'exécution et service de contexte d'unité d'exécution pour des composants d'application qui utilisent Concurrency Utilities for Java™ EE ou des beans asynchrones. Utilisez la console d'administration pour configurer des gestionnaires de travaux.

Avant de commencer

Si vous ne connaissez pas les gestionnaires de travaux, reportez-vous à la rubrique conceptuelle Gestionnaire de travaux.

Pourquoi et quand exécuter cette tâche

Le service de gestionnaire de travaux est toujours activé. Dans les versions précédentes du produit, le service de gestionnaire de travaux pouvait être désactivé via la console d'administration ou le service de configuration. Les objets de configuration du service de gestionnaire de travaux sont toujours présents dans le service de configuration, mais l'attribut activé est ignoré.

Vous pouvez définir plusieurs gestionnaires de travaux pour chaque cellule. Chaque gestionnaire de travaux est lié à un emplacement unique dans l'espace de nom de l'interface JNDI (Java Naming and Directory Interface).

Important : Le service de gestionnaire de travaux n'est pris en charge qu'au sein du conteneur d'EJB (JavaBeans) ou du conteneur Web. La consultation et l'utilisation d'un gestionnaire de travaux configuré à partir d'un conteneur de client d'application Java Platform, Enterprise Edition (Java EE) ne sont pas prises en charge.

Procédure

  1. Démarrez la console d'administration.
  2. Sélectionnez Ressources > Accès concurrents > Gestionnaires de travaux.
  3. Spécifiez une valeur de Portée et cliquez sur Nouveau.
  4. Spécifiez les propriétés requises pour les paramètres du gestionnaire de travaux :
    Portée
    Portée de la ressource configurée. Cette valeur spécifie l'emplacement du fichier de configuration.
    Chaîne
    Nom du gestionnaire de travaux.
    Nom JNDI
    Nom JNDI (Java Naming and Directory Interface) du gestionnaire de travaux. Des références d'environnement de ressource peuvent être liées à ce nom et utilisées par les composants qui doivent interroger le gestionnaire de travaux. Chaque gestionnaire de travaux doit avoir un nom JNDI unique au sein de la cellule.
    Nombre d'unités d'exécution d'alarme
    Nombre maximal d'unités d'exécution qui doivent être utilisées pour un pool d'unités d'exécution distinct dédié au traitement des alarmes dédié et pour le travail planifié pour s'exécuter à un moment spécifique. Le gestionnaire de travaux surveille et déploie les alarmes en attente et le travail planifié sur ce pool d'unités d'exécution.
    Remarque : Le nombre d'unités d'exécution d'alarme que vous indiquez pour cette propriété n'a pas d'impact sur le nombre d'unités d'exécution indiqué pour les propriétés Nombre minimal d'unités d'exécution et Nombre maximal d'unités d'exécution. La propriété Nombre d'unités d'exécution d'alarme ne s'applique qu'au pool des unités d'exécution d'alarme. Les propriétés Nombre minimal d'unités d'exécution et Nombre maximal d'unités d'exécution ne s'appliquent au pool d'unités d'exécution principal qui gère les demandes de travail.
    Nombre minimal d'unités d'exécution
    S'applique au principal pool d'unités d'exécution pour le travail soumis au gestionnaire de travaux qui doit s'exécuter immédiatement (et non pour le travail dont l'exécution est planifiée). Nombre d'unités d'exécution à conserver dans le pool d'unités d'exécution et créées selon les besoins.
    Nombre maximal d'unités d'exécution
    Remarque : S'applique au principal pool d'unités d'exécution pour le travail soumis au gestionnaire de travaux qui doit s'exécuter immédiatement (et non pour le travail dont l'exécution est planifiée). Nombre d'unités d'exécution maximal à créer dans le pool d'unités d'exécution. Le nombre maximal d'unités d'exécution peut être provisoirement dépassé si l'option Evolutif est sélectionnée. Ces unités d'exécution sont annulées lorsque le travail de l'unité d'exécution se termine.
    Priorité des unités d'exécution
    Priorité à affecter à toutes les unités d'exécution du pool d'unités d'exécution et à toutes les unités d'exécution créées par la fabrique d'unités d'exécution gérée.

    Une priorité est affectée à chaque unité d'exécution. Les unités d'exécution dotées d'une priorité plus élevée sont lancées avant celles dotées d'une priorité moindre. Pour plus d'informations sur l'utilisation des priorités d'unité d'exécution, voir la documentation Java relative à la méthode setPriority de la classe java.lang.Thread dans la spécification Java Standard Edition.

  5. [Facultatif] Indiquez une description et une catégorie pour le gestionnaire de travaux.
  6. [Facultatif] Sélectionnez les noms de service (types de contexte d'unité d'exécution disponible mis à la disposition des composants Java EE) que ce gestionnaire de travaux doit capturer à partir de l'unité d'exécution de soumission et rendre disponible sur l'unité d'exécution. Le gestionnaire de travaux connaît la liste des services sélectionnés connue sous le nom de règle de contexte d'héritage. La sélection d'un nombre excessif de services risque de réduire les performances.
    Autres zones facultatives :
    Délai du travail
    Indique le temps d'attente (en millisecondes) avant l'annulation ou la libération d'une unité de travail démarrée. Si aucune valeur n'est indiquée, le délai d'attente est désactivé.
    Taille de la file d'attente des demandes de travaux
    Indique la taille de la file d'attente des demandes de travaux. Cette file d'attente est une mémoire tampon qui conserve les objets de travaux planifiés et peut posséder toute valeur supérieure ou égale à 1. Le pool d'unités d'exécution extrait les travaux de cette file d'attente. Si vous n'indiquez pas de valeur ou si celle-ci est de 0, la taille de la file d'attente est automatiquement gérée. Quand la taille de la file d'attente est gérée de manière automatique, le calcul correspond au plus grand nombre entre le nombre maximal d'unités d'exécution et 20. Les valeurs élevées peuvent solliciter une quantité importante de ressources système.
    Action en cas de saturation de la file d'attente des demandes de travaux
    Indique l'action prise lorsque le pool d'unités d'exécution est épuisé et que la file d'attente des demandes de travaux est saturée. Cette action est lancée lorsque vous soumettez un travail non démon au gestionnaire de travaux. Si la valeur définie est FAIL, les méthodes de l'API de gestionnaire de travaux ou du programme d'exécution créent une exception au lieu d'avoir une action bloquante.
    [z/OS]Classe de transaction par défaut
    [z/OS]Indique le nom de la classe de transaction employé pour classifier le travail exécuté par cette instance de gestionnaire de travaux lorsque les informations de classe du service Work Load Manager de z/OS ne figurent pas dans les informations du contexte de travail.
    [z/OS]Classe de transaction démon
    [z/OS]Indique le nom de la classe de transaction employé pour classifier le travail démon initié par cette instance de gestionnaire de travaux.
  7. [Facultatif] Sélectionnez Propriétés personnalisées > Nouveau. Autres zones facultatives :
    Chaîne
    lateWorkTime
    valeur
    Nombre de secondes
    Description
    Entrez une description
    Type
    Sélectionnez java.lang.String

    La propriété personnalisée lateWorkTime indique le nombre de secondes au delà duquel le travail différé doit consigner un message d'information. Le message d'information est consigné une fois par le gestionnaire de travaux. La valeur par défaut est de 60 secondes et la valeur 0 désactive cette propriété.

    Chaîne
    lateAlarmTime
    valeur
    Nombre de secondes
    Description
    Entrez une description
    Type
    Sélectionnez java.lang.String

    La propriété personnalisée lateAlarmTime indique le nombre de secondes au delà duquel l'alarme à déclenchement différé doit consigner un message d'information. Le message d'information est consigné une fois par le gestionnaire de travaux. La valeur par défaut est de 5 secondes et la valeur 0 désactive la propriété.

  8. Sauvegardez votre configuration.

Résultats

Le gestionnaire de travaux est à présent configuré et exploitable par les composants de l'application qui doivent gérer le lancement du code asynchrone.

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



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