ADDJOBSCDE

La commande ADDJOBSCDE (Ajouter poste planning travaux) permet à l'utilisateur d'ajouter un poste au planning des travaux. Vous pouvez utiliser cette commande pour planifier un travail par lots à soumettre une seule fois ou plusieurs fois à intervalles réguliers.

Chaque poste du planning des travaux comprend toutes les informations nécessaires pour soumettre un travail : la commande exécutée, la description de travail et le profil utilisateur associés à ce travail, la file d'attente de travaux et la file d'attente de messages.

Le travail est soumis aux date et heure précisées dans la commande, puis il est placé dans la file d'attente de travaux indiquée. Cependant, cette commande ne permet pas de garantir que le travail sera exécuté à l'heure planifiée. L'exécution ne sera pas lancée si la file d'attente de travaux est mise en suspens ou si elle n'est pas associée à un sous-système, ou si le nombre maximum de travaux actifs exécutés dans le sous-système ou une seule fois dans le système a été atteint.

Chaque poste du planning des travaux est identifié par un nom de travail indiqué au paramètre JOB de cette commande et par un numéro que le système attribue à ce poste lorsqu'il est ajouté. Le texte de remplacement du message envoyé pour chaque nouveau poste contient le numéro du poste. Si plusieurs postes ont le même nom de travail, vous devrez peut-être préciser le numéro de poste pour modifier le poste à l'aide de la commande CHGJOBSCDE (Modifier poste planning travx), supprimer le poste à l'aide de la commande RMVJOBSCDE (Enlever poste planning travaux) ou pour suspendre ou libérer un poste du planning des travaux à l'aide de la commande HLDJOBSCDE (Suspendre poste planning travx) ou RLSJOBSCDE (Libérer poste planning travaux). Vous pouvez utiliser la commande WRKJOBSCDE (Gérer postes planning travaux) pour afficher ou imprimer des postes.

Pour plus de détails, reportez-vous au manuel Ensemble de rubriques Gestion des travaux de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restrictions :

1. Pour utilisez cette commande, vous devez disposer des droits suivants :
   • Le droit d'utilisation (*USE) sur la commande spécifiée par le paramètre CMD (Commande à exécuter) et le droit d'exécution (*EXECUTE) sur la bibliothèque contenant cette commande.
   • Le droit d'utilisation (*USE) sur la description de travail (JOBD) et le droit d'exécution (*EXECUTE) sur la bibliothèque contenant cette description.
   • Le droit d'utilisation (*USE) sur la file d'attente (JOBQ) et le droit d'exécution (*EXECUTE) sur la bibliothèque contenant cette file d'attente. Un droit à la file d'attente de travaux ne provient pas des droits adoptés.
   • Le droit d'utilisation (*USE) sur le profil utilisateur (USER) à exécuter.
   • Le droit d'utilisation (*USE), le droit d'ajout (*ADD) sur la file d'attente de messages (MSGQ) et le droit d'exécution (*EXECUTE) sur la bibliothèque contenant cette file d'attente de messages. Un droit à la file d'attente de messages ne provient pas des droits adoptés.
   • Le droit de modification (*CHANGE) sur l'objet QDFTJOBSCD, le type *JOBSCD, dans la bibliothèque QUSRSYS et le droit d'exécution (*EXECUTE) sur la bibliothèque QUSRSYS.

Paramètres

Travail (JOB)

Indique le nom du poste de planning des travaux.

Ce paramètre est obligatoire.

*JOBD

La description de travail indiquée pour le paramètre JOBD est utilisée pour le nom du poste ajouté au planning des travaux.

nom

Indiquez le nom du poste de planning des travaux.

Remarque :Afin de ne pas supprimer, suspendre ou libérer des postes créés par des produits IBM lorsque vous effectuez l'une de ces opérations sur vos propres postes à l'aide de noms génériques, n'ajoutez pas de postes dont les noms de travaux commencent par la lettre Q.

Commande à exécuter (CMD)

Indique la commande exécutée par le travail soumis. La commande spécifiée étant utilisée pour les données de requête, la valeur affectée au paramètre RQSDTA dans la description de travail est ignorée. De plus, cette commande fait l'objet d'un contrôle de syntaxe lorsque le poste est ajouté.

Ce paramètre est obligatoire.

chaîne-commande

Indiquez une commande comportant 512 caractères au maximum.

