CHGJRN

La commande CHGJRN permet de modifier le récepteur d'un journal, sa file d'attente de messages, l'attribut de gestion des récepteurs, l'attribut de suppression de récepteur, les options de taille du récepteur, l'état du journal (autorisant des données spécifiques de poste réduites), la mise en mémoire cache du journal, le seuil des récepteurs de journal, la limite d'objets de journal, le nombre de rétablissements de journal ou le texte associé au journal indiqué. Cette commande permet d'attacher un récepteur de journal au journal indiqué. Ce récepteur, qui est immédiatement opérationnel, remplace le récepteur précédemment attaché.

Il est possible de réinitialiser les numéros de séquence de postes de journal lors d'un changement de récepteur. Si la réinitialisation n'est pas effectuée, un message d'information est envoyé pour indiquer le premier numéro de séquence dans le nouveau récepteur. Si le journal est défini avec RCVSIZOPT(*MAXOPT1 ou *MAXOPT2), un message d'information (CPF7019) est envoyé à l'opérateur système pour lui demander de réinitialiser les numéros de séquence lorsque le premier numéro de séquence est supérieur à 9 500 000 000. Si le journal est défini avec RCVSIZOPT(*MAXOPT3), un message d'information (CPF7019) est envoyé à l'opérateur système pour lui demander de réinitialiser les numéros de séquence lorsque le premier numéro de séquence est supérieur à 18 446 600 000 000 000 000. Sinon, ce message est envoyé lorsque le premier numéro de séquence est supérieur à 2 000 000 000.

Si la valeur *SAME est indiquée au paramètre JRNRCV, le récepteur de journal attaché est conservé.

Le récepteur de journal peut être modifié lorsque les fonctions de journal suivantes sont en cours : comparaison d'images, affichage de journaux, réception ou extraction de postes de journal, application ou suppression de modifications journalisées, gestion des attributs de journal, restauration de récepteurs de journal ou affichage des attributs de récepteur de journal.

Restrictions :

• Pour pouvoir utiliser cette commande, l'utilisateur doit avoir ouvert la session en tant que QPGMR, QSYSOPR ou QSRV, ou il doit disposer du droit *ALLOBJ.
• La création du récepteur indiqué doit intervenir avant l'émission de cette commande. Il doit être vide, c'est-à-dire qu'il ne doit pas être attaché ou en cours d'attachement à un journal.
• Un récepteur au plus peut être attaché en même temps à un journal.
• La réinitialisation des numéros de séquence n'est pas acceptée si le paramètre JRNRCV(*SAME) est indiqué, si un objet en cours de journalisation contient des modifications dont l'écriture en mémoire secondaire n'a pas encore été forcée, ou si une modification de contrôle de validation associée au journal est en attente. Lorsque le numéro de séquence maximal est atteint, un message d'erreur est envoyé (poste non journalisé) et toutes les opérations suivantes nécessitant la journalisation échouent.
• Si le journal n'est pas défini avec l'une des valeurs *MAXOPT de RCVSIZOPT, la valeur de seuil maximale pouvant être spécifiée pour un récepteur de journal attaché est 1 919 999 kilo-octets.
• SEQOPT(*RESET) doit être spécifié si le journal a été défini avec l'une des valeurs *MAXOPT pour le paramètre RCVSIZOPT et qu'aucune valeur *MAXOPT n'est indiquée dans le cadre de la demande CHGJRN.
• Si la bibliothèque contenant le journal est sur un ASP indépendant, le récepteur de journal indiqué doit se trouver sur un ASP indépendant qui soit dans le même groupe ASP que la bibliothèque du journal. Si la bibliothèque contenant le journal n'est pas sur un ASP indépendant, le récepteur de journal indiqué ne peut pas se trouver sur un ASP indépendant.
• RCVSIZOPT(*MINFIXLEN) et FIXLENDTA ne peuvent pas être utilisés pour le journal d'audit de sécurité système QSYS/QAUDJRN. Les postes de journal du journal d'audit de sécurité doivent contenir toutes les données possibles qui pourraient être utilisées pour l'audit.
• SEQOPT(*RESET) doit être spécifié si le journal a été défini avec RCVSIZOPT(*MAXOPT3) et si *MAXOPT3 ne fait partie de la demande CHGJRN.
• JRNOBJLMT(*MAX10M) n'est valide que si l'une des valeurs *MAXOPT a été indiquée pour le paramètre RCVSIZOPT.
• Une fois indiqué pour un journal, JRNOBJLMT(*MAX10M) ne peut être modifié.

Paramètres

Journal (JRN)

Indique le nom et la bibliothèque du journal correspondant aux récepteurs ou attributs à modifier.

Ce paramètre est obligatoire.

nom-journal

Indiquez le journal correspondant aux récepteurs ou attributs à modifier.

*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.

Récepteur de journal (JRNRCV)

Indique le récepteur à attacher au journal indiqué.

Remarque :Ce paramètre ne peut être indiqué pour des journaux éloignés.

Valeurs uniques

*SAME

La valeur reste inchangée.

*GEN

Le récepteur est créé par le système, puis attaché au journal. Les attributs, le propriétaire, les droits, le niveau d'audit et la bibliothèque du récepteur créé sont identiques à ceux du récepteur de journal en cours. Le nom du nouveau récepteur reprend une partie du nom du récepteur en cours auquel est ajouté un nombre à quatre chiffres, ou reprend le nom de ce dernier en ajoutant 1 au chiffre qu'il renferme. Ce nom est ensuite communiqué par le biais d'un message d'information. Pour plus d'informations sur les noms de récepteur de journal généré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/.

