Gestion des abonnements

• Code abonnement (champ CODABT)

Identifie le code abonnement.

• Intitulé (champ NOMABT)

Intitulé associé au code précédent

• Dossier (champ DOSSIER)

Définit le nom du dossier dans lequel sera lancée la requête (le code du dossier courant est proposé par défaut).

• Code utilisateur (champ USER)

Définit le code d'un utilisateur sous l'identité duquel la tâche sera lancée (le code de l'utilisateur courant est proposé par défaut).

• Mot de passe (champ PASSE)

Lorsque le dossier ou la tâche doit être exécutée n'est pas le dossier courant, ou si l'utilisateur ne correspond pas au code utilisateur courant, il est nécessaire de saisir le mot de passe correspondant afin de s'identifier.

• Groupe (champ GRP)

Définit un groupe de tâches à lancer.

• Code tâche (champ TACHE)

Définit le code de la tâche qui sera lancée automatiquement par le serveur batch.

• Langue (champ LAN)

• Actif (champ ENAFLG)

Sélectionnez cette case à cocher pour activer la fiche courante.

Les enregistrements non sélectionnés conservent leur contenu et paramétrage, mais ne pourront pas être utilisés en rappelant leur code dans :

• les autres enregistrements, comme les documents et paramètres,
• les traitements en masse.

Les habilitations sur une fonction donnée peuvent interdire la création d'une fiche active. Dans ce cas, la case est désactivée par défaut. Elle est modifiable uniquement par un utilisateur autorisé, ou via un Workflow de signature.

• Dernière exécution (champ DJOUR)

Lorsque l'abonnement a déjà donné lieu à des exécutions de tâches, ce champ permet de connaître la date de dernière exécution.

• Périodicité (champ PERIO)

Ce champ définit la périodicité d'exécution de la tâche.

Si la période est le mois, on peut indiquer un quantième (date dans le mois comprise entre le 1 et le 31) et/ou cocher la case fin de mois. Si la période est hebdomadaire, il faut cocher un ou plusieurs jours de la semaine.

• Jours exclus (champ CAL)

Saisissez un code de Calendrier pour exclure des jours spécifiques de l'exécution des abonnements.

• champ JOUR

Sélectionnez le ou les jour(s) où la tâche sera exécutée chaque semaine.

• Quantièmes (champ QUANT)

Si vous avez sélectionné Mensuel, vous pouvez indiquer un jour du mois entre 1 et 31, et/ou sélectionner l'option Fin de mois.

• Fin de mois (champ FDM)

Si vous avez choisi Mensuel, sélectionnez cette case à cocher pour exécuter la tâche le dernier jour de chaque mois, sauf si la date est exclue du Calendrier.

• Heure début (champ HDEB)

Saisissez une heure de début et de fin pour limiter l'exécution de la tâche à cette période de temps.

• Heure fin (champ HFIN)

• Fréquence (mn) (champ FRQ)

Saisissez le nombre de minutes entre plusieurs itérations d'une tâche. Par exemple, si la première exécution ne traite pas tous les Nb enregistrements, la tâche s'exécute à nouveau après le nombre de minutes défini.

• Une seule requête (champ ONE)

Sélectionnez cette case si l'abonnement est défini selon une fréquence.

Lorsque cette case est sélectionnée, une seule requête est lancée par jour pour exécuter le traitement demandé. Dès que le traitement est terminé, la tâche se met en veille pendant le nombre de minutes définies par la fréquence, et reprend son exécution jusqu'à l'heure de fin. La requête affiche le statut En cours pendant tout l'intervalle d'exécution.

Cela permet de s'assurer que la requête est toujours présente en mémoire une fois lancée, au détriment d'autres tâches si le nombre maximum de tâches lancées simultanément est atteint.

• Epuration (champ EPUR)

Cette case à cocher peut uniquement être sélectionnée pour un abonnement défini selon une fréquence. Lorsque cette case est sélectionnée, aucune trace des exécutions successives de la tâche n'est conservée dans la fonction de gestion des requêtes. Seule la requête en cours et la requête précédente sont conservées dans la table correspondante.

• Continuer si erreur (champ CNTERR)

Si cette case à cocher est sélectionnée, un abonnement est lancé à nouveau, même en cas d'erreur.
Les erreurs qui peuvent interrompre une tâche sont :
- Variable GOK différente de 1 : indique généralement qu'il y a eu une erreur dans une transaction de mise à jour de la base.
- Variable GERRBATCH supérieure à 100 : cette variable peut être positionnée dans le traitement qui exécute la tâche.
- Variable GERREUR différente de 0 : dans certains traitements, cette variable est positionnée dans un sous-programme de gestion d'erreur déclenché par l'instruction Onerrgo.

• Heure (champ HEURE)

Quand la tâche n'est pas définie selon une fréquence, vous pouvez choisir de la lancer à trois heures différentes dans une journée.

• Exécution forcée (champ FORCE)

Cette case à cocher peut uniquement être sélectionnée si des heures fixes d'exécution ont été définies pour un l'abonnement concerné. Cela permet de s'assurer que la demande d'exécution est créée, même si l'heure est dépassée au moment où le serveur batch traite les abonnements de la journée.

Par exemple, si une tâche est programmée à 7:00, 10:00 et 15:00, mais si le serveur batch démarre un matin à 8:00 :

• Si la case est cochée, trois demandes d'exécution (à 7:00, 10:00 et 15:00) sont créées. La demande d'exécution datée de 7:00 est exécutée, ou non, selon les paramètres du serveur, qui permettent de définir un retard d'exécution maximal. Dans tous les cas, une ligne est effectivement programmée pour 7:00.
• Si la case n'est pas cochée, seules les deux demandes d'exécution postérieures à l'heure actuelle sont créées.

• Zone date (champ DATZON)

Utilisez ce champ pour saisir le nom de la zone d'écran à initialiser.
Vous pouvez spécifier l'abréviation de l'écran si la boîte de saisie des paramètres de la tâche utilise plusieurs écrans.

• Date de base (champ DATDEP)

Permet de renseigner la date de référence pour le calcul.

• Incrément (champ DATNBR)

Nombre à ajouter ou retirer de la date de référence.
Ce nombre correspond à l'unité choisie (jour, semaine, mois).

• Unité de temps (champ DATJRS)

Unité de temps

• Formule (champ DATFRM)

Utilisez ce champ pour renseigner la formule appliquée dans l'environnement de saisie des paramètres de l'abonnement de la tâche batch : tables ouvertes, variables globales, variables utilisateurs, etc.