Fréquence (FRQ)

Indique la fréquence de soumission du travail.

Ce paramètre est obligatoire.

*ONCE

Le travail n'est soumis qu'une fois.

*WEEKLY

Le travail est soumis le(s) même(s) jour(s) de chaque semaine, à l'heure planifiée.

*MONTHLY

Le travail est soumis le(s) même(s) jour(s) de chaque mois, à l'heure planifiée.

Si vous choisissez la valeur *MONTHLY alors que le jour indiqué au paramètre SCDDATE n'existe pas pour un mois donné, le travail n'est pas soumis ce mois-là. Par exemple, si vous indiquez les paramètres SCDDATE(01/31/2004) et FRQ(*MONTHLY), le travail sera soumis le 31/01, 31/03, 31/05, 31/07, 31/08, 31/10 et le 31/12, et non pas en février, avril, juin, septembre ou novembre. Pour soumettre un travail le dernier jour du mois, utilisez le paramètre SCDDATE(*MONTHEND).

Si vous choisissez la valeur *MONTHLY alors que votre système ou votre travail est configuré avec un format de date julien, celui-ci n'est pas pris en compte.

*YEARLY

Le travail est soumis une fois par an à la même date.

Si vous spécifiez *YEARLY, vous devez préciser une date au paramètre SCDDATE.

Si vous choisissez la valeur *YEARLY alors que la date indiquée au paramètre SCDDATE n'existe pas pour une année donnée, le travail n'est pas soumis ce année.

Date planifiée (SCDDATE)

Indique la date choisie pour la soumission du travail.

Si votre système ou votre travail est configuré avec un format de date julien, celui-ci n'est pas pris en compte pour le calcul des valeurs *MONTHSTR et *MONTHEND.

Les paramètres SCDDATE et SCDDAY sont incompatibles.

*CURRENT

La date de soumission du travail est la date du jour.

*MONTHSTR

Le travail est soumis le premier jour du mois. Si vous entrez la valeur *MONTHSTR à cette date et si l'heure indiquée au paramètre SCDTIME n'est pas encore passée, le travail est soumis le jour même. Dans le cas contraire, il est présenté le premier jour du mois suivant.

*MONTHEND

Le travail est soumis le dernier jour du mois. Si vous entrez la valeur *MONTHEND à cette date et si l'heure indiquée au paramètre SCDTIME n'est pas encore passée, ce travail est soumis le jour même. Dans le cas contraire, il est présenté le dernier jour du mois suivant.

*NONE

Aucune date de début n'est indiquée. Si vous indiquez la valeur *NONE au paramètre SCDDATE, vous ne pouvez pas utiliser cette valeur pour le paramètre SCDDAY.

date

Indiquez une date dans le format de date utilisé pour le travail.

Jour planifié (SCDDAY)

Indique le jour de la semaine choisi pour la soumission du travail.

Les paramètres SCDDATE et SCDDAY sont incompatibles.

Si la date du jour est indiquée au paramètre SCDDAY et si l'heure indiquée au paramètre SCDTIME n'est pas encore passée, le travail est soumis le jour même. Dans le cas contraire, il est soumis le même jour de la semaine suivante. Par exemple, si vous indiquez les paramètres SCDDAY(*FRI) et SCDTIME(12:00:00) et si vous ajoutez ce poste au planning des travaux un vendredi à 11:00, le travail est soumis le jour même. En revanche, si vous ajoutez ce poste un vendredi à 16:00 ou un lundi à 11:00, le travail est soumis le vendredi suivant.

Valeurs uniques

*NONE

Aucun jour de début n'est indiqué. Cette valeur ne peut être utilisée si elle est déjà indiquée au paramètre SCDDATE.

*ALL

Le travail est soumis tous les jours.

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

*MON

Le travail est soumis le lundi.

*TUE

Le travail est soumis le mardi.

*WED

Le travail est soumis le mercredi.

*THU

Le travail est soumis le jeudi.

*FRI

Le travail est soumis le vendredi.

*SAT

Le travail est soumis le samedi.

*SUN

Le travail est soumis le dimanche.

Heure planifiée (SCDTIME)

Indique l'heure à la date planifiée pour la soumission du travail.

Remarque :Vous pouvez préciser l'heure à la seconde près, mais il est possible que le travail ne démarre pas à l'heure exacte, compte tenu du temps nécessaire pour soumettre le travail et la charge du système.

