DLTJRNRCV

La commande DLTJRNRCV permet de supprimer du système le ou les récepteurs indiqués, afin de libérer de l'espace mémoire. Le point d'exit QIBM_QJO_DLT_JRNRCV est fourni pour la commande DLTJRNRCV. Pour plus d'informations, reportez-vous au manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Restrictions :

• Le récepteur ne doit pas être attaché à un journal lorsque la commande est exécutée.
• Si une tentative de suppression d'un récepteur de journal attaché à un journal éloigné est effectuée, et que ce dernier ne reçoit pas activement de postes de journal ou n'en duplique pas et que DLTOPT(*IGNINQMSG) n'est pas indiqué, un message d'interrogation (CPA705E) est envoyé au poste de travail demandeur. Si la demande est effectuée à partir d'un travail par lots, le message est envoyé à l'opérateur système. Il est possible de répondre automatiquement à ce message d'interrogation. Pour plus d'informations, reportez-vous au paramètre INQMSGRPY de la commande CRTJOBD (Créer description de travail).
• Le récepteur de journal ne peut pas se trouver au milieu d'une chaîne de récepteurs en ligne, sauf s'il est endommagé ou si son récepteur double l'est. (Les récepteurs doivent être supprimés dans le même ordre que celui dans lequel ils ont été détachés, pour empêcher l'apparition de discontinuités dans la plage de récepteurs.
• Si une tentative de suppression d'un récepteur de journal n'ayant pas été sauvegardé est effectuée et que DLTOPT(*IGNINQMSG) n'est pas indiqué, un message d'interrogation (CPA7025) est envoyé au poste de travail demandeur. Si la demande est effectuée à partir d'un travail par lots, le message est envoyé à l'opérateur système. Il est possible de répondre automatiquement à ce message d'interrogation. Pour plus d'informations, reportez-vous à la description du paramètre INQMSGRPY de la commande CRTJOBD (Créer description de travail).
• L'utilisateur doit disposer des droits *ALLOBJ et *SECADM pour pouvoir indiquer la valeur spéciale *IGNEXITPGM.
• Cette commande peut admettre les unités d'exécution multiples, en fonction des conditions relatives à l'enregistrement des programmes d'exit pour le point d'exit QIBM_QJO_DLT_JRNRCV :
  • Si aucun programme d'exit n'est enregistré ou si DLTOPT(*IGNEXITPGM) est indiqué, la commande admet les unités d'exécution multiples.
  • Si tous les programmes d'exit admettent les unités d'exécution multiples et sont enregistrés pour s'exécuter dans un travail à unités d'exécution multiples, la commande admet ces dernières.
  • Si l'enregistrement d'un programme d'exit ne permet pas son exécution dans un travail à unités d'exécution multiples et que vous tentez de l'exécuter dans un tel travail, la commande échoue et le récepteur de journal n'est pas supprimé.

  Utilisez le paramètre MLTTHDACN ou la commande ADDEXITPGM pour indiquer si un programme d'exit peut s'exécuter dans un travail à unités d'exécution multiples. Pour plus de détails, reportez-vous à l'aide associée à la commande ADDEXITPGM.

Paramètres

Récepteur de journal (JRNRCV)

Indique le nom et la bibliothèque du ou des récepteurs de journal à supprimer.

Ce paramètre est obligatoire.

Qualificatif 1 : Récepteur de journal

nom-récepteur-journal

Indiquez le nom et la bibliothèque du récepteur de journal à supprimer. Si *LIBL ou *USRLIBL est indiqué comme nom de bibliothèque, seul sera supprimé le premier récepteur rencontré portant ce nom. Si *ALLUSR ou *ALL est indiqué pour le nom de la bibliothèque, les objets récepteur de journal portant le nom indiqué peuvent être supprimés dans plusieurs bibliothèques.

nom-générique*-récepteur-journal

Indiquez le nom générique de récepteur de journal à supprimer. Un nom générique est une chaîne d'un ou de plusieurs caractères suivie d'un astérisque (*) ; ABC*, par exemple. L'astérisque remplace des caractères valides quelconques. Un nom générique spécifie tous les objets dont le nom commence par le préfixe générique et pour lesquels l'utilisateur dispose d'un droit d'accès. En l'absence d'astérisque dans le nom générique (préfixe), le système considère que le nom d'objet indiqué est complet.

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.

