QSYS2.HARDWARE_RESOURCE_INFO

À quoi ça sert

Ce service existe sous deux formes : une vue et une fonction de table. Il renvoie une ligne par ressource matérielle, avec son identifiant (ID) et celui de son parent (PARENT_ID) qui reconstituent l'arborescence, sa catégorie, son nom, son statut et son statut étendu, le type et le modèle d'unité, le numéro de série, le numéro de pièce, le code d'emplacement et les adresses de bus, d'adaptateur et d'unité. Pour les ports réseau, il donne aussi l'adresse MAC par défaut et la vitesse du réseau local.

La fonction de table accepte trois paramètres : RESOURCE_CATEGORY pour limiter à une catégorie (l'exemple d'IBM utilise 'TAPE'), DETAILED_INFO (défaut NO) pour obtenir toutes les colonnes détaillées, et IGNORE_ERRORS (défaut YES). La forme vue répond à la question la plus fréquente, par exemple lister toutes les ressources dont le statut n'est pas opérationnel.

C'est un bon outil d'inventaire et de surveillance : il se planifie, se compare d'un jour à l'autre et se joint à d'autres services, ce que la commande ne permet pas.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT * FROM QSYS2.HARDWARE_RESOURCE_INFO

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

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 toutes les ressources qui ne sont pas opérationnelles, ou renvoyer toutes les informations des ressources de type bande.

-- Description: List all resources that are not operational. 
   SELECT RESOURCE_NAME, STATUS, EXTENDED_STATUS FROM QSYS2.HARDWARE_RESOURCE_INFO 
     WHERE STATUS <> 'OPERATIONAL';

-- Description: Return full information about tape resources. 
   SELECT * FROM TABLE (QSYS2.HARDWARE_RESOURCE_INFO(RESOURCE_CATEGORY => 'TAPE', 
                                                  DETAILED_INFO => 'YES'));

Paramètres

Colonnes renvoyées (39)