ADDRMTJRN

La commande ADDRMTJRN permet d'associer un journal éloigné sur le système cible, identifié par le poste de répertoire de base de données relationnelle, au journal indiqué sur le système source. Le journal sur le système source peut être un journal local ou un autre journal éloigné. Vous pouvez associer au maximum 255 journaux éloignés à un seul journal sur un système source.

Lorsqu'il est ajouté à un journal source, un journal éloigné est créé sur le système cible sur la base d'une combinaison d'attributs provenant du journal source et des paramètres en entrée indiqués avec cette commande. Pour que celle-ci puisse être exécutée sur le système source, le système cible doit déjà contenir la bibliothèque dans laquelle sera créé le journal éloigné. Tout journal éloigné créé à l'aide de cette commande a pour type *REMOTE et n'est attaché à aucun récepteur de journal.

Remarque :Un récepteur est attaché lors de l'activation du journal éloigné à l'aide de la commande CHGRMTJRN ou de l'API QjoChangeJournalState (Modification d'état de journal).

Lors de son ajout, le journal éloigné peut être créé dans une bibliothèque de même nom que celle du journal source ou dans une autre bibliothèque redirigée sur le système cible. Cette dernière fournit un moyen permettant aux journaux éloignés et aux récepteurs de journal éventuellement associés de résider dans des bibliothèques du système cible portant des noms différents de ceux des bibliothèques du système local correspondantes contenant le journal et les récepteurs de journal. Si une validation de bibliothèque de journal est indiquée sur le système cible, c'est le nom de bibliothèque redirigée qui est utilisé. De même, les récepteurs de journal qui seront ultérieurement créés et associés à ce journal éloigné pourront résider soit dans la même bibliothèque que les récepteurs du journal source sur le système source, soit dans une autre bibliothèque portant un nom distinct et redirigée sur le système cible. Si vous envisagez d'indiquer une bibliothèque redirigée pour les récepteurs de journal, vous devez le faire au moment d'ajouter le journal éloigné à l'aide de cette commande.

Lors de l'ajout d'un journal éloigné sur un système cible, vous pouvez indiquer deux types de journal éloigné : *TYPE1 et *TYPE2. Ce type a une incidence sur la fonction de redirection, les opérations de restauration de récepteur de journal et les caractéristiques d'association au journal éloigné.

• Tout journal éloigné *TYPE1 associé au journal local doit utiliser la même redirection pour le journal éloigné et le récepteur de journal éloigné. Ceci permet la sauvegarde et la restauration d'un récepteur de journal à partir de/vers n'importe quel système du réseau du journal éloigné et son association avec un journal local ou éloigné.
• Tout journal éloigné *TYPE2 associé au journal local peut utiliser une redirection différente pour le journal éloigné ou le récepteur de journal éloigné. Ceci a pour conséquence de restreindre les options de sauvegarde et de restauration. Le récepteur de journal ne peut être associé au journal éloigné que s'il a été sauvegardé à partir du système sur lequel réside ce journal éloigné. Si le récepteur de journal a été sauvegardé à partir du système sur lequel réside le journal local, il ne peut être associé au journal éloigné d'aucun système.

Lorsque le journal indiqué existe déjà sur le système cible, vous pouvez l'associer au journal source si les conditions suivantes sont toutes réunies :

• le journal est de type *REMOTE ;
• le type du journal éloigné correspond au type de journal éloigné indiqué ;
• le journal éloigné a précédemment été associé au même journal source.

Par ailleurs, le journal peut indifféremment être attaché ou non à un récepteur.

Une fois ajouté sur le système cible, le journal éloigné est à l'état *INACTIVE, c'est-à-dire qu'il ne peut pas encore recevoir de postes de journal provenant de son journal source qui réside sur le système source. La commande CHGRMTJRN et l'API QjoChangeJournalState (Modification de journal éloigné) permettent d'activer le journal éloigné et de lancer la réplication de poste entre le journal source et le journal éloigné.

