Aller au contenu

Service SQL IBM i (AS/400) · Procédure

QSYS2.ADD_MIRROR_VERSION

Enregistrer une version dans la liste Db2 Mirror

Procédure Db2 Mirror qui enregistre une entrée de version pour une fonction dans la liste de versions du miroir (MVL).

À quoi ça sert

Cette procédure sert avec Db2 Mirror for i (option 48 de 5770SS1) et n'a d'intérêt que si ce produit est configuré. Elle inscrit dans la liste de versions du miroir (Mirror Versioning List, MVL) une entrée pour une fonction ou un logiciel donné.

Les paramètres obligatoires sont VERSION_GROUP, VERSION_NAME et VERSION_IDENTIFIER. On peut y ajouter l'état (STATE), l'horodatage d'activation (ACTIVATION_TIME) et un texte descriptif (TEXT_DESCRIPTION).

La liste sert aux éditeurs de logiciels pour coordonner le niveau de version entre les deux nœuds. Elle se consulte ensuite avec QSYS2.MIRROR_VERSION_LIST et se teste avec QSYS2.CHECK_MIRROR_VERSION.

Résultat réel sur un IBM i 7.5

Db2 Mirror for i n'est pas installé sur notre IBM i de test : ce service n'a rien à montrer.

L'exemple d'IBM

Enregistrer une entrée de version pour une fonction précise dans la liste de versions du miroir (MVL).

-- Description: Register a version information entry for a specific feature or                     
-- function in the Mirror Versioning List (MVL).                                                    
    CALL QSYS2.ADD_MIRROR_VERSION(VERSION_GROUP => 'SOFTVEND01',                                  
                                  VERSION_NAME => 'APPLICATION_LIBRARY_02',                       
                                  VERSION_IDENTIFIER => '2.0.0',                                  
                                  STATE => 'APPLIED',                                             
                                  ACTIVATION_TIME => 'IMMEDIATE',                                 
                                  TEXT_DESCRIPTION => 'Support latest major revision');

Paramètres

ParamètreTypePar défautSignification
VERSION_GROUP VARCHAR(10) obligatoire Groupe de versions
VERSION_NAME VARCHAR(30) obligatoire Nom de la version
VERSION_IDENTIFIER VARCHAR(11) obligatoire Identifiant de la version
STATE VARCHAR(7) NULL État
ACTIVATION_TIME VARCHAR(9) NULL Horodatage d'activation
TEXT_DESCRIPTION GRAPHIC VARYING NULL Texte descriptif