STRJRN

La commande STRJRN (Démarrer la journalisation) 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), *DTAQ (files d'attente de données), *STMF (fichiers STREAM), *DIR (répertoires) et *SYMLNK (liens symboliques). Seuls sont pris en charges les objets de type *STMF, *DIR ou *SYMLNK présents sur les systèmes de fichiers "root" (/) et QOpenSys et sur le système permanent défini par l'utilisateur. 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".

L'utilisateur peut indiquer que seule l'image après ou les deux image 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)
• 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 :

• 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 fichiers STREAM qui sont mappés en mémoire, qui sont des fichiers de volume virtuel ou qui sont utilisés en tant qu'espaces mémoire réseau IXS ne peuvent pas être journalisés.
• Les objets marqués en interne comme non admissibles à la journalisation ne peuvent pas être journalisés. Le système peut marquer comme inadmissibles à la journalisation des répertoires qui ont été créés dans des répertoires utilisateur. Le système marquera comme non admissibles les objets présents sur tout système de fichiers temporaire défini par l'utilisateur.
• 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, *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.
• Vous devez spécifier au moins le paramètre OBJ ou OBJFID.

Paramètres

Objets (OBJ)

Indique jusqu'à 300 objets pour lesquels les modifications doivent être journalisées. Seuls les objets dont le nom de chemin identifie un objet de type *STMF, *DIR, *SYMLNK, *DTAARA ou *DTAQ sont pris en charge.

Elément 1 : Nom

'nom-chemin-objet'

Indiquez le nom de chemin de l'objet pour lequel les modifications vont être journalisées.

Il est possible d'indiquer un modèle dans la dernière partie du nom de chemin. Un astérisque (*) correspond à un nombre quelconque de caractères, alors qu'un point d'interrogation (?) désigne un seul caractère. Si le nom de chemin est qualifié ou contient un modèle, il doit figurer entre apostrophes. Les liens symboliques du nom de chemin ne seront pas suivis. S'il figure au début du nom de chemin, le caractère tilde indique que le chemin d'accès est relatif au répertoire personnel approprié.

Pour plus d'informations sur les modèles de noms de chemins, reportez-vous au manuel Rubriques Système de fichiers intégré de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Elément 2 : Inclure ou omettre

Le deuxième élément indique si les noms correspondant au modèle doivent être inclus ou non dans l'opération. Lors de l'opération permettant de déterminer si un nom correspond à un modèle, on considère toujours que les modèles de noms relatifs se rapportent au répertoire de travail en cours.

*INCLUDE

Les objets correspondant au modèle de nom d'objet vont être journalisés, sauf si la valeur *OMIT se substitue à cette valeur.

*OMIT

Les objets correspondant au modèle de nom d'objet ne vont pas être journalisés. Cette valeur se substitue à la valeur *INCLUDE et doit être utilisée pour omettre un sous-ensemble d'un chemin préalablement sélectionné.

Identificateur de fichier (OBJFID)

Indique jusqu'à 300 identificateurs de fichier (FID) pour lesquels les modifications doivent être journalisées. Les FID sont des identificateurs uniques associés à des objets liés au système de fichiers intégré. Cette zone admet les entrées au format hexadécimal. Seuls les objets dont le FID identifie un objet de type *STMF, *DIR ou *SYMLNK présent dans les systèmes de fichier "root" (/), QOpenSys ou définis par l'utilisateur, ou les objets de type *DTAARA ou *DTAQ, sont pris en charge.

identificateur-fichier

Les objets identifiés par le FID sont journalisés.

Journal (JRN)

Indique le nom de chemin du journal recevant les modifications journalisées.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

'nom-chemin-journal'

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

Branche du répertoire (SUBTREE)

Indique si les branches de répertoire sont incluses dans l'opération de démarrage de la journalisation.

Remarque :Ce paramètre est ignoré si OBJ n'est pas indiqué.

