STRJRNLIB

La commande STRJRNLIB (Démarrer la journalisation de bibliothèque) permet de démarrer la journalisation des modifications (apportées à une bibliothèque ou une liste de bibliothèques) dans un journal donné et éventuellement de démarrer la journalisation des modifications apportées aux objets de la bibliothèque ou de la liste de bibliothèques. Les objets créés, déplacés ou restaurés dans une bibliothèque journalisée peuvent être automatiquement journalisés dans le même journal que la bibliothèque. 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".

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 objets créés, déplacés ou restaurés dans la bibliothèque admissibles pour la journalisation peuvent automatiquement démarrer la journalisation dans le même journal que la bibliothèque. Les objets héritant de l'état de journal de la bibliothèque et les attributs avec lesquels ils démarrent la journalisation sont déterminés par les attributs de journalisation d'héritage de la bibliothèque.

Utilisez la commande DSPLIBD (Afficher une description de bibliothèque) pour afficher les informations de journal incluant les règles d'héritage de la bibliothèque.

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)
• Autres objets - STRJRNOBJ (Démarrer la journalisation d'objet)

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).
• Les bibliothèques suivantes ne peuvent pas être journalisées : QSYS, QSYSxxxxx, QSYS2, QSYS2xxxxx, QPTFOBJ1, QPTFOBJ2, QRECOVERY, QRCYxxxxx, QSPL, QSPLxxxxx, QRCL, QRCLxxxxx, QRPLOBJ, QRPLxxxxx, QGPL, QTEMP, SYSIBM, SYSIBxxxxx, SYSIBMADM, SYSPROC et SYSTOOLS, où xxxxx est le numéro à cinq chiffres d'un pool de mémoire secondaire indépendant (IASP).
• Traitement du verrouillage

  Le bibliothèque pour démarrer la journalisation est verrouillée à l'aide d'un verrou exclusif avec lecture permise (*EXCLRD).

Paramètres

Biblio (LIB)

Indique jusqu'à 300 noms de bibliothèque pour lesquelles les modifications doivent être journalisées.

nom-générique

Indiquez le nom générique de la bibliothèque 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 de toutes les bibliothèques dont le nom commence par le même préfixe que le nom générique seront journalisées.

nom-bibliothèque

Indiquez le nom de la bibliothèque dont les modifications doivent ê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.

Règles d'héritage (INHRULES)

Indique les objets créés, déplacés ou restaurés dans une bibliothèque journalisée devant hériter de l'état du journal de la bibliothèque ainsi que les attributs de journalisation auxquels ils doivent être associés.

Chaque règle définit les types d'objet, les noms d'objet et les opérations auxquels elle s'applique. Plusieurs règles peuvent être définies pour le même ensemble d'objets. Si plusieurs règles sont définies pour un même objet et une même opération, c'est la dernière règle définie pour cet objet qui s'applique.

Ces règles n'affectent que les objets créés / restaurés dans la bibliothèque ou déplacés vers la bibliothèque. Si les objets inclus dans la bibliothèque sont rebaptisés, l'état et les attributs de journalisation de ces objets ne sont pas modifiés. Une fois les objets journalisés, leur journalisation n'est pas automatiquement interrompue lorsqu'ils sont extraits de la bibliothèque. Par ailleurs, pour les objets journalisés avant déplacement vers la bibliothèque, ce déplacement ne modifie pas l'état ou les attributs de journalisation.

Elément 1 : Type d'objet

Indiquez le type des objets identifiés par cette règle.

*ALL

Cette règle s'applique à tous les objets qui peuvent être journalisés.

*DTAARA

Cette règle s'applique aux zones de données.

*DTAQ

Cette règle s'applique aux files d'attente de données.

*FILE

Cette règle s'applique aux fichiers physiques de la base de données.

Elément 2 : Opération

Indique l'opération ou les opérations identifiée(s) par cette règle.

*ALLOPR

Cette règle s'applique à tous les objets créés / restaurés dans la bibliothèque ou déplacés vers la bibliothèque. Il s'agit d'une combinaison des valeurs *CREATE, *MOVE et *RESTORE. Voir leurs descriptions pour plus d'informations.

*CREATE

Cette règle s'applique à tous les objets créés dans la bibliothèque.

*MOVE

Cette règle s'applique à tous les objets déplacés dans la bibliothèque, s'il n'ont pas déjà été journalisés.

*RESTORE

Cette règle s'applique à tous les objets restaurés dans la bibliothèque. Si un objet est restauré sur un objet existant, l'objet restauré conservera l'état de journal et les attributs de journalisation de l'objet sur lequel il a été restauré. Si un objet n'a jamais été journalisé lors de sa sauvegarde, sa journalisation commence lors de sa restauration dans la bibliothèque. Dans le cas contraire, si un objet a été journalisé lors de sa sauvegarde, il tentera en premier lieu de lancer la journalisation dans le journal dans lequel il a été journalisé lors de sa sauvegarde, avec les mêmes attributs de journalisation. Si ce journal n'existe pas, l'objet lancera la journalisation dans le même journal dans lequel la bibliothèque est journalisée, avec les attributs de journalisation définis par cette règle. Une règle *RESTORE spécifiée va remplacer toutes les règles précédentes pour le même type d'objet avec *RSTOVRJRN indiqué.

