ADDJOBJS

La commande ADDJOBJS permet de planifier les travaux en traitement par lots par l'ajout de postes au planning des travaux. Un travail peut être isolé, faire partie d'un groupe de travaux ou encore correspondre à une application. Grâce à cette commande, vous pouvez planifier le traitement d'un travail par lots, de sorte qu'il soit soumis une seule fois, plusieurs fois à intervalles réguliers, etc., en fonction du code de planification que vous avez indiqué. Pour la planification des travaux, vous pouvez utiliser des calendriers définis par l'utilisateur, des calendriers de congés ou des calendriers fiscaux.

Un poste du planning des travaux contient toutes les informations requises pour la soumission du travail à savoir, les commandes à exécuter, la description du travail et le profil utilisateur utilisés pour son exécution, la file d'attente de travaux à laquelle il sera envoyé, la file destinée à recevoir les messages, etc.

La soumission du travail à la file d'attente de travaux s'effectue aux date et heure spécifiées par vous-même ou calculées par IBM Advanced Job Scheduler for i . Toutefois, cette commande ne garantit pas que le travail sera exécuté à l'heure planifiée. En effet, l'exécution du travail ne pourra pas commencer si la file de travaux est à l'état suspendu ou si le sous-système dont elle dépend est inactif, ou encore si le nombre maximal de travaux actifs pouvant être exécutés simultanément sur le sous-système ou sur le système est atteint.

Chaque poste du planning des travaux correspond à un travail défini par l'utilisateur et indiqué au paramètre Travail JS (JOB) de cette commande.

Restrictions :

• Vous devez disposer des droits d'utilisation (*USE) sur la description de travail et le profil utilisateur.
• Vous devez disposer des droits *USE et *ADD sur la file d'attente des messages.
• Vous devez disposer du droit de lecture (*READ) sur la file d'attente de travaux et sur toutes les bibliothèques associées aux objets indiqués.
• Vous devez disposer du droit *USE sur la fonction *ADDJOB.

Paramètres

Travail JS (JOB)

Nom d'un travail dans la liste de travaux planifiés. Vous devez spécifier un nom pour chaque travail et éventuellement le groupe auquel appartient ce travail ainsi que le numéro de séquence de ce dernier au sein du groupe.

Le premier travail doit porter le numéro "1". Pour les travaux suivants, utilisez un système de numérotation (10, 20, 30, etc...) permettant l'insertion éventuelle d'autres travaux.

Ce paramètre est obligatoire.

Elément 1 : Travail

nom

Indiquez le nom que vous attribuez à ce poste dans la liste de travaux planifiés.

Elément 2 : Groupe

*NONE

Le travail n'appartient à aucun groupe.

nom

Indiquez le nom, défini par l'utilisateur, du groupe auquel appartient le travail.

Elément 3 : Séquence dans le groupe

*NONE

Aucun numéro de séquence n'est attribué au travail.

1-99

Indiquez le numéro de séquence du travail dans le groupe.

Application (APP)

Nom de l'application à laquelle appartient le travail indiqué pour le paramètre Travail (JOB).

*JOBCTL

L'application utilisée est celle indiquée dans l'environnement travaux de JS.

*NONE

Aucune application n'est indiquée pour ce travail.

nom

Indiquez le nom de l'application à laquelle appartient le travail que vous ajoutez.

Code de planification (SCDCDE)

Code de planification que vous voulez attribuer au travail.

Remarque :Les jours d'exécution d'un travail définis à l'aide d'un code de planification peuvent être modifiés en sélectionnant un calendrier dans l'une des zones appropriées. Le menu Environnement travaux de JS (JSJOBCTL) vous permet de sélectionner le type de calendrier que vous souhaitez consulter.

*DAILY

Le travail est planifié pour une exécution quotidienne ou certains jours de la semaine. Par exemple, vous pouvez planifier l'exécution d'un travail le mercredi uniquement ou chaque jour de la semaine.

*CALENDAR

La planification du travail s'effectue selon un calendrier. Les calendriers sont indiqués à l'écran Gestion des calendriers.

*DATE

L'exécution du travail est prévue à des dates spécifiques tout au long de l'année. Les travaux sont conservés sur le système au format MMJJ (mois jour) ou JJMM (jour mois), en fonction des valeurs système, et sont soumis aux dates indiquées. Vous pouvez indiquer jusqu'à 13 dates d'exécution pour un travail.

*DAY

Le travail doit être exécuté certains jours du mois, tous les mois. Ces jours sont indiqués au format JJ (jour).

*NUMDAY

Le travail doit s'exécuter suivant un intervalle défini. Le nombre de jours définissant cet intervalle peut être compris entre 1 et 99.

Remarque :Si l'heure d'exécution planifiée est supérieure à l'heure en cours,IBM Advanced Job Scheduler for i considère qu'il s'agit d'un jour entier (si vous soumettez un travail à IBM Advanced Job Scheduler for i le lundi à 15 heures afin qu'il s'exécute tous les 2 jours à 17 heures, la première exécution de ce travail aura lieu le mardi à 17 heures)..

*MINUTES

Le travail doit s'exécuter suivant un intervalle défini. Le nombre de minutes définissant cet intervalle est celui indiqué pour le paramètre Intervalle (ITVMIN).

*ONCE

Le travail ne doit être exécuté qu'une seule fois. Le paramètre Sauvegarde (SAVE) indique si le travail, une fois exécuté, doit être sauvegardé (*YES) ou supprimé (*NO). S'il s'agit d'un groupe de travaux, le paramètre SAVE ne s'affiche pas et prend par défaut la valeur *YES. La date prévue pour l'exécution du travail figure dans le paramètre Date unique (SNGDATE). Si la zone est laissée à blanc, le travail est exécuté à l'heure planifiée.

*MONTHEND

Le travail doit s'exécuter le dernier jour du mois.

*FIRST

Le travail doit s'exécuter à la première occurrence du jour choisi pour chaque mois ou période fiscale indiquée. Cette option est utilisée conjointement avec le paramètre Jour unique (SNGDAY). Par exemple, si *TUE est indiqué pour le paramètre SNGDAY, le travail sera planifié pour s'exécuter le premier mardi de chaque mois.

*SECOND

