SYSTOOLS.END_JOBS

À quoi ça sert

Cette procédure trouve les travaux actifs correspondant aux filtres JOB_NAME_FILTER, CURRENT_USER_LIST_FILTER et SUBSYSTEM_LIST_FILTER (liste séparée par des virgules), puis les termine un par un avec l'option END_OPTION (CONTROLLED par défaut) et un délai de fin contrôlée END_CONTROLLED_DELAY.

On peut supprimer les fichiers spoule du travail (DELETE_SPOOLED_FILES) et limiter la taille de son historique (MAXIMUM_JOBLOG_ENTRIES, 0 pour ne pas en produire). Les paramètres JOB_END_MAXIMUM, JOB_END_ITERATION_COUNT et JOB_END_ITERATION_DELAY règlent l'attente de la fin effective des travaux.

Elle est utile avant une sauvegarde ou une maintenance, pour arrêter proprement tous les travaux d'un lot ou d'un sous-système.

Résultat réel sur un IBM i 7.5

Procédure non exécutée sur notre IBM i de test : elle agit sur la configuration du système ou sur d'autres travaux.

L'exemple d'IBM

Trouver et terminer tous les travaux actifs nommés BATCHTEST, en fin contrôlée, en conservant les fichiers spoule et sans produire d'historique du travail.

-- Description: Find and end all the active jobs with a job name of BATCHTEST. 
    -- For every job, end using the controlled option, save any spooled files, and do 
    -- not generate a job log. 
  CALL SYSTOOLS.END_JOBS(JOB_NAME_FILTER          => 'BATCHTEST',  
                       END_OPTION               => 'CONTROLLED', 
                       DELETE_SPOOLED_FILES     => 'NO', 
                       MAXIMUM_JOBLOG_ENTRIES   => 0);

Paramètres