*CURRENT

L'heure de soumission du travail est l'heure actuelle. Si vous choisissez les paramètres SCDTIME(*CURRENT) et SCDDATE(*CURRENT), le travail est immédiatement placé dans la file d'attente de travaux indiquée.

heure

Indiquez l'heure à laquelle vous souhaitez soumettre le travail. Pour cela, utilisez le format 24 heures, avec ou sans séparateur :

• Si vous n'utilisez pas de séparateur, entrez une chaîne de 4 ou 6 chiffres (hhmm ou hhmmss) où hh représente les heures, mm, les minutes et ss, les secondes. Les valeurs correctes pour la plage hh vont de 00 à 23. Les valeurs correctes pour les plages mm et ss vont de 00 à 59.
• Si vous utilisez un séparateur, entrez une chaîne de 5 ou 8 caractères dans laquelle le séparateur spécifié pour le travail permet de séparer les heures, les minutes et les secondes. Si la commande est entrée depuis une ligne de commande, la chaîne doit être placée entre apostrophes. Si vous utilisez un séparateur différent, la commande ne peut pas aboutir.

Jour relatif du mois (RELDAYMON)

Indique le jour relatif (du mois) choisi pour la soumission du travail.

Ce paramètre doit être utilisé uniquement si une valeur est indiquée pour le paramètre SCDDAY (Date planifiée) et si le paramètre FRQ (Fréquence) est affecté de la valeur *MONTHLY.

Vous pouvez affecter 5 valeurs à ce paramètre.

1

Le travail est soumis une fois par mois, à la première occurrence du jour indiqué. Par exemple, si vous indiquez SCDDAY(*TUE), FRQ(*MONTHLY) et RELDAYMON(1), le travail est soumis le premier jeudi de chaque mois.

2

Le travail est soumis une fois par mois, à la deuxième occurrence du jour indiqué.

3

Le travail est soumis une fois par mois, à la troisième occurrence du jour indiqué.

4

Le travail est soumis une fois par mois, à la quatrième occurrence du jour indiqué.

5

Le travail est soumis une fois par mois, à la cinquième occurrence du jour indiqué.

*LAST

Le travail est soumis une fois par mois, à la dernière occurrence du jour indiqué.

Sauvegarde (SAVE)

Indique si le poste d'un travail soumis une seule fois est conservé après cette opération. Ce paramètre peut être utilisé uniquement si le paramètre FRQ (Fréquence) est affecté de la valeur *ONCE.

*NO

Le poste est enlevé une fois le travail soumis.

*YES

Le poste est conservé après la soumission du travail. Lorsque vous précisez *YES, ce travail n'est soumis qu'une fois. Si vous souhaitez le soumettre à nouveau, indiquez une nouvelle date et une nouvelle heure à l'aide de la commande CHGJOBSCDE (Modifier poste planning travx).

Omettre la date (OMITDATE)

Indique un nombre maximal de 20 dates auxquelles le travail ne sera pas soumis. Vous pouvez, par exemple, utiliser ce paramètre pour éviter de soumettre des travaux répétitifs lors des vacances. Le format de date doit correspondre à celui utilisé pour le travail.

*NONE

Aucune date n'est indiquée.

date

Indiquez une date à laquelle un travail n'est pas soumis.

Action de reprise (RCYACN)

Indique la procédure à suivre si l'état du système (hors tension ou restreint) ne permet pas de soumettre le travail à l'heure planifiée. L'action indiquée pour ce paramètre sera effectuée au cours de la prochaine procédure de chargement initial (IPL) ou lorsque le système ne sera plus à l'état restreint.

Les travaux soumis durant un IPL ou lorsque le système n'est plus à l'état restreint sont présentés dans l'ordre correspondant à celui des heures indiquées dans le planning des travaux. Si plusieurs soumissions d'un travail ne sont pas effectuées, ce travail n'est soumis qu'une seule fois. Les travaux sont classés à partir de la première fois où un travail répétitif n'a pas été soumis et la fois suivante est calculée depuis la date du jour.

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

Ce paramètre n'est pas applicable dans les cas suivants :

• Lorsqu'un travail est libéré après avoir été suspendu à la date et à l'heure de soumission planifiées.
• Lorsque la date et l'heure de soumission planifiées pour un travail sont passées en raison de la modification des valeurs système de date et d'heure

