STRJRNPF

La commande STRJRNPF (Démarrer la journalisation de fichier physique) permet de démarrer la journalisation des modifications apportées à un fichier base de données physique. Les modifications effectuées dans les nouveaux membres ajoutés au fichier seront également journalisées.

L'utilisateur peut indiquer que seule l'image après ou les deux images avant et après des enregistrements du fichier physique 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). En outre, le système capte automatiquement les images avant pour un fichier base de données si le fichier est ouvert sous contrôle de validation. Pour plus d'informations sur le contrôle de validation, reportez-vous au manuel Rubrique Base de données de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Après le début de la journalisation du fichier et après l'ajout de membres à celui-ci, l'utilisateur doit exécuter la commande SAVCHGOBJ (Sauvegarder l'objet modifié) en veillant à indiquer OBJTYPE(*FILE) et OBJJRN(*YES). En outre, le fichier doit être sauvegardé car les modifications journalisées ne peuvent pas être appliquées à une version du fichier sauvegardée avant la journalisation.

Quand le fichier journalisé est réparti, la commande STRJRNPF l'est également à condition que la journalisation ait démarré sans incident au niveau local. Même si la demande de répartition échoue, le fichier local reste journalisé.

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)
• Bibliothèques - STRJRNLIB (Démarrer la journalisation de bibliothèque)
• Autres objets - STRJRNOBJ (Démarrer la journalisation d'objet)

Restrictions :

• Le fichier ne doit pas journaliser de modifications dans un autre journal.
• Les substitutions ne sont pas appliquées aux fichiers indiqués dans le paramètre FILE.
• 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 à la rubrique consacrée à la gestion du journal.
• Dans le cas de travaux à unités d'exécution multiples, cette commande n'admet pas l'utilisation d'unités d'exécution multiples pour les fichiers répartis. Elle échoue dans le cas de fichiers répartis utilisant une base de données relationnelle de type *SNA.
• Si le fichier comporte des colonnes LOB (Large Object) et si le total de ces colonnes ajouté à la taille de l'enregistrement est supérieur à 15 761 440 octets, le fichier ne peut être journalisé que dans un journal défini avec RCVSIZOPT(*MAXOPT2) ou RCVSIZOPT(*MAXOPT3).
• Traitement du verrouillage

  Le fichier physique pour démarrer la journalisation est verrouillé à l'aide d'un verrou exclusif avec lecture permise (*EXCLRD). Tous les fichiers physiques créés sur le fichier physique sont également verrouillés à l'aide d'un verrou exclusif avec lecture permise (*EXCLRD).

Paramètres

Fichier physique à journaliser (FILE)

Indique jusqu'à 300 fichiers physiques dont les modifications doivent être journalisées.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier physique à journaliser

*ALL

Les modifications de tous les fichiers physiques de la bibliothèque spécifiée seront écrites dans le journal.

nom-générique

Indiquez le nom générique du fichier physique 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 tous les fichiers physiques dont le nom commence par le même préfixe que le nom générique seront journalisées.

nom-fichier

Indiquez le nom du fichier physique dont les modifications vont ê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.

Journal (JRN)

Indique le journal destiné à recevoir les modifications journalisées.

Ce paramètre est obligatoire.

Qualificatif 1 : Journal

nom-journal

Indiquez le nom du journal.

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 d'enregistrement (IMAGES)

Indique les types d'images à journaliser lorsque des modifications sont apportées aux enregistrements du fichier.

*AFTER

Seules les images après sont journalisées.

*BOTH

Le système journalise à la fois les images avant et les images après.

Postes de journal à omettre (OMTJRNE)

Indique les postes de journal à omettre.

*NONE

Aucun poste de journal n'est omis.

*OPNCLO

Les postes d'ouverture et de fermeture sont omis. Les opérations d'ouverture et de fermeture sur les membres du fichier indiqué ne créent pas de postes d'ouverture et de fermeture dans le journal. Ceci empêche l'utilisation de postes TOJOBO et TOJOBC dans les commandes APYJRNCHG (Appliquer les modifications journalisées) et RMVJRNCHG (Enlever les modifications journalisées) mais permet d'économiser de l'espace mémoire dans les récepteurs attaché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

STRJRNPF   FILE(MYFILE)  JRN(MYLIB/JRNLA)

Cette commande journalise vers le journal JRNLA de la bibliothèque MYLIB, toutes les modifications de tous les membres du fichier MYFILE (à l'aide de la liste de recherche des bibliothèques). Seules les images après des enregistrements mis à jour sont écrites dans le journal.

Messages d'erreur

Messages *ESCAPE

CPF6971

Journalisation de l'objet &1 empêchée par dommage.

CPF6979

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

CPF70A6

L'objet &1 de la bibliothèque &2 membre &3 n'est pas admissible pour l'opération demandée.

CPF700A

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

CPF700D

Fichier &1 de la bibliothèque &2 non journalisé.

CPF7002

Le fichier &1 de la bibliothèque &2 n'est pas un fichier physique.

CPF7003

Poste non journalisé dans &1. Code raison &3.

CPF7004

Nombre maximal d'objets journalisés dans &1.

CPF7011

Ressources ou mémoire insuffisantes.

CPF703B

L'arrêt implicite de la journalisation des chemins d'accès a échoué.

CPF703C

Une transaction de contrôle de validation fait obstacle à l'opération de journalisation.

CPF7030

Objet de type *&3 déjà journalisé.

CPF7031

Impossible d'allouer membre &3 du fichier &1 de &2.

CPF7033

Echec de démarrage ou arrêt de journalisation pour membre &3.

CPF7034

Dommage logique du fichier &1 de &2.

CPF7035

Objet &1 de &2 déjà connu du journal.

CPF704B

Journalisation démarrée localement, mais échec des demandes réparties.

CPF705A

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

CPF7057

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

CPF7084

Echec de l'opération de journal pour l'objet de type *&6.

CPF708D

Récepteur de journal endommagé au niveau logique.

CPF709D

Impossible de démarrer la journalisation de l'objet de type *&7.

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.

CPF9812

Fichier &1 non trouvé dans la bibliothèque &2.

CPF9820

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

CPF9822

Non autorisé au fichier &1 de &2.

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.