Planifier les travaux, WRKJOBSCDE et ADDJOBSCDE

À quoi sert le planning des travaux ?

À ne plus soumettre à la main ce qui revient : la paie, les éditions de la semaine ou du mois, les purges, les sauvegardes, les échanges de fichiers de la nuit. On décrit le traitement une fois, et le système le lance aux dates prévues, de jour comme de nuit, sans personne devant l'écran.

Toutes les entrées sont rangées dans un seul objet, QDFTJOBSCD, de type *JOBSCD, dans la bibliothèque QUSRSYS. On ne peut ni le créer, ni le supprimer, ni le déplacer. Comme c'est un objet permanent, les entrées survivent à un vidage de file d'attente et se sauvegardent avec QUSRSYS. Il est livré avec un droit public *CHANGE, le minimum pour ajouter et gérer des entrées (c'est bien le cas sur notre système).

Le moteur est un travail système, QJOBSCD : il surveille les heures des entrées et soumet les travaux. Sur notre IBM i 7.5, il est actif hors de tout sous-système (type SYS), en état EVTW : il attend le prochain événement.

Ajouter une entrée : ADDJOBSCDE

Trois paramètres sont obligatoires : le nom du travail, la commande et la fréquence. Les autres ont une valeur par défaut :

Pour ajouter une entrée, il faut le droit *USE sur la commande, sur la description de travail, sur la file d'attente et sur le profil indiqué dans USER (avec *EXECUTE sur leurs bibliothèques).

Les fréquences, par l'exemple

Le couple FRQ / SCDDATE ou SCDDAY couvre presque tous les besoins. À ajouter à ADDJOBSCDE JOB(…) CMD(…) ; les dates s'écrivent au format de date du travail (jj/mm/aa sur notre système) :

Notre démonstration sur un IBM i 7.5

Nous avons ajouté quatre entrées : une à exécuter une seule fois trois minutes plus tard, et trois récurrentes, aussitôt suspendues pour la démonstration.

/* Une seule fois, aujourd'hui à 13:36:29 ; l'entrée disparaît ensuite  */
ADDJOBSCDE JOB(UNEFOIS) CMD(DSPLIB LIB(JOBITRV) OUTPUT(*PRINT)) +
             FRQ(*ONCE) SCDDATE(*CURRENT) SCDTIME('13:36:29') +
             JOBD(JOBITRV/DEMOJOBD) JOBQ(QGPL/QBATCH) +
             TEXT('Démo : une seule fois')

/* Les jours ouvrés à 6 h                                               */
ADDJOBSCDE JOB(OUVRES) CMD(DSPLIB LIB(JOBITRV) OUTPUT(*PRINT)) +
             FRQ(*WEEKLY) SCDDATE(*NONE) +
             SCDDAY(*MON *TUE *WED *THU *FRI) SCDTIME('06:00:00') +
             JOBD(JOBITRV/DEMOJOBD) JOBQ(QGPL/QBATCH) +
             TEXT('Démo : jours ouvrés à 6 h')

/* Le premier lundi de chaque mois à 7 h                                */
ADDJOBSCDE JOB(PREMLUNDI) CMD(DSPLIB LIB(JOBITRV) OUTPUT(*PRINT)) +
             FRQ(*MONTHLY) SCDDATE(*NONE) SCDDAY(*MON) RELDAYMON(1) +
             SCDTIME('07:00:00') JOBD(JOBITRV/DEMOJOBD) +
             JOBQ(QGPL/QBATCH) TEXT('Démo : premier lundi du mois')

/* Le dernier jour du mois à 23 h 30, sauf le 31/12, sans rattrapage   */
ADDJOBSCDE JOB(FINMOIS) CMD(DSPLIB LIB(JOBITRV) OUTPUT(*PRINT)) +
             FRQ(*MONTHLY) SCDDATE(*MONTHEND) SCDTIME('23:30:00') +
             OMITDATE('31/12/26') RCYACN(*NOSBM) +
             JOBD(JOBITRV/DEMOJOBD) JOBQ(QGPL/QBATCH) +
             TEXT('Démo : fin de mois sauf 31/12')

/* Les trois entrées récurrentes sont suspendues après la démonstration */
HLDJOBSCDE JOB(OUVRES)
HLDJOBSCDE JOB(PREMLUNDI)
HLDJOBSCDE JOB(FINMOIS)

WRKJOBSCDE les liste, avec la prochaine date de soumission que le système a calculée. On y voit aussi PRGAUDRCV, une vraie entrée de notre système qui purge chaque nuit à 3 h 30 les récepteurs d'audit de plus de 90 jours :

L'option 5 affiche une entrée en détail, avec le résultat de sa dernière soumission :

L'entrée UNEFOIS, à 13:36:29

À l'heure dite, le travail 012166/SAKADM/UNEFOIS est entré dans le système à 13:36:29, sans une seconde d'écart, s'est exécuté et s'est terminé normalement. Son historique dit qui l'a soumis :

CPF1124  Travail 012166/SAKADM/UNEFOIS démarré le 15/10/26 à
         13:36:29 dans le sous-système QBATCH de QSYS ; soumis le 15/10/26 à
         13:36:29.
CPI1125  Travail 012166/SAKADM/UNEFOIS soumis.
         Le travail 012166/SAKADM/UNEFOIS a été soumis en file
         d'attente de travaux QBATCH de QGPL à partir du travail 011426/QSYS/QJOBSCD.
         Le travail 012166/SAKADM/UNEFOIS a été démarré par la commande SBMJOB
         (Soumettre un travail) avec les attributs : JOBPTY(5) OUTPTY(5) PRTTXT()
         RTGDTA(QCMDI) SYSLIBL(QSYS       QSYS2      QHLPSYS    QUSRSYS)
         CURLIB(*CRTDFT) INLLIBL(JOBITRV    QGPL       QTEMP) INLASPGRP(*NONE) LOG(4
         00 *SECLVL) LOGCLPGM(*NO) LOGOUTPUT(*JOBEND) OUTQ(JOBITRV/DEMOOUTQ) […]
*NONE    -DSPLIB LIB(JOBITRV) OUTPUT(*PRINT)
CPF1164  Travail 012166/SAKADM/UNEFOIS arrêté le 15/10/26 à
         13:36:29; temps UC 0,007; code fin 0 .

Deux constats :

• C'est le travail système QSYS/QJOBSCD qui a soumis le travail.
• Le travail a reçu la liste de bibliothèques de sa JOBD (INLLIBL(JOBITRV QGPL QTEMP)), ses données de routage (QCMDI) et sa file de sortie. C'est l'inverse d'un SBMJOB tapé dans une session, qui prend par défaut la liste et la file de sortie de la session (le piège de la page JOBQ et JOBD). Pour un travail planifié, c'est donc la JOBD qu'il faut soigner.

Comme son SAVE valait *NO, l'entrée a disparu du planning après la soumission :

Gérer les entrées

Depuis WRKJOBSCDE : 2 modifie, 3 suspend, 4 retire, 5 affiche le détail, 6 libère, 8 montre le travail de la dernière soumission, 10 soumet tout de suite (pratique pour tester une entrée sans attendre). Les mêmes actions existent en commandes :

• Suspendre puis libérer ne rattrape rien : une entrée libérée ne soumet pas les heures passées pendant sa suspension ; elle repart à la prochaine date prévue.
• Pour retirer les entrées des autres, il faut le droit spécial *JOBCTL ; sans lui, on ne retire que les siennes.
• Chaque entrée est identifiée par son nom et un numéro à 6 chiffres attribué par le système : deux entrées peuvent porter le même nom.
• La zone de données locale (*LDA) du travail soumis est vide au démarrage.

En SQL, QSYS2.SCHEDULED_JOB_INFO donne tout le planning :

SELECT SCHEDULED_JOB_NAME, STATUS, FREQUENCY, SCHEDULED_TIME,
       SCHEDULED_DAYS, NEXT_SUBMISSION_DATE, COMMAND_STRING
  FROM QSYS2.SCHEDULED_JOB_INFO
 ORDER BY NEXT_SUBMISSION_DATE

Et si le système est arrêté à l'heure prévue ?

Système éteint ou en état restreint (pendant une sauvegarde complète, par exemple) : aucune entrée ne peut être soumise. Au prochain démarrage, ou à la sortie de l'état restreint, chaque entrée suit son action de reprise (RCYACN) :

Même si plusieurs heures ont été manquées, le travail n'est soumis qu'une fois, et les entrées sont traitées dans l'ordre de leurs heures. D'autres travaux peuvent démarrer pendant ce temps. Pour un traitement qui n'a de sens qu'à son heure, choisissez *NOSBM, comme notre entrée FINMOIS.

Planning ou SBMJOB à heure fixe ?

Pour une exécution unique, il y a plus simple : SBMJOB … SCDDATE(…) SCDTIME(…). Le travail entre tout de suite dans la file d'attente, en état planifié, et n'en sort qu'à l'heure dite. Nous l'avons vérifié :

SBMJOB CMD(DSPLIB LIB(JOBITRV) OUTPUT(*PRINT)) JOB(PLUSTARD) +
       JOBD(JOBITRV/DEMOJOBD) JOBQ(QGPL/QBATCH) +
       SCDDATE(*CURRENT) SCDTIME('23:59:00')

JOB_NAME                JOB_STATUS  JOB_QUEUE_STATUS  JOB_SCHEDULED_TIME
012168/SAKADM/PLUSTARD  JOBQ        SCHEDULED         2026-10-15 23:59:00

Au-delà, pour enchaîner des travaux (« B quand A est fini »), gérer des calendriers de jours fériés ou suivre un historique d'exécution, IBM propose un produit à part, IBM Advanced Job Scheduler for i (5770-JS1), installé sur notre système. Le planning de base, lui, est livré avec IBM i.

Questions fréquentes