Le travail doit s'exécuter à la deuxième occurrence du jour choisi pour chaque mois ou période fiscale indiquée. Cette option est utilisée conjointement avec le paramètre SNGDAY. Par exemple, si *TUE est indiqué pour le paramètre SNGDAY, le travail sera planifié pour s'exécuter le deuxième mardi de chaque mois.

*THIRD

Le travail doit s'exécuter à la troisième occurrence du jour choisi pour chaque mois ou période fiscale indiquée. Cette option est utilisée conjointement avec le paramètre SNGDAY. Par exemple, si *TUE est indiqué pour le paramètre SNGDAY, le travail sera planifié pour s'exécuter le troisième mardi de chaque mois.

*FOURTH

Le travail doit s'exécuter à la quatrième occurrence du jour choisi pour chaque mois ou période fiscale indiquée. Cette option est utilisée conjointement avec le paramètre SNGDAY. Par exemple, si *TUE est indiqué pour le paramètre SNGDAY, le travail sera planifié pour s'exécuter le quatrième mardi de chaque mois.

*FIFTH

Le travail doit s'exécuter à la cinquième occurrence du jour choisi pour chaque mois ou période fiscale indiquée. Cette option est utilisée conjointement avec le paramètre SNGDAY. Par exemple, si *TUE est indiqué pour le paramètre SNGDAY, le travail sera planifié pour s'exécuter le cinquième mardi de chaque mois.

Remarque :S'il n'existe pas de cinquième occurrence du jour choisi dans le mois, le travail ne s'exécutera pas et sera planifié pour une exécution à la cinquième occurrence suivante du jour choisi dans un mois.

*LAST

Le travail doit s'exécuter à la dernière occurrence du jour choisi pour chaque mois ou période fiscale indiquée. Cette option est utilisée conjointement avec le paramètre SNGDAY. Par exemple, si *TUE est indiqué pour le paramètre SNGDAY, le travail sera planifié pour s'exécuter le dernier mardi de chaque mois.

*FIRSTWRK

Le travail doit s'exécuter à la première occurrence du jour ouvré choisi pour chaque mois ou période fiscale indiquée. Cette option est utilisée conjointement avec l'invite Jours ouvrés dans l'environnement système de JS.

*LASTWRK

Le travail doit s'exécuter à la dernière occurrence du jour ouvré choisi pour chaque mois ou période fiscale indiquée. Cette option est utilisée conjointement avec l'invite Jours ouvrés dans l'environnement système de JS.

*ALTERNATE

Le travail doit s'exécuter lorsqu'un travail régulier se termine de façon anormale et qu'il est défini en tant que travail alterné pour le travail dont l'exécution a échoué.

*NONE

L'exécution du travail n'est pas planifiée. Il peut s'agir d'un travail faisant partie d'un travail de groupe en attente d'être soumis, d'un travail attendant qu'un travail prédécesseur s'exécute ou d'un travail attendant d'être soumis par l'utilisateur.

Remarque :Le code de planification *NONE remplace le code de planification *DEPJOB utilisé dans les éditions antérieures à la V4R2.

*JOBCTL

Le travail est planifié pour s'exécuter en fonction du code de planification indiqué dans l'environnement travaux de JS.

Heure planifiée (TIME)

Heure(s) souhaitée(s) pour l'exécution du travail aux jours indiqués. L'heure est indiquée au format HHMM (heures et minutes) et les valeurs admises sont comprises entre 0001 et 2400 (minuit).

Ce paramètre admet des valeurs multiples.

0-2400

Indiquez l'heure à laquelle vous souhaitez qu'IBM Advanced Job Scheduler for i soumette le travail.

Intervalle (ITVMIN)

Nombre de minutes à utiliser comme intervalle avec le code de planification *MINUTES. Cette zone est obligatoire lorsque vous utilisez le code de planification *MINUTES.

1-720

Indiquez le nombre de minutes qui doivent s'écouler entre les différentes soumissions du travail.

Calendrier (CAL)

Nom du calendrier que vous voulez utiliser pour le travail. Un calendrier est un ensemble de jours ou de dates défini par l'utilisateur et pouvant être utilisé avec tous les codes de planification, à l'exception de *NONE, *ALTERNATE et *NUMDAY. Les calendriers vous permettent d'ajouter plusieurs dates à un planning en plus des dates planifiées normalement.

*JOBCTL

Le calendrier utilisé est celui indiqué dans l'environnement travaux de JS.

*NONE

Le travail n'utilise pas de calendrier.

nom

Indiquez le nom du calendrier à utiliser pour ce travail.

Calendrier de congés (HDYCAL)

Nom du calendrier de congés à utiliser pour un travail. Un calendrier de congés regroupe un ensemble de jours ou de dates définis par l'utilisateur. Il permet de déterminer le traitement d'un travail.

*JOBCTL

la valeur utilisée est celle indiquée pour le calendrier de congés dans l'environnement travaux de JS.

*NONE

Le travail n'utilise pas de calendrier de congés.

nom

Indiquez le nom du calendrier de congés à utiliser pour le travail.

Calendrier fiscal (FSCCAL)

Nom du calendrier fiscal à utiliser pour le travail indiqué pour le paramètre Travail (JOB). Un calendrier fiscal se compose de 12 ou 13 périodes définies chacune par une date de début et une date de fin.

*JOBCTL

La valeur utilisée est celle indiquée pour le calendrier fiscal dans l'environnement travaux de JS.

*NONE

Il n'existe aucun calendrier fiscal pour ce travail.

nom

Indiquez le nom du calendrier fiscal, défini par l'utilisateur, à utiliser pour ce travail.

Jours (DAY)

Jours souhaités pour le traitement du travail. Ces jours sont indiqués à l'aide des codes de planification *DAILY et *MINUTES ou pour des groupes de travaux dont le numéro de séquence est supérieur à 1.

Ce paramètre admet des valeurs multiples.

*ALL

Le travail doit s'exécuter tous les jours.

*MON

Le travail est planifié pour s'exécuter le lundi.

*TUE

Le travail est planifié pour s'exécuter le mardi.

*WED

Le travail est planifié pour s'exécuter le mercredi.

*THU

Le travail est planifié pour s'exécuter le jeudi.

*FRI

Le travail est planifié pour s'exécuter le vendredi.

*SAT

Le travail est planifié pour s'exécuter le samedi.

*SUN

Le travail est planifié pour s'exécuter le dimanche.

Jour unique (SNGDAY)