*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 soumissions du travail non effectuées. Si le poste du planning des travaux correspond à un travail répétitif, les soumissions futures sont exécutées.

Description de travail (JOBD)

Indique le nom qualifié de la description de travail utilisée lors de sa soumission.

Valeurs uniques

*USRPRF

La description de travail est celle indiquée dans le profil utilisateur associé au travail soumis. Le paramètre USER définit le profil utilisateur.

Qualificatif 1 : Description de travail

nom

Indiquez le nom de la description de travail.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de l'unité d'exécution jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La bibliothèque en cours pour l'unité d'exécution permet de localiser l'objet. Si celle-ci n'est indiquée, QGPL est prise par défaut.

nom

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

File d'attente de travaux (JOBQ)

Indique le nom qualifié de la file d'attente de travaux dans laquelle le travail est placé.

Pour utiliser ce paramètre, vous devez disposer du droit d'accès à la file d'attente. Un droit à la file d'attente ne provient pas des droits adoptés.

Valeurs uniques

*JOBD

Le travail soumis est placé dans la file d'attente de travaux indiquée dans la description de travail. Le paramètre JOBD indique la description de travail.

Qualificatif 1 : File d'attente de travaux

nom

Indiquez le nom de la file d'attente de travaux.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de l'unité d'exécution jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La bibliothèque en cours pour l'unité d'exécution permet de localiser l'objet. Si celle-ci n'est indiquée, QGPL est prise par défaut.

nom

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

Utilisat (USER)

Indique le nom du profil utilisateur sous lequel le travail est soumis.

*CURRENT

Le travail est soumis sous le profil utilisateur qui ajoute le poste.

*JOBD

Le profil utilisateur est celui indiqué au paramètre USER de la description de travail. Le paramètre JOBD de cette commande indique la description de travail. Cette valeur ne peut être utilisée si le paramètre USER(*RQD) est précisé dans la description de travail.

nom

Indiquez un nom de profil utilisateur. Vous devez disposer des droits appropriés sur ce profil. Le profil utilisateur doit également disposer des droits sur la description de travail et la file d'attente des messages indiquées pour cette commande.

File attente messages (MSGQ)

Indique le qualificatif de la file d'attente de messages à laquelle les messages sont envoyés.

Les messages sont envoyés lors de la soumission et de la fin d'un travail. Dans les cas suivants, des messages indiquant des erreurs graves sont envoyés dans la file d'attente de messages QSYSOPR et ce, quelle que soit la valeur précisée pour le paramètre MSGQ :

• Lorsque la file d'attente de messages indiquée pour ce paramètre est endommagée.
• Lorsque le paramètre MSGQ(*NONE) est indiqué.
• Lorsque les paramètres MSGQ(*USRPRF) et USER(*JOBD) sont indiqués et que la description de travail précisée pour le paramètre JOBD a été affectée de la valeur USER(*RQD) après l'ajout du poste.

Valeurs uniques

*USRPRF

La file d'attente de messages indiquée est celle indiquée dans le profil utilisateur associé au travail soumis. Le paramètre USER définit le profil utilisateur.

*NONE

Aucun message de fin de travail n'est envoyé. En revanche, les messages d'erreur sont envoyés dans la file d'attente de messages QSYSOPR.

Qualificatif 1 : File attente messages

nom

Indiquez le nom de la file d'attente de messages.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de l'unité d'exécution jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La bibliothèque en cours pour l'unité d'exécution permet de localiser l'objet. Si celle-ci n'est indiquée, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque dans laquelle figure la file d'attente de messages.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement le poste du planning des travaux.

*BLANK

Aucun texte n'est indiqué.

valeur-alphanumérique

Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Exemples

Exemple 1 : planification d'un travail hebdomadaire

ADDJOBSCDE   JOB(CLEANUP)  SCDDATE(*NONE)
             CMD(CALL PGM(CLNUPLIB/CLNUPPGM))
             SCDDAY(*FRI)  SCDTIME('23:00:00')
             FRQ(*WEEKLY)  RCYACN(*NOSBM)
             JOBD(CLNUPLIB/CLNUPJOBD)

