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ètre | Type | Par défaut | Signification |
|---|---|---|---|
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
| Colonne | Type | Signification |
|---|---|---|
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 |