Jour de semaine souhaité pour le traitement du travail. Ce jour est indiqué à l'aide des codes de planification *FIRST, *SECOND, *THIRD, *FOURTH, *FIFTH et *LAST.

Remarque :*SUN est le jour de semaine par défaut lorsque vous indiquez *FIRST, *SECOND, *THIRD, *FOURTH, *FIFTH ou *LAST.

*SUN

Le travail est planifié pour s'exécuter le dimanche.

*MON

Le travail est planifié pour s'exécuter le lundi.

*TUE

Le travail est planifié pour s'exécuter le mardi.

*WED

Le travail est planifié pour s'exécuter le mercredi.

*THU

Le travail est planifié pour s'exécuter le jeudi.

*FRI

Le travail est planifié pour s'exécuter le vendredi.

*SAT

Le travail est planifié pour s'exécuter le samedi.

Intervalle (ITVDAY)

Nombre de jours à utiliser comme intervalle avec le code de planification *NUMDAY. Cette zone est obligatoire lorsque vous utilisez le code de planification *NUMDAY.

1-99

Indiquez le nombre de jours qui doivent s'écouler entre les différentes soumissions du travail.

Dates de l'année (DATE)

Dates prévues pour le traitement d'un travail. Ces dates sont entrées au format MMJJ (mois jour) ou JJMM (jour mois) en fonction des valeurs système. Le paramètre DATE est obligatoire lorsque le paramètre Code de planification (SCDCDE) a pour valeur *DATE.

Ce paramètre admet des valeurs multiples.

date

Indiquez une date à laquelle soumettre un travail.

Date unique (SNGDATE)

Date prévue pour le traitement d'un travail. Les dates sont entrées au format MMJJ (mois jour) ou JJMM (jour mois) en fonction du format utilisé par le système. Le paramètre SNGDATE est utilisé lorsque le paramètre Code de planification (SCDCDE) a pour valeur *ONCE.

*NEXT

Le travail doit être traité à l'heure prévue suivante.

date

Indiquez la date unique à laquelle le travail doit être soumis.

Sauvegarde (SAVE)

Indique si le travail, une fois exécuté, doit être sauvegardé. Le paramètre SAVE est utilisé avec le code de planification *ONCE.

*YES

Une fois exécuté, le travail doit être sauvegardé dans IBM Advanced Job Scheduler for i .

*NO

Une fois exécuté, le travail doit être supprimé par IBM Advanced Job Scheduler for i .

Jour du mois (DAYMONTH)

Jours du mois souhaités pour le traitement du travail. Les jours du mois sont indiqués à l'aide du code de planification *DAY.

Vous pouvez indiquer 13 valeurs pour ce paramètre.

1-31

Indiquez le jour du mois auquel le travail doit être traité.

Jours ouvrés (WRKDAY)

Vous permet d'indiquer si les jours spécifiés pour le paramètre Jour du mois (DAYMONTH) ou Intervalle (ITVDAY) sont des jours ouvrés. Les jours ouvrés sont utilisés respectivement avec les codes de planification *DAY et *NUMDAY. Par exemple, avec le code de planification *DAY, si vous indiquez DAYMONTH(05 10) et WRKDAY(*YES), le travail s'exécutera les cinquième et dixième jours ouvrés de chaque mois. Si vous avez indiqué *NO, le travail s'exécute le cinquième et le dixième jour de chaque mois. Les jours ouvrés sont indiqués dans l'environnement système de JS.

Si vous utilisez le code de planification *NUMDAY, l'intervalle choisi dépend des jours ouvrés ou des jours de calendrier, en fonction de ce que vous avez choisi pour le paramètre WRKDAY.

*NO

Les jours ouvrés ne sont pas utilisés conjointement avec le paramètre DAYMONTH ou INTERVAL respectivement.

*YES

Les jours ouvrés sont utilisés conjointement avec le paramètre DAYMONTH ou INTERVAL respectivement.

Période fiscale (FSCPERIOD)

Périodes d'une année fiscale à inclure pour le travail. Ces périodes sont utilisées lorsqu'un nom de calendrier fiscal est indiqué pour le paramètre Calendrier fiscal (FSCCAL).

Valeurs uniques

*ALL

Toutes les périodes doivent être incluses pour le travail.