Cette commande permet de soumettre un travail nommé CLEANUP tous les vendredis à 23:30. Le travail utilise la description de travail CLNUPJOBD dans la bibliothèque CLNUPLIB. Si le système est hors tension ou à l'état restreint le vendredi à 23:00, le travail ne sera pas soumis lors de l'IPL ni lors du retour à l'état normal du système.

Exemple 2 : planification d'un travail mensuel

ADDJOBSCDE   JOB(PAYROLLJOB)  CMD(CALL PAYROLL)
             SCDDATE(*NONE)  SCDDAY(*MON)
             SCDTIME('09:00:00')  FRQ(*MONTHLY)
             RELDAYMON(1)

Cette commande permet de soumettre un travail pour qu'il exécute le programme PAYROLL à 9:00 le premier lundi du mois.

Exemple 3 : omission des dates

ADDJOBSCDE   JOB(MONTHEND)  CMD(CALL INVENTORY)
             SCDDATE(*MONTHEND)  SCDTIME('23:30:00')
             FRQ(*MONTHLY)  OMITDATE('31.12.2003')

Cette commande permet de soumettre un travail pour qu'il exécute le programme INVENTORY à 23:30 le dernier jour de chaque mois excepté le 31 décembre 2003.

Exemple 4 : planification d'un travail quotidien

ADDJOBSCDE   JOB(*JOBD)  CMD(CALL DAILYCLEAN)  SCDDATE(*NONE)
             SCDDAY(*ALL)  SCDTIME('18:00:00')
             FRQ(*WEEKLY)  RCYACN(*NOSBM)  USER(SOMEPGMER)

Cette commande permet de soumettre un travail pour qu'il exécute le programme DAILYCLEAN tous les jours à 18:00. Le travail s'exécute sous le profil utilisateur SOMEPGMER. Si le système est hors tension ou à l'état restreint à 18:00, le travail ne sera pas soumis lors de l'IPL ni lors du retour à l'état normal du système.

Exemple 5 : planification d'un travail hebdomadaire

ADDJOBSCDE   JOB(*JOBD)  CMD(CALL PGM1)  SCDDATE('01.06.2003')
             FRQ(*WEEKLY)  USER(PGMR1)

Cette commande permet de soumettre un travail pour qu'il exécute le programme PGM1 chaque semaine à partir du 1er juin 2003 à l'heure en cours. Etant donné que le 1er juin est un samedi, le travail sera soumis tous les samedis.

Exemple 6 : planification d'un travail à exécuter deux fois par mois

ADDJOBSCDE   JOB(*JOBD)  CMD(CALL PGM2)
             SCDDATE(*NONE)  SCDDAY(*MON *WED)
             FRQ(*MONTHLY)  RELDAYMON(3)
             SCDTIME('23:30:00')

Cette commande permet de soumettre un travail pour qu'il exécute le programme PGM2 tous les troisièmes lundis et mercredis du mois à 23:30. Le travail est soumis ce mois-ci si le troisième lundi et le troisième mercredi ne sont pas encore passés au moment de l'ajout de ce poste. Si, par exemple, le troisième lundi était hier, que le troisième mardi est aujourd'hui et que demain sera le troisième mercredi, le travail sera soumis demain, et pas avant le mois prochain.

Exemple 7 : planification d'un travail à exécuter deux fois par mois

ADDJOBSCDE  JOB(*JOBD)  CMD(CALL PGM3)
            SCDDATE(*NONE)  SCDDAY(*MON)
            FRQ(*MONTHLY)  RELDAYMON(1 3)
            SCDTIME('09:00:00')
            USER(PGMR3)

Cette commande permet de soumettre un travail pour qu'il exécute le programme PGM3 le premier et le troisième lundi du mois à 9:00. Le travail s'exécute sous le profil utilisateur PGMR3.

Exemple 8 : planification d'un travail à exécuter chaque jour ouvrable

ADDJOBSCDE   JOB(*JOBD)  CMD(CALL PGM4)
             SCDDATE(*NONE) SCDDAY(*MON *TUE *WED *THU *FRI)
             SCDTIME('19:00:00') FRQ(*WEEKLY)

Cette commande permet de soumettre un travail pour qu'il exécute le programme PGM4 chaque jour ouvrable à 19:00.

Messages d'erreur

Messages *ESCAPE

CPF1633

Le poste de planning des travaux &3 numéro &4 n'a pas été ajouté.

CPF9872

Programme ou programme de service &1 de la bibliothèque &2 arrêté. Code raison : &3.