Remarque :Ce paramètre n'est pris que compte si nom-chemin-objet est un objet de répertoire (*DIR).

*NONE

Seuls les objets correspondant aux critères de sélection sont traités. Les objets contenus dans les répertoires sélectionnés ne sont pas traités implicitement.

*ALL

Tous les objets qui correspondent aux critères de sélection sont traités, ainsi que l'ensemble de la branche de chaque répertoire correspondant à ces critères. La branche inclut tous les sous-répertoires et les objets contenus dans ces derniers.

Une fois que la commande a commencé à traiter une branche d'un répertoire spécifique, les objets localisés et traités peuvent être affectés par les opérations qui mettent à jour l'organisation des objets dans l'arborescence de répertoire spécifiée. Cela inclut, sans caractère limitatif, les éléments suivants :

• Ajout, suppression ou nouvelle dénomination des liens d'objet
• Montage ou démontage des systèmes de fichiers
• Mise à jour du répertoire racine effectif pour le processus qui appelle la commande
• Mise à jour du contenu d'un lien symbolique

Pour traiter la branche du répertoire, le code du système peut augmenter le nombre maximal de descripteurs de fichier, dans la portée du processus, qui peuvent être ouverts lors du traitement. Cette opération est effectuée afin que la commande ne soit pas susceptible d'échouer en raison d'un manque de descripteurs. Cette valeur maximale de portée de processus n'est pas réinitialisée à la fin de la commande.

Masque du nom (PATTERN)

Indique au maximum 20 modèles à utiliser pour inclure ou exclure des objets pour le démarrage de la journalisation.

Seule la dernière partie du nom de chemin sera prise en compte pour déterminer si ce nom correspond au modèle. Les délimiteurs de nom de chemin ne sont pas admis dans le modèle de nom. Un astérisque (*) correspond à un nombre quelconque de caractères, alors qu'un point d'interrogation (?) désigne un seul caractère. Si le nom de chemin est qualifié ou contient un modèle, il doit figurer entre apostrophes. Les liens symboliques du nom de chemin ne seront pas suivis.

Si ce paramètre n'est pas indiqué, le nom devra correspondre par défaut à tous les modèles.

Pour plus d'informations sur les modèles de noms de chemins, reportez-vous au manuel Rubriques Système de fichiers intégré de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre est ignoré si OBJ n'est pas indiqué.

Remarque :Ce paramètre s'applique aux objets qui existent lorsque la commande de démarrage de la journalisation est traitée. Ce paramètre ne s'applique pas aux objets qui vont être créés ultérieurement dans un répertoire journalisé dans lequel les nouveaux objets héritent de la journalisation.

Elément 1 : Masque

'*'

Tous les objets correspondant au paramètre OBJP en entrée doivent être inclus ou exclus de l'opération de démarrage de la journalisation.

modèle-nom

Indiquez le modèle à utiliser pour inclure ou exclure des objets pour le démarrage de la journalisation.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Elément 2 : Inclure ou omettre

Le deuxième élément indique si les noms correspondant au modèle doivent être inclus ou non dans l'opération. Lors de l'opération permettant de déterminer si un nom correspond à un modèle, on considère toujours que les modèles de noms relatifs se rapportent au répertoire de travail en cours.

*INCLUDE

Les objets correspondant au modèle de nom d'objet sont inclus dans l'opération de démarrage de la journalisation, sauf si la valeur *OMIT se substitue à cette valeur.

*OMIT

Les objets correspondant au modèle de nom d'objet ne doivent pas être inclus dans l'opération. Cette valeur se substitue à la valeur *INCLUDE et doit être utilisée pour omettre un sous-ensemble d'un modèle préalablement sélectionné.

Nouv obj héritent journalisat (INHERIT)

Indique si les objets créés dans un répertoire journalisé doivent hériter des options et de l'état du journal de son répertoire parent.

*NO

Les objets créés dans le répertoire n'hériteront pas des options et de l'état du journal du répertoire parent.