Autres valeurs (jusqu'à 13 répétitions)

1-13

Indiquez le nombre de périodes fiscales à inclure pour le travail.

Texte (TEXT)

Texte associé au travail.

*NONE

Aucun texte descriptif n'est associé au travail.

valeur-alphanumérique

Entrez le texte descriptif à associer au travail.

Commande à exécuter (CMD)

Commande à exécuter dans le travail. Vous pouvez indiquer une commande, un appel de programme ou transmettre des paramètres à un programme appelé. La validité des commandes est vérifiée et le fichier de paramètres d'IBM Advanced Job Scheduler for i est utilisé pour vérifier la validité des paramètres. L'existence d'objets n'est pas vérifiée dans les travaux faisant l'objet d'un ajout ou d'une modification.

chaîne-commande

Indiquez la commande à exécuter.

Nom de lieu éloigné (RMTLOCNAME)

Lieu et identificateur réseau du système sur lequel doit s'exécuter le travail.

Remarque :Toute valeur indiquée pour le paramètre RMTLOCNAME est ignorée si vous utilisez le code de planification *ALTERNATE.

*JOBCTL

Le nom de lieu éloigné utilisé est celui indiqué dans l'environnement travaux de JS.

*LCL

Exécution du travail sur l'IBM i local.

nom-lieu-éloigné

Indiquez le nom de lieu éloigné associé au système sur lequel doit s'exécuter le travail.

ID-réseau.nom-lieu-éloigné

Indiquez l'identificateur réseau et le nom de lieu éloigné associés au système. Utilisez pour cela le format nnnnnnnn.cccccccc où nnnnnnnn représente l'identificateur réseau et cccccccc, le nom de lieu éloigné.

Plage de plannings (RANGE)

Heures et dates de début et de fin définies pour le travail.

Remarque :Si vous utilisez le code de planification *MINUTES, l'invite Heure de début est utilisée conjointement avec l'invite Heure de fin. *MINUTES est le seul code de planification qui utilise ces deux valeurs pour indiquer le début et la fin d'un travail.

Elément 1 : Heure et date de début

Elément 1 : Heure de début

*NONE

Aucune heure de début n'est définie pour le travail.

0-2400

Indiquez l'heure de début du travail au format HHMM (heure minute).

Elément 2 : Date de début

*NONE

Aucune date de début n'est définie pour le travail.

valeur-alphanumérique

Indiquez la date de début du travail au format de ce dernier.

Elément 2 : Heure et date de fin

Elément 1 : Heure de fin

*NONE

Aucune heure de fin de plage n'est définie pour ce travail.

0-2400

Indiquez l'heure de fin du travail au format HHMM (heure minute).

Elément 2 : Date de fin

*NONE

Aucune date de fin de plage n'est définie pour ce travail.

valeur-alphanumérique

Indiquez la date de fin du travail au format de ce dernier.

Temps d'exécution maximal (MAXRUN)

Temps maximal d'exécution, en minutes, du travail.

Remarque :Toute valeur indiquée à l'invite MAXRUN est ignorée si vous utilisez le code de planification *ALTERNATE.

*NOMAX

Aucun temps maximal d'exécution n'est défini pour le travail.

1-9999

Indiquez la durée maximale (en minutes) prévue pour l'exécution de ce travail. Lorsque le nombre de minutes indiqué est écoulé, IBM Advanced Job Scheduler for i arrête le travail, qu'il soit terminé ou non.

Notification normale (PGRRCPNORM)

Destinataire auquel seront adressés les messages signalant la fin normale du travail que vous ajoutez ou modifiez. Cette zone est utilisée conjointement avec la commande de notification.

Remarque :Des informations de protocole SMTP doivent être indiquées pour que cette fonction puisse être utilisée avec la commande SNDDSTJS (Envoyer une distribution via JS).

Remarque :Les valeurs indiquées pour les zones Destinat. notif. si normal et Message de notification sont les variables de substitution utilisées respectivement pour les variables &RCP et &MSGTXT dans la commande CHGNFYJS.

Vous pouvez indiquer le message à envoyer au destinataire spécifié lorsque l'exécution du travail s'achève normalement.

Valeurs uniques

*NONE

Aucun destinataire de notification ne reçoit de message lorsque le travail se termine normalement.

Elément 1 : Destinataire de notification

*JOBCTL

Le destinataire est celui indiqué dans l'environnement travaux de JS.

*ONCALL

Seuls les destinataires qui sont de garde reçoivent le message.

nom

Indiquez le nom du destinataire auquel seront envoyés les messages signalant la fin normale du travail.

Elément 2 : Message de notification

*JOBCTL

Le destinataire de la notification reçoit le message indiqué dans l'environnement travaux de JS.

*COMP

L'état d'achèvement du travail est envoyé.

valeur-alphanumérique

Indiquez le message à envoyer au destinataire de la notification lorsque le travail s'achève normalement.

Notification anormale (PGRRCPABN)

Destinataire auquel seront adressés les messages signalant la fin anormale du travail que vous ajoutez ou modifiez. Cette zone est utilisée conjointement avec la commande de notification.

Remarque :Des informations de protocole SMTP doivent être indiquées pour que cette fonction puisse être utilisée avec la commande SNDDSTJS.

Remarque :Les valeurs indiquées pour les zones Destinat. notif. si incid. et Message de notification sont les variables de substitution utilisées respectivement pour les variables &RCP et &MSGTXT dans la commande CHGNFYJS.

Vous pouvez indiquer le message à envoyer au destinataire en cas de fin anormale du travail.

Valeurs uniques

*NONE

Aucun destinataire de notification ne reçoit de message lorsque le travail se termine anormalement.

Elément 1 : Destinataire de notification

*JOBCTL

Le destinataire est celui indiqué dans l'environnement travaux de JS.

*ONCALL

Seuls les destinataires qui sont de garde reçoivent le message.

nom

Indiquez le nom du destinataire auquel seront envoyés les messages signalant la fin anormale du travail.

Elément 2 : Message de notification

*JOBCTL

Le destinataire de la notification reçoit le message indiqué dans l'environnement travaux de JS.

*COMP

L'état d'achèvement du travail est envoyé.

valeur-alphanumérique

Indiquez le message à envoyer au destinataire de la notification lorsque le travail s'achève normalement.

Travail démarrage notification (PGRRCPSTR)

Destinataire auquel seront adressés les messages signalant que le travail que vous ajoutez ou modifiez ne démarre pas dans les délais définis après sa soumission. Cette zone est utilisée conjointement avec la commande de notification.

Remarque :Des informations de protocole SMTP doivent être indiquées pour que cette fonction puisse être utilisée avec la commande SNDDSTJS (Envoyer une distribution via JS).

Remarque :Les valeurs indiquées pour la zone Destinat. notif. si pas démarré sont les variables de substitution utilisées respectivement pour la variable &RCP dans la commande CHGNFYJS (Modifier la commande de notification). La variable &MSGTXT est remplacée par le message IJS6059.

Vous pouvez indiquer un délai de démarrage en minutes. Il s'agit de la durée pendant laquelle un travail peut demeurer en file d'attente de travaux avant qu'un message de notification ne soit émis.

Valeurs uniques

*NONE

Aucun destinataire de notification ne reçoit de message lorsque le délai de démarrage est dépassé pour ce travail.

Elément 1 : Destinataire de notification

*JOBCTL

Le destinataire est celui indiqué dans l'environnement travaux de JS.

*ONCALL

Seuls les destinataires qui sont de garde reçoivent le message.

nom

Indiquez le nom du destinataire auquel seront envoyés les messages signalant que le travail n'a pas démarré dans les délais après avoir été soumis.

Elément 2 : Délai de démarrage

*JOBCTL

Le délai de démarrage utilisé est celui qui est défini dans l'environnement travaux de JS.

1-999

Indiquez la durée (en minutes) pendant laquelle un travail peut demeurer en file d'attente de travaux avant qu'un message de notification ne soit émis.

Message d'erreur notification (PGRRCPERR)

Destinataire auquel doivent être adressés les messages d'erreur associés au travail que vous ajoutez ou modifiez. Une notification est émise lorsque le travail est en attente d'un message d'interrogation et lorsque des messages d'erreur sont reçus après traitement d'une commande pour le travail. Cette zone est utilisée conjointement avec la commande de notification.

Remarque :Aucune notification d'erreur n'est émise pour les travaux exécutés sur un système éloigné.

Remarque :Des informations de protocole SMTP doivent être indiquées pour que cette fonction puisse être utilisée avec la commande SNDDSTJS (Envoyer une distribution via JS).

Remarque :Les valeurs indiquées pour le destinataire et pour le message sont les variables de substitution utilisées respectivement pour les variables &RCP et &MSGTXT de la commande CHGNFYJS.

Vous pouvez indiquer le message à envoyer au destinataire de la notification lorsqu'un message d'erreur est généré pour le travail.

Valeurs uniques

*NONE

Aucun destinataire n'est identifié pour une notification en cas de messages d'erreur.

Elément 1 : Destinataire de notification

*JOBCTL

Le destinataire est celui indiqué dans l'environnement travaux de JS.

*ONCALL

Seuls les destinataires qui sont de garde reçoivent le message.

nom

Indiquez le nom du destinataire auquel seront envoyés les messages d'erreur.

Elément 2 : Message de notification

*JOBCTL

Le destinataire de la notification reçoit le message indiqué dans l'environnement travaux de JS.

*ERRMSG

Le message d'erreur proprement dit est envoyé.

*JOBLOG

Le journal du travail est envoyé dans le corps du courrier électronique. Cette option ne peut être utilisée que conjointement avec la commande SNDDSTJS (Envoyer une distribution via JS).

valeur-alphanumérique

Indiquez le message à envoyer au destinataire de la notification lorsqu'un message d'erreur est généré pour le travail.

Travail alterné (ALTJOB)

Nom du travail alterné associé au travail que vous ajoutez. Les travaux alternés ne s'exécutent qu'en cas de fin anormale d'un travail de base. Un travail alterné ne doit pas nécessairement être défini pour tout travail. Si vous souhaitez sélectionner un travail dans une liste de travaux, placez le curseur sur ce paramètre et appuyez sur F4.

Vous pouvez également indiquer un groupe et un numéro de séquence dans un groupe si le travail alterné est membre d'un groupe.

Valeurs uniques

*NONE

Le travail n'est associé à aucun travail alterné.

Elément 1 : Travail

nom

Indiquez le nom du travail alterné à associer à ce travail.

Elément 2 : Groupe

*NONE

Le travail alterné n'est associé à aucun groupe alterné.

nom

Indiquez le nom du groupe auquel appartient le travail alterné associé à ce travail.

Elément 3 : Séquence dans le groupe

*NONE

Aucun numéro de séquence n'est attribué au travail alterné.

1-99

Indiquez le numéro de séquence attribué au travail alterné.

ID distribution de rapport (RPTDSTID)

ID utilisé pour la distribution des rapports générés à l'issue du traitement du travail.

*NONE

Le travail n'a pas d'ID distribution de rapport.

nom

Indiquez l'ID distribution de rapport que vous souhaitez associer à ce travail.

Action de reprise (RCYACN)

Action de reprise à effectuer lorsque le travail ne peut pas être soumis à l'heure planifiée en raison de la mise hors tension ou de l'état restreint du système. L'action indiquée par le paramètre est effectuée à l'IPL suivant ou lorsque IBM Advanced Job Scheduler for i redevient actif.

Les travaux soumis pendant l'IPL ou lorsque le système n'est plus à l'état restreint, sont traités selon l'ordre qui aurait été suivi s'ils avaient été soumis aux heures indiquées dans le planning des travaux. Si plusieurs exécutions d'un travail itératif sont manquées, le travail n'est soumis qu'une seule fois. Le décompte des exécutions manquées est calculé à partir de la date du jour.

Etant donné que l'IPL du système peut être terminé sans que l'IPL de la partie planificateur le soit, d'autres travaux peuvent être démarrés sur le système avant que tous les travaux planifiés aient été soumis.

Ce paramètre ne s'applique pas lorsqu'un travail suspendu est libéré.

Remarque :Toute valeur indiquée pour le paramètre RCYACN est ignorée si vous utilisez les code de planification *ALTERNATE ou *NONE.

*JOBCTL

L'action de reprise effectuée est celle indiquée dans l'environnement travaux de JS.

*SBMRLS

Le travail est soumis à l'état libéré (RLS).

*SBMHLD

Le travail est soumis à l'état suspendu (HLD).

*NOSBM

Le travail n'est pas soumis.

La valeur *NOSBM n'affecte que les occurrences non traitées. Dans le cas d'un travail itératif, cette valeur est sans effet sur les occurrences suivantes.

Description de travail (JOBD)

Description de travail à utiliser avec le travail.

Valeurs uniques

*JOBCTL

La description utilisée est celle indiquée dans l'environnement travaux de JS.

*USRPRF

La description de travail utilisée est celle indiquée dans le profil utilisateur associé au travail soumis.

Nom qualifié 1 : Description de travail

nom

Indiquez le nom de la description utilisée pour le travail.

Nom qualifié 2 : Bibliothèque

*LIBL

La description de travail est recherchée dans la liste des bibliothèques.

*CURLIB

Le nom de la description du travail est recherché dans la bibliothèque en cours. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours, QGPL est utilisée.

nom

Indiquez le nom de la bibliothèque contenant la description de travail.

File d'attente de travaux (JOBQ)

File d'attente de travaux dans laquelle doit être placé le travail.

Valeurs uniques

*JOBCTL

Le travail est placé dans la file d'attente de travaux indiquée dans l'environnement travaux de JS.

*JOBD

Le travail soumis est placé dans la file d'attente de travaux indiquée dans la description de travail.

Nom qualifié 1 : File d'attente de travaux

nom

Indiquez le nom de la file d'attente de travaux dans laquelle doit être placé le travail soumis.

Nom qualifié 2 : Bibliothèque

*LIBL

La file d'attente de travaux est recherchée dans la liste des bibliothèques.

*CURLIB

Le nom de la file d'attente de travaux est recherché dans la bibliothèque en cours. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours, QGPL est utilisée.

nom

Indiquez le nom de la bibliothèque contenant la file d'attente de travaux.

Priorité du travail (JOBQ) (JOBPTY)

Priorité attribuée aux travaux planifiés lorsqu'ils sont placés en file d'attente. Les valeurs admises sont comprises entre 1 et 9, 1 désignant la priorité la plus élevée et 9, la priorité la plus faible.

*JOBCTL

La priorité utilisée est celle indiquée dans l'environnement travaux de JS.

*JOBD

La priorité utilisée est celle indiquée dans la description du travail.

1-9

Indiquez une valeur de priorité de planification pour le travail.

Priorité en sortie (OUTQ) (OUTPTY)

Priorité en file d'attente en sortie pour les fichiers spoule générés par ce travail. Les valeurs admises sont comprises entre 1 et 9, 1 désignant la priorité la plus élevée et 9, la priorité la plus faible.

*JOBCTL

La priorité en sortie utilisée est celle indiquée dans l'environnement travaux de JS.

*JOBD

La priorité en sortie utilisée est celle indiquée dans la description du travail.

1-9

Indiquez une valeur de priorité en sortie pour le travail.

Unité imprimante (PRTDEV)

Nom qualifié de l'imprimante par défaut utilisée pour ce travail.

*JOBCTL

L'unité imprimante utilisée est celle indiquée dans l'environnement travaux de JS.

*CURRENT

L'unité imprimante utilisée est celle associée au travail en cours d'exécution.

*USRPRF

L'unité imprimante utilisée est celle indiquée dans le profil utilisateur associé au travail soumis. Son nom est recherché dans le profil utilisé pour la soumission de ce travail.

*SYSVAL

L'unité imprimante utilisée est celle indiquée dans la valeur système, QPRTDEV, lors de la soumission du travail.

*JOBD

L'unité imprimante utilisée est celle indiquée dans la description du travail soumis.

nom

Indiquez le nom de l'unité imprimante utilisée pour le travail soumis.

File d'attente en sortie (OUTQ)

File d'attente en sortie à utiliser pour les fichiers spoule générés par le travail. Ce paramètre ne s'applique qu'aux fichiers imprimante spoule pour lesquels la valeur de file d'attente en sortie est *JOB.

Valeurs uniques

*JOBCTL

La file d'attente en sortie utilisée est celle indiquée dans l'environnement travaux de JS.

*USRPRF

La file d'attente en sortie utilisée est celle indiquée dans le profil utilisateur associé au travail soumis.

*DEV

La file d'attente en sortie utilisée est celle qui est associée à l'unité imprimante pour le fichier spoule.

*JOBD

La file d'attente en sortie utilisée est celle indiquée dans la description du travail soumis.

Nom qualifié 1 : File d'attente en sortie

nom

Indiquez le nom de la file d'attente en sortie à utiliser par défaut pour le travail soumis.

Nom qualifié 2 : Bibliothèque

*LIBL

La file d'attente en sortie est recherchée dans la liste des bibliothèques.

*CURLIB

Le nom de la file d'attente en sortie est recherché dans la bibliothèque en cours. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours, QGPL est utilisée.

nom

Indiquez le nom de la bibliothèque contenant la file d'attente en sortie.

Utilisateur (USER)

Nom du profil utilisateur associé au travail soumis. Si la description du travail mentionne *RQD, il convient de ne pas indiquer *JOBD mais un nom de profil utilisateur.

Remarque : Les profils IBM ci-après ne sont pas admis pour ce paramètre.

• QDBSHR
• QDFTOWN
• QDOC
• QLPAUTO
• QLPINSTALL
• QRJE
• QSECOFR
• QSPL
• QSYS
• QTSTRQS

*JOBCTL

Le profil utilisateur défini dans l'environnement travaux de JS est utilisé pour le travail soumis.

*CURRENT

Le profil utilisé est celui du travail en cours d'exécution.

*JOBD

Le profil utilisé est celui indiqué dans la description du travail.

nom

Indiquez le nom du profil utilisé pour le travail soumis. Vous devez détenir des droits sur le profil utilisateur qui doit lui-même posséder des droits sur la description de travail.

Texte à imprimer (PRTTXT)

Texte (30 caractères maximum) imprimé au bas de chaque page et sur les pages intercalaires.

*JOBCTL

La valeur utilisée est celle indiquée dans l'environnement travaux de JS.

*JOBD

La valeur utilisée est celle indiquée dans la description du travail.

*SYSVAL

La valeur système QPRTTXT est utilisée pour ce travail.

*BLANK

Aucun texte n'est imprimé.

valeur-alphanumérique

Indiquez la chaîne de caractères qui doit s'imprimer au bas de chaque page. Vous pouvez entrer 30 caractères au maximum, placés entre apostrophes. Le texte est centré tel que vous l'avez entré.

Données de routage (RTGDTA)

Données de routage utilisées pour démarrer la première phase d'activation du travail. Ces données permettent de déterminer le poste de routage identifiant le programme exécuté par le travail.

*JOBCTL

Les données de routage utilisées sont celles indiquées dans l'environnement travaux de JS.

*JOBD

Les données de routage utilisées sont celles indiquées dans la description du travail.

valeur-alphanumérique

Indiquez la chaîne de caractères constituant les données de routage du travail. Un maximum de 80 caractères, placés entre apostrophes, est admis.

Bibliothèque en cours (CURLIB)

Nom de la bibliothèque en cours associée au travail en cours d'exécution.

*JOBCTL

La bibliothèque en cours utilisée est celle indiquée dans l'environnement travaux de JS.

*USRPRF

La bibliothèque utilisée est celle définie dans le profil utilisateur associé au travail soumis.

*CRTDFT

Aucune bibliothèque en cours n'est définie pour le travail soumis. Si des objets sont créés dans la bibliothèque en cours, QGPL est utilisée comme bibliothèque en cours par défaut.

nom

Indiquez le nom de la bibliothèque utilisée pour le travail soumis.

Liste de bibliothèques (LIBL)

Indique le nom de la liste de bibliothèques utilisée pour rechercher les noms d'objet du système d'exploitation non qualifiés d'un nom de bibliothèque. Si vous souhaitez sélectionner une bibliothèque dans une liste de bibliothèques, placez le curseur sur ce paramètre et appuyez sur F4.

*JOBCTL

La liste de bibliothèques utilisée est celle indiquée dans l'environnement travaux de JS.

*JOBD

La partie utilisateur de la liste de bibliothèques utilisée est celle indiquée dans la description de travail.

*SYSVAL

La liste de bibliothèques utilisateur par défaut est utilisée par ce travail. Elle contient les noms de bibliothèque indiqués dans la valeur système QUSRLIBL au démarrage du travail.

*NONE

La partie utilisateur de la liste de bibliothèques initiale pour ce travail ne comportera aucune entrée.

nom

Indiquez le nom de la liste de bibliothèques que vous souhaitez utiliser pour ce travail.

Consignation des messages (LOG)

Valeurs qui déterminent la quantité et le type d'informations consignées dans le journal du travail. Ce paramètre se décompose en trois parties : le niveau de consignation, le niveau de gravité et le niveau du texte du message. Si vous n'indiquez aucune valeur pour ce paramètre, les valeurs spécifiées dans la description de travail associée à ce travail sont utilisées.

Elément 1 : Niveau

*JOBCTL

La valeur utilisée est celle indiquée dans l'environnement travaux de JS.

*JOBD

La valeur utilisée est celle indiquée dans la description du travail.

0-4

Indiquez une valeur pour le niveau de consignation des messages à utiliser pour les messages de ce travail. Les niveaux de consignation possibles sont les suivants :

0

Aucune donnée n'est consignée.

1

Les informations suivantes sont consignées : tous les messages envoyés à la file d'attente de messages externe et ayant un niveau de gravité supérieur ou égal à la gravité définie (y compris les indications de début, de fin et d'achèvement du travail).

