Aller au contenu

Service SQL IBM i (AS/400) · Fonction table

QSYS2.TRACKED_JOB_INFO

Suivi des travaux d'une file d'attente

Renvoie l'historique des travaux suivis pour des files d'attente des travaux : heures d'entrée, d'activation et de fin, gravité et commande exécutée.

À quoi ça sert

TRACKED_JOB_INFO lit la table de suivi des travaux des files d'attente des travaux déclarées comme suivies. Pour chaque travail, elle donne le nom qualifié, la commande ou les données de la demande, l'heure d'entrée dans le système, l'heure d'activation, l'heure de fin, la file d'attente des travaux, la description de travail, la gravité de fin, le temps processeur, la priorité et la file d'attente de sortie.

Quatre filtres facultatifs ciblent la lecture : NODE_NAME_FILTER, IASP_NAME_FILTER, JOB_QUEUE_LIBRARY_FILTER et JOB_QUEUE_FILTER. L'exemple d'IBM liste les travaux non terminés (JOB_END_TIME IS NULL) de la file MYJOBQ.

Elle sert à retrouver ce qui est passé par une file d'attente des travaux, même après la fin des travaux : durée d'attente, durée d'exécution, travaux en échec.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT * FROM TABLE(QSYS2.TRACKED_JOB_INFO(JOB_QUEUE_LIBRARY_FILTER => 'JQLIB', 
                                           JOB_QUEUE_FILTER => 'MYJOBQ')) 
  WHERE JOB_END_TIME IS NULL

Aucune ligne : aucune file d'attente des travaux n'est suivie (procédure ADD_TRACKED_JOB_QUEUE).

L'exemple d'IBM

Afficher toutes les entrées de la table de suivi des travaux non terminés de la file d'attente MYJOBQ de la bibliothèque JQLIB.

-- Description: Show all entries in the job queues tracking table for jobs that 
    -- have not completed for job queue MYJOBQ in library JQLIB. 
  SELECT * FROM TABLE(QSYS2.TRACKED_JOB_INFO(JOB_QUEUE_LIBRARY_FILTER => 'JQLIB', 
                                           JOB_QUEUE_FILTER => 'MYJOBQ')) 
  WHERE JOB_END_TIME IS NULL;

Bon à savoir

Seules les files déclarées comme suivies (voir TRACKED_JOB_QUEUES et ADD_TRACKED_JOB_QUEUE) alimentent cette table. Si elle reste vide, vérifiez d'abord que la file est bien suivie.

Paramètres

ParamètreTypePar défautSignification
NODE_NAME_FILTER VARCHAR(8) NULL Filtre sur le nom du nœud
IASP_NAME_FILTER VARCHAR(10) NULL Filtre sur le nom de l'ASP indépendant
JOB_QUEUE_LIBRARY_FILTER VARCHAR(10) NULL Filtre sur la bibliothèque de la file d'attente des travaux
JOB_QUEUE_FILTER VARCHAR(10) NULL Filtre sur la file d'attente des travaux

Colonnes renvoyées (75)