*YES

Les objets créés dans le répertoire hériteront des options et de l'état du journal du répertoire parent.

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 génère à la fois les images avant et les images après lorsque des modifications sont apportées aux objets.

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

Omettre poste de journal (OMTJRNE)

Indique les postes de journal à omettre.

*NONE

Aucun poste n'est omis.

*OPNCLOSYN

Les postes d'ouverture, de fermeture et d'écriture en mémoire secondaire sont omis. Les opérations d'ouverture, de fermeture et d'écriture en mémoire secondaire des objets spécifiés ne génèrent pas de postes de journal d'ouverture, de fermeture et d'écriture en mémoire secondaire. 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 *OPNCLOSYN n'est admise que pour les objets *DIR et *STMF.

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 avec omission de répertoire

STRJRN  OBJ(('/mypath' *INCLUDE) ('/mypath/myobject' *OMIT))
         JRN('/QSYS.LIB/MYLIB.LIB/JRNLA.JRN')

Cette commande journalise toutes les modifications de tous les objets pris en charge par cette commande dans le répertoire de premier niveau '/mypath', sauf '/mypath/myobject' dans le journal '/QSYS.LIB/MYLIB.LIB/JRNLA.JRN'. Aucun objet des sous-répertoires de '/mypath' ne sera journalisé.

Seules les images après des enregistrements mis à jour sont écrites dans le journal.

Exemple 2 : Démarrage de la journalisation avec correspondance de modèle

STRJRN  OBJ(('/mypath' *INCLUDE)('/mypath/myobject.txt' *OMIT))
         JRN('/QSYS.LIB/MYLIB.LIB/JRNLA.JRN')  SUBTREE(*ALL)
         PATTERN(('*.TXT' *INCLUDE)) OMTJRNE(*OPNCLOSYN)

Cette commande journalise les modifications de tous les objets qui correspondent au modèle '*.txt' dans le répertoire '/mypath' sauf l'objet '/mypath/myobject.txt'. Les postes d'ouverture, de fermeture et d'écriture en mémoire secondaire sont omis.

Seules les images après des enregistrements mis à jour sont écrites dans le journal.

Exemple 3 : Démarrage de la journalisation avec omission en fonction du modèle

STRJRN  OBJ(('/mypath/my*' *INCLUDE))
         JRN('/QSYS.LIB/MYLIB.LIB/JRNLA.JRN')
         PATTERN(('*.DTA*' *OMIT))

Cette commande journalise les modifications de tous les objets des répertoires de premier niveau qui correspondent au modèle pour le chemin '/mypath/my*' et omet tous les objets qui correspondent au modèle '*.DTA*' (objets de type *DTAARA et *DTAQ).

Seules les images après des enregistrements mis à jour sont écrites dans le journal.

Exemple 4 : Démarrage de la journalisation à l'aide des identificateurs de fichiers

STRJRN  OBJFID(00000000000000007E09BDB000000009
                00000000000000009E09BDB00000000A)
         JRN('/QSYS.LIB/MYLIB.LIB/JRNLA.JRN')

Cette commande journalise toutes les modifications des objets représentés par l'identificateur de fichiers indiqué vers le journal '/QSYS.LIB/MYLIB.LIB/JRNLA.JRN'.

Seules les images après des enregistrements mis à jour sont écrites dans le journal.

Exemple 5 : Démarrage de la journalisation sur un jeu de files d'attente de données

STRJRN  OBJ(('/QSYS.LIB/MYLIB.LIB/MYDATA*.DTAQ'))
         JRN('/QSYS.LIB/MYLIB.LIB/MYJRN.JRN')

Cette commande journalise toutes les modifications des objets de type *DTAQ de la bibliothèque MYLIB commençant par les caractères 'MYDATA'.

Messages d'erreur

Messages *ESCAPE

CPFA0D4

Une erreur s'est produite dans le système de fichiers. Code erreur &1.

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.