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ètre | Type | Par défaut | Signification |
|---|---|---|---|
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 |