CRTJRNRCV

La commande CRTJRNRCV (Créer un récepteur de journal) permet de créer un récepteur de journal. Une fois le récepteur attaché au journal (par la commande CRTJRN (Créer un journal) ou CHGJRN (Modifier un journal)), les postes de journal peuvent y être placés. Un pool de mémoire secondaire (ASP) et une valeur de seuil d'espace mémoire peuvent être indiqués pour le récepteur du journal.

Restrictions :

• Un récepteur de journal ne peut pas être créé dans la bibliothèque QTEMP.
• Cette commande ne peut pas être utilisée pour créer un récepteur pour un journal éloigné.
• Si la bibliothèque qui va contenir le récepteur de journal est sur un ASP indépendant, ASP(*LIBASP) doit être indiqué.

Paramètres

Récepteur de journal (JRNRCV)

Indique le nom et la bibliothèque du récepteur de journal à créer.

Ce paramètre est obligatoire.

Qualificatif 1 : Récepteur de journal

nom-récepteur

Indiquez le nom du récepteur de journal à créer.

Qualificatif 2 : Biblio

*CURLIB

Le récepteur de journal est créé 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 la bibliothèque dans laquelle le récepteur de journal doit être créé.

Numéro d'ASP (ASP)

Indique le pool de mémoire secondaire (ASP) à partir duquel le système alloue un espace mémoire au récepteur de journal.

*LIBASP

L'espace mémoire alloué au récepteur de journal provient du pool de mémoire secondaire (ASP) dans lequel réside la bibliothèque du récepteur de journal.

identificateur-ASP

Indiquez une valeur comprise entre 1 et 32 pour définir l'identificateur de l'ASP à partir duquel l'espace mémoire du récepteur de journal doit être alloué. Les valeurs correctes sont fonction de la façon dont les ASP sont définis sur le système.

Remarque :La valeur 1 désigne l'ASP système. Toute autre valeur correspond à un ASP utilisateur.

Seuil d'alerte du récepteur (THRESHOLD)

Valeur de seuil d'espace mémoire (en ko) pour le récepteur de journal. 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 de la commande CRTJRN (Créer un journal) ou CHGJRN (Modifier un journal).

Remarque :La valeur du paramètre MNGRCV est indiquée dans la commande CRTJRN ou CHGJRN pour le journal. 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.

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.

1500000

Il s'agit de la valeur de seuil par défaut. Chaque tranche de 1 000 Ko correspond à 1 024 000 octets d'espace mémoire.

*NONE

Aucune valeur de seuil n'est indiquée. Le message CPF7099 n'est pas envoyé et le paramètre MNGRCV(*SYSTEM) ne peut pas être indiqué lorsque ce récepteur est attaché à un journal.

1-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. Une valeur inférieure à 100 000 sera automatiquement réinitialiser à 100 000. 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 d'attacher un récepteur à 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.
2. Si vous avez indiqué une valeur inférieure à 100 000, celle-ci sera automatiquement réinitialiser à 100 000. Sinon, vous risqueriez de provoquer l'émission fréquente du message du dépassement du seuil. Une valeur de seuil trop basse risque également de provoquer l'émission de ce message lors de l'attachement d'un récepteur à un journal à l'aide de la commande CRTJRN (Créer un journal) ou CHGJRN (Modifier un journal).

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*BLANK

Aucun texte n'est précisé.

'descriptif'

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

Choix unité stockage second (UNIT)

Ce paramètre n'est plus pris en charge. Il est cependant conservé pour maintenir la compatibilité au niveau syntaxique avec les éditions antérieures à la version 1, édition 3, niveau de modification 0, du système d'exploitation.

Pour isoler le récepteur de journal sur un disque, utilisez le paramètre ASP. Pour plus d'informations sur l'emploi des ASP utilisateur, voir l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Vous pouvez indiquer pour ce paramètre la valeur *ANY ou une valeur comprise entre 1 et 32.

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.

*EXCLUDE

L'utilisateur ne peut pas accéder à l'objet.

*LIBCRTAUT

Le système détermine les droits sur l'objet à l'aide de la valeur spécifiée à l'invite Droits pour objets créés (paramètre CRTAUT) dans la commande CRTLIB pour la bibliothèque contenant l'objet à créer. Si la valeur précisée au paramètre CRTAUT est modifiée, la nouvelle valeur n'affecte pas les objets existants.

*CHANGE

L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.

*ALL

L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.

*USE

L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).

nom

Indiquez le nom d'une liste d'autorisation permettant de déterminer les droits sur l'objet. Les droits sur l'objet précisés dans la liste sont accordés aux utilisateurs qui figurent sur cette liste. La liste d'autorisation doit exister à la création de l'objet.

Exemples

CRTJRNRCV   JRNRCV(MYLIB/JRNRCLA)  ASP(3)
            THRESHOLD(100000)  AUT(*ALL)
            TEXT('RECEPTEUR SEMAINE 37')

Cette commande crée le récepteur de journal JRNRCLA dans la bibliothèque MYLIB. L'espace mémoire du récepteur de journal provient du pool de mémoire secondaire (ASP) 3 de l'utilisateur. Quand la taille de JRNRCLA dépasse 100 000 kilo-octets (102 400 000 octets), le message CPF7099 est envoyé à la file de messages du journal, si le journal auquel est attaché ce récepteur possède l'attribut MNGRCV(*USER). Le droit d'accès au récepteur de journal est *ALL.

Messages d'erreur

Messages *ESCAPE

CPF2108

Objet &1, type *&3, non ajouté à la bibliothèque &2.

CPF2283

La liste d'autorisation &1 n'existe pas.

CPF70FD

Objet d'état recréé pour le journal système interne.

CPF7010

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

CPF7011

Ressources ou mémoire insuffisantes.

CPF7012

Pool de mémoire secondaire &4 non trouvé pour objet &1.

CPF70FD

Objet d'état recréé pour le journal système interne.

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.

CPF9839

Objet &1 non créé.

CPF9840

Objet &1 non créé.

CPF9873

Accès à l'objet impossible en raison de l'état de l'ASP.

CPF9875

Ressources insuffisantes dans l'ASP &1.Appuyez sur AIDE.