CHGRMTJRN

La commande CHGRMTJRN permet de modifier l'état d'un journal éloigné.

Exécutée sur le système source pour un journal éloigné associé à un journal de ce système, cette commande permet de faire passer l'état du journal éloigné de *ACTIVE à *INACTIVE, et vice versa. L'état *ACTIVE d'un journal éloigné indique que celui-ci peut recevoir des postes provenant du journal associé sur le système source ; et l'état *INACTIVE, qu'il ne peut pas recevoir ces postes. Cette commande permet également de définir des attributs d'état de journal supplémentaires.

La commande CHGJRN permet de modifier les autres attributs du journal éloigné, tels que la file d'attente de messages, la suppression de récepteurs ou le texte descriptif.

Restrictions :

• Le système cible doit contenir un profil utilisateur portant le même nom que le profil utilisateur utilisé pour exécuter cette commande sur le système source. Cette restriction s'applique quel que soit le protocole de communication sélectionné.
• Le mode de réception synchrone n'est pas pris en charge si un journal éloigné est indiqué pour le paramètre de nom de journal de système source.
• Le journal éloigné à activer ne peut pas être déjà à l'état *ACTIVE.
• Le journal éloigné à désactiver ne peut pas être déjà à l'état *INACTIVE.
• Un journal éloigné à l'état *CTLINACT ne peut pas être désactivé à l'aide du paramètre INACTOPT(*CNTRLD).
• Vous ne pouvez pas désactiver un journal éloigné dont les postes sont en cours de réplication vers d'autres journaux éloignés.
• Il est impossible de répliquer un récepteur de journal faisant partie d'un double.
• Il est impossible de répliquer un récepteur de journal n'ayant jamais été attaché après l'installation de la version 4 édition 2 niveau de modification 0 car un tel récepteur ne contient pas toutes les informations requises.
• Le poste de répertoire de base de données relationnelle (RDB) doit respecter les règles suivantes :
  • Le protocole de communication utilisé pour la base de données relationnelle doit être pris en charge pour les fonctions de journal éloigné.
  • Le nom de lieu éloigné dans le poste du répertoire de la base de données relationnelle (RDB) ne doit pas faire référence à la base de données *LOCAL.
  • Le poste de répertoire de la base de données relationnelle (RDB) ne peut pas utiliser un programme de pilote demandeur d'application (*ARDPGM) pour localiser le système cible.
• Le filtrage des postes de journal n'est pas pris en charge lorsque le mode de livraison indiqué est le mode synchrone.
• Le filtrage des postes de journal n'est pas pris en charge lorsqu'un journal éloigné est indiqué pour le paramètre de nom de journal source.
• Le filtrage des postes de journal n'est pas pris en charge lorsque la valeur *MAXOPT1, *MAXOPT2 ou *MAXOPT3 n'est pas spécifiée pour le paramètre RCVSIZOPT du journal source.
• Les récepteurs de journal éloigné pour lesquels des critères de filtrage sont spécifiés ne peuvent pas être sauvegardés ni restaurés vers une édition antérieure à la V7R1M0 , et aucun critère de filtrage ne peut être indiqué si l'édition du système éloigné est antérieure à la V7R1M0.

Paramètres

Base de données relationnelle (RDB)

Indique le nom du poste de répertoire de base de données relationnelle contenant le nom de lieu éloigné du système cible. Ce nom doit correspondre au nom du poste de répertoire de base de données relationnelle *LOCAL sur l'ordinateur cible.

Ce paramètre est obligatoire.

poste-base-données-relationnelle

Indiquez le nom du poste de répertoire de base de données relationnelle (18 caractères au maximum).

Journal source (SRCJRN)

Indique le nom du journal source associé au journal éloigné en cours de modification, ainsi que la bibliothèque dans laquelle il réside.

Ce paramètre est obligatoire.

Qualificatif 1 : Journal source

nom-journal-source

Indiquez le journal source associé au journal éloigné en cours de modification.

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 recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

nom-bibliothèque

Indiquez le nom de la bibliothèque dans laquelle réside le journal.

Journal cible (TGTJRN)

Indique le journal éloigné en cours de modification sur le système cible.

Valeurs uniques

*SRCJRN

Le nom du journal cible est identique à celui du journal source.

Qualificatif 1 : Journal cible

nom-journal-cible

Indiquez le nom du journal cible à modifier.

Qualificatif 2 : Biblio