Une fois qu'un journal éloigné a été ajouté à un journal, le récepteur attaché au journal source au moment de l'exécution de cette commande, ou tout autre récepteur ultérieurement attaché, ne peut pas être supprimé tant que tous les postes de journal du récepteur de journal n'ont pas encore été répliqués sur le journal éloigné. Cette protection ne s'applique pas si ce dernier est supprimé à l'aide de la commande RMVRMTJRN ou de l'API QjoRemoveRemoteJournal (Suppression de journal éloigné).

Restrictions :

• La commande ADDRMTJRN ne peut être appelée qu'à partir du système source.
• Le système cible doit contenir un profil utilisateur portant le même nom que le profil utilisateur utilisé pour exécuter la commande ADDRMTJRN sur le système source. Cette restriction s'applique quel que soit le protocole de communication sélectionné.
• Lors de l'ajout d'un journal éloigné *TYPE1 à un journal source, vous devez indiquer le même journal et la même bibliothèque de récepteur de journal redirigée que ceux spécifiés pour les autres journaux éloignés *TYPE1 déjà ajoutés à ce journal source. Un journal éloigné utilise toujours la bibliothèque redirigée indiquée, le cas échéant, pour le journal local. Pour modifier les valeurs de bibliothèque de journal éloigné et de bibliothèque de récepteur de journal éloigné, procédez comme suit :
  1. Supprimez du journal local tous les journaux éloignés *TYPE1 qui lui sont associés.
  2. Supprimez le journal éloigné.
  3. Modifiez le journal local pour attacher un nouveau récepteur.
  4. Ajoutez le journal éloigné en spécifiant les nouvelles informations de redirection.
• Vous ne pouvez pas indiquer QTEMP comme bibliothèque de journal éloigné, bibliothèque de récepteur de journal éloigné ou bibliothèque de file d'attente de messages éloignée.
• Un journal éloigné dont le nom commence par Q ne peut pas être associé à une bibliothèque de journal éloigné dont le nom commence aussi par Q, sauf s'il s'agit de QGPL. Cela afin d'éviter les collisions entre les journaux locaux et les journaux éloignés utilisés pour les fonctions du système.
• Un journal éloigné de *TYPE1 ne peut pas être ajouté à un journal éloigné de *TYPE2.
• 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 file d'attente des messages du journal éloigné sur le système éloigné doit être soit dans le même groupe ASP que le journal éloigné, soit dans l'ASP système, soit dans un ASP utilisateur de base.
• La bibliothèque de récepteur éloigné et la bibliothèque de journal éloigné sur le système éloigné doit exister à la fois soit sur les ASP système et utilisateur de base soit dans le même groupe ASP. Elles ne peuvent pas être dans deux différents groupes ASP.

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 sur le système source auquel le journal éloigné est ajouté, ainsi que la bibliothèque dans laquelle il réside. Le journal sur le système source peut être un journal local ou un autre journal éloigné.

Ce paramètre est obligatoire.

nom-journal-source

Indiquez le journal source auquel le journal cible est ajouté.

Le nom du journal source 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-bibliothèque

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

Journal cible (TGTJRN)

Indique le nom du journal éloigné sur le système cible.

*SRCJRN

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

nom-bibliothèque/nom-journal-cible

Indiquez le journal cible en cours d'ajout comme journal éloigné au journal source.

Bibliothèque récepteur éloigné (RMTRCVLIB)

Indique le nom de la bibliothèque destinée à contenir les récepteurs qui seront associés à ce journal éloigné sur le système cible.

*SRCRCVLIB

Les récepteurs de journal sont créés sur le système cible dans la même bibliothèque que sur le système source.

nom-bibliothèque-récepteurs-journal-éloigné

Indiquez le nom de la bibliothèque destinée à contenir les récepteurs qui seront associés à ce journal éloigné sur le système cible.

Type de journal éloigné (RMTJRNTYPE)

Indique le type du journal éloigné sur le système cible. Ce type a une incidence sur la fonction de redirection, les opérations de restauration de récepteur de journal et les caractéristiques d'association au journal éloigné. Le manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ fournit une description détaillée des différences entre ces deux types de journal éloigné.