Elément 1 : Récepteur de journal

Qualificatif 1 : Récepteur de journal

nom-récepteur

Indiquez le nom du récepteur de journal attaché au journal indiqué. Le récepteur doit avoir été préalablement créé dans la bibliothèque spécifiée mais ne doit pas avoir été attaché ni avoir été en cours d'attachement à un 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 aucune bibliothèque n'est indiquée comme bibliothèque en cours, la bibliothèque QGPL est utilisée.

nom-bibliothèque

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Elément 2 : Récepteur de journal

S'il est indiqué, le second récepteur de journal n'est pas pris en compte.

Option de séquence (SEQOPT)

Indique si le numéro de séquence du journal continue à partir du récepteur en cours, ou si la numérotation reprend à partir de 1 pour les nouveaux récepteurs.

Remarque :Ce paramètre ne peut être indiqué pour des journaux éloignés.

*CONT

Le numéro de séquence du nouveau poste de journal suit (incrémentation de 1) le numéro du dernier poste existant dans le récepteur en cours.

*RESET

Le numéro de séquence du premier poste de journal pour le nouveau récepteur est réinitialisé à 1. *RESET n'est pas admis lorsque *SAME est mentionné en regard de l'invite Récepteur de journal (paramètre JRNRCV) lorsque l'un des objets journalisés contient des modifications dont l'écriture en mémoire secondaire n'a pas encore été forcée ou lorsque toute modification de contrôle de validation qui lui est associée est en instance.

File attente messages journal (MSGQ)

Indique le nom qualifié de la file d'attente de messages associée au journal. Un message est envoyé à cette file d'attente dans les cas suivants :

• La taille limite d'un récepteur de journal attaché est dépassée. Le message CPF7099 est envoyé si le journal a pour attribut MNGRCV(*USER).
• La taille limite d'un récepteur de journal attaché est dépassée. Le système tente de créer et d'attacher un nouveau récepteur, si le journal a pour attribut MNGRCV(*SYSTEM). Lorsque l'ancien récepteur est détaché, le message CPF7020 est émis. Si la tentative échoue en raison de conflits de verrouillage, le système envoie le message CPI70E5 et effectue une nouvelle tentative toutes les 10 minutes (ou aussi souvent que le paramètre MNGRCVDLY le demande) jusqu'à ce que l'opération de modification de journal aboutisse.
• Si le récepteur était attaché à un journal défini avec RCVSIZOPT(*MAXOPT1 ou *MAXOPT2), ce même message est envoyé lorsque le numéro de séquence est supérieur à 9 900 000 000. Si le récepteur était attaché à un journal défini avec RCVSIZOPT(*MAXOPT3), ce même message est envoyé lorsque le numéro de séquence est supérieur à 18 446 644 000 000 000 000. Sinon, ce message est envoyé lorsque le numéro de séquence du récepteur de journal est supérieur à 2 147 000 000.
• Lorsque le système ne peut pas déterminer si le journal a pour attribut MNGRCV(*SYSTEM) ou si la tentative de création et d'attachement d'un récepteur échoue pour une raison autre qu'un conflit de verrouillage, le message CPI70E3 est émis.
• Lorsque des opérations relatives à un journal éloigné se produisent, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ pour plus d'informations.
• Lorsque le système ne peut pas supprimer un récepteur en raison d'un conflit de verrouillage, d'un programme d'exit indiquant que le récepteur ne peut pas être supprimé ou du fait que le récepteur n'est pas encore dupliqué en totalité dans tous les journaux éloignés, le message CPI70E6 est envoyé et l'opération est relancée toutes les 10 minutes (ou aussi souvent que le paramètre DLTRCVDLY le demande). Si la suppression échoue pour toute autre raison, le message CPI70E1 est envoyé.

Pour définir la valeur de taille limite, reportez-vous à la description de Seuil d'alerte du récepteur (THRESHOLD) ou de la commande CRTJRNRCV (Créer un récepteur de journal).

Remarque :Il n'est pas possible d'indiquer pour ce paramètre une file d'attente de messages de la bibliothèque QTEMP.

Remarque :Certains messages envoyés à la file d'attente de messages du journal vont également être envoyés à la file d'attente de messages QSYSOPR et à QHST.

Valeurs uniques

*SAME

La valeur ne change pas.

Qualificatif 1 : File attente messages journal

nom-file-attente-messages-journal

Indiquez le nom de la file d'attente de messages de journal destinée à remplacer celle qui était précisée auparavant et dans laquelle sont envoyés les messages du journal. Si cette dernière n'est pas disponible au moment de l'envoi d'un message, celui-ci sera envoyé vers la file d'attente de messages QSYSOPR.

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

La file d'attente de messages du journal est recherchée 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 contenant la file d'attente de messages du journal.

Gestion des récepteurs (MNGRCV)

Mode de modification des récepteurs de journal (opération qui consiste à détacher le récepteur de journal en cours et en attacher un nouveau).

Remarque :Ce paramètre ne peut être indiqué pour des journaux éloignés.

*SAME

La valeur ne change pas.

*SYSTEM