nom-bibliothèque

Indiquez le nom de la bibliothèque dans laquelle réside le journal.

Etat du journal (JRNSTATE)

Indique si le journal éloigné est prêt à recevoir des postes du journal source.

*SAME

La valeur ne change pas.

*ACTIVE

Le journal éloigné est prêt à recevoir des postes du journal source.

*INACTIVE

Le journal éloigné n'est pas prêt à recevoir des postes du journal source.

Mode de réception des messages (DELIVERY)

Indique si les postes de journal sont répliqués de façon synchrone ou asynchrone lorsque le journal éloigné est activé.

Remarque :Ce paramètre n'est correct qu'en présence de JRNSTATE(*ACTIVE).

*SAME

La valeur reste inchangée.

*ASYNC

Les postes de journal sont répliqués de façon asynchrone.

*SYNC

Les postes de journal sont répliqués de façon synchrone.

Début au récepteur de journal (STRJRNRCV)

Récepteur de journal à partir duquel commence la réplication des postes de journal du système source vers le système cible.

Remarque :Ce paramètre n'est correct qu'en présence de JRNSTATE(*ACTIVE).

*ATTACHED

La réplication de postes de journal commence à partir du récepteur actuellement attaché au journal éloigné sur le système cible. Les postes de journal sont répliqués à partir du récepteur de journal correspondant associé au journal sur le système source. La réplication commence par les postes de journal qui suivent le dernier poste présent dans le récepteur de journal sur le système éloigné. Si le journal éloigné sur le système cible n'est associé à aucun récepteur de journal, le récepteur attaché au journal sur le système source est créé sur le système cible et attaché au journal éloigné. La réplication commence par le premier poste existant dans le récepteur actuellement attaché au journal se trouvant sur le système source. Si aucun récepteur n'est attaché à ce journal (ce qui ne peut se produire que dans le cas d'un journal éloigné associé à un autre journal éloigné), aucune réplication de postes de journal ne peut avoir lieu et un message d'erreur est envoyé.

*SRCSYS

La réplication de postes de journal commence à partir du récepteur de journal actuellement attaché au journal sur le système source. Si le récepteur de journal correspondant existe et est attaché au journal éloigné sur le système cible, la réplication commence par les postes de journal qui suivent le dernier poste de journal présent dans le récepteur de journal attaché sur le système cible. Sinon, si le récepteur de journal correspondant existe mais qu'il n'est pas attaché au journal éloigné sur le système cible, aucune réplication de postes ne peut avoir lieu et un message d'erreur est envoyé. Si le récepteur de journal correspondant n'existe pas sur le système cible, il y est créé et attaché au journal éloigné. La réplication commence par le premier poste existant dans le récepteur actuellement attaché au journal se trouvant sur le système source. Si aucun récepteur n'est attaché à ce journal (ce qui ne peut se produire que dans le cas d'un journal éloigné associé à un autre journal éloigné), aucune réplication de postes de journal ne peut avoir lieu et un message d'erreur est envoyé.

nom-récepteur-journal-départ

Indiquez le récepteur de journal à partir duquel la réplication doit débuter. Si le récepteur de journal correspondant existe et est attaché au journal éloigné sur le système cible, la réplication commence par les postes de journal qui suivent le dernier poste de journal présent dans le récepteur de journal attaché sur le système cible. Sinon, si le récepteur de journal correspondant existe mais qu'il n'est pas attaché au journal éloigné sur le système cible, aucune réplication de postes ne peut avoir lieu et un message d'erreur est envoyé. Si le récepteur de journal correspondant n'existe pas sur le système cible, il y est créé et attaché au journal éloigné. Ensuite, la réplication est effectuée, en commençant par le premier poste de journal dans le récepteur de journal indiqué sur le système source.

Le nom du récepteur de journal de départ peut être qualifié de l'une des valeurs de bibliothèque suivantes :

*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 recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

nom

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Services de point d'accès (DTAPORTSRV)

Indique le nom de l'identificateur du noeud de grappe et quatre adresses Internet au maximum à utiliser comme méthode de communication alternative lors de l'envoi des postes de journal vers un système cible. La configuration de la grappe et des services de point d'accès avec plusieurs lignes peut contribuer à une meilleure résilience des communications.

*SAME

La valeur reste inchangée.

*NONE

