CHGJRNOBJ

La commande CHGJRNOBJ modifie les attributs de journalisation d'un objet journalisé sans nécessiter l'arrêt et le redémarrage de la journalisation de celui-ci.

La commande permet de modifier la valeur du paramètre Images (IMAGES) d'un objet fichier base de données (*FILE) ou zone de données (*DTAARA) sans nécessiter l'arrêt et le redémarrage de la journalisation de l'objet. Autrement, la commande STRJRNPF (Démarrer la journalisation de fichier physique) permet de définir cette valeur pour les fichiers base de données. Cette valeur de zone de données peut être définie à l'aide de la commande STRJRN (Démarrer la journalisation) ou STRJRNOBJ (Démarrer l'objet de journal).

La commande permet de modifier la valeur Omettre poste de journal (OMTJRNE) d'un fichier base de données (*FILE), d'un fichier de flux de système de fichiers intégré (*STMF) ou d'un objet répertoire (*DIR) sans nécessiter l'arrêt et le redémarrage de la journalisation de l'objet. Autrement, la commande STRJRNPF (Démarrer la journalisation de fichier physique) permet de définir cette valeur pour les fichiers base de données. La commande STRJRN (Démarrer la journalisation) permet de définir cette valeur pour les objets système de fichiers intégré.

La commande permet de modifier la valeur Nouv obj héritent journalisat (INHERIT) d'un objet répertoire de système de fichiers intégré (*DIR) sans nécessiter l'arrêt et le redémarrage de la journalisation de l'objet. Autrement, la commande STRJRN (Démarrer la journalisation) permet de définir cette valeur pour les objets système de fichiers intégré.

La commande peut être exécutée pour permettre l'utilisation d'un fichier base de données (*FILE) contenant des modifications de transactions partielles. Les transactions partielles ne peuvent exister que pour un objet modifiable sous contrôle de validation. Les objets fichiers base de données (*FILE) sont les seuls objets pouvant être ouverts en utilisant le contrôle de validation.

Deux raisons expliquent l'existence de transactions partielles :

1. La plus courante est que l'objet a été sauvegardé au milieu d'une transaction et que cette version sauvegardée a ensuite été restaurée. Dans ce cas, la méthode favorite pour compléter toutes les transactions partielles consiste à utiliser la commande APYJRNCHG (Appliquer des modifications journalisées) ou RMVJRNCHG (Enlever des modifications journalisées). Si les récepteurs de journal requis par APYJRNCHG ou RMVJRNCHG ne sont pas disponibles, vous pouvez, en dernier lieu, employer le paramètre Transactions partielles (PTLTNS) pour permettre l'ouverture et l'utilisation du fichier base de données sans compléter les transactions.
2. L'autre raison de l'existence de transactions partielles est que l'objet a été impliqué dans une opération d'annulation relativement longue qui a été interrompue. Dans ce cas, APYJRNCHG et RMVJRNCHG ne permettent pas de compléter les transactions partielles. S'il n'existe aucune version sauvegardée du fichier à restaurer, vous pouvez, en dernier lieu, employer le paramètre Transactions partielles (PTLTNS) pour permettre l'ouverture et l'utilisation du fichier base de données sans compléter la transaction.

La commande peut être utilisée pour modifier la valeur Règles d'héritageINHRULES pour une bibliothèque (*LIB) sans devoir arrêter et redémarrer la journalisation de la bibliothèque. Sinon, la commande STRJRNLIB (Démarrer la journalisation de bibliothèque) permet de définir cette valeur pour les bibliothèques. Utilisez la commande DSPLIBD pour afficher les règles d'héritage en cours d'une bibliothèque.

La commande peut être utilisée pour modifier la valeur Filtre de journaux éloignés (RMTJRNFTR) pour un objet.

Si une modification ne s'applique pas à un type d'objet, les objets de ce type ne sont pas pris en compte, et le traitement se poursuit avec le prochain objet. De plus, si l'objet possède déjà la valeur appropriée pour l'attribut en cours de modification, aucune erreur ne sera retournée.

Restrictions :

• Un seul attribut de journalisation peut être modifié à la fois.
• La modification des paramètres IMAGES, OMTJRNE, INHERIT INHRULES ou RMTJRNFTR n'est possible que si l'objet indiqué est actuellement journalisé.
• Le droit d'accès spécial à tous les objets (*ALLOBJ) est obligatoire avec PTLTNS(*ALWUSE).
• Traitement du verrouillage

  L'objet en cours de modification est verrouillé à l'aide d'un verrou exclusif avec lecture permise (*EXCLRD).

Paramètres

Objets (OBJ)

Indique un objet ou une liste d'objets dont les attributs de journalisation doivent être modifiés.

Elément 1 : Objet

Qualificatif 1 : Objet

*ALL

Les attributs de journal de tous les objets de la bibliothèque indiquée du type précisé, qui sont actuellement journalisés, sont modifiés. Le nom de bibliothèque doit être indiqué. Si *ALL est indiqué alors que l'utilisateur ne possède pas les droits requis sur tous les objets de la bibliothèque, un message est émis et le traitement se poursuit avec l'objet suivant. *ALL n'est pas admis lorsque *LIBL est spécifié pour le nom de bibliothèque.

nom

Entrez le nom de l'objet dont les attributs de journalisation doivent être modifiés.

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. Un nom générique n'est pas admis lorsque *LIBL est spécifié pour le nom de bibliothèque.

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.

Elément 2 : Type d'objet

Entrez le type de l'objet dont les attributs de journalisation doivent être modifiés.

*DTAARA

Les attributs de journalisation des zones de données sont modifiés.

*DTAQ

Les attributs de journalisation des files d'attente de données sont modifiés.

*FILE

Les attributs de journalisation des membres de fichier base de données sont modifiés.

*LIB

Les attributs de journalisation des bibliothèques sont modifiés.

Objets (OBJPATH)

Indique jusqu'à 300 objets dont les attributs de journalisation doivent être modifiés. Seuls sont pris en charge les objets dont le nom de chemin identifie un objet de type *STMF, *DIR ou *SYMLNK présent sur les systèmes de fichiers root (/), QOpenSys ou définis par l'utilisateur ou les objets de type *FILE, *DTAARA, "DTAQ" ou *LIB. Les objets qui répondent aux critères de sélection mais ne sont pas journalisés sont ignorés.

Elément 1 : Nom

nom-chemin

Entrez le nom de l'objet dont les attributs de journalisation doivent être modifiés.

Les liens symboliques du nom de chemin ne seront pas suivis.

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 nom de chemin ou à un 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 doivent être inclus dans la liste d'objets pour lesquels les attributs de journalisation doivent être modifiés, 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 la liste d'objets pour lesquels les attributs de journalisation doivent être modifiés. 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é.

Identificateur de fichier (OBJFID)

Indique jusqu'à 300 identificateurs de fichiers (FID) pour lesquels des attributs de journalisation doivent être modifiés. 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 sont pris en charge les objets dont le FID identifie un objet de type *STMF, *DIR ou *SYMLNK présent sur les systèmes de fichiers root (/), QOpenSys ou définis par l'utilisateur ou les objets de type *FILE, *DTAARA, "DTAQ" ou *LIB.

identificateur-fichier

Les attributs des objets identifiés par le FID sont modifiés.

Branche du répertoire (SUBTREE)

Indique si les branches de répertoire sont incluses pour déterminer les objets pour lesquels des attributs de journalisation doivent être modifiés.

Remarque :Ce paramètre n'est admis que si au moins un nom de chemin a été indiqué dans le paramètre Objets (OBJPATH).

*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 lesquels des attributs de journalisation sont modifiés.

Remarque :Ce paramètre n'est admis que si au moins un nom de chemin a été indiqué dans le paramètre Objets (OBJPATH).

Remarque :Ce paramètre s'applique aux objets qui existent lorsque la commande de modification de l'objet du journal 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 OBJPATH doivent être inclus.

nom-modèle

Indiquez le modèle à utiliser pour inclure ou exclure des objets pour lesquels des attributs de journalisation sont modifiés. 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.

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 sont inclus dans l'opération, 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é.

Attribut (ATR)

Indique quel attribut sera sélectionné en vue de sa modification.

*IMAGES

L'attribut géré par le paramètre Images (IMAGES) doit être modifié.

*OMTJRNE

L'attribut géré par le paramètre Omettre poste de journal (OMTJRNE) doit être modifié.

*INHERIT

L'attribut géré par le paramètre Nouv obj héritent journalisat (INHERIT) doit être modifié.

*PTLTNS

L'attribut géré par le paramètre Transactions partielles (PTLTNS) doit être modifié.

*INHRULES

L'attribut géré par le paramètre Règles d'héritage (INHRULES) doit être modifié.

*RMTJRNFTR

L'attribut géré par le paramètre Filtre de journaux éloignés (RMTJRNFTR) doit être modifié.

Images (IMAGES)

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

*SAME

Cette valeur reste inchangée.

*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 est ignorée pour tous les types d'objet, à l'exception des objets zones de données (*DTAARA) et fichier base de données (*FILE).

Omettre poste de journal (OMTJRNE)

Indique les postes de journal à omettre.

*SAME

Cette valeur reste inchangée.

*NONE

Aucun poste n'est omis.

*OPNCLOSYN

Les postes d'ouverture et de fermeture sont omis pour les objets *FILE. Les postes d'ouverture, de fermeture et d'écriture en mémoire secondaire sont omis pour les objets *DIR et *STMF. 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 est ignorée pour tous les types d'objet, à l'exception des objets *FILE, *DIR et *STMF.

Remarque :La valeur *OPNCLOSYN est identique à OMTJRNE(*OPNCLO) dans la commande STRJRNPF (Démarrer la journalisation de fichier physique) pour les objets *FILE.

Nouv obj héritent journalisat (INHERIT)

Indique si les objets créés, déplacés ou restaurés dans un répertoire journalisé doivent hériter de l'état du journal du répertoire parent.

Remarque :Le paramètre INHERIT est ignoré pour tous les types d'objet, à l'exception des objets *DIR.

*SAME

Cette valeur reste inchangée.

*NO

Les objets créés, déplacés ou restaurés dans le répertoire n'hériteront pas de l'état du journal du répertoire parent.

*YES

Les objets créés, déplacés ou restaurés dans le répertoire hériteront de l'état du journal du répertoire parent.

Transactions partielles (PTLTNS)

Indique si un objet qui contient des modifications pour des transactions partielles peut être utilisé ou non.

Remarque :Le paramètre PTLTNS est ignoré pour tous les types d'objet, à l'exception des objets *FILE.

Remarque :Le paramètre PTLTNS ne peut pas être modifié pour les objets répliqués par Db2 Mirror.

*SAME

Cette valeur reste inchangée.

*ALWUSE

L'objet qui contient des modifications de transactions partielles est modifié pour pouvoir être employé, mais les transactions partielles elles-mêmes ne sont pas complétées. Toutes les modifications apportées à l'objet et demeurant en souffrance en raison de transactions partielles sont conservées dans celui-ci.

Remarque :Le droit d'accès spécial à tous les objets (*ALLOBJ) est obligatoire avec *ALWUSE.

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.

Valeurs uniques

*SAME

La valeur reste inchangée.

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.

Filtre de journaux éloignés (RMTJRNFTR)

Indique si les postes de journal consignés pour les objets 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).

