Aller au contenu

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

QSYS2.CHECK_REPLICATION_CRITERIA

Vérifier l'état de réplication d'un objet

Fonction scalaire Db2 Mirror qui indique l'état d'inclusion dans la réplication d'une bibliothèque ou d'un objet donné.

À 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 indique si un objet ou une bibliothèque est inclus ou exclu de la réplication, selon les critères en vigueur.

On lui donne l'ASP (IASP_NAME), la bibliothèque (LIBRARY_NAME) et le type d'objet (OBJECT_TYPE), éventuellement le nom (OBJECT_NAME), ainsi que APPLY_STATE et APPLY_LABEL. Elle ne modifie rien et s'appelle avec VALUES.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

VALUES QSYS2.CHECK_REPLICATION_CRITERIA(IASP_NAME    => '*SYSBAS',                            
                                            LIBRARY_NAME => 'APPLIB1',                            
                                            OBJECT_TYPE  => '*FILE',                              
                                            OBJECT_NAME  => 'MYTABLE')

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

00001
EXCLUDE

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 l'état d'inclusion dans la réplication du fichier MYTABLE de la bibliothèque APPLIB1.

-- Description: Check the replication inclusion state for file MYTABLE in                          
-- library APPLIB1.                                                                                 
    VALUES QSYS2.CHECK_REPLICATION_CRITERIA(IASP_NAME    => '*SYSBAS',                            
                                            LIBRARY_NAME => 'APPLIB1',                            
                                            OBJECT_TYPE  => '*FILE',                              
                                            OBJECT_NAME  => 'MYTABLE');

Paramètres

ParamètreTypePar défautSignification
IASP_NAME VARCHAR(10) obligatoire Nom de l'ASP indépendant
LIBRARY_NAME VARCHAR(10) obligatoire Nom de la bibliothèque
OBJECT_TYPE VARCHAR(8) obligatoire Type de l'objet
OBJECT_NAME VARCHAR(128) NULL Nom de l'objet
APPLY_STATE VARCHAR(7) NULL État d'application
APPLY_LABEL VARCHAR(26) NULL Libellé d'application