2

Les informations suivantes sont consignées :

• Informations de niveau 1.
• Demandes ou commandes consignées à partir d'un programme CL pour lequel des messages sont émis avec un code de gravité supérieur ou égal à la gravité définie.
• Ensemble des messages associés à une demande, ou commandes consignées à partir d'un programme CL, accompagnés d'un message de haut niveau avec un code de gravité supérieur ou égal à la gravité définie.

3

Les informations suivantes sont consignées :

• Informations de niveau 1.
• Ensemble des demandes ou commandes consignées à partir d'un programme CL.
• Ensemble des messages associés à une demande, ou commandes consignées à partir d'un programme CL, accompagnés d'un message de haut niveau avec un code de gravité supérieur ou égal à la gravité définie.

4

Les informations suivantes sont consignées : ensemble des demandes ou commandes consignées à partir d'un programme CL et ensemble des messages (y compris les messages de trace) dont le code de gravité est supérieur ou égal à la gravité définie.

Remarque :Un message de haut niveau est un message envoyé dans la file d'attente de messages du programme qui a reçu la demande ou les commandes consignées à partir d'un programme CL.

Elément 2 : Gravité

*JOBCTL

La valeur utilisée est celle indiquée dans l'environnement travaux de JS.

*JOBD

La valeur utilisée est celle indiquée dans la description du travail.