Afficher les 75 colonnes
ColonneTypeSignification
NODE_NAME VARCHAR(8) Nom du nœud
QUALIFIED_JOB_NAME VARCHAR(28) Nom qualifié du travail
JOB_NAME VARCHAR(10) Nom du travail
JOB_USER VARCHAR(10) Profil utilisateur du travail
JOB_NUMBER VARCHAR(6) Numéro du travail
COMMAND_OR_REQUEST_DATA VARCHAR(20000) Données de la commande ou de la demande
JOB_ENTERED_SYSTEM_TIME TIMESTAMP Horodatage d'entrée du travail dans le système
JOB_ACTIVE_TIME TIMESTAMP Horodatage d'activation du travail
JOB_END_TIME TIMESTAMP Horodatage de fin du travail
JOB_QUEUE_ASP_NAME VARCHAR(10) Nom de l'ASP de la file d'attente des travaux
JOB_QUEUE_LIBRARY VARCHAR(10) Bibliothèque de la file d'attente des travaux
JOB_QUEUE VARCHAR(10) File d'attente des travaux
JOB_DESCRIPTION_LIBRARY VARCHAR(10) Bibliothèque de la description de travail
JOB_DESCRIPTION VARCHAR(10) Description de travail
JOB_END_SEVERITY INTEGER Gravité de fin du travail
PROCESSING_UNIT_TIME BIGINT Temps d'unité de traitement
JOB_QUEUE_PRIORITY INTEGER Priorité dans la file d'attente des travaux
PRINTER_DEVICE_NAME VARCHAR(10) Nom de l'unité d'impression
OUTPUT_QUEUE_LIBRARY VARCHAR(10) Bibliothèque de la file d'attente de sortie
OUTPUT_QUEUE VARCHAR(10) File d'attente de sortie
OUTPUT_QUEUE_PRIORITY INTEGER Priorité de sortie des fichiers spoule
JOB_ACCOUNTING_CODE VARCHAR(15) Code de comptabilisation du travail
RUN_PRIORITY INTEGER Priorité d'exécution
PRINT_TEXT VARCHAR(30) Texte d'impression
ROUTING_DATA VARCHAR(80) Données d'acheminement
CURRENT_LIBRARY VARCHAR(10) Bibliothèque courante
SYSTEM_LIBRARY_LIST_COUNT INTEGER Nombre de bibliothèques de la partie système
SYSTEM_LIBRARY_LIST VARCHAR(165) Partie système de la liste de bibliothèques
USER_LIBRARY_LIST_COUNT INTEGER Nombre de bibliothèques de la partie utilisateur
USER_LIBRARY_LIST VARCHAR(2750) Partie utilisateur de la liste de bibliothèques
INITIAL_JOB_ASP_GROUP VARCHAR(10) Groupe d'ASP initial du travail
MESSAGE_LOGGING_LEVEL INTEGER Niveau de journalisation des messages
MESSAGE_LOGGING_SEVERITY INTEGER Gravité de journalisation des messages
MESSAGE_LOGGING_TEXT VARCHAR(7) Texte de journalisation des messages
LOG_CL_PROGRAM_COMMANDS VARCHAR(4) Journalisation des commandes des programmes CL
JOB_LOG_OUTPUT VARCHAR(10) Traitement de l'historique du travail
MAXIMUM_JOB_MESSAGE_QUEUE_SIZE INTEGER Taille maximale de la file de messages du travail
JOB_MESSAGE_QUEUE_FULL_ACTION VARCHAR(8) Action en cas de file de messages du travail pleine
INQUIRY_MESSAGE_REPLY VARCHAR(8) Réponse aux messages d'interrogation
HOLD_ON_JOB_QUEUE VARCHAR(4) Retenir dans la file d'attente des travaux
BREAK_MESSAGE VARCHAR(10) Message d'interruption
STATUS_MESSAGE VARCHAR(10) Message de statut
DDM_CONVERSATION VARCHAR(5) Conversation DDM
JOB_SCHEDULED_TIME TIMESTAMP Horodatage planifié du travail
JOB_DATE VARCHAR(10) Date du travail
DATE_FORMAT CHAR(4) Format de date
DATE_SEPARATOR CHAR(1) Séparateur de date
TIME_SEPARATOR CHAR(1) Séparateur d'heure
JOB_SWITCHES CHAR(8) Commutateurs du travail
ALLOW_WRKSBMJOB VARCHAR(4) Affichage par WRKSBMJOB autorisé
QUALIFIED_SUBMITTER_JOB_NAME VARCHAR(28) Nom qualifié du travail émetteur
SUBMITTER_JOB_NAME VARCHAR(10) Nom du travail émetteur
SUBMITTER_JOB_USER VARCHAR(10) Utilisateur du travail émetteur
SUBMITTER_JOB_NUMBER VARCHAR(6) Numéro du travail émetteur
JOBEND_MESSAGE_QUEUE_LIBRARY VARCHAR(10) Bibliothèque de la file de messages de fin de travail
JOBEND_MESSAGE_QUEUE VARCHAR(10) File de messages de fin de travail
TIME_SLICE INTEGER Tranche de temps
PURGE_ALLOWED VARCHAR(4) Purge autorisée
DEFAULT_WAIT INTEGER Délai d'attente par défaut
PRINT_KEY_FORMAT VARCHAR(10) Format de la touche d'impression
SORT_SEQUENCE_LIBRARY VARCHAR(10) Bibliothèque de la séquence de tri
SORT_SEQUENCE VARCHAR(10) Séquence de tri
LANGUAGE_ID CHAR(3) Identifiant de langue
COUNTRY_ID CHAR(2) Identifiant du pays
CCSID INTEGER CCSID
COPY_ENVIRONMENT_VARIABLES VARCHAR(4) Copie des variables d'environnement
ALLOW_MULTIPLE_THREADS VARCHAR(4) Unités d'exécution multiples autorisées
DECIMAL_FORMAT VARCHAR(6) Format décimal
CHARACTER_IDENTIFIER_CONTROL VARCHAR(9) Contrôle des identificateurs de caractères
SPOOLED_FILE_ACTION VARCHAR(7) Action sur les fichiers spoule
MAXIMUM_PROCESSING_TIME_ALLOWED INTEGER Temps de traitement maximal autorisé
MAXIMUM_TEMPORARY_STORAGE_ALLOWED INTEGER Stockage temporaire maximal autorisé
PROCESSOR_RESOURCES_PRIORITY VARCHAR(10) Priorité des ressources processeur
ROUTING_STEP INTEGER Étape d'acheminement
INTERNAL_JOB_IDENTIFIER BINARY(16) Identifiant interne du travail