Aller au contenu

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

QSYS2.EVALUATE_PENDING_REPLICATION_CRITERIA

Évaluer les critères de réplication en attente

Liste les objets concernés par un changement de critère de réplication Db2 Mirror encore en attente, avec le résultat de leur comparaison entre les deux nœuds.

À quoi ça sert

La fonction de table QSYS2.EVALUATE_PENDING_REPLICATION_CRITERIA montre l'effet qu'aurait la mise en application des règles de réplication en attente : pour chaque objet concerné, son état d'inclusion actuel et son état d'inclusion en attente, sa présence sur le système principal et secondaire, et le résultat de la comparaison.

Paramètres : IASP_NAME (obligatoire), COMPARE_OBJECTS pour activer ou non la comparaison des objets présents sur les deux nœuds, et APPLY_LABEL pour limiter l'évaluation aux règles associées à un libellé d'application.

Elle concerne Db2 Mirror for i (option 48 de 5770SS1) et n'est utile que si ce produit est configuré. Elle permet de prévisualiser un changement avant son traitement.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT *                                                                                        
     FROM TABLE(QSYS2.EVALUATE_PENDING_REPLICATION_CRITERIA(IASP_NAME => '*SYSBAS',               
                                                            APPLY_LABEL => 'TESTGROUP1',          
                                                            COMPARE_OBJECTS => 'NO'))             
     ORDER BY LIBRARY_NAME, OBJECT_TYPE, OBJECT_NAME

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

L'exemple d'IBM

Lister les objets ayant un changement de réplication en attente qui correspondent aux règles associées au libellé TESTGROUP1, sans comparer les objets présents sur les deux nœuds.

-- Description: List all the objects with a pending replication change that                        
-- match one of the replication criteria rules associated with apply-label TESTGROUP1.              
-- Do not perform any comparisons on objects that are found on both nodes.                          
    SELECT *                                                                                        
     FROM TABLE(QSYS2.EVALUATE_PENDING_REPLICATION_CRITERIA(IASP_NAME => '*SYSBAS',               
                                                            APPLY_LABEL => 'TESTGROUP1',          
                                                            COMPARE_OBJECTS => 'NO'))             
     ORDER BY LIBRARY_NAME, OBJECT_TYPE, OBJECT_NAME;

Paramètres

ParamètreTypePar défautSignification
IASP_NAME VARCHAR(10) obligatoire Nom de l'ASP indépendant
COMPARE_OBJECTS VARCHAR(3) NULL Comparaison des objets
APPLY_LABEL VARCHAR(26) NULL Libellé d'application

Colonnes renvoyées (11)

Afficher les 11 colonnes
ColonneTypeSignification
IASP_NAME VARCHAR(10) Nom de l'ASP indépendant
LIBRARY_NAME VARCHAR(10) Nom de la bibliothèque
OBJECT_NAME VARCHAR(128) Nom de l'objet
OBJECT_TYPE VARCHAR(8) Type de l'objet
INCLUSION_STATE VARCHAR(10) État d'inclusion
PENDING_INCLUSION_STATE VARCHAR(10) État d'inclusion en attente
OBJECT_ON_PRIMARY VARCHAR(3) Objet présent sur le système principal
OBJECT_ON_SECONDARY VARCHAR(3) Objet présent sur le système secondaire
COMPARE_RESULT VARCHAR(10) Résultat de la comparaison
OBJECT_INFO INTEGER Informations sur l'objet
OBJECT_INFO_TEXT VARCHAR(1024) Texte d'informations sur l'objet