Aller au contenu

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

QSYS2.ASSOCIATE_JOURNAL_RECEIVER

Réassocier un récepteur de journal

Rétablit l'association entre un journal et un récepteur de journal, par exemple après une restauration, et renvoie le résultat de l'opération.

À quoi ça sert

Cette fonction de table rétablit l'association entre le journal (JOURNAL_LIBRARY, JOURNAL_NAME) et le récepteur de journal (RECEIVER_LIBRARY, RECEIVER_NAME). Elle est utile après une restauration où le journal et ses récepteurs ne sont plus reliés.

Le jeu de résultats rappelle les noms fournis et ajoute le résultat, son détail et un code retour : on vérifie ainsi que l'opération a réussi sans consulter le journal de travail. Le service modifie la chaîne de récepteurs du journal : à manier avec précaution.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT * 
 FROM TABLE ( 
   QSYS2.ASSOCIATE_JOURNAL_RECEIVER('APPLIB', 'APPJRN', 'RCVRLIB', 'RCV001'))

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

JOURNAL_LIBRARY Bibliothèque du journal JOURNAL_NAME Nom du journal RECEIVER_LIBRARY Bibliothèque du récepteur de journal RECEIVER_NAME Nom du récepteur de journal RESULT Résultat RESULT_DETAIL Détail du résultat RETURN_CODE Code retour
APPLIB APPJRN RCVRLIB RCV001 FAILURE Journal library not found 6

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

Rétablir l'association entre le journal APPLIB/APPJRN et le récepteur de journal RCVRLIB/RCV001.

-- Description: Re-establish the association of journal APPLIB/APPJRN with journal 
     --  receiver RCVRLIB/RCV001. 
 SELECT * 
 FROM TABLE ( 
   QSYS2.ASSOCIATE_JOURNAL_RECEIVER('APPLIB', 'APPJRN', 'RCVRLIB', 'RCV001'));

Paramètres

ParamètreTypePar défautSignification
JOURNAL_LIBRARY CHAR(10) obligatoire Bibliothèque du journal
JOURNAL_NAME CHAR(10) obligatoire Nom du journal
RECEIVER_LIBRARY CHAR(10) obligatoire Bibliothèque du récepteur de journal
RECEIVER_NAME CHAR(10) obligatoire Nom du récepteur de journal

Colonnes renvoyées (7)

Afficher les 7 colonnes
ColonneTypeSignification
JOURNAL_LIBRARY VARCHAR(10) Bibliothèque du journal
JOURNAL_NAME VARCHAR(10) Nom du journal
RECEIVER_LIBRARY VARCHAR(10) Bibliothèque du récepteur de journal
RECEIVER_NAME VARCHAR(10) Nom du récepteur de journal
RESULT VARCHAR(7) Résultat
RESULT_DETAIL GRAPHIC VARYING Détail du résultat
RETURN_CODE INTEGER Code retour