STRJRNAP

La commande STRJRNAP (Démarrer la journalisation de chemin d'accès) permet de démarrer la journalisation des chemins d'accès de tous les membres d'un fichier base de données. Le chemin d'accès de tout membre ajouté ultérieurement au fichier sera également journalisé.

Si un fichier physique est indiqué, la journalisation peut être lancée pour ses chemins d'accès. Dans ce cas, cette journalisation est effectuée uniquement sur les chemins d'accès à ses membres. La journalisation des chemins d'accès de tout fichier logique doit être démarrée explicitement.

Les postes de journal créés après l'exécution de cette commande ne peuvent pas être utilisés pour une opération d'application ou de retrait de modifications journalisées. Ils servent uniquement à rétablir le chemin d'accès sans le reconstruire, après une fin anormale du système.

Si vous lancez la journalisation de vos chemins d'accès, indiquez RCVSIZOPT(*RMVINTENT) dans la commande CRTJRN (Créer un journal) ou CHGJRN (Modifier un journal) de manière à réduire la quantité de mémoire supplémentaire nécessaire à la journalisation des chemins d'accès.

Vous pouvez vous épargner la gestion de la journalisation des chemins d'accès en recourant à la fonction de protection des chemins d'accès gérée par le système. Pour plus d'informations, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/, et aux commandes EDTRCYAP (Réviser le rétablissement de chemin d'accès) ou CHGRCYAP (Modifier le rétablissement de chemin d'accès).

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

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

Restrictions :

• Avant de procéder à la journalisation d'un chemin d'accès, tous les fichiers physiques sur lesquels il est construit doivent être journalisés au préalable dans le journal qui sera utilisé pour ce chemin d'accès. Même si tous les membres d'un fichier physique particulier sont enlevés du chemin d'accès d'un fichier logique, tous les fichiers physiques doivent être journalisés, avant le chemin d'accès, et dans le même journal que ce dernier.
• 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.
• Tous les chemins d'accès à journaliser doivent indiquer MAINT(*IMMED) ou MAINT(*DLY).
• Si seules les images après sont journalisées pour les membres de fichier physique, le système démarre automatiquement la journalisation des images avant et après pour ce fichier physique, une fois que la journalisation a été démarrée pour tout chemin d'accès construit à partir du fichier physique. Lorsque la journalisation des chemins d'accès est arrêtée, le système arrête automatiquement la journalisation des images avant pour le fichier physique et journalise uniquement les images après.
• Les substitutions ne sont pas appliquées aux fichiers indiqués dans le paramètre FILE.
• 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/.
• Traitement du verrouillage

  Le fichier comportant le chemin d'accès au démarrage de la journalisation est verrouillé à l'aide d'un verrou exclusif avec lecture permise (*EXCLRD).

Paramètres

Nom du fichier journalisé (FILE)

Indique jusqu'à 300 fichiers base de données dont les chemins d'accès sont journalisés.

Ce paramètre est obligatoire.

Qualificatif 1 : Nom du fichier journalisé

nom-fichier

Indiquez le nom du fichier.

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 postes de journal de modifications de fichier.

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.

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

STRJRNAP   FILE(MYFILE)  JRN(MYLIB/JRNLA)

Cette commande journalise vers le journal JRNLA de la bibliothèque MYLIB, tous les chemins d'accès de tous les membres du fichier MYFILE (à l'aide de la liste de recherche des bibliothèques).

Messages d'erreur

Messages *ESCAPE

CPF6971

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

CPF6972

Impossible d'allouer chemin d'accès pour fichier &1 de &2.

CPF7003

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

CPF7004

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

CPF7008

Démarrage ou arrêt impossible de la journalisation des chemins d'accès pour fichier &1.

CPF7009

Tous les fichiers sous-jacents ne sont pas journalisés dans &3.

CPF7011

Ressources ou mémoire insuffisantes.

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.

CPF705A

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

CPF7079

Journalisation de chemin d'accès non démarrée pour fichier &1.

CPF708D

Récepteur de journal endommagé au niveau logique.

CPF7084

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

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.

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.