*SAME

Cette valeur reste inchangée.

*NO

Les postes de journal consignés pour les objets ne seront pas admissibles pour un filtrage par objet du journal éloigné.

*YES

Les postes de journal consignés pour les objets 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.

Remarque :La valeur *YES est ignorée pour tous les types d'objet, à l'exception des objets zone de données (*DTAARA), file d'attente de données (*DTAQ) et fichier base de données (*FILE).

Exemples

Exemple 1 : Modification de l'attribut de journalisation de fichier IMAGES

CHGJRNOBJ   OBJ((LIBA/FILEA *FILE))  ATR(*IMAGES) IMAGES(*BOTH)

Cette commande modifiera l'attribut du fichier FILEA de la bibliothèque LIBA pour journaliser les images avant et après du fichier sans devoir arrêter, puis redémarrer la journalisation de celui-ci.

Exemple 2 : Modification de l'attribut de journalisation de fichier OMTJRNE

CHGJRNOBJ   OBJ((LIBB/FILEB *FILE))  ATR(*OMTJRNE) OMTJRNE(*OPNCLOSYN)

Cette commande modifie l'attribut du fichier FILEB de la bibliothèque LIBB pour omettre les postes ouverts et fermés.

Exemple 3 : Modification de l'attribut de journalisation OMTJRNE