Le système gère la modification des récepteurs de journal (fonction de gestion des modifications de journaux par le système). Lorsqu'un récepteur de journal attaché atteint sa taille limite, le système le détache, en crée un nouveau, puis l'attache. Le message CPF7020 est envoyé à la file d'attente de messages du journal lorsque le récepteur est détaché. Si la valeur *SYSTEM est associée et que le paramètre Récepteur de journal (JRNRCV) a pour valeur *GEN, alors que le récepteur actuellement attaché ne possède pas de seuil, un seuil de 1 500 000 Ko est attribué au nouveau récepteur. *SYSTEM n'est pas correct si le paramètre Récepteur de journal (JRNRCV) a pour valeur *SAME.

Si le récepteur était attaché au journal défini avec RCVSIZOPT(*MAXOPT1 ou *MAXOPT2), le système tente d'exécuter une commande CHGJRN pour réinitialiser le numéro de séquence du récepteur s'il est supérieur à 9 900 000 000. Si le récepteur était attaché au journal défini avec RCVSIZOPT(*MAXOPT3), le système tente d'exécuter une commande CHGJRN pour réinitialiser le numéro de séquence du récepteur s'il est supérieur à 18 446 644 000 000 000 000. Pour les autres récepteurs, le système tente d'exécuter cette même commande lorsque le numéro de séquence est supérieur à 2 147 000 000.

Par ailleurs, lors d'une IPL ou d'une mise en fonction, le système exécute la commande CHGJRN pour créer et attacher un nouveau récepteur de journal et pour réinitialiser le numéro de séquence des journaux non requis pour le rétablissement du contrôle de validation pour cet IPL ou cette mise en fonction, excepté si RCVSIZOPT prend la valeur *MAXOPT3. Le numéro de séquence ne sera pas réinitialisé et aucun nouveau récepteur de journal ne sera associé si RCVSIZOPT a pour valeur *MAXOPT3, à moins que ce numéro ne dépasse le seuil des numéros de séquence fixé à 18 446 600 000 000 000 000. Si certaines transactions de contrôle de validation en attente sont associées à l'un des journaux, un nouveau récepteur de journal sera attaché mais le numéro de séquence ne sera pas réinitialisé. Si un récepteur attaché comporte moins de trois postes de journal pour l'un des journaux au moment de l'IPL, le système ne tentera pas d'attacher un nouveau récepteur de journal.

Remarques :

1. La valeur du seuil de récepteur de journal doit être non nulle avec MNGRCV(*SYSTEM). Le seuil de récepteur de journal peut être indiqué dans le paramètre THRESHOLD de cette commande ou à l'aide d'une valeur de seuil de la commande CRTJRNRCV (Créer un récepteur de journal).
2. MNGRCV(*SYSTEM) n'empêche pas d'utiliser cette commande pour gérer un récepteur de journal.

*USER

L'utilisateur gère la modification des récepteurs de journal en utilisant la commande CHGJRN pour attacher un nouveau récepteur et détacher l'ancien.

Suppression des récepteurs (DLTRCV)

Indique si c'est le système ou l'utilisateur qui supprime les récepteurs de journal lorsqu'ils ne sont plus requis, après qu'ils aient été détachés par la fonction de gestion des modifications de journaux par le système, ou par un utilisateur à l'aide de la commande CHGJRN (Modifier un journal).

Remarque :Ce paramètre peut être indiqué uniquement si MNGRCV(*SYSTEM) est précisé, si le journal en cours a été défini avec le paramètre MNGRCV(*SYSTEM) ou si le journal est éloigné.

*SAME

La valeur ne change pas.

*NO

Les récepteurs de journal ne sont pas supprimés par le système.

*YES

Les récepteurs de journal sont supprimés par le système. Pour indiquer cette valeur, aucun autre récepteur que celui qui est attaché ne peut figurer dans le répertoire des récepteurs.

Remarque :Pour savoir quels sont les récepteurs de journal présents dans le répertoire des récepteurs, affichez l'écran Gestion du répertoire des récepteurs à l'aide de la commande WRKJRNA (Gérer les attributs de journal).

Lorsque le journal dispose de l'attribut DLTRCV(*YES), les conditions suivantes peuvent empêcher le système de supprimer le récepteur. Lorsque l'une de ces conditions se produit, le système envoie le message CPI70E6 et relance l'opération de suppression toutes les 10 minutes (ou aussi souvent que le paramètre DLTRCVDLY le demande) jusqu'à ce qu'elle aboutisse.

• Un conflit de verrouillage s'est produit pour le récepteur ou le journal associé à ce dernier.
• Un programme d'exit enregistré par le biais du point d'exit QIBM_QJO_DLT_JRNRCV indique qu'un récepteur ne peut pas être supprimé.
• Des journaux éloignés sont associés à un journal et ce récepteur n'est pas totalement dupliqué dans un ou plusieurs de ces journaux.

Options de taille de récepteur (RCVSIZOPT)

Options s'appliquant à la taille du récepteur attaché au journal.

Remarque :Pour supprimer une option de taille d'un récepteur, spécifiez toutes les options de taille que vous souhaitez conserver et ne spécifiez pas celle que vous souhaitez supprimer.

Remarque :*SYSDFT, *NONE, *RMVINTENT, *MINFIXLEN, *MAXOPT1, *MAXOPT2 et *MAXOPT3 ne sont pas admis si le paramètre Récepteur de journal (JRNRCV) a pour valeur *SAME.

Remarque :Ce paramètre ne peut être indiqué pour des journaux éloignés.