*USRLIBL

S'il existe un poste de bibliothèque en cours dans la liste des bibliothèques de l'unité d'exécution en cours, la recherche porte sur celle-ci ainsi que sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Dans le cas contraire, la recherche porte uniquement sur les bibliothèques de la partie utilisateur de la liste des bibliothèques.

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur. La recherche porte sur toutes les bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception des bibliothèques suivantes :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Par conséquent, ces bibliothèques sont considérées comme des bibliothèques utilisateur et sont donc recherchées :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

1. 'xxxxx' représente le numéro de l'ASP principal.
2. L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

*ALL

La recherche porte sur toutes les bibliothèques du système, y compris QSYS.

nom

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

Option (DLTOPT)

Indique si des contrôles supplémentaires doivent être ignorés avant la suppression d'un récepteur de journal.

*NONE

La suppression du récepteur de journal est tentée sans ignorer les contrôles préventifs effectués avant une telle opération.

*IGNTGTRCV

Le système ne vérifie pas si tous les journaux éloignés associés à ce journal qui sont immédiatement en aval sur un système éloigné ont reçu tous les postes de journal de ce récepteur de journal. L'opération de suppression se poursuit même si l'un de ces journaux éloignés ne les a pas tous reçus. Cette protection d'un récepteur de journal s'applique uniquement lorsque le journal éloigné a été ajouté à l'aide de l'API QjoAddRemoteJournal (ajout d'un journal éloigné), jusqu'à ce qu'il soit retiré à l'aide de l'API QjoRemoveRemoteJournal (retrait d'un journal éloigné) ou jusqu'à ce que le journal soit supprimé. Pour plus d'informations sur les API, reportez-vous au manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

*IGNINQMSG

Le message d'interrogation est ignoré. Le message d'interrogation CPA7025 n'est pas présenté à l'utilisateur, même si ce récepteur n'a pas été totalement sauvegardé (par exemple, en cas de sauvegarde après le détachement du récepteur). Le message d'interrogation CPA705E n'est pas non plus présenté à l'utilisateur même si le récepteur est attaché à un journal éloigné. L'opération de suppression se poursuit.

*IGNEXITPGM

Les programmes d'exit utilisateur sont ignorés. Ceux qui sont enregistrés pour le point d'exit QIBM_QJO_DLT_JRNRCV ne sont pas appelés et ne sont pas pris en compte dans la décision de suppression du récepteur de journal.

Exemples

DLTJRNRCV   JRNRCV(MYLIB/JRNRCLA)

Cette commande supprime du système le journal JRNRCLA résidant dans la bibliothèque MYLIB.

Messages d'erreur

Messages *ESCAPE

CPF2105

Objet &1 de &2 type *&3 non trouvé.

CPF2110

Bibliothèque &1 non trouvée.

CPF2113

Impossible d'allouer la bibliothèque &1.

CPF2114

Impossible d'allouer objet &1 de &2 type *&3.

CPF2117

&4 objet(s) de type *&3 supprimé(s). &5 objet(s) non supprimé(s).

CPF2125

Aucun objet supprimé.

CPF2160

Objet de type *&1 incorrect pour la fonction demandée.

CPF2176

Bibliothèque &1 endommagée.

CPF2182

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

CPF2189

Utilisation de l'objet &1 de &2, type *&3 non autorisée.

CPF70ED

Récepteur non supprimé en raison d'un programme d'exit. Code raison : &7.

CPF701B

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

CPF7022

Impossible de supprimer récepteur de journal &1 si attaché.

CPF7023

Impossible de supprimer récepteur de journal &1 de &2.

CPF7024

Récepteur &1 de &2 non supprimé. Code raison &3.

CPF7025

Suppression du récepteur &1 de &2 annulée.

CPF705B

Non autorisé à indiquer OPTION(*IGNEXITPGM).

CPF705E

Suppression du récepteur &1 de &2 annulée.

CPF705F

Récepteur non répliqué vers &8 journaux éloignés.

CPF707C

Suppression du récepteur de journal &1 impossible. Code raison &5.

CPF707D

Récepteur de journal &1 de &2 non supprimé.

CPF707E

Récepteur de journal &1 de &2 non supprimé.

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.