Paramètres spécifiés pour les processus en arrière-plan

Cette section décrit les divers types de paramètre fournis aux processus en arrière-plan.

Paramètres généraux

Les informations ci-dessous sont transmises à tous les processus en arrière-plan.

  • Code de batch. Le code de batch est l'identifiant unique du processus en arrière-plan.

  • Numéro de thread de batch. Le numéro de thread n'est utilisé que pour les processus en arrière-plan qui peuvent être exécutés dans plusieurs threads parallèles. Il contient le numéro de thread relatif du processus. Par exemple, si le processus de facturation a été paramétré pour être exécuté dans 20 threads parallèles, chacune des 20 instances reçoit son numéro de thread relatif (1 à 20). Pour plus d'informations, voir Nombre de threads optimum pour les processus en arrière-plan parallèles.

  • Nombre de threads de batch. Le nombre de threads n'est utilisé que pour les processus en arrière-plan qui peuvent être exécutés dans plusieurs threads parallèles. Il contient le nombre total de threads parallèles qui ont été programmés. Par exemple, si le processus de facturation a été paramétré pour exécuter 20 threads parallèles, chacune des 20 instances reçoit un nombre de threads de 20. Pour plus d'informations, voir Nombre de threads optimum pour les processus en arrière-plan parallèles.

  • Numéro de réexécution de batch. Le numéro de réexécution n'est utilisé que pour les processus en arrière-plan qui exportent des informations appartenant à un numéro d'exécution donné. Il ne doit être indiqué que si vous devez exporter une exécution historique (et non la dernière exécution).

  • Date commerciale du batch. La date commerciale n'est utilisée que pour les processus en arrière-plan qui utilisent la date actuelle dans leur traitement. Par exemple, un processus de facturation peut utiliser la date commerciale pour déterminer les cycles de facturation devant être exportées. Si ce paramètre est laissé vide, la date système est utilisée. Si ce paramètre est spécifié, la date doit être au format AAAA-MM-JJ. Remarque : Ce paramètre n'est utilisé que lors de l'assurance qualité afin de tester le comportement des processus dans le temps.

    Remarque :
    Il peut y avoir un léger retard du délai de soumission pour les traitements batch soumis en ligne. Si la date/heure d'exécution souhaitée est proche de minuit, votre traitement batch peut être exécuté le jour suivant votre soumission. Si vous n'avez pas renseigné la date commerciale, elle aura comme valeur par défaut le jour suivant la date à laquelle vous avez soumis le traitement.

  • Remplacer le nombre maximum d'enregistrements entre les validations (commit). Ce paramètre est facultatif et remplace chaque validation (commit) standard du processus en arrière-plan. Vous pouvez modifier cette valeur, par exemple si vous soumettez un traitement pendant la journée et voulez des validations (commit) plus fréquentes pour relâcher des ressources bloquées. Vous pouvez vouloir augmenter cette valeur lorsqu'un processus en arrière-plan est exécuté pendant le nuit (ou les week-ends) et si vous avez beaucoup de mémoire sur vos serveurs.

  • Remplacer le nombre maximum de minutes entre les réinitialisations du curseur. Ce paramètre est facultatif et remplace chaque nombre de minutes de réinitialisation de curseur standard du processus en arrière-plan. Vous pouvez réduire cette valeur, par exemple si vous soumettez un traitement pendant la journée et voulez des validations (commit) plus fréquentes pour relâcher les ressources bloquées (ou des initialisations plus fréquentes du curseur). Vous pouvez vouloir augmenter cette valeur lorsqu'un processus en arrière-plan est exécuté pendant le nuit (ou les week-ends) et si vous avez beaucoup de mémoire sur vos serveurs.

  • ID utilisateur. Veuillez noter les points suivants concernant l'ID utilisateur :

    • L'utilisateur soumettant le traitement et l'ID utilisateur enregistré sur la soumission de batch ont tous deux accès au service applicatif pour le contrôle de batch sécurisant l'exécution.

    • Si un processus en mode batch estampille un ID utilisateur sur un enregistrement qu'il crée / met à jour, il utilise cet ID utilisateur dans le traitement applicable.

    • Le profil d'affichage de cet ID utilisateur contrôle la manière dont les dates et les valeurs de devise sont formatées dans les messages.

    • Lors de la soumission d'un traitement batch en ligne, l'utilisateur, la langue et l'adresse email du batch prennent par défaut les valeurs de l'utilisateur qui soumet le traitement. Seuls les utilisateurs auxquels le mode d'accès Substitution utilisateur est accordé dans le service applicatif Soumission de traitement batch peuvent remplacer l'ID utilisateur du batch.

    • Si l'utilisateur de la soumission dispose de privilèges de remplacement, il peut conserver les détails de l'utilisateur du batch d'origine lors de la duplication ou de la réexécution d'un traitement batch à partir de la soumission en ligne. Si la case Exécuter en tant qu'utilisateur d'origine est cochée, l'utilisateur du batch, la langue et l'adresse email de l'exécution de batch d'origine seront copiés dans le nouveau traitement batch. Dans le cas contraire, les détails utilisateur sont définis par défaut à partir de l'utilisateur de la soumission.

  • Mot de passe. Actuellement, le mot de passe n'est pas utilisé.

  • Code de langue. Le code de langue est utilisé pour accéder aux valeurs de la table de contrôle propre à la langue. Par exemple, les messages d'erreur sont présentés dans ce code de langue.

  • Trace au démarrage du programme, Trace à l'arrêt du programme, Trace SQL et Trace de sortie. Ces bascules ne sont utilisées que lors de l'assurance qualité et du banc d'essai. Si la bascule Trace au démarrage du programme est cochée, un message est affiché lorsqu'un programme est démarré. Si la bascule Trace à l'arrêt du programme est cochée, un message est affiché lorsqu'un programme est arrêté. Si la bascule Trace SQL est cochée, un message est affiché lorsqu'une instruction SQL est exécutée. Si la bascule Trace de sortie est cochée, des messages spéciaux formatés par le processus en arrière-plan sont écrits.

