ENDJRN

Arrêter journalisation

En bref

La commande ENDJRN permet d'interrompre la journalisation des modifications d'un objet ou d'une liste d'objets.

ENDJRN se lit END (Arrêter) + JRN. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ENDJRN

Paramètres

OBJ Objets
OBJFID Identificateur de fichier
SUBTREE Branche du répertoire
PATTERN Masque du nom
JRN Journal
LOGLVL Niveau de consignation

Astuce : dans une session 5250, tapez ENDJRN puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Oui

La commande ENDJRN permet d'interrompre la journalisation des modifications d'un objet ou d'une liste d'objets. 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 charge les objets de type *STMF, *DIR ou *SYMLNK présents sur les systèmes de fichiers root (/), QOpenSys et défini par l'utilisateur.

La journalisation en cours des types d'objet pris en charge par cette commande dans un journal spécifique peut également être arrêtée.

Les commandes suivantes vous offrent d'autres méthodes d'arrêt de la journalisation :

Chemins d'accès - ENDJRNAP (Arrêter la journalisation de chemin d'accès)
Fichiers physiques - ENDJRNPF (Arrêter la journalisation de fichier physique)
Bibliothèques - ENDJRNLIB (Arrêter la journalisation de bibliothèque)
Autres objets - ENDJRNOBJ (Arrêter la journalisation d'objet)

Restrictions :

Si OBJ(*ALL) est indiqué, un nom de journal est obligatoire (paramètre JRN).
Si un nom de journal et une liste de noms d'objets sont indiqués, tous les objets doivent être journalisés dans le journal indiqué.
Le journal indiqué doit être local.
Vous devez spécifier au moins le paramètre OBJ ou OBJFID.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OBJ	Objets	Valeurs uniques: ALL Autres valeurs (jusqu'à 300 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Nom	Chemin d'accès, *
	Élément 2: Inclure ou omettre	INCLUDE, OMIT
OBJFID	Identificateur de fichier	Values (jusqu'à 300 répétitions): Valeur hexadécimale	Facultatif
SUBTREE	Branche du répertoire	NONE, ALL	Facultatif
PATTERN	Masque du nom	Values (jusqu'à 20 répétitions): Liste d'éléments	Facultatif
	Élément 1: Masque	Valeur caractère, *
	Élément 2: Inclure ou omettre	INCLUDE, OMIT
JRN	Journal	Chemin d'accès, *OBJ	Facultatif
LOGLVL	Niveau de consignation	ERRORS, ALL	Facultatif

Objets (OBJ)

Indique les noms de chemins d'objet (jusqu'à 300) pour lesquels les modifications ne seront plus 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.

Valeurs uniques

*ALL: La journalisation en cours des modifications de tous les objets associés à un type pris en charge dans le journal indiqué va être arrêtée. Si *ALL est indiqué, ne spécifiez pas le paramètre OBJFID.

Elément 1 : Nom

'nom-chemin-objet'

Indiquez le nom de chemin de l'objet pour lequel les modifications ne sont plus 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: La journalisation des modifications des objets correspondant au modèle de nom d'objet va être arrêtée, 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 les objets dont la journalisation des modifications va être arrêtée. 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 ne sont plus 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 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 fichier root (/), QOpenSys ou défini par l'utilisateur, ou bien les objets de type *DTAARA ou *DTAQ.

identificateur-fichier: Les objets identifiés par le FID ne sont plus journalisés.

Branche du répertoire (SUBTREE)

Indique si la journalisation des modifications des objets des branches de répertoire va être arrêtée.

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

Remarque :Ce paramètre est ignoré si OBJFID est indiqué.

*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 l'arrêt 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.

Remarque :Ce paramètre est ignoré si OBJFID est indiqué.

Elément 1 : Masque du nom

'*': Tous les objets correspondant au paramètre OBJP en entrée doivent être inclus ou exclus de l'opération d'arrêt de la journalisation.
nom-modèle: Indiquez le modèle à utiliser pour inclure ou exclure des objets pour l'arrêt 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.

Elément 2 : Inclure ou omettre

*INCLUDE: La journalisation des modifications des objets correspondant au modèle de nom d'objet va être arrêtée, 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 les objets dont la journalisation des modifications va être arrêtée. 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é.

Journal (JRN)

Indique le journal dans lequel les modifications sont journalisées.

*OBJ: Le nom du journal est déterminé par le système à partir du nom de chemin d'objet ou de l'identificateur de fichier d'objet spécifié.
nom-chemin-journal: Indiquez le nom de chemin du journal dans lequel les modifications sont journalisées.

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 : Arrêt de la journalisation pour toutes les ressources autres que des bases de données

ENDJRN   OBJ(*ALL)  JRN('/qsys.lib/mylib.lib/myjrn.jrn')

Cette commande arrête la journalisation de toutes les modifications apportées à tous les objets de type *DIR, *STMF, *SYMLNK, *DTAARA et *DTAQ dans le journal /qsys.lib/mylib.lib/myjrn.jrn.

Exemple 2 : Arrêt de la journalisation avec omission de répertoire

ENDJRN   OBJ(('/mypath' *INCLUDE) ('/mypath/myobject' *OMIT))

Cette commande arrête la journalisation de toutes les modifications apportées à tous les objets de premier niveau du répertoire directory /mypath hormis à ceux de l'objet de répertoire /mypath/myobject. L'objet /mypath/myobject continuera à être journalisé.

Exemple 3 : Arrêt de la journalisation avec sélection du modèle

ENDJRN   OBJ(('/mypath' *INCLUDE) ('/mypath/mysubdir' *OMIT))
         SUBTREE(*ALL)  PATTERN(('*.txt' *INCLUDE))

Cette commande arrête la journalisation de toutes les modifications de tous les objets de type *DIR, *STMF et *SYMLNK résidant dans le répertoire /mypath et correspondant au motif '*.txt'. Tous les objets du répertoire /mypath/mysubdir continueront à être journalisés.

Exemple 4 : Arrêt de la journalisation à l'aide d'identificateurs de fichier

ENDJRN   OBJFID(00000000000000007E09BDB000000009
                00000000000000009E09BDB00000000A)

Cette commande arrête la journalisation des modifications apportées aux objets de type *DIR, *STMF, *SYMLNK, *DTAARA ou *DTAQ représentés par les identificateurs de fichier indiqués.

Exemple 5 : Arrêt de la journalisation sur un jeu de zones de données

ENDJRN   OBJ(('/qsys.lib/mylib.lib/mydata*.dtaara'))
         JRN('/qsys.lib/mylib.lib/myjrn.jrn')

Cette commande arrête la journalisation de toutes les modifications des objets de type *DTAARA 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.
CPF700B: La journalisation a été arrêtée 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.