STRJRNOBJ

La commande STRJRNOBJ permet de démarrer la journalisation des modifications apportées à un objet ou à une liste d'objets dans un journal donné. Les types d'objet pris en charge via cette interface sont les suivants : *DTAARA (zones de données) et *DTAQ (files d'attente de données). Pour plus d'informations sur les postes de journal pouvant être envoyés, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/. Recherchez "programme de recherche de poste de journal".

Par ailleurs, l'utilisateur peut indiquer que seule l'image après ou les deux images avant et après d'un objet de type *DTAARA doivent être journalisées. Les images avant sont nécessaires à la suppression des modifications journalisées par la commande RMVJRNCHG (Enlever des modifications journalisées).

Une fois que la journalisation a commencé pour l'objet, l'utilisateur doit sauvegarder le journalisé afin de conserver les informations relatives aux attributs du journal. En outre, l'objet doit être sauvegardé car, par exemple, les modifications journalisées ne peuvent pas être appliquées à une version de l'objet sauvegardée avant la journalisation.

Les commandes suivantes vous offrent d'autres méthodes de démarrage de la journalisation :

• Chemins d'accès - STRJRNAP (Démarrer la journalisation de chemin d'accès)
• Objets du système de fichiers intégré - STRJRN (Démarrer la journalisation)
• Fichiers physiques - STRJRNPF (Démarrer la journalisation de fichier physique)
• Bibliothèques - STRJRNLIB (Démarrer la journalisation de bibliothèque)

Restrictions :

• L'objet ne doit pas journaliser de modifications dans un autre journal.
• Le nombre maximal d'objets pouvant être associés à un journal est 250 000 ou 10 000 000. Pour obtenir 10 000 000, la valeur de *MAX10M est fixée par le paramètre JRNOBJLMT de la commande CRTJRN (Créer un journal) ou CHGJRN (Modifier un journal). Si le nombre d'objets est supérieur ou égal à cette valeur maximale, la journalisation ne démarre pour aucun objet.
• Le journal indiqué doit être local. Bien que les modifications de types d'objet qui peuvent être journalisés dans un journal local puissent être envoyées à un journal éloigné, cette procédure s'effectue en deux temps. Démarrez tout d'abord la journalisation dans le journal local. Connectez ensuite le journal local à une instance éloignée. Pour établir une telle connexion, utilisez la commande ADDRMTJRN ou l'API QjoAddRemoteJournal (ajout de journal éloigné). Pour plus d'informations sur la journalisation éloignée, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
• Le journal et l'objet indiqués doivent résider dans le même pool de mémoire secondaire (ASP).
• En ce qui concerne les zones de données, seuls les objets de zone de données externe locale peuvent être journalisés. Les zones de données spéciales (*LDA, *GDA et *PDA) et DDM ne peuvent pas être journalisés.
• Seules les files d'attente de données locales sont prises en charge. Les files d'attente de données DDM ne peuvent pas être journalisées.
• Traitement du verrouillage

  L'objet pour démarrer la journalisation est verrouillé à l'aide d'un verrou exclusif avec lecture permise (*EXCLRD).

Paramètres

Objet (OBJ)

Indique les noms qualifiés d'objets (jusqu'à 300) pour lesquels les modifications doivent être journalisées.

Ce paramètre est obligatoire.

Qualificatif 1 : Objet

*ALL

Les modifications de tous les objets du type indiqué dans la bibliothèque spécifiée seront écrites dans le journal.

nom-générique

Indiquez le nom générique de l'objet dont les modifications vont être journalisées. Un nom générique est composé d'un ou de plusieurs caractères suivis d'un astérisque (*). Si un nom générique est indiqué, les modifications apportées à tous les objets du type d'objet indiqué dont le nom commence par le même préfixe que le nom générique sont journalisées.

nom-objet

Indiquez le nom de l'objet dont les modifications doivent être journalisées.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le système effectue la recherche dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Type d'objet (OBJTYPE)

Indique le type d'objet pour lequel les modifications doivent être journalisées.

Ce paramètre est obligatoire.

*DTAARA

Les modifications apportées aux objets de la zone de données vont être journalisées.

*DTAQ

Les modifications apportées aux objets de la file d'attente de données vont être journalisées.

Journal (JRN)

Indique le journal recevant les modifications journalisées.

Ce paramètre est obligatoire.

Qualificatif 1 : Journal

nom-journal

Indiquez le nom du journal recevant les modifications journalisées.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le système effectue la recherche dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Images (IMAGES)

Indique les types d'images écrits dans le récepteur de journal lorsque des modifications sont apportées aux objets.

*AFTER

Seules les images après sont générées lorsque des modifications sont apportées aux objets.

*BOTH

Le système journalise à la fois des images avant et des images après lorsque des modifications sont apportées à l'objet.

Remarque :La valeur *BOTH n'est admise que pour les objets *DTAARA.

Niveau de consignation (LOGLVL)

Indique le niveau d'enregistrement des erreurs utilisé. Ce paramètre permet de déterminer les messages qui vont être envoyés.

*ERRORS

Tous les messages de diagnostic et d'arrêt programme sont envoyés, mais la commande n'enverra pas de messages d'achèvement pour chaque objet. A l'issue de cette commande, un message d'achèvement est envoyé.

*ALL

La commande envoie tous les messages qui seraient envoyés avec *ERRORS, ainsi que le message d'achèvement pour chaque objet.

Exemples

STRJRNOBJ   OBJ(DTALIB/MYDTAARA)  OBJTYPE(*DTAARA)
            JRN(MYLIB/JRNLA)

Cette commande journalise dans le journal JRNLA de la bibliothèque MYLIB, toutes les modifications apportées à la zone de données MYDTAARA de la bibliothèque DTALIB. Seules les images après des enregistrements mis à jour sont écrites dans le journal.

Messages d'erreur

Messages *ESCAPE

CPF6979

Journal &1 de la bibliothèque &2 inutilisable.

CPF700A

La journalisation a démarré pour &1 objet(s) sur &2.

CPF705A

Echec de l'opération car journal éloigné.

CPF7057

*LIBL n'est pas admis avec *ALL, *ALLLIB ou un nom générique.

CPF9801

Objet &2 non trouvé dans la bibliothèque &3.

CPF9802

Non autorisé à l'objet &2 de &3.

CPF9803

Impossible d'allouer l'objet &2 de la bibliothèque &3.

CPF9810

Bibliothèque &1 non trouvée.

CPF9820

Non autorisé à utiliser la bibliothèque &1.

CPF9825

Accès non autorisé à l'unité &1.

CPF9830

Allocation de la bibliothèque &1 impossible.

CPF9873

Accès à l'objet impossible en raison de l'état de l'ASP.

CPF9875

Ressources insuffisantes dans l'ASP &1.Appuyez sur AIDE.