L'environnement de journal éloigné n'utilisera pas les services de point d'accès. La base de données relationnelle sera utilisée pour toutes les communications vers le système cible.

Elément 1 : Node identifier

nom

Indiquez l'identificateur de noeud de grappe pour le système cible. L'utilisateur est responsable de la configuration d'un environnement de grappe, le système cible étant l'un de ses noeuds. Le noeud de grappe du système cible doit être actif avant d'activer le journal éloigné.

Elément 2 : Data port IP address

valeur-caractère

Indiquez quatre adresses Internet distinctes vers le noeud cible. L'utilisateur est responsable de la configuration des adresses TCP/IP. Ces adresses doivent être configurées entre les systèmes cible et source avant d'activer le journal éloigné. Toutes les adresses en double seront ignorées.

Priorité de tâche d'envoi (SNDTSKPTY)

Indique la priorité de la tâche d'envoi sur le système source pour les journaux éloignés soumis à une mise à jour asynchrone. La valeur de priorité est comprise entre 1 (priorité la plus élevée) et 99 (priorité la plus faible). Elle reflète l'importance (relative, et non absolue) de cette tâche pour les ressources machine.

Remarque :Ce paramètre n'est correct qu'en présence de JRNSTATE(*ACTIVE) et de DELIVERY(*ASYNC).

*SAME

La valeur reste inchangée.

*SYSDFT

