WRKACTJOB

Gérer les travaux actifs

À quoi ça sert

Voir en temps réel tout ce qui tourne sur la machine : qui consomme le processeur, qui est bloqué, dans quel sous-système.

Pourquoi on fait ça

Le téléphone sonne : « l'IBM i rame ». C'est la première commande à taper. Elle montre chaque travail actif avec son pourcentage d'UC et son état. On repère en quelques secondes le travail qui monopolise la machine, ou celui qui est à l'état MSGW : il attend une réponse à un message et bloque tout ce qui dépend de lui.

Le cas concret

/* Les plus gros consommateurs d'UC en premier */
WRKACTJOB  SEQ(*CPUPCT)

/* Seulement les travaux batch */
WRKACTJOB  SBS(QBATCH)

/* Les connexions SQL / ODBC (travaux QZDASOINIT) */
WRKACTJOB  JOB(QZDA*)

/* Une photo imprimée, à joindre à un ticket d'incident */
WRKACTJOB  OUTPUT(*PRINT)

Sur la liste, l'option 5 ouvre le détail d'un travail et F5 réactualise les chiffres. Pour un travail en MSGW, l'option 7 affiche le message qui l'attend.

Le piège classique

Le pourcentage d'UC est mesuré sur l'intervalle écoulé depuis le dernier affichage. Juste après l'ouverture, il ne veut pas dire grand-chose : attendez quelques secondes et appuyez sur F10 (réinitialiser) puis F5 pour une mesure fiable.

Voir aussi : WRKJOB, WRKSBSJOB, ENDJOB, DSPJOBLOG, la fonction SQL QSYS2.ACTIVE_JOB_INFO.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande WRKACTJOB (Gérer les travaux actifs) permet de gérer les informations relatives aux performances et à l'état des travaux actifs dans le système. La séquence de travaux peut être modifiée à l'aide du paramètre SEQ (Séquence) ou via des opérations d'affichage. D'autres paramètres permettent de sélectionner les travaux à afficher. Les paramètres de sélection peuvent également être modifiés via des opérations d'affichage.