Si la valeur *OMIT a été attribuée à l'action associée à la règle et que l'objet n'est pas restauré sur un objet existant, l'objet restauré conservera le même état de journal et les mêmes attributs de journalisation d'avant sa sauvegarde. L'état de journal de la bibliothèque est ignoré.

*RSTOVRJRN

Cette règle s'applique à tous les objets restaurés dans la bibliothèque. Si un objet est restauré sur un objet existant, l'objet restauré conservera l'état de journal et les attributs de journalisation de l'objet sur lequel il a été restauré. Dans le cas contraire, l'objet lancera la journalisation dans le même journal dans lequel la bibliothèque est journalisée, avec les attributs de journalisation définis par cette règle. Une règle *RSTOVRJRN spécifiée va remplacer toutes les règles précédentes pour le même type d'objet avec *RESTORE indiqué.

Si la valeur *OMIT a été attribuée à l'action associée à la règle et que l'objet n'est pas restauré sur un objet existant, l'objet restauré conservera le même état de journal et les mêmes attributs de journalisation d'avant sa sauvegarde. L'état de journal de la bibliothèque est ignoré.

Elément 3 : Action associée à la règle

Indique si les objets correspondant au type d'objet et à l'opération de cette règle seront inclus ou ignorés dans la liste des objets qui héritent de l'état de journal de la bibliothèque.

*INCLUDE

Tous les objets correspondant au type d'objet et à l'opération hériteront de l'état du journal de la bibliothèque et utiliseront les attributs de journalisation définis par cette règle.

*OMIT

Tous les objets correspondant au type d'objet et à l'opération n'hériteront pas de l'état du journal de la bibliothèque. Cette valeur se substitue à la valeur *INCLUDE et doit être utilisée pour omettre un sous-ensemble d'une règle préalablement définie.

Elément 4 : Images

Indique les types des images écrites dans le récepteur de journal lorsque des modifications sont apportées à des objets qui héritent de l'état du journal de la bibliothèque.

Remarque :Cet élément est ignoré si *OMIT est indiqué pour l'action associée à la règle.

*OBJDFT

La valeur par défaut de chaque type d'objet sera utilisée pour cet attribut de journalisation lorsqu'un objet hérite de l'état du journal de la bibliothèque. Les fichiers base de données (*FILE) comporteront des images avant et après générées par le système (*BOTH). Tous les autres types d'objet ne comporteront que des images après générées par le système (*AFTER).

*AFTER

Seules les images après sont générées pour les objets qui héritent de l'état du journal de la bibliothèque.

*BOTH

Les images avant et après sont générées pour les objets qui héritent de l'état du journal de la bibliothèque.

Remarque :La valeur *BOTH est correcte à la fois pour les objets zone de données (*DTAARA) et les objets fichier base de données (*FILE). Si *BOTH est indiqué et que *ALL est précisé pour Type d'objet, le système générera les images avant et après pour les zones de données et les fichiers base de données. Tous les autres types d'objet généreront uniquement des images après.

Elément 5 : Omettre poste de journal

Indique les postes de journal omis pour les objets qui héritent de l'état du journal de la bibliothèque.

Remarque :Cet élément est ignoré si *OMIT est indiqué pour l'action associée à la règle.

*OBJDFT

La valeur par défaut de chaque type d'objet sera utilisée pour cet attribut de journalisation lorsqu'un objet hérite de l'état du journal de la bibliothèque. Les fichiers base de données (*FILE) omettront les postes d'ouverture et de fermeture. Aucun autre type d'objet n'omettra les postes de journal.

*NONE

Aucun poste de journal ne sera omis pour les objets qui héritent de l'état du journal de la bibliothèque.

*OPNCLO

Les postes d'ouverture et de fermeture sont omis pour le fichier base de données (*FILE) qui héritent de l'état du journal de la bibliothèque. Ceci empêche l'utilisation de postes TOJOBO et TOJOBC dans la commande APYJRNCHG (Appliquer les modifications journalisées), mais permet d'économiser de l'espace mémoire dans les récepteurs de journal.

Remarque :La valeur *OPNCLO est valide uniquement pour les fichiers base de données (*FILE). Si *OPNCLO est spécifié et que *ALL est indiqué pour Type d'objet, les fichiers base de données omettront les postes d'ouverture et de fermeture. Tous les autres types d'objet n'omettront pas les postes de journal.

Elément 6 : Filtre de journaux éloignés

