Aller au contenu

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

QSYS2.VALIDATE_PENDING_REPLICATION_CRITERIA

Validation des critères de réplication Db2 Mirror

Fonction de table Db2 Mirror qui liste les règles de réplication actives et en attente pour un libellé d'application, avec leur ordre de priorité.

À quoi ça sert

VALIDATE_PENDING_REPLICATION_CRITERIA appartient à Db2 Mirror for i (option 48 de 5770SS1). Elle renvoie les règles de réplication actives et en attente pour un ASP (IASP_NAME) et, en option, un libellé d'application (APPLY_LABEL) : identifiant de la règle, état d'application, état d'inclusion, ordre de priorité, bibliothèque, type et nom d'objet, source de la règle.

Elle indique aussi les anomalies détectées, avec le SQLSTATE, l'identifiant et le texte du message, ce qui permet de contrôler les règles avant de les appliquer.

Elle n'est utile que si Db2 Mirror est configuré. Le tri par PRECEDENCE_ORDER montre l'ordre dans lequel les règles s'appliquent.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT * FROM TABLE(QSYS2.VALIDATE_PENDING_REPLICATION_CRITERIA(IASP_NAME => '*SYSBAS',       
                                                                    APPLY_LABEL => 'TESTGROUP1')) 
     ORDER BY PRECEDENCE_ORDER

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 toutes les règles de critères de réplication actives et en attente associées au libellé TESTGROUP1.

-- Description: List all the active and pending replication criteria rules                         
-- associated with apply-label TESTGROUP1.                                                          
    SELECT * FROM TABLE(QSYS2.VALIDATE_PENDING_REPLICATION_CRITERIA(IASP_NAME => '*SYSBAS',       
                                                                    APPLY_LABEL => 'TESTGROUP1')) 
     ORDER BY PRECEDENCE_ORDER;

Paramètres

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

Colonnes renvoyées (16)

Afficher les 16 colonnes
ColonneTypeSignification
RULE_IDENTIFIER BIGINT Identifiant de la règle
APPLY_STATE VARCHAR(14) État d'application
INCLUSION_STATE VARCHAR(10) État d'inclusion
PRECEDENCE_ORDER SMALLINT Ordre de priorité
APPLY_LABEL VARCHAR(26) Libellé d'application
IASP_NAME VARCHAR(10) Nom de l'ASP indépendant
LIBRARY_NAME VARCHAR(10) Nom de la bibliothèque
OBJECT_TYPE VARCHAR(8) Type de l'objet
OBJECT_NAME VARCHAR(128) Nom de l'objet
RULE_SOURCE VARCHAR(6) Source de la règle
REMOVABLE VARCHAR(3) Amovible
RESTRICTED VARCHAR(3) Restreint
SQLSTATE CHAR(5) Code SQLSTATE
MESSAGE_ID VARCHAR(7) Identifiant du message
MESSAGE_TEXT GRAPHIC VARYING Texte du message
MESSAGE_SECOND_LEVEL_TEXT GRAPHIC VARYING Texte de second niveau du message