*TYPE1

Le journal éloigné ajouté est de *TYPE1. Tout journal éloigné *TYPE1 associé au journal local doit utiliser la même redirection pour le journal éloigné et le récepteur de journal éloigné. Ceci permet la sauvegarde et la restauration d'un récepteur de journal à partir de/vers n'importe quel système du réseau du journal éloigné et son association avec un journal local ou éloigné.

*TYPE2

Le journal éloigné ajouté est de *TYPE2. Tout journal éloigné *TYPE2 associé au journal local peut utiliser une redirection différente pour le journal éloigné ou le récepteur de journal éloigné. Ceci a pour conséquence de restreindre les options de sauvegarde et de restauration. Le récepteur de journal ne peut être associé au journal éloigné que s'il a été sauvegardé à partir du système sur lequel réside ce journal éloigné. Si le récepteur de journal a été sauvegardé à partir du système sur lequel réside le journal local, il ne peut être associé au journal éloigné d'aucun système.

File attente messages journal (MSGQ)

Indique le nom de la file d'attente de messages associée au journal éloigné. Cette valeur n'est définie que pour un journal créé sur le système cible.

QSYS/QSYSOPR

Le message est envoyé dans la file d'attente QSYSOPR.

nom-bibliothèque/file-attente-messages-journal

Indiquez le nom de la file d'attente de messages vers laquelle les messages du journal seront envoyés. 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.

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.

Suppression des récepteurs (DLTRCV)

Indique si les récepteurs de journal cible sont supprimés lorsqu'ils ne sont plus nécessaires ou conservés sur le système cible pour être supprimés par l'utilisateur une fois qu'ils sont détachés par ce système cible. Cette valeur n'est définie que pour un journal créé sur le système cible.

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

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 éloigné sur le système cible, ce paramètre indique la durée (en minutes) indiqué avant de retenter l'opération. Cette valeur n'est définie que pour un journal créé sur le système cible.

10

Le système attend 10 minutes avant la nouvelle tentative.

délai-suppression-récepteur

Le système attend le nombre de minutes indiqué avant la nouvelle tentative. Les valeurs correctes sont comprises entre 1 et 1440.

Texte 'descriptif' (TEXT)

Indique un texte qui décrit brièvement le journal éloigné sur le système cible. Cette valeur n'est définie que pour un journal créé sur le système cible.

*BLANK

Aucun texte n'est indiqué.

'descriptif'

Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Exemples

Exemple 1 : Ajout d'un journal distant *TYPE1 avec indication de valeurs pour les paramètres DLTRCV et TEXT.

ADDRMTJRN   SRCJRN(LOCLIB/J)  RDB(DETROIT)  TGTJRN(RMTLIB/J)
            DLTRCV(*NO)
            TEXT('Journal éloigné créé pour application Z')

Cette commande ajoute le journal éloigné J de la bibliothèque RMTLIB au journal J de la bibliothèque LOCAL ; le paramètre DLTRCV du journal *NO, quel que soit l'attribut du journal J de la bibliothèque LOCLIB. Si le journal J de RMTLIB n'existe pas, il est créé ; dans le cas contraire, il est réassocié au journal J de LOCLIB, à condition de répondre aux critères appropriés.

Messages d'erreur

Messages *ESCAPE

CPF69A4

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

CPF695A

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

CPF695B

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

CPF695C

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

CPF695D

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

CPF695E

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

CPF695F

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

CPF6973

Jrn source incompatible avec syst cible.

CPF6982

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

CPF6983

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

CPF6984

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

CPF6985

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

CPF6988

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

CPF6989

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

CPF699B

Profil utilisateur &8 non trouvé.

CPF6991

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

CPF70DB

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

CPF70D6

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

CPF701B

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

CPF7010

L'objet &1 de type *&3 existe déjà dans &2.

CPF7011

Ressources ou mémoire insuffisantes.

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.

CPF9830

Allocation de la bibliothèque &1 impossible.