QSYS2.CHECK_MIRROR_VERSION

À quoi ça sert

Cette fonction scalaire sert avec Db2 Mirror for i (option 48 de 5770SS1) et n'a d'intérêt que si ce produit est configuré. Elle contrôle une entrée de la liste de versions du miroir : VERSION_GROUP et VERSION_NAME désignent l'entrée, et VERSION_IDENTIFIER le niveau à comparer.

Le paramètre ENTRY_SOURCE précise la source de l'entrée. Une application peut ainsi tester, avant d'utiliser une fonction, que les deux nœuds sont au niveau requis. La fonction s'appelle avec VALUES et ne modifie rien.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

VALUES QSYS2.CHECK_MIRROR_VERSION(VERSION_GROUP => 'SOFTVEND02',                              
                                      VERSION_NAME => 'APPLICATION_LIBRARY_02',                   
                                      VERSION_IDENTIFIER => '1.3.0')

Ce que l'IBM i a renvoyé le 01/10/2026 (1 ligne 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

Vérifier que le numéro de version actif est supérieur ou égal à 1.3.0 pour le groupe SOFTVEND02 et le nom de version APPLICATION_LIBRARY_02.

-- Description: Check the active version number is greater than or equal                           
-- to 1.3.0 for group name SOFTVEND02 with version name APPLICATION_LIBRARY_02.                     
    VALUES QSYS2.CHECK_MIRROR_VERSION(VERSION_GROUP => 'SOFTVEND02',                              
                                      VERSION_NAME => 'APPLICATION_LIBRARY_02',                   
                                      VERSION_IDENTIFIER => '1.3.0');

Paramètres