0-99

Indiquez le niveau de gravité le plus faible à partir duquel un message d'erreur est consigné dans le journal du travail.

Elément 3 : Texte

*JOBCTL

La valeur utilisée est celle indiquée dans l'environnement travaux de JS.

*JOBD

La valeur utilisée est celle indiquée dans la description du travail.

*MSG

Seul le texte du message est consigné dans le journal du travail ou présenté à l'utilisateur.

*SECLVL

Le texte et l'aide du message sont consignés dans le journal du travail ou présentés à l'utilisateur.

*NOLIST

Aucun journal n'est généré pour un travail qui se termine de façon normale. Lorsqu'un travail se termine de façon anormale (code de fin de travail égal ou supérieur à 20), un journal est généré pour le travail. Ce journal contient à la fois le texte et l'aide des messages.

Consignation commandes CL (LOGCLPGM)

Indique si les commandes exécutées dans un programme CL sont consignées dans le journal du travail via la file d'attente de messages de ce programme. Ce paramètre définit l'état de l'indicateur de consignation pour le travail. Si la valeur *JOB est spécifiée au paramètre LOG de la commande CRTCLPGM (Créer un programme CL), la valeur correspondant à ce paramètre est utilisée. Si d'autres valeurs sont indiquées pour le paramètre LOG, elles remplacent la valeur fournie pour ce paramètre. Les commandes sont consignées de la même manière que les demandes.

