RMVRMTJRN

Enlever un journal éloigné

En bref

La commande RMVRMTJRN permet de dissocier un journal éloigné sur le système cible indiqué du journal spécifié sur le système source.

RMVRMTJRN se lit RMV (Retirer) + RMTJRN. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RMVRMTJRN RDB(…) SRCJRN(…)

Paramètres

RDB Base de données relationnelle obligatoire
SRCJRN Journal source obligatoire
TGTJRN Journal cible

Astuce : dans une session 5250, tapez RMVRMTJRN 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 : Non

La commande RMVRMTJRN permet de dissocier un journal éloigné sur le système cible indiqué du journal spécifié sur le système source. Le journal sur le système source peut être un journal local ou un autre journal éloigné.

Cette commande ne supprime pas le journal éloigné sur le système cible, ni, le cas échéant, les récepteurs de journal associés. En effet, aucun traitement n'est exécuté sur le système cible. Vous pouvez, ultérieurement, ajouter de nouveau le journal éloigné conservé sur le système cible à la définition de journal éloigné relative au journal de système source. Pour ce faire, utilisez la commande ADDRMTJRN ou de l'API QjoAddRemoteJournal (Ajout de journal éloigné).

Si vous le souhaitez, c'est à vous de supprimer du système cible le journal éloigné et, le cas échéant, les récepteurs de journal associés.

Une fois l'association de journal éloigné supprimée d'un journal, les récepteurs de journal en cours dans le répertoire de récepteurs de journal sur le système source ne sont plus protégés contre la suppression, même si les postes de journal ne sont pas encore répliqués sur le journal éloigné.

Restrictions :

Cette commande doit être appelée à partir du système source pour un journal local ou éloigné.
Le journal éloigné sur le système cible indiqué ne peut pas être à l'état *ACTIVE.
Le poste de répertoire de base de données relationnelle (RDB) doit respecter les règles suivantes :
- Le protocole de communication choisi doit être pris en charge par la fonction de journal éloigné.
- Le nom de lieu éloigné dans la base de données relationnelle (RDB) ne doit pas faire référence à la base de données *LOCAL.
- 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.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
RDB	Base de données relationnelle	Nom	Obligatoire, positionnel 1
SRCJRN	Journal source	Nom d'objet qualifié	Obligatoire, positionnel 2
	Qualificatif 1: Journal source	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
TGTJRN	Journal cible	Valeurs uniques: SRCJRN Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: Journal cible	Nom
	Qualificatif 2: Biblio	Nom

Base de données relationnelle (RDB)

Nom du poste de répertoire de base de données relationnelle contenant le nom de lieu éloigné du système cible.

Ce paramètre est obligatoire.

nom-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 journal du système source d'où est retiré le journal éloigné. Le journal sur le système source peut être un journal local ou un journal éloigné.

Ce paramètre est obligatoire.

Qualificatif 1 : Journal source

nom-journal-source: Indiquez le nom du journal source à partir duquel le journal cible est en cours de suppression.

Qualificatif 2 : Biblio

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: Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Journal cible (TGTJRN)

Indique le journal éloigné 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 journal cible en cours de suppression à partir du journal source.

Qualificatif 2 : Biblio

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

Exemples

Exemple 1 : Retrait d'un journal éloigné portant le même nom que le journal source

RMVRMTJRN   SRCJRN(RMTLIB/JOURNAL)  RDB(CHICAGO)
            TGTJRN(*SRCJRN)

Cette commande retire le journal éloigné JOURNAL de la bibliothèque RMTLIB identifié par le poste de répertoire de bases de données relationnelles, CHICAGO, du journal source JOURNAL de la bibliothèque RMTLIB.

Messages d'erreur

Messages *ESCAPE

CPF6981: Journal éloigné &1 de &2 non enlevé.
CPF6982: Poste de répertoire de base de données relationnelle &1 incorrect.
CPF6992: Journal éloigné &1 de &2 non enlevé.
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.