CHGJRNOBJ   OBJFID(00000000000000007E09BDB000000009)
            ATR(*OMTJRNE) OMTJRNE(*OPNCLOSYN)

Cette commande modifie l'attribut de l'objet représenté par l'identificateur de fichier indiqué pour omettre les postes correspondant à des ouvertures, des fermetures et des écritures. Cet objet peut être de type *DIR ou *STMF.

Exemple 4 : Modification de l'attribut de fichier PTLTNS

CHGJRNOBJ   OBJ((LIBC/FILEC *FILE))  ATR(*PTLTNS) PTLTNS(*ALWUSE)

Cette commande modifiera le fichier pour qu'il puisse être réutilisé, bien que les transactions partielles soient elles-même terminées. Cette méthode ne doit être employée que de rares cas où le fichier ne peut être récupéré par l'application ou le retrait de modifications journalisées.

Exemple 5 : Modification de l'attribut de journalisation de bibliothèque INHRULES

CHGJRNOBJ   OBJ((LIBD *LIB))  ATR(*INHRULES)
            INHRULES((*FILE *CREATE *INCLUDE *BOTH *NONE *NO
                      *ALL))

Cette commande permet de modifier les règles d'héritage de la bibliothèque de sorte que tous les fichiers base de données créés dans la bibliothèque LIBD démarrent automatiquement la journalisation dans le même journal que celui dans lequel LIBD est journalisée. Les fichiers seront journalisés avec IMAGES(*BOTH), OMTJRNE(*NONE) et RMTJRNFTR(*NO).

Exemple 6 : Modification de l'attribut de journalisation de fichier RMTJRNFTR

CHGJRNOBJ   OBJ((LIBE/FILEE *FILE)) ATR(*RMTJRNFTR)
            RMTJRNFTR(*YES)

Cette commande modifie l'attribut du fichier FILEE de la bibliothèque LIBE de telle sorte que les postes consignés pour ce fichier soient soumis à un filtrage par objet du journal éloigné.

Messages d'erreur

Messages *ESCAPE

CPF7057

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

CPF70B1

&1 objet(s) sur &2 modifiés.

CPF70B2

&2 n'est peut-être pas indiqué avec ATR(*&1).

CPF70B3

Non autorisé à utiliser le paramètre PTLTNS.