*JOBCTL

La valeur utilisée est celle indiquée dans l'environnement travaux de JS.

*JOBD

La valeur utilisée est celle définie dans la description du travail.

*YES

Les commandes de programme CL sont consignées dans le journal du travail.

*NO

Les commandes de programme CL ne sont pas consignées dans le journal du travail.

Réponse messages d'interrog (INQMSGRPY)

Mode de réponse aux messages prédéfinis envoyés à la suite de l'exécution de ce travail. Vous pouvez demander qu'aucune modification ne soit apportée au mode de réponse existant, qu'une réponse soit apportée à tous les messages, qu'une réponse par défaut soit émise ou qu'une réponse appropriée soit recherchée dans la liste de réponses du système.

*JOBCTL

La valeur utilisée pour la réponse aux messages d'interrogation est celle indiquée dans l'environnement travaux de JS.

*JOBD

La valeur utilisée pour la réponse aux messages d'interrogation est celle définie dans la description du travail.

*RQD

Une réponse est requise de la part du destinataire de tout message d'interrogation émis lors de l'exécution de cette commande.

*DFT

La réponse par défaut est utilisée pour répondre à tous les messages d'interrogation envoyés pendant l'exécution de cette commande.

*SYSRPYL

Le système recherche dans sa liste de réponses un message dont l'ID et les données correspondent à ceux du message d'interrogation émis à la suite de l'exécution de ce travail. Si une correspondance existe, la réponse contenue dans le message trouvé est utilisée. Si aucun poste n'existe pour ce message, une réponse est requise.

Suspendre en file de travaux (HOLD)

Indique si ce travail est suspendu lorsqu'il est placé en file d'attente de travaux. Un travail suspendu placé en file d'attente conserve cet état jusqu'à ce qu'il soit libéré par la commande RLSJOB ou bien arrêté par la commande ENDJOB ou CLRJOBQ.

*JOBCTL

La valeur utilisée pour la suspension en file d'attente de travaux est celle indiquée dans l'environnement travaux de JS.

*JOBD

La valeur indiquée dans la description de travail détermine si le travail est suspendu lorsqu'il est placé en file d'attente de travaux.

*YES

Le travail est suspendu lorsqu'il est placé en file d'attente de travaux, et le reste jusqu'à ce qu'il soit libéré par la commande RLSJOB (Libérer un travail) ou arrêté par la commande ENDJOB (Arrêter un travail).

*NO

Le travail n'est pas suspendu lorsqu'il est placé en file d'attente.

Indicateurs externes (SWS)