Remarque :Vous ne pouvez choisir que l'une des trois valeurs : *MAXOPT1, *MAXOPT2 ou *MAXOPT3.

Valeurs uniques

*SAME

La valeur ne change pas.

*SYSDFT

Le système utilise les valeurs recommandées en cours. Cette valeur est équivalente à *MAXOPT2 et à *RMVINTENT.

*NONE

Aucune option ne s'applique à la taille des postes de journal attachés au récepteur. Tous les postes de journal placés dans le récepteur sont permanents. Les données à longueur fixe comme indiquées par FIXLENDTA seront incluses dans chaque poste de journal consigné dans le récepteur de journal attaché. Si cette valeur est spécifiée pour le journal, la taille maximale approximative du récepteur qui y est attaché est de 2 gigaoctets (2,147,483,647) et son numéro de séquence ne doit pas excéder 2,147,483,136. En outre, la taille maximale du poste de journal pouvant être consigné est de 15 761 440 octets.

Autres valeurs (trois répétitions au maximum)

*RMVINTENT

La taille du récepteur attaché au journal est réduite par le retrait automatique des postes internes requis uniquement pour l'IPL (procédure de chargement initial) ou la mise en fonction d'ASP indépendant, une fois qu'ils ne sont plus nécessaires.

*MINFIXLEN

La taille des postes de journal consignés dans le récepteur de journal attaché est réduite par la suppression automatique des données à longueur fixe qui ne sont pas jugées nécessaires pour le rétablissement. Cette option est incorrecte lorsque FIXLENDTA est également indiqué.

*MAXOPT1

Si cette valeur est spécifiée pour le journal, la taille maximale approximative du récepteur qui y est attaché est d'un téraoctet (1 099 511 627 776 octets) et son numéro de séquence ne doit pas excéder 9 999 999 999. En outre, la taille maximale du poste de journal pouvant être consigné est de 15 761 440 octets. Cette valeur n'est pas admise si *MAXOPT2 ou *MAXOPT3 figure dans la commande.

*MAXOPT2

Si cette valeur est spécifiée pour le journal, la taille maximale approximative du récepteur qui y est attaché est d'un téraoctet (1 099 511 627 776 octets) et son numéro de séquence ne doit pas excéder 9 999 999 999. En outre, la taille maximale du poste de journal pouvant être consigné est de 4 000 000 000 octets. Cette valeur n'est pas admise si *MAXOPT1 ou *MAXOPT3 figure dans la commande.

*MAXOPT3

Si cette valeur est spécifiée pour le journal, la taille maximale approximative du récepteur qui y est attaché est d'un téraoctet (1 099 511 627 776 octets) et son numéro de séquence ne doit pas excéder 18 446 744 073 709 551 600. En outre, la taille maximale du poste de journal pouvant être consigné est de 4 000 000 000 octets. Ce type de récepteur ne peut pas être sauvegardé et restauré vers des éditions antérieures à la V5R3M0. Il ne peut pas non plus être répliqué vers des journaux éloignés sur des systèmes dont l'édition est antérieure à la V5R3M0. De plus, si MNGRCV(*SYSTEM) est indiqué lors d'un IPL ou de la mise en fonction d'un ASP indépendant, le système n'exécutera pas de commande CHGJRN pour créer et attacher une nouveau récepteur de journal, puis réinitialiser le numéro de séquence de journal sauf si ce dernier excède le seuil de 18 446 600 000 000 000 000. Cette valeur n'est pas admise si *MAXOPT1 ou *MAXOPT2 figure dans la commande.

Etat du journal (JRNSTATE)

Indique si des postes de journal peuvent être placés dans le journal.

Remarque :Les valeurs *ACTIVE, *INACTIVE et *STANDBY ne sont correctes que lorsque JRNRCV(*SAME) est indiqué.

*SAME

La valeur ne change pas.

*ACTIVE

Tous les postes peuvent être placés dans le journal.

Remarque :Cette valeur ne peut être indiquée pour des journaux éloignés.

*INACTIVE

Cet état ne s'applique qu'à des journaux éloignés. Quand un journal éloigné est inactif (*INACTIVE), aucun poste n'est émis par le système source. Lorsque l'état du journal devient *ACTIVE, les postes en attente seront expédiés du système source.

Remarque :Si cette valeur est indiqué, *SAME est obligatoire pour les autres paramètres (sauf JRN).

*STANDBY

La plupart des postes de journal ne sont pas consignés dans le journal. Si une tentative pour consigner un poste dans le journal est faite, aucune erreur n'indiquera que le poste n'a pas été consigné. Lorsque le journal est à l'état *STANDBY, la journalisation peut être démarrée ou arrêtée. Cependant, l'utilisation du contrôle de validation est interdite lorsque le journal est à l'état *STANDBY. Le contrôle de validation étant interdit, les fonctions dans lesquelles le système effectue un contrôle de validation sont également interdites. De même, les chemins d'accès construits sur des fichiers journalisés dans un journal à l'état *STANDBY ne seront pas admissibles pour la protection des chemins d'accès gérée par le système (SMAPP). Cela risque d'avoir un impact sur les performances du système, sur l'IPL du système ou sur la durée de mise en fonction du pool de mémoire secondaire indépendant (IASP) ou à la fois sur les performances du système et l'IPL ou la durée de mise en fonction, étant donné que le système tente d'obtenir le temps de reprise du chemin d'accès spécifique.