Indique si les postes de journal consignés pour les objets qui héritent de l'état du journal de la bibliothèque doivent être admissibles pour un filtrage par objet du journal éloigné.

Pour plus de détails concernant le filtrage d'un journal éloigné, reportez-vous à la commande CHGRMTJRN (Modifier un journal éloigné) ou à l'API QjoChangeJournalState (Modification d'état de journal).

Remarque :Cet élément est ignoré si *OMIT est indiqué pour l'action associée à la règle.

*OBJDFT

La valeur par défaut de chaque type d'objet sera utilisée pour cet attribut de journalisation lorsqu'un objet hérite de l'état du journal de la bibliothèque. Pour tous les types d'objet, les postes de journal consignés pour les objets qui héritent de l'état du journal de la bibliothèque ne seront pas admissibles pour un filtrage par objet du journal éloigné.

*NO

Les postes de journal consignés pour les objets qui héritent de l'état du journal de la bibliothèque ne seront pas admissibles pour un filtrage par objet du journal éloigné.

*YES

Les postes de journal consignés pour les objets qui héritent de l'état du journal de la bibliothèque seront admissibles pour un filtrage par objet du journal éloigné. Lors d'un filtrage par objet du journal éloigné, les postes du journal pour l'objet ne seront pas envoyés au système cible.

Elément 7 : Filtre de noms

Indique les noms des objets identifiés par la règle.

*ALL

La règle s'applique à tous les objets répondant aux autres critères.

nom

La règle s'applique à tous les objets répondant aux autres critères et correspondant au nom indiqué.

nom-générique

La règle s'applique à tous les objets répondant aux autres critères et correspondant au nom générique indiqué.

Remarque :Un nom générique peut se présenter sous la forme d'une chaîne d'un ou plusieurs caractères suivis d'un astérisque (*). Si un nom générique est spécifié, tous les objets dont le nom comporte le même préfixe que le nom d'objet générique sont sélectionnés.

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

Exemple 1 : Démarrage de la journalisation d'une seule bibliothèque

STRJRNLIB  LIB(MYLIBA) JRN(MYLIBA/JRN)

Cette commande journalise toutes les modifications apportées à la bibliothèque MYLIBA dans le journal JRN de MYLIBA. De même, la journalisation de tous les objets qui peuvent l'être et qui sont créés, déplacés ou restaurés dans cette bibliothèque démarrera automatiquement dans le journal JRN de MYLIBA.

Exemple 2 : Démarrage de la journalisation d'une bibliothèque et héritage sélectif de la journalisation

STRJRNLIB LIB(MYLIBC) JRN(MYLIBC/JRN)
          INHRULES((*FILE *ALLOPR *INCLUDE *BOTH *OPNCLOSYN)
                   (*DTAARA *CREATE *INCLUDE *OBJDFT *OBJDFT))

Cette commande journalise toutes les modifications apportées à la bibliothèque MYLIBC dans le journal JRN de MYLIBC. La journalisation de tous les fichiers créés, déplacés ou restaurés dans la bibliothèque MYLIBC démarrera dans le journal JRN de la bibliothèque MYLIBC, générera des images avant et après et omettra les postes d'ouverture et de fermeture. La journalisation de toutes les zones de données créées dans la bibliothèque MYLIBC démarrera.

Exemple 3 : Démarrage de la journalisation d'une bibliothèque et héritage sélectif de la journalisation avec omission

STRJRNLIB LIB(MYLIBD) JRN(MYLIBA/JRN)
          INHRULES((*ALL *ALLOPR *INCLUDE *OBJDFT *OBJDFT
                    *OBJDFT)
                   (*FILE *CREATE *OMIT)
                   (*FILE *RESTORE *OMIT))

Cette commande journalise toutes les modifications apportées à la bibliothèque MYLIBD dans le journal JRN de MYLIBA. La journalisation de tous les objets qui peuvent l'être et qui sont créés, déplacés ou restaurés dans la bibliothèque MYLIBD démarrera dans le journal JRN de MYLIBA, à l'exception des fichiers créés ou restaurés dans la bibliothèque.

Exemple 4 : Démarrage de la journalisation d'une bibliothèque et héritage sélectif de la journalisation avec omission et filtrage par nom

STRJRNLIB LIB(MYLIBD) JRN(MYLIBA/JRN)
          INHRULES((*ALL *ALLOPR *INCLUDE *OBJDFT *OBJDFT
                    *OBJDFT *ALL)
                   (*FILE *ALLOPR *OMIT *OBJDFT *OBJDFT
                    *OBJDFT W*))

Cette commande journalise toutes les modifications apportées à la bibliothèque MYLIBD dans le journal JRN de MYLIBA. La journalisation de tous les objets qui peuvent l'être et qui sont créés, déplacés ou restaurés dans la bibliothèque MYLIBD démarrera dans le journal JRN de MYLIBA, à l'exeption des fichiers dont le nom commence par 'W'.

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é.

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.