Etat initial des huit indicateurs externes du travail. Ces indicateurs peuvent être définis ou testés dans un programme CL et utilisés pour contrôler le flux du programme. Seules les valeurs 1 (actif) ou 0 (inactif) peuvent être indiquées dans la chaîne de 8 caractères.

*JOBCTL

La valeur utilisée pour les indicateurs externes est celle indiquée dans l'environnement travaux de JS.

*JOBD

La valeur indiquée dans la description du travail détermine l'état initial des indicateurs externes du travail.

valeur-alphanumérique

Indiquez une combinaison quelconque de 8 chiffres (0 et 1) qui définira l'état initial des indicateurs externes du travail soumis.

File d'attente de messages (MSGQ)

Indique le nom de la file d'attente de messages dans laquelle est envoyé le message d'achèvement après l'exécution du travail soumis (fin normale ou anormale). Si une fin anormale a lieu, vous trouverez les causes possibles de l'incident dans l'aide du message d'achèvement.

Valeurs uniques

*JOBCTL

La valeur utilisée pour la file d'attente de messages est celle de l'environnement travaux de JS.

*USRPRF

Le message d'achèvement est envoyé dans la file d'attente de messages indiquée dans le profil utilisateur du demandeur.

*NONE

Aucun message d'achèvement n'est envoyé.

Nom qualifié 1 : File d'attente de messages

nom

Indiquez le nom de la file d'attente de messages dans laquelle est envoyé le message d'achèvement.

Nom qualifié 2 : Bibliothèque

*LIBL

La file d'attente de messages est recherchée dans la liste de bibliothèques.

*CURLIB

La file d'attente de messages est recherchée dans la bibliothèque en cours du travail. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours, QGPL est utilisée.

nom

Indiquez le nom de la bibliothèque contenant la file d'attente de messages.

Code comptabilité (ACGCDE)

Code comptabilité indiqué lors de la consignation de l'utilisation des ressources système pour les travaux associés à cette description.

*JOBCTL

Le code comptabilité des travaux utilisant cette description est celui indiqué dans l'environnement travaux de JS.

*JOBD

Le code comptabilité des travaux utilisant cette description est celui indiqué dans la description de travail.

*USRPRF

Le code comptabilité des travaux utilisant cette description est celui indiqué dans le profil utilisateur associé au travail.

*BLANK

Un code comptabilité constitué de 15 blancs est attribué aux travaux qui utilisent cette description.

valeur-alphanumérique

Indiquez le code comptabilité souhaité pour les travaux qui utilisent cette description.

Priorité d'exécution (RUNPTY)

Priorité d'exécution du travail. La valeur de priorité d'exécution est comprise entre 1 (priorité la plus élevée) et 99 (priorité la plus basse). Elle est utilisée lorsque plusieurs travaux sont en conflit pour l'utilisation des ressources de la machine. Cette valeur représente l'importance relative (et non absolue) du travail. Si le travail est redirigé, cette valeur est réinitialisée selon l'importance du travail dans la classe de travail.

*JOBCTL

La priorité d'exécution est extraite de l'environnement travaux de JS.

*NOCHG

La priorité d'exécution n'est pas modifiée lors du démarrage du traitement des travaux.

01-99

Indiquez la priorité d'exécution à utiliser.

Groupe ASP initial (INLASPGRP)

Paramètre initial pour le nom de groupe ASP de l'unité d'exécution initiale du travail soumis. La commande SETASPGRP peut être utilisée par une unité d'exécution pour modifier l'espace de nom de sa bibliothèque. Lorsqu'un groupe ASP est associé à une unité d'exécution, toutes les bibliothèques des ASP indépendants dans le groupe ASP sont alors accessibles et tous les objets qu'elles contiennent peuvent être référencés à l'aide d'une syntaxe de nom d'objet standard. Les bibliothèques des ASP indépendants du groupe ASP, ajoutées aux bibliothèques de l'ASP système (ASP numéro 1) et aux ASP utilisateur de base (ASP 2 à 32) constituent l'espace de nom de bibliothèque pour l'unité d'exécution.

*JOBCTL

Le groupe ASP initial est obtenu à partir de l'environnement travaux de JS.

*CURRENT

Le nom de groupe ASP de l'unité d'exécution en cours est utilisé pour le travail soumis.

*JOBD

Le nom de groupe ASP est celui indiqué dans la description du travail soumis.

*NONE

Indique que l'unité d'exécution initiale du travail soumis sera lancée sans groupe ASP. L'espace de nom de bibliothèque ne contient alors aucune bibliothèque de groupe ASP. Seules les bibliothèques de l'ASP système et des ASP utilisateur de base figurent alors dans l'espace de nom de bibliothèque.

nom

Indiquez le nom du groupe ASP initial à définir pour l'unité d'exécution initiale du travail soumis. Ce nom correspond au nom de l'ASP principal dans le groupe ASP. Toutes les bibliothèques de tous les ASP de ce groupe sont alors incluses dans l'espace de nom de bibliothèque.

Autres commandes (ADLCMD)

Commandes supplémentaires que vous voulez inclure dans le travail. Vous pouvez indiquer une commande, un appel de programme ou transmettre des paramètres à un programme appelé. La validité des commandes est vérifiée et le fichier de paramètres d'IBM Advanced Job Scheduler for i est utilisé pour vérifier la validité des paramètres. L'existence d'objets n'est pas vérifiée dans les travaux faisant l'objet d'un ajout ou d'une modification.

Vous pouvez indiquer 4 valeurs pour ce paramètre.

valeur-alphanumérique

Indiquez les autres commandes à exécuter.

Exemples

Exemple 1 : Ajout d'un travail

ADDJOBJS   JOB(JOB01)  TIME(1000)

Cette commande ajoute un travail au planning des travaux. Dans cet exemple, le travail JOB01 est ajouté au planning des travaux et son exécution est prévue à 10:00. Le code de planification par défaut pour ce travail est *DAILY et le paramètre DAY a pour valeur *ALL.

Exemple 2 : Ajout d'un travail avec un code de planification *CALENDAR

ADDJOBJS   JOB(JOB02) SCDCDE(*CALENDAR)  CAL(CAL)
           TIME(1100)  CMD(WRKACTJOB)

Cette commande ajoute le travail JOB02 dans Job Scheduler. L'exécution du travail est prévue à 11:00 avec un code de planification *CALENDAR et un calendrier appelé CAL. Lorsque le travail s'exécute, il traite la commande WRKACTJOB.

Messages d'erreur