Le système choisit, pour la tâche d'envoi, une valeur de priorité supérieure à la priorité la plus élevée qu'un utilisateur puisse indiquer (c'est-à-dire supérieure à la priorité 1).

1-99

Indiquez la priorité de la tâche d'envoi sur le système source.

Dépassement délai envoi synch (SYNCTIMO)

Indique le temps d'attente de réponse maximal (en secondes) du système éloigné lorsqu'une réponse est requise dans un environnement de journal éloigné synchrone. Si une réponse n'est pas reçue dans le nombre de secondes imparti, l'environnement de journal éloigné sera désactivé.

Remarque :Ce paramètre est uniquement valide lorsque JRNSTATE(*ACTIVE) et DELIVERY(*SYNC) sont indiqués.

Remarque :Lorsque le journal entame le processus d'association d'un nouveau récepteur, les postes de journal du système source sont maintenus tant que le nouveau récepteur n'est pas associé. Le délai d'attente des nouveaux postes de journal ne démarreront pas tant que le nouveau récepteur n'est pas associé et que les nouveaux postes de journal ne sont pas envoyés au système cible.

*SAME

La valeur reste inchangée.

*SYSDFT

Par défaut, le système choisit la valeur de 60 secondes d'attente de réponse de la part du système éloigné.

1-3600

Indiquez le délai d'attente de réponse maximal (en secondes) de la part du système éloigné.

Contrôle de validité (VLDCHK)

Indique s'il convient d'utiliser la vérification de validité des communications. Lorsque la vérification de validité des communications est activée, l'environnement de journal éloigné propose de vérifier que les données reçues par le système cible correspondent à celles envoyées par le système source. Si les données ne correspondent pas, elles ne sont pas écrites sur le système cible, l'environnement de journal éloigné est désactivé et des messages indiquant les incidents de communication sont envoyés dans la file d'attente de messages du journal et QHST.

Remarque :Ce paramètre n'est correct qu'en présence de JRNSTATE(*ACTIVE).

*SAME

La valeur reste inchangée.

*DISABLED

La vérification de validité des communications est désactivée pour cet environnement de journal éloigné.

*ENABLED

La vérification de validité des communications est activée pour cet environnement de journal éloigné.

Remarque :La vérification de validité des communications peut avoir un impact sur les performances.

Redémarrage automatique (RESTART)

Indique si le système d'exploitation doit ou non tenter de réactiver le journal éloigné suite à un incident remédiable. Pour une liste des incidents auxquels le système d'exploitation tentera de remédier, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre n'est correct qu'en présence de JRNSTATE(*ACTIVE).

Valeurs uniques

*SAME

La valeur reste inchangée.

*NONE

Le système d'exploitation ne tentera pas de réactiver le journal éloigné suite à un incident remédiable.

Elément 1 : Nbre maximal de tentatives

1-200

Le système d'exploitation tentera de réactiver le journal éloigné, ceci jusqu'à concurrence du nombre de tentatives indiqué.

Elément 2 : Délai

10-3600

Le système d'exploitation attendra le nombre de secondes indiqué entre les différentes tentatives de réactivation du journal éloigné.

Filtrer par objet (FTROBJ)

Indique si les postes de journal envoyés au journal éloigné doivent ou non être filtrés par objet.

Remarque :Ce paramètre n'est correct qu'en présence de JRNSTATE(*ACTIVE).

Remarque :Lors d'une modification des critères de filtrage, le paramètre Début au récepteur de journal (STRJRNRCV) ne peut pas prendre la valeur *ATTACHED, de même qu'il n'est pas possible d'indiquer le récepteur de journal actuellement attaché au journal éloigné.

Remarque :Lorsque, sur des récepteurs de journal du système cible, certains postes de journal peuvent avoir été filtrés au titre de cette option, ces récepteurs ne peuvent pas être utilisés avec les commandes APYJRNCHG (Appliquer les modifications journalisées), APYJRNCHGX (Appliquer les modifications journalisées étendues) ou RMVJRNCHG (Enlever les modifications journalisées).

*SAME

La valeur reste inchangée.

*NO

Les postes de journal envoyés au journal éloigné ne seront pas filtrés par objet.

*YES

Les postes de journal consignés pour les objets indiquant un filtrage du journal éloigné au moment de la consignation ne seront pas envoyés au journal éloigné.

Filtrer les images (FTRIMAGES)

Indique si les images avant doivent ou non être envoyées au journal éloigné.

Remarque :Ce paramètre n'est correct qu'en présence de JRNSTATE(*ACTIVE).

Remarque :Lors d'une modification des critères de filtrage, le paramètre Début au récepteur de journal (STRJRNRCV) ne peut pas prendre la valeur *ATTACHED, de même qu'il n'est pas possible d'indiquer le récepteur de journal actuellement attaché au journal éloigné.

Remarque :Lorsque, sur des récepteurs de journal du système cible, certains postes de journal peuvent avoir été filtrés au titre de cette option, ces récepteurs ne peuvent pas être utilisés avec la commande RMVJRNCHG (Enlever les modifications journalisées).

*SAME

La valeur reste inchangée.

*NONE

Toutes les postes de journal seront envoyés au journal éloigné, excepté s'ils doivent être filtrés au titre du filtrage par objet (paramètre FTROBJ) ou du filtrage par programme.

*BEFORE

Les images avant ne seront pas envoyées au journal éloigné.

Méthode de désactivation (INACTOPT)

Indique la manière dont la réplication de postes de journal prend fin lorsque le journal éloigné est désactivé.

Remarque :Ce paramètre n'est correct qu'en présence de JRNSTATE(*INACTIVE).

*CNTRLD

Le système exécute une désactivation contrôlée de la réplication de postes de journal. Cela signifie qu'avant de désactiver le journal éloigné, le système doit répliquer d'abord tous les postes de journal déjà mis en file d'attente pour être envoyés du système source au système cible. Dès lors qu'une demande de désactivation contrôlée a été émise, aucun autre poste de journal ne peut être mis en file d'attente. La désactivation contrôlée est impossible si le journal est à l'état de suspension ou en cours de mise à jour synchrone. Dans ces deux cas, le système modifie implicitement la demande de désactivation contrôlée en demande de désactivation immédiate.

*IMMED

Le système exécute une désactivation immédiate de la réplication de postes de journal. Cela signifie qu'avant de désactiver le journal éloigné, le système met fin à toute réplication de postes de journal placés en file d'attente.

Exemples

Exemple 1 : Activation d'un journal éloigné à gérer de façon asynchrone

CHGRMTJRN   RDB(CHICAGO)
            SRCJRN(LCLLIB/JOURNAL1)  TGTJRN(RMTLIB/JOURNAL1)
            JRNSTATE(*ACTIVE)  DELIVERY(*ASYNC)
            SNDTSKPTY(*SYSDFT) VLDCHK(*ENABLED)
            RESTART(10 60)

Cette commande active le journal éloigné JOURNAL1 de la bibliothèque RMTLIB afin que les postes de journal soient répliqués depuis le journal source JOURNAL1 de la bibliothèque LCLLIB vers le journal éloigné JOURNAL1 de la bibliothèque RMTLIB. La réplication s'effectuera de manière asynchrone, le système fixera la priorité de la tâche d'envoi et la vérification de validité des communications sera activée. Si le journal éloigné échoue de façon imprévue suite à une erreur remédiable, le système tentera de réactiver ce journal toutes les 60 secondes, ceci jusqu'à concurrence de dix tentatives.

Exemple 2 : Activation d'un journal éloigné à l'aide des services de point d'accès

CHGRMTJRN   RDB(CHICAGO)
            SRCJRN(LCLLIB/JOURNAL1)  TGTJRN(RMTLIB/JOURNAL1)
            JRNSTATE(*ACTIVE)  DELIVERY(*SYNC)
            DTAPORTSRV(CLUNODE1 255.255.255.001 255.255.255.002)
            SYNCTIMO(*SYSDFT) VLDCHK(*ENABLED)

Cette commande active le journal éloigné JOURNAL1 de la bibliothèque RMTLIB afin que les postes de journal soient répliqués depuis le journal source JOURNAL1 de la bibliothèque LCLLIB vers le journal éloigné JOURNAL1 de la bibliothèque RMTLIB. La réplication s'effectuera de manière synchrone. Les données seront envoyées à l'aide des services de point d'accès au noeud de grappe CLUNODE1 par les adresses Internet 255.255.255.001 et 255.255.255.002. La valeur système par défaut de 60 secondes sera attribuée au délai d'attente d'envoi synchrone et la vérification de validité des communications sera activée.

Exemple 3 : Désactivation d'un journal éloigné

CHGRMTJRN   RDB(CHICAGO)  SRCJRN(LCLLIB/JOURNAL1)
            TGTJRN(RMTLIB/JOURNAL1)
            JRNSTATE(*INACTIVE)  INACTOPT(*IMMED)

Cette commande désactive le journal éloigné JOURNAL1 de la bibliothèque RMTLIB afin que les postes de journal ne soient plus répliqués depuis le journal source JOURNAL1 de la bibliothèque LCLLIB vers le journal éloigné JOURNAL1 de la bibliothèque RMTLIB. La désactivation sera immédiate.

Exemple 4 : Activation d'un journal éloigné filtré

CHGRMTJRN   RDB(NEWYORK)
            SRCJRN(LCLLIB/JOURNAL1)  TGTJRN(RMTLIB/JOURNAL1)
            JRNSTATE(*ACTIVE)  DELIVERY(*ASYNC)
            FTRIMAGES(*BEFORE)

Cette commande active le journal éloigné JOURNAL1 de la bibliothèque RMTLIB afin que les postes de journal soient répliqués depuis le journal source JOURNAL1 de la bibliothèque LCLLIB vers le journal éloigné JOURNAL1 de la bibliothèque RMTLIB. La réplication s'effectuera de manière asynchrone. Tous les postes de journal d'image avant seront filtrés et ces postes ne seront pas envoyés au journal éloigné.

Messages d'erreur

Messages *ESCAPE

CPF69A2

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

CPF69A3

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

CPF69A8

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

CPF694D

Récepteur de journal &8 inattendu trouvé.

CPF694F

Echec de la communication (code raison &10).

CPF6942

Type de journal &1 de &2 incorrect.

CPF6943

Options de taille du récepteur incorrectes pour le journal &1 de &2.

CPF696F

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

CPF697A

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

CPF697B

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

CPF697C

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

CPF697D

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

CPF697E

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

CPF697F

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

CPF6973

Jrn source incompatible avec syst cible.

CPF6974

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

CPF698A

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

CPF698B

Récepteur de journal imprévu attaché à &1.

CPF698C

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

CPF698D

Le journal &1 n'est pas un journal éloigné.

CPF698E

Journal &1 non associé au journal source.

CPF698F

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

CPF6982

Poste de répertoire de base de données relationnelle &1 incorrect.

CPF699A

Récepteur de journal &8 inattendu trouvé.

CPF699E

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

CPF6993

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

CPF6994

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

CPF6995

Récepteur de journal inattendu &8 détecté ; code raison &12.

CPF6996

Réplication des postes de journal arrêtée.

CPF6997

Récepteur de journal &8 inattendu trouvé.

CPF6998

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

CPF6999

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

CPF70A3

Journal éloigné &1 de &2 non modifié.

CPF70DB

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

CPF70D9

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

CPF701B

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

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.

CPF9814

Unité &1 non trouvée.

CPF9820

Non autorisé à utiliser la bibliothèque &1.

CPF9830

Allocation de la bibliothèque &1 impossible.

TCP1901

Adresse Internet &2 non valide. Internet address &2 not valid.