Remarque :
Les informations affichées lorsque la bascule de fichier de trace est activée dépendent de chaque processus en arrière-plan. Il est possible qu'un processus en arrière-plan n'affiche aucune information spéciale pour cette bascule.

Paramètres communs supplémentaires

Chaque contrôle de batch prend en charge la définition de paramètres supplémentaires. Certains d'entre eux sont communs à tous les processus en mode batch, d'autres sont communs à un type particulier de processus en mode batch. Le contrôle de batch doit être fourni avec les paramètres supplémentaires appropriés. Cependant, si de nouveaux paramètres supplémentaires sont introduits, il n'est pas obligatoire de les ajouter dans les contrôles de batch existants.

Le tableau ci-dessous présente les paramètres communs pouvant être associés à un contrôle de batch. A noter que les paramètres de batch ont un numéro de séquence qui en détermine l'ordre d'affichage ; cependant, le processus en mode batch n'utilise pas ce numéro pour identifier un paramètre, il utilise le nom du paramètre. Dans certains cas, plusieurs noms de paramètre sont pris en charge (une version avec minuscules et initiales majuscules et une version entièrement en majuscules).

Nom du paramètre Description Commentaires
MAX-ERRORS / maxErrors Chacun des processus en mode batch a, comme faisant partie de ses paramètres d'exécution, une constante prédéfinie qui détermine le nombre d'erreurs qu'un processus en mode batch peut rencontrer avant que l'exécution ne soit abandonnée. Un utilisateur peut remplacer cette constante à l'aide de ce paramètre. La valeur entrée doit être un nombre entier supérieur ou égal à zéro. La valeur valide maximum pour ce paramètre est 999.999.999.999.999.
DIST-THD-POOL Chaque processus en mode batch est exécuté dans un pool de threads. Ce paramètre n'est nécessaire que si le processus en mode batch doit s'exécuter dans un pool de threads autre que celui par défaut. Le nom du pool de threads par défaut est DEFAULT.
emailMode Lorsque le traitement batch est soumis avec une adresse électronique associée, la logique par défaut consiste à envoyer un email lorsque le traitement se termine, que ce soit avec succès ou non. Ce paramètre permet de limiter l'envoi de l'email à certains états de fin du traitement. Valeurs valides

  • ERROR - Envoyer un email uniquement lorsque le traitement se termine avec l'état Erreur.

  • SUCCESS - Envoyer un email uniquement lorsque le traitement se termine avec succès.

  • ALL - Toujours envoyer un email lorsque le traitement se termine. (Il s'agit de la valeur par défaut.)
Les paramètres ci-dessous ne s'appliquent qu'aux traitements qui utilisent la méthode de répartition du travail entre les threads Sélection SQL de niveau thread, décrite dans Processus en arrière-plan parallèles.
overrideLowIdValue Indique un nouvel ID inférieur à utiliser pour calculer la plage pour un thread. Par défaut, Framework considère que l'ID est compris entre une valeur entièrement composée de 0 (par exemple 000000000) et une valeur entièrement composée de 9 (par exemple 9999999999), mais ce paramètre remplace la valeur inférieure. La valeur du paramètre peut être un nombre, ou ce peut être auto. Avec auto, la valeur devient la valeur actuellement la plus basse dans la table de base de données associée au processus en arrière-plan.
overrideHighIdValue Indique un nouvel ID supérieur à utiliser pour calculer la plage pour un thread. Par défaut, Framework considère que l'ID est compris entre une valeur entièrement composée de 0 (par exemple 000000000) et une valeur entièrement composée de 9 (par exemple 9999999999), mais ce paramètre remplace la valeur supérieure.     La valeur du paramètre peut être un nombre, ou ce peut être auto. Avec auto, la valeur devient la valeur actuellement la plus élevée dans la table de base de données associée au processus en arrière-plan.
idRangeOverrideClass Utilisez ce paramètre pour spécifier une classe personnalisée pour le calcul de la plage des threads. Au cours de l'exécution de batch, cette classe de substitution est instanciée et les méthodes set sont appelées afin d'initialiser les ID conformément aux besoins. Les méthodes get d'obtention de valeurs inférieures et supérieures sont utilisées pour extraire les ID inférieurs et supérieurs à employer pour l'exécution. Le nom de classe spécifié doit implémenter l'interface com.splwg.base.api.batch.BatchIdRangeOverride.
batchStrategy Utilisez ce paramètre pour remplacer une stratégie par lots THDS par la stratégie JOBS - Job-Level ou KEYS - Key Ranges. Ce paramètre est uniquement pris en charge par les programmes batch pilotés par plug-in Surveillance et Ad hoc.
Les paramètres ci-dessous ne s'appliquent qu'aux traitements qui effectuent une validation unique, par exemple aux traitements batch d'extraction.
numRecordsToFlush Ce paramètre définit à quelle fréquence le cache Hibernate doit être vidé pour éviter une consommation élevée de portions de mémoire et des erreurs d'insuffisance de mémoire.

Paramètres de batch spécifiques

Certains processus en arrière-plan définissent des paramètres supplémentaires propres à leur fonctionnalité. Lorsqu'un processus reçoit des paramètres supplémentaires, ceux-ci sont définis et documentés dans l'entrée du contrôle de batch dans l'application.

Lors de la soumission d'un traitement batch en ligne, les valeurs de paramètre par défaut configurées dans l'enregistrement de contrôle de batch sont prises en compte par défaut et peuvent être replacées. Notez que si la valeur de paramètre est configurée pour être cryptée dans la configuration de contrôle de batch, la valeur qui s'affiche sera également cryptée.