La fonction de table QSYS2.ACTIVE_JOB_INFO renvoie des informations similaires.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OUTPUT	Sortie	, PRINT	Facultatif, positionnel 1
RESET	Réinitialiser les statistiques	NO, YES	Facultatif, positionnel 2
SBS	Sous-système	Valeurs uniques: ALL Autres valeurs (jusqu'à 25 répétitions): Nom*	Facultatif
CPUPCTLMT	Limite pourcentage UC	0.1-99.9, *NONE	Facultatif
RSPLMT	Limite temps de réponse	0.1-999.9, *NONE	Facultatif
SEQ	Séquence	SBS, AUXIO, CPU, CPUPCT, CURUSR, FUNCTION, INT, JOB, NUMBER, POOL, PTY, RSP, STS, THREADS, TMPSTG, TYPE, *USER	Facultatif
JOB	Travail	Liste de qualificatifs	Facultatif
JOB	Qualificatif 1: Travail	Nom générique, nom, ALL, SYS, *SBS	Facultatif
INTERVAL	Fréquence réaffichage auto	5-999, *PRV	Facultatif

Sortie (OUTPUT)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

*: La sortie est affichée pour les travaux interactifs ou imprimée avec la sortie spoule de travaux dans le cas des travaux non interactifs.

*PRINT: Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

Réinitialiser les statistiques (RESET)

Indique si les statistiques du travail actif sont réinitialisées.

*NO: Les statistiques du travail actif ne sont pas réinitialisées. L'intervalle de temps de mesure est prolongé si une commande WRKACTJOB a été lancée dans le travail en cours. Tous les travaux actifs sont affichés.
*YES: Les statistiques du travail actif sont réinitialisées. L'intervalle de temps de mesure est utilisé. Tous les travaux actifs sont affichés.

Sous-système (SBS)

Indique les noms des sous-systèmes (ou de tous les sous-systèmes) dont les travaux actifs doivent être affichés.

Valeurs uniques

*ALL: Affiche tous les travaux actifs du système. Les travaux système n'étant associés à aucun sous-système sont également affichés.

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

nom: Indiquez le nom du sous-système à afficher. Tous les travaux actifs de ce sous-système (y compris le moniteur) sont affichés.

Limite pourcentage UC (CPUPCTLMT)

Indique le pourcentage de temps minimal de traitement requis pour qu'un travail s'affiche à l'écran.

*NONE: Le temps minimal de traitement nécessaire pour l'affichage d'un travail n'est pas limité.
0,1-99,9: Indique le pourcentage de temps minimal de traitement requis pour qu'un travail s'affiche à l'écran.

Limite temps de réponse (RSPLMT)

Indique le temps de réponse minimal requis pour qu'un travail s'affiche.

*NONE: Le temps de réponse minimal requis pour qu'un travail s'affiche n'est pas limité.
0,1-999,9: Indique le temps minimal de réponse requis pour qu'un travail soit affiché.

Séquence (SEQ)

Indique l'ordre dans lequel les travaux actifs sont affichés.

*SBS: Les travaux actifs sont classés en fonction du sous-système dans lequel ils s'exécutent. Les travaux d'un sous-système (travaux à démarrage automatique, interactifs, par lots, lecteurs ou éditeurs) sont classés par ordre alphabétique d'après leurs noms, et placés en retrait au-dessous du nom du sous-système auquel ils sont associés. Les travaux du moniteur de sous-système (avec les travaux de sous-système groupés dans chaque travail de moniteur) sont classés par ordre alphabétique et placés avant les travaux système. Les travaux système sont classés par ordre alphabétique d'après leurs noms et sont placés après les moniteurs de sous-système et les travaux du sous-système.
*AUXIO: Les travaux sont classés d'après le nombre d'opérations d'E/S concernant la mémoire secondaire effectuées pendant l'intervalle de temps de mesure. Les valeurs les plus élevées sont présentées en priorité.
*CPU: Les travaux sont classés d'après le temps de traitement qu'ils utilisent depuis leur démarrage. Les valeurs les plus élevées sont présentées en priorité.
*CPUPCT: Les travaux sont classés d'après le pourcentage de ressources UC utilisées pendant l'intervalle de mesure. Les valeurs les plus élevées sont présentées en priorité.
*CURUSR: Les travaux sont classés par ordre alphabétique d'après le profil utilisateur sous lequel l'unité d'exécution initiale est en cours d'exécution.
*FUNCTION: Les travaux sont classés par ordre alphabétique d'après le contenu de la zone correspondant à la fonction du travail.
*INT: Les travaux sont classés d'après le nombre d'interventions opérateur dans l'intervalle de mesure. Les valeurs les plus élevées sont présentées en priorité. Les travaux non interactifs sont ensuite affichés avec la zone correspondante à blanc.
*JOB: Les travaux sont classés par ordre alphabétique d'après leurs noms.
*NUMBER: Les travaux sont classés en fonction de leur numéro. Les valeurs les plus élevées sont présentées en priorité.
*POOL: Les travaux sont classés sur la base du pool de mémoire système dans lequel ils s'exécutent. Les valeurs les plus basses sont affichées en priorité.
*PTY: Les travaux sont classés par priorité d'exécution. Les valeurs dont le niveau de priorité est le plus élevé (0) sont présentées avant les autres.
*RSP: Les travaux sont classés par temps de réponse moyen pendant l'intervalle de mesure. Les valeurs les plus élevées sont présentées en priorité. Les travaux non interactifs sont ensuite affichés avec la zone correspondante à blanc.
*STS: Les travaux sont classés par ordre alphabétique d'après le contenu de la zone d'état.
*THREADS: Les travaux sont classés en fonction du nombre d'unités d'exécution actives. Les travaux avec le plus grand nombre d'unités d'exécution actives sont affichés en premier.
*TMPSTG: Les travaux sont classés en fonction du volume de mémoire temporaire utilisé. Les travaux qui utilisent le plus de mémoire temporaire sont affichés en premier.
*TYPE: Les travaux sont classés par ordre alphabétique d'après leurs types et leurs noms pour un même type.
*USER: Les travaux sont classés par ordre alphabétique d'après les noms des utilisateurs.

Travail (JOB)

Indique le nom des travaux actifs à afficher. Seuls les travaux actifs des sous-systèmes sélectionnés (en fonction du paramètre SBS) sont affichés. Les noms de moniteur de sous-système s'affichent uniquement lorsque *ALL ou *SBS est indiqué. Les travaux du système ne s'affichent que lorsque *ALL ou *SYS est indiqué.

Qualificatif 1 : Travail

*ALL: Tous les travaux actifs sont affichés.
*SYS: Tous les travaux système actifs doivent être affichés. Si une valeur autre que la valeur par défaut est indiquée au paramètre SBS, un message d'erreur est émis.
*SBS: Tous les moniteurs de sous-système actifs sont affichés.
nom-générique: Indiquez tous les travaux actifs, répondant aux critères spécifiés, qui doivent être affichés. Ce paramètre n'est pas utilisé pour afficher les travaux système et les moniteurs de sous-système.
nom: Indiquez le travail actif à afficher. Ce paramètre n'est pas utilisé pour afficher les travaux système et les moniteurs de sous-système.

Fréquence réaffichage auto (INTERVAL)

Indique la fréquence (en secondes) du réaffichage automatique. La valeur par défaut est de 300 secondes (5 minutes). Les valeurs admises sont comprises entre 5 et 999 secondes. Si l'utilisateur modifie cette valeur, celle-ci est sauvegardée et utilisée comme valeur par défaut. Lorsque le réaffichage automatique est lancé, l'écran se réaffiche automatiquement en fonction de l'intervalle indiqué.

*PRV: Intervalle utilisé lors du précédent appel de cette option. Tant qu'un intervalle n'est pas spécifié, la valeur par défaut est de 300 secondes.
5-999: Indiquez la fréquence (en secondes) du réaffichage automatique.

Exemples

Exemple 1 : réinitialisation des statistiques du travail actif

WRKACTJOB   RESET(*YES)  CPUPCTLMT(2)

Cette commande permet à l'utilisateur de gérer un affichage où aucun travail n'apparaît ; les statistiques du travail actif sont réinitialisées et aucun temps UC n'a été alloué au travail depuis la réinitialisation. Lorsque l'affichage apparaît, appuyez sur la touche F5 ; tous les travaux qui ont dépassé 2 pour cent de l'utilisation de l'unité de traitement depuis la réinitialisation s'affichent.

Exemple 2 : gestion des travaux dans un sous-système

WRKACTJOB   SBS(QINTER)  SEQ(*INT)

Cette commande permet à l'utilisateur de gérer tous les travaux dans le sous-système QINTER. La séquence des travaux est classée selon le nombre d'interventions opérateur (le travail présentant le plus d'interventions apparaît en premier).

Messages d'erreur

Messages *ESCAPE

CPF1093: Substitution incorrecte du type d'unité du fichier.
CPF9845: Erreur lors de l'ouverture du fichier &1.
CPF9846: Erreur lors du traitement du fichier &1 de &2.
CPF9847: Erreur lors de la fermeture du fichier &1 de bibliothèque &2.
CPF9850: Substitution non admise pour fichier imprimante &1.
CPF9851: Valeur de ligne fin de page trop faible pour fichier &1 dans &2.
CPF9871: Erreur lors du traitement.