Remarque :Cette valeur ne peut être indiquée pour des journaux éloignés.

Remarque :Reportez-vous à Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ pour savoir quels postes de journal sont autorisés à être consignés dans ces états. Recherchez "programme de recherche de poste de journal".

Réduction de données de poste (MINENTDTA)

Indique quels types d'objets admettent dans les postes de journal des données spécifiques de poste réduites.

Les récepteurs de journal utilisant l'option *FLDBDY pour réduire au minimum les données spécifiques de poste ne peuvent pas être sauvegardés et restaurés vers des éditions antérieures à la V5R4M0. Ils ne peuvent pas non plus être répliqués vers des journaux éloignés sur des systèmes dont l'édition est antérieure à la V5R4M0. Reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ pour connaître les restrictions et l'utilisation des postes de journal avec des données spécifiques de postes réduites.

Remarque :*NONE, *FILE, *FLDBDY et *DTAARA ne sont pas admis si le paramètre Récepteur de journal (JRNRCV) a pour valeur *SAME.

Remarque :Ce paramètre ne peut être indiqué pour des journaux éloignés.

*SAME

La valeur ne change pas.

*NONE

Aucun type d'objet n'admet les postes de journal comportant des données spécifiques de poste réduites. Les postes de journal de tous les objets journalisés seront consignés dans le journal avec des données spécifiques de poste complètes.

*FILE

Les fichiers journalisés peuvent comporter des postes de journal consignés avec des données spécifiques de poste réduites. La réduction n'interviendra pas sur les limites de zones. Par conséquent, il se peut que les données de poste spécifiques ne soient pas consultables et utilisables à des fins d'audit. Cette valeur n'est pas admise si *FLDBDY figure dans la commande.

*FLDBDY

Les fichiers journalisés peuvent comporter des postes de journal consignés avec des données spécifiques de poste réduites. La réduction des fichiers journalisés interviendra sur les limites de zones. Par conséquent, les données de poste spécifiques seront consultables et utilisables à des fins d'audit.

*DTAARA

Les zones de données journalisées peuvent comporter des postes de journal consignés avec des données spécifiques de poste réduites.

Mise en cache du journal (JRNCACHE)

Indique si les postes de journal seront placés dans la mémoire cache avant d'être écrits sur le disque.

Remarque :Ce paramètre ne peut être indiqué pour des journaux éloignés.

*SAME

La valeur ne change pas.

*NO

Les postes de journal sont écrits sur le disque immédiatement si nécessaire afin d'assurer un rétablissement de système simple.

*YES

Les postes de journal sont écrits sur la mémoire principale. Lorsque plusieurs postes de journal se trouvent dans la mémoire principale, les postes de journal sont écrits de la mémoire principale vers le disque. Si l'application exécute de nombreuses modifications, les écritures de disque synchrones peuvent être moins nombreuses entraînant une amélioration des performances. Cependant, il n'est pas recommandé d'utiliser cette option si vous jugez inacceptable de perdre ne serait-ce qu'une modification récente lors d'une défaillance du système où le contenu de la mémoire principale n'est pas protégé. Ce type de journalisation est dirigé en premier lieu vers les travaux par lots et peut ne pas convenir aux applications interactives où le rétablissement de système simple est la raison principale de l'utilisation de la journalisation.

Remarque :Les applications utilisant le contrôle de validation devraient voir moins d'améliorations au niveau des performances car le contrôle de validation exécute déjà des mises en mémoire cache de journaux.

Remarque :Les postes qui se trouvent dans le cache ne peuvent pas être affichés à l'aide des commandes DSPJRN (Afficher le journal), RCVJRNE (Recevoir des postes de journal) et RTVJRNE (Récupérer des postes de journal) ou de l'API QjoRetrieveJournalEntries. De plus, les postes résidant dans le cache sont pas envoyés à un système cible avec journal éloigné. Cependant, ces postes de journal sont inclus dans le dernier numéro de séquence du récepteur de journal via la commande DSPJRNRCVA (Afficher les attributs du récepteur de journal) ou l'API QjoRtvJrneReceiverInformation.

Remarque :Cette valeur n'est pas admise pour un nom de journal qui commence par Q et pour une bibliothèque de journal dont le nom commence aussi par Q, sauf s'il s'agit de QGPL.

Gérer temps attente récepteur (MNGRCVDLY)

Indique le temps (en minutes) qui doit être utilisé pour différer la prochaine tentative pour attacher un nouveau récepteur de journal à ce journal si celui-ci est géré par le système (MNGRCV(*SYSTEM)).

Remarque :Ce paramètre ne peut être indiqué pour des journaux éloignés.

*SAME

La valeur ne change pas.

1-1440

Lorsque le système ne peut pas allouer un objet requis pour attacher un nouveau récepteur de journal à ce journal, il attendra le nombre de minutes indiqué avant de réessayer.

Supprimer temps attente récept (DLTRCVDLY)

Lorsque le système ne peut pas allouer un objet requis pour la suppression d'un récepteur de journal associé au journal et que DLTRCV(*YES) est indiqué, ce paramètre détermine la durée (en minutes) avant de retenter l'opération.

*SAME

La valeur ne change pas.

1-1440

Le système attend le nombre de minutes indiqué avant la nouvelle tentative.

Données de longueur fixe (FIXLENDTA)

Indique les données comprises dans la portion de longueur fixe des postes de journal consignés dans le récepteur de journal associé. Ce paramètre est incorrect lorsque RCVSIZOPT(*MINFIXLEN) est également indiqué.

