Aller au contenu

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

QSYS2.ACTIVATION_GROUP_INFO

Groupes d'activation d'un travail

Liste les groupes d'activation d'un travail avec leur état, leurs programmes, leur mémoire statique et leurs tas (heaps), à partir du nom ou de l'identifiant interne du travail.

À quoi ça sert

Cette fonction de table renvoie une ligne par groupe d'activation du travail désigné : nom et numéro du groupe, modèle de mémoire, état, nombre d'activations, programme associé, taille de la mémoire statique et nombre de tas. Elle sert à comprendre pourquoi un travail RPG ou ILE consomme beaucoup de mémoire ou garde des ressources ouvertes.

Le travail se désigne par JOB_NAME (nom qualifié) ou par INTERNAL_JOB_ID (identifiant interne, que l'on obtient par exemple avec QSYS2.ACTIVE_JOB_INFO). Le paramètre IGNORE_ERRORS vaut 'YES' par défaut : les erreurs sont ignorées plutôt que de faire échouer la requête.

Le SQL permet de trier les groupes par taille de mémoire, de ne garder que les groupes nommés ou de rapprocher le résultat d'autres services sur les travaux.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT * FROM TABLE(QSYS2.ACTIVATION_GROUP_INFO(JOB_NAME => '*'))

Ce que l'IBM i a renvoyé le 01/10/2026 (5 lignes au plus) :

ACTIVATION_GROUP_NAME Nom du groupe d'activation ACTIVATION_GROUP_NUMBER Numéro du groupe d'activation STORAGE_MODEL Modèle de mémoire STATE État NUMBER_OF_ACTIVATIONS Nombre d'activations PROGRAM_LIBRARY Bibliothèque du programme PROGRAM Programme PROGRAM_TYPE Type de programme SHARED_ACTIVATION_GROUP Groupe d'activation partagé IN_USE En cours d'utilisation STATIC_STORAGE_SIZE Taille de la mémoire statique NUMBER_OF_HEAPS Nombre de tas (heaps) HEAP_STORAGE_SIZE Taille de l'espace de tas
*DFTACTGRP 1 *SNGLVL SYSTEM 448 NULL NULL NULL NO YES 10850304 5 2486272
*DFTACTGRP 2 *SNGLVL USER 6 NULL NULL NULL NO YES 49152 0 0
*DFTACTGRP 6 *TERASPACE USER 10 NULL NULL NULL NO YES 57344 0 0
QLGLOCAL 17 *SNGLVL SYSTEM 25 QSYS QLGLOCAL SRVPGM NO NO 303104 0 0
QSQCLI 18 *SNGLVL SYSTEM 61 QSYS QSQCLI SRVPGM NO NO 421888 1 12288

Données anonymisées : les noms de système, de profils, de bibliothèques, de postes et les adresses IP ont été remplacés. Les objets du schéma JOBISQL sont des objets de démonstration créés pour ce site.

L'exemple d'IBM

Lister les informations de groupes d'activation d'un travail à partir de son identifiant interne.

-- Description: List the activation group information for a job based on its 
     --  internal job identifier. 
    SELECT * FROM TABLE(QSYS2.ACTIVATION_GROUP_INFO( 
                    INTERNAL_JOB_ID => BX'00D10003007E3F00A784A7CBD6E89001'));

Bon à savoir

Pour un travail qui grossit sans cesse, regardez les colonnes de mémoire statique et de tas par groupe d'activation : un groupe nommé qui n'est jamais récupéré est un suspect classique.

Paramètres

ParamètreTypePar défautSignification
JOB_NAME VARCHAR(28) NULL Nom du travail
INTERNAL_JOB_ID BINARY(16) NULL Identifiant interne du travail
IGNORE_ERRORS VARCHAR(3) 'YES' Ignorer les erreurs

Colonnes renvoyées (13)

Afficher les 13 colonnes
ColonneTypeSignification
ACTIVATION_GROUP_NAME VARCHAR(10) Nom du groupe d'activation
ACTIVATION_GROUP_NUMBER DECIMAL(20, 0) Numéro du groupe d'activation
STORAGE_MODEL VARCHAR(10) Modèle de mémoire
STATE VARCHAR(6) État
NUMBER_OF_ACTIVATIONS INTEGER Nombre d'activations
PROGRAM_LIBRARY VARCHAR(10) Bibliothèque du programme
PROGRAM VARCHAR(10) Programme
PROGRAM_TYPE VARCHAR(6) Type de programme
SHARED_ACTIVATION_GROUP VARCHAR(3) Groupe d'activation partagé
IN_USE VARCHAR(3) En cours d'utilisation
STATIC_STORAGE_SIZE DECIMAL(20, 0) Taille de la mémoire statique
NUMBER_OF_HEAPS INTEGER Nombre de tas (heaps)
HEAP_STORAGE_SIZE DECIMAL(20, 0) Taille de l'espace de tas