CHGJOBSCDE

La commande CHGJOBSCDE (Modifier poste planning travx) permet à l'utilisateur de modifier un poste du planning des travaux.

Ce poste comprend toutes les informations nécessaires à la soumission automatique d'un travail par lots. Vous pouvez utiliser cette commande pour modifier :

• la commande exécutée par le travail
• la date et l'heure planifiées d'exécution du travail
• les actions de reprise effectuées par le système si le travail ne peut être soumis à l'heure planifiée
• la description de travail et le profil utilisateur associés au travail
• la file d'attente de travaux dans laquelle le travail est placé lorsqu'il est soumis
• la file d'attente destinée à recevoir les messages

Chaque poste du planning des travaux est identifié par un nom de travail indiqué pour le paramètre JOB de cette commande et par un numéro que le système attribue à ce poste lorsqu'il est ajouté. De plus, ce numéro est inclus dans le message envoyé pour confirmer l'ajout de 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 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 de la commande 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. L'émetteur de la commande doit utiliser un profil utilisateur identique à l'identité de l'utilisateur du travail pour le poste de travail planifié en cours de modification, ou un profil utilisateur disposant du droit spécial *JOBCTL.

   L'identité de l'utilisateur du travail correspond au nom du profil utilisateur permettant d'identifier un travail par rapport aux autres travaux. Pour plus d'informations sur l'identité de l'utilisateur du travail, 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/.

2. 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.

nom

Indiquez le nom du poste de planning des travaux que vous souhaitez modifier.

Numéro de poste (ENTRYNBR)

Indique le numéro du poste de planning des travaux que vous souhaitez modifier. Ce numéro est inclus dans le message envoyé pour confirmer l'ajout d'un poste. Vous pouvez également déterminer le numéro de poste à l'aide de la commande WRKJOBSCDE (Gérer postes planning travaux). Pour ce faire, appuyez sur F11 depuis cet écran afin de visualiser les numéros des postes sélectionnés.

*ONLY

Un seul poste du planning des travaux correspond au nom de travail indiqué pour le paramètre JOB. Si vous choisissez la valeur *ONLY alors que plusieurs postes ont ce nom de travail, aucun de ces postes n'est modifié et un message d'erreur est envoyé.

000001-999999

Indiquez le numéro du poste de planning des travaux que vous souhaitez modifier.

Commande à exécuter (CMD)

Indique la commande exécutée par le travail soumis. Ce travail ne peut démarrer que si vous utilisez le programme de routage par défaut QCMD fourni par IBM. 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é.

chaîne-commande

Indiquez une commande comportant 512 caractères au maximum.

Fréquence (FRQ)

Indique la fréquence de soumission du travail.

*SAME

La valeur ne change pas.

*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(31/01/93) et FRQ(*MONTHLY), le travail sera soumis le 31/01, le 31/03, le 31/05, le 31/07, le 31/08, le 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.

*SAME

La valeur ne change pas.

*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 soumission 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

*SAME

La valeur ne change pas.

*NONE

Aucun jour de soumission 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.

*SAME

La valeur ne change pas.

*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, placez celui qui est défini pour votre travail dans une chaîne de 5 ou 8 chiffres entre 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.

*SAME

La valeur ne change pas.

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

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.

*SAME

La valeur ne change pas.

*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.

Valeurs uniques

*SAME

La valeur ne change pas.

*NONE

Aucune date n'est indiquée.

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

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 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

*SAME

La valeur ne change pas.

*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

*SAME

La valeur ne change pas.

*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

*SAME

La valeur ne change pas.

*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.

*SAME

La valeur ne change pas.

*CURRENT

Le travail est soumis sous le profil utilisateur qui modifie 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 file d'attente de travaux, la file d'attente de messages et la description de travail précisées dans la commande.

File attente messages (MSGQ)

Indique le nom de la file d'attente destinée à recevoir les messages.

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

*SAME

La valeur ne change pas.

*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 l'objet.

*SAME

La valeur ne change pas.

*BLANK

Aucun texte n'est indiqué.

valeur-alphanumérique

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

Exemples

Exemple 1 : modification d'un poste du planning des travaux

CHGJOBSCDE   JOB(BACKUP)  ENTRYNBR(001584)  JOBQ(QGPL/QBATCH)

Cette commande permet de modifier le numéro 001584 du poste du planning des travaux BACKUP de façon à ce que ses travaux soient soumis à la file d'attente QBATCH de la bibliothèque QGPL.

Exemple 2 : modification d'un poste du planning des travaux

CHGJOBSCDE   JOB(EXAMPLE)  ENTRYNBR(*ONLY)  CMD(CALL PGM(A))
             FRQ(*WEEKLY) SCDDATE(121503)  SCDTIME(110000)

Cette commande permet de planifier un travail par lots pour qu'il exécute le programme A à 11:00 le 15.12.2003 et toutes les semaines ce même jour.

Messages d'erreur

Messages *ESCAPE

CPF1620

Poste de planning des travaux &3 numéro &4 non modifié.

CPF9872

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