*SAME

La valeur ne change pas.

*JOBUSRPGM

Le nom du travail, le nom de l'utilisateur et le nom du programme seront inclus dans les postes de journal consignés dans le récepteur de journal associé.

*JOB

Le nom du travail sera inclus dans les postes de journal consignés dans le récepteur de journal associé.

*USR

Le nom du profil utilisateur effectif sera inclus dans les postes de journal consignés dans le récepteur de journal associé.

*PGM

Le nom du programme sera inclus dans les postes de journal consignés dans le récepteur de journal associé.

*PGMLIB

Le nom de la bibliothèque du programme et le nom de l'unité ASP qui contient la bibliothèque du programme seront inclus dans les postes de journal consignés dans le récepteur de journal associé.

*SYSSEQ

Le numéro de séquence système sera inclus dans les postes de journal consignés dans le récepteur de journal associé. Le numéro de séquence système donne une séquence relative à tous les postes de journal dans tous les récepteurs de journal sur le système.

*RMTADR

S'ils sont appropriés, le port éloigné, l'adresse éloignée et la famille d'adresses seront inclus dans les postes de journal consignés dans les récepteurs de journal associés.

*THD

L'identificateur de l'unité d'exécution sera inclus dans les postes de journal consignés dans le récepteur de journal associé. L'identificateur de l'unité d'exécution aide à distinguer les différentes unités en cours de fonctionnement dans le même travail.

*LUW

S'il est approprié, l'identificateur d'unité d'oeuvre logique (LUWID) sera inclus dans les postes de journal consignés dans les récepteurs de journal associés. L'ID d'unité d'oeuvre logique identifie l'oeuvre relative à des cycles de validation spécifiques.

*XID

S'il est approprié, l'identificateur de transaction sera inclus dans les postes de journal consignés dans le récepteur de journal associé. L'identificateur de transaction identifie les transactions relatives à des cycles de validation spécifiques.

FIXLENDTA n'est pas correct pour les journaux éloignés et n'est pas compatible avec JRNRCV(*SAME).

Seuil d'alerte du récepteur (THRESHOLD)

Valeur de seuil d'espace mémoire (en ko) pour le récepteur de journal.

Remarque :Si RCVSIZOPT(*RMVINTENT) est indiqué pour le journal, l'espace interne est indiqué pour le journal, l'espace interne occupé par les postes internes s'applique par l'intermédiaire du seuil de récepteur. Une fois le récepteur de journal détaché, l'espace des postes internes sera libéré. La taille du récepteur de journal sera alors inférieure à la valeur de seuil.

Remarque :Indiquez JRNRCV(*GEN) pour que la valeur seuil soit différente de *SAME.

Si ce seuil est dépassé lors de la journalisation, l'une des situations suivantes se produit :

• Le message CPF7099 est envoyé à la file d'attente de messages du journal si ce dernier a pour attribut MNGRCV(*USER).
• Le système tente de créer et d'attacher un récepteur, si le journal a pour attribut MNGRCV(*SYSTEM). Lorsque l'ancien récepteur est détaché, le message CPF7020 est envoyé à la file d'attente de messages associée au journal. Si la tentative échoue en raison de conflits de verrouillage, le système envoie le message CPI70E5 et effectue une nouvelle tentative toutes les dix minutes (ou aussi souvent que le paramètre MNGRCVDLY le demande) jusqu'à ce que l'opération de modification de journal aboutisse.
• Lorsque le système ne peut pas déterminer si le journal a pour attribut MNGRCV(*SYSTEM) ou si la tentative de création et d'attachement d'un récepteur échoue pour une raison autre qu'un conflit de verrouillage, le message CPI70E3 est émis.

La file d'attente de messages associée au journal est indiquée à l'aide du paramètre MSGQ de cette commande ou à l'aide de la commande CRTJRN (Créer un journal).

Remarque :La valeur du paramètre MNGRCV est indiquée dans cette commande ou dans la commande CRTJRN. Si vous n'avez pas indiqué MNGRCV(*SYSTEM) et que la valeur de seuil est dépassée, vous pouvez faire appel à la commande CHGJRN.

*SAME

La valeur ne change pas.

*NONE

Aucune valeur de seuil n'est indiquée. Cette valeur ne peut être indiquée si la commande MNGRCV est lancée avec le paramètre *SYSTEM.

100000-1000000000

Indiquez une valeur de seuil de récepteur de journal exprimée en kilo-octets (Ko) de mémoire de stockage. Chaque tranche de 1000 Ko correspond à 1 024 000 octets d'espace mémoire. Lorsque l'espace mémoire réservé au récepteur de journal est supérieur à cette valeur, un message est envoyé, le cas échéant, à la file d'attente identifiée, et la journalisation se poursuit.

Remarques :

1. Si vous avez l'intention de générer un récepteur pour un journal non défini avec l'une des valeurs *MAXOPT de RCVSIZOPT, le seuil maximal à spécifier est de 1 919 999 kilo-octets.

Limite objet journal (JRNOBJLMT)

Indique l'option affectant le nombre maximal d'objets pouvant être consignés dans le journal.

*SAME

La valeur ne change pas.

*MAX10M

Le nombre maximal d'objets pouvant être journalisés dans le journal est de 10 000 000. Les récepteurs de journal associés à un tel journal ne peuvent être ni sauvegardés ni restaurés vers une version antérieure à la V5R4M0, ni répliqués via la journalisation éloignée vers une version antérieure à la V5R4M0.

Une fois cette valeur indiquée pour le journal, il est impossible d'indiquer une limite inférieure pour JRNOBJLMT.

Un nouveau récepteur doit être attaché au moment même de la modification de cette valeur.

Les performances d'exécution doivent être prises en compte lors du choix de cette option. Avec ce nouvel attribut, il est possible de journaliser un plus grand nombre d'objets par journal. Par conséquent, le nombre potentiel d'objets susceptibles d'être modifiés activement est plus élevé mais risque d'avoir une incidence sur les performances d'exécution du journal. Par conséquent, si la fréquence de consignations de postes dans ce journal affecte les performances d'exécution, il est préférable de répartir les objets journalisés dans plusieurs journaux.

Attention, l'augmentation du nombre d'objets associés à un même journal peut allonger la durée de l'IPL, de la mise en fonction de l'ASP indépendant ou de la reprise après incident. En règle générale, il est conseillé d'opter pour la journalisation dans plusieurs journaux si le nombre d'objets à journaliser excède 5 000. La durée de rétablissement du journal au moment de l'IPL ou de la mise en fonction d'un ASP indépendant est proportionnelle au nombre d'objets journal en cours de modification pour un journal donné au moment de l'arrêt système.

Nb de rétablissements journal (JRNRCYCNT)

Le nombre de rétablissements de journal permet à un utilisateur de faire un choix entre un rétablissement d'IPL anormal ou de la mise en fonction d'ASP indépendant plus rapide et un traitement exécutable réduit. La valeur indiquée a une incidence sur la fréquence de stockage forcé des objets journalisés dans la mémoire secondaire lorsque ceux-ci sont modifiés. Le nombre de rétablissements de journal indiqué correspond au nombre approximatif des modifications journalisées qui devraient être rétablies lors de la synchronisation de ce journal en cas d'IPL ou de la mise en fonction anormale. Indiquer une valeur inférieure réduit le nombre de modifications qui devraient être rétablies à partir de ce journal en cas d'IPL ou de la mise en fonction anormale en augmentant la fréquence de stockage forcé des objets modifiés. Indiquer une valeur supérieure augmente le nombre de modifications qui devraient être rétablies à partir de ce journal en cas d'IPL ou de la mise en fonction anormale en réduisant la fréquence de stockage forcé des objets modifiés. Le fait de modifier cette valeur peut avoir une incidence sur les performances système car cette opération sollicite les unités de mémoire secondaire.

Tous les journaux sont créés avec le nombre de rétablissements de journal par défaut. Si une valeur autre que *SYSDFT (valeur par défaut) est indiquée, le nombre de rétablissements de journal par défaut ne s'applique plus à ce journal.

Remarque :Le système d'exploitation accepte par défaut un nombre maximal de 250 000 rétablissements de journal système. S'il est nécessaire de modifier le nombre maximal par défaut de rétablissements de journal système pour tous les nouveaux journaux et tous les journaux existants auxquels est associée la valeur *SYSDFT, voir l'API de QJOCHRVC dans Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Remarque :Les valeurs *SYSDFT et 10000-2000000000 ne sont correctes que lorsque JRNRCV(*SAME) est indiqué.

*SAME

La valeur ne change pas.

*SYSDFT

La valeur est réglée sur le nombre de rétablissements de journal par défaut défini par le système.

10000-2000000000

Indique le nombre de postes de journal qui doivent être récupérées à partir de ce journal lors d'un IPL ou d'une mise en fonction anormal.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement le journal.

*SAME

Le texte reste inchangé.

*BLANK

Le texte est remplacé par des blancs.

'descriptif'

Entrez, entre apostrophes, un texte de 50 caractères au maximum. Cette variable représente le nouveau texte associé au journal.

Exemples

Exemple 1 : Détacher un récepteur de journal et réinitialiser des numéros de séquence

CHGJRN   JRN(JRNLA)  JRNRCV(RCV10)  SEQOPT(*RESET)

Cette commande détache le récepteur de journal actuellement attaché au journal JRNLA (ce journal est trouvé à l'aide de la liste de recherche de bibliothèque *LIBL). Le récepteur de journal RCV10 (trouvé à l'aide de la liste de recherche de bibliothèque *LIBL) est attaché au journal JRNLA. Du fait que SEQOPT(*RESET) est indiqué, le numéro de séquence 1 est attribué au premier poste du journal dans le récepteur RCV10.

Exemple 2 : Créer et attacher un nouveau récepteur de journal

CHGJRN   JRN(JRNLA)  JRNRCV(*GEN) THRESHOLD(1500000)

Cette commande détache le récepteur de journal actuellement attaché au journal JRNLA. Un nouveau récepteur de journal est créé et attaché au journal JRNLA. Les niveaux bibliothèque, propriétaire, autorité et audit du nouveau récepteur de journal sont les mêmes que ceux du récepteur détaché. Le nom du nouveau récepteur dépend de celui du récepteur détaché. Par exemple, si l'ancien récepteur s'appelle RCVJRNA, le nouveau récepteur aura pour nom RCVJRN0001. Si l'ancien récepteur s'appelle RCVJRN0001, le nouveau récepteur aura pour nom RCVJRN0002. Le numéro de séquence du premier poste du nouveau récepteur de journal est supérieur au dernier numéro de séquence du récepteur détaché. Le nouveau récepteur possédera un seuil de taille de 1 500 000 kilo-octets environ.

Exemple 3 : Utilisation de la gestion du récepteur système

CHGJRN   JRN(LIBY/JRN) JRNRCV(LIBX/RCV0001)
         MNGRCV(*SYSTEM) DLTRCV(*YES)
         RCVSIZOPT(*MAXOPT2) MNGRCVDLY(10) DLTRCVDLY(30)

Cette commande détache le récepteur de journal actuellement attaché au journal JRN. L'utilisateur a précédemment créé le récepteur de journal RCV0001 dans la bibliothèque LIBX. Ce récepteur de journal est attaché au journal JRN. Le nouveau récepteur de journal possédera une taille maximale d'un téraoctet environ. Il permettra d'atteindre 9 999 999 999 pour le numéro de séquence, et la taille maximale d'un poste de journal pouvant être déposé dans le récepteur s'élèvera à 4 000 000 000 d'octets. Le numéro de séquence du premier poste du nouveau récepteur de journal est supérieur au dernier numéro de séquence du récepteur détaché. Le système utilise ces valeurs pour gérer les attachements et les détachements de récepteurs de journal. Si le système ne parvient pas à allouer un objet lors de ce processus, il attend 10 minutes avant de renouveler l'opération. Dès lors, le système gérera également la suppression des récepteurs détachés. Si le système ne parvient pas à allouer un objet lors de la suppression du récepteur du journal, il attend 30 minutes avant de renouveler l'opération.

Exemple 4 : Augmentation du nombre maximal d'objets

CHGJRN   JRN(QGPL/DBJRN) JRNRCV(*GEN)
         JRNOBJLMT(*MAX10M)

Cette commande modifie le journal DBJRN dans la bibliothèque QGPL pour autoriser la journalisation de 10 000 000 objets au maximum. Un nouveau récepteur est actuellement attaché au journal. Le numéro de séquence du premier poste du nouveau récepteur de journal est supérieur au dernier numéro de séquence du récepteur détaché. Après cette modification, il est possible de consigner plus de 250 000 objets dans le journal.

Messages d'erreur

Messages *ESCAPE

CPF69A9

Erreur interne détectée, code raison &2.

CPF70A0

Paramètre FIXLENDTA non admis.

CPF70A1

Paramètre FIXLENDTA non admis avec RCVSIZOPT(*MINFIXLEN).

CPF70A2

JRNRCV(*SAME) non admis.

CPF70A5

Valeur de RCVSIZOPT non admise.

CPF70B4

RCVSIZOPT(&1) ne peut être supprimé.

CPF70B5

JRNOBJLMT(&1) non admis

CPF70B6

Valeur de seuil du récepteur &1 incorrecte.

CPF70B8

Les valeurs définies pour MINENTDTA ne sont pas admises.

CPF70C9

Etat du journal &1 de &2 non modifié.

CPF70CF

Impossible de désactiver le journal éloigné avec les paramètres indiqués.

CPF70DB

Environnement de journal éloigné arrêté pour le journal &1 de la bibliothèque &2.

CPF70DD

Impossible d'attacher un récepteur double au journal &1.

CPF70DE

Etat du journal &1 de &2 non modifié.

CPF70DF

Impossible de modifier l'attribut d'un journal éloigné.

CPF70D1

Impossible d'activer un journal éloigné via la commande CHGJRN.

CPF70D2

Impossible de détacher le récepteur de journal &3.

CPF70D9

Modification de l'état du journal non admise. Code raison &3.

CPF70E0

Opération sur &1 non admise.

CPF70E2

DLTRCV(*YES) non admis.

CPF70E3

Seuls les récepteurs attachés sont admis dans le répertoire des récepteurs

CPF70E4

MNGRCV(*SYSTEM) non admis.

CPF70E5

Valeurs de RCVSIZOPT non admises.

CPF70E7

Valeur de MINENTDTA non admise avec JRNRCV(*SAME).

CPF70F1

Seuil de récepteur trop élevé pour le journal.

CPF70F5

Valeur de seuil de récepteur incorrecte.

CPF70F6

Valeur de RCVSIZOPT non admise.

CPF70F8

Les valeurs RCVSIZOPT, FIXLENDTA et JRNOBJLMT ne sont pas admises avec JRNRCV(*SAME).

CPF7003

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

CPF7004

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

CPF701A

Récepteur de journal non disponible pour cette opération.

CPF701B

Le rétablissement par journal d'une opération interrompue a échoué.

CPF7011

Ressources ou mémoire insuffisantes.

CPF7013

Le récepteur de journal n'a pas été créé.

CPF7015

Erreur dans spécifications JRNRCV.

CPF7017

Bibliothèque QTEMP incorrecte pour paramètre file d'attente de messages.

CPF7018

Restauration des numéros de séquence non admise. Code raison &3.

CPF704E

RCVSIZOPT(*MINFIXLEN) non admis.

CPF708D

Récepteur de journal endommagé au niveau logique.

CPF708E

Récepteur de journal interdit avec *MAXOPT1, *MAXOPT2 ou *MAXOPT3.

CPF708F

Impossible de placer en attente un journal éloigné.

CPF709F

Lancement de la mise en cache du journal non admis. Code raison &3.

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.

CPF9804

Objet &2 dans bibliothèque &3 endommagé.

CPF9806

Impossible d'exécuter fonction pour objet &2 de &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.