Aller au contenu

Commande CL IBM i (AS/400)

CRTJRN

Créer un journal

En bref

La commande CRTJRN permet de créer un journal en tant que journal local ayant les attributs spécifiés, et de lui attacher le récepteur indiqué.

CRTJRN se lit CRT (Créer) + JRN. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CRTJRN JRN(…) JRNRCV(…)

Paramètres

  • JRN Journal obligatoire
  • JRNRCV Récepteur de journal obligatoire
  • ASP Numéro d'ASP
  • MSGQ File attente messages journal
  • MNGRCV Gestion des récepteurs
  • DLTRCV Suppression des récepteurs
  • RCVSIZOPT Options de taille de récepteur
  • MINENTDTA Réduction de données de poste
  • JRNCACHE Mise en cache du journal
  • MNGRCVDLY Gérer temps attente récepteur
  • DLTRCVDLY Supprimer temps attente récept
  • FIXLENDTA Données de longueur fixe
  • JRNOBJLMT Limite objet journal
  • TEXT Texte 'descriptif'
  • AUT Droits

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

La commande CRTJRN permet de créer un journal en tant que journal local ayant les attributs spécifiés, et de lui attacher le récepteur indiqué. Une fois créé, le journal peut enregistrer les modifications apportées aux objets journalisés ou recevoir des postes utilisateur. L'état du journal créé est *ACTIVE.

Restrictions :

  • La création d'un journal est impossible dans la bibliothèque QTEMP.
  • Le récepteur indiqué doit être créé avant le lancement de cette commande et il doit être vide (il ne doit pas avoir été attaché à un journal ni avoir été en cours d'attachement).
  • Cette commande ne peut pas être utilisée pour créer un journal éloigné. Veuillez vous reporter à la description de la commande ADDRMTJRN (Ajouter un journal éloigné) ou de l'API QjoAddRemoteJournal dans le manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).
  • Si le journal n'est pas défini avec l'une des valeurs *MAXOPT de RCVSIZOPT, la valeur de seuil maximale pouvant être spécifiée pour un récepteur de journal attaché est 1 919 999 kilo-octets.
  • Si la bibliothèque qui va contenir le journal est sur un ASP indépendant, le récepteur de journal indiqué doit se trouver sur un ASP indépendant qui soit dans le même groupe ASP que la bibliothèque du journal. Si la bibliothèque qui va contenir le journal n'est pas sur un ASP indépendant, le récepteur de journal indiqué ne peut pas se trouver sur un ASP indépendant.
  • Si la bibliothèque qui va contenir le journal est sur un ASP indépendant, ASP(*LIBASP) doit être indiqué.
  • RCVSIZOPT(*MINFIXLEN) et FIXLENDTA ne peuvent pas être utilisés pour le journal d'audit de sécurité système QSYS/QAUDJRN. Les postes de journal du journal d'audit de sécurité doivent contenir toutes les données possibles qui pourraient être utilisées pour l'audit.
  • JRNOBJLMT(*MAX10M) n'est valide que si l'une des valeurs *MAXOPT a été indiquée pour le paramètre RCVSIZOPT.
  • Une fois indiqué pour un journal, JRNOBJLMT(*MAX10M) ne peut être modifié.

Paramètres

Mot-clé Description Valeurs possibles Remarques
JRN Journal Nom d'objet qualifié Obligatoire, positionnel 1
Qualificatif 1: Journal Nom
Qualificatif 2: Biblio Nom, *CURLIB
JRNRCV Récepteur de journal Values (jusqu'à 2 répétitions): Nom d'objet qualifié Obligatoire, positionnel 2
Qualificatif 1: Récepteur de journal Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
ASP Numéro d'ASP 1-32, *LIBASP Facultatif
MSGQ File attente messages journal Nom d'objet qualifié Facultatif
Qualificatif 1: File attente messages journal Nom, QSYSOPR
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
MNGRCV Gestion des récepteurs *SYSTEM, *USER Facultatif
DLTRCV Suppression des récepteurs *NO, *YES Facultatif
RCVSIZOPT Options de taille de récepteur Valeurs uniques: *SYSDFT, *NONE
Autres valeurs (jusqu'à 3 répétitions): *RMVINTENT, *MINFIXLEN, *MAXOPT1, *MAXOPT2, *MAXOPT3
Facultatif
MINENTDTA Réduction de données de poste Valeurs uniques: *NONE
Autres valeurs (jusqu'à 2 répétitions): *FILE, *FLDBDY, *DTAARA
Facultatif
JRNCACHE Mise en cache du journal *NO, *YES Facultatif
MNGRCVDLY Gérer temps attente récepteur 1-1440, 10 Facultatif
DLTRCVDLY Supprimer temps attente récept 1-1440, 10 Facultatif
FIXLENDTA Données de longueur fixe Valeurs uniques: *JOBUSRPGM
Autres valeurs (jusqu'à 9 répétitions): *JOB, *USR, *PGM, *PGMLIB, *SYSSEQ, *RMTADR, *THD, *LUW, *XID
Facultatif
JRNOBJLMT Limite objet journal *MAX250K, *MAX10M Facultatif
TEXT Texte 'descriptif' Valeur caractère, *BLANK Facultatif
AUT Droits Nom, *EXCLUDE, *LIBCRTAUT, *CHANGE, *ALL, *, *USE Facultatif

Journal (JRN)

Indique le nom qualifié du journal à créer.

Ce paramètre est obligatoire.

Qualificatif 1 : Journal

nom-journal
Indiquez le nom du journal à créer.

Qualificatif 2 : Biblio

*CURLIB
Le 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 journal doit être créé.

Récepteur de journal (JRNRCV)

Indique le récepteur à attacher au journal indiqué.

Deux récepteurs de journal au plus peuvent être indiqués, mais le second est ignoré.

Ce paramètre est obligatoire.

Qualificatif 1 : Récepteur de journal

nom-récepteur
Indiquez le nom du récepteur de journal.

Le récepteur de journal ne doit pas avoir été attaché à un journal ni avoir été en cours de l'être.

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
Le système effectue la recherche dans la bibliothèque en cours du travail. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours, la bibliothèque QGPL est utilisée.
nom-bibliothèque
Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Numéro d'ASP (ASP)

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

*LIBASP
L'espace mémoire attribué au journal provient du pool de mémoire secondaire (ASP) dans lequel réside la bibliothèque du journal. Utilisez cette valeur si vous souhaitez que le journal réside dans un pool de mémoire secondaire utilisateur indépendant.
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 journal doit être alloué. Les valeurs correctes sont fonction de la façon dont les ASP sont définis sur le système. Indiquez un numéro d'ASP uniquement si vous souhaitez placer le journal dans un pool de mémoire secondaire utilisateur de base non-bibliothèque.

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

File attente messages journal (MSGQ)

Indique le nom qualifié de la file d'attente de messages associée au journal. Un message est envoyé à cette file d'attente dans les cas suivants :

  • La taille limite d'un récepteur de journal attaché est dépassée. Le message CPF7099 est envoyé si le journal a pour attribut MNGRCV(*USER).
  • La taille limite d'un récepteur de journal attaché est dépassée. Le système tente de créer et d'attacher un nouveau récepteur, si le journal a pour attribut MNGRCV(*SYSTEM). Lorsque l'ancien récepteur est détaché, le message CPF7020 est émis. 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. Si le journal de modification échoue pour une tout autre raison, le message CPI70E3 est envoyé.
  • Lorsque le numéro de séquence d'un récepteur de journal est supérieur à 2 147 000 000, le message CPI70E7 est émis. Si le récepteur était attaché à un journal défini avec RCVSIZOPT(*MAXOPT1 ou *MAXOPT2), ce même message est envoyé lorsque le numéro de séquence est supérieur à 9 900 000 000. Si le récepteur était attaché à un journal défini avec RCVSIZOPT(*MAXOPT3), ce même message est envoyé lorsque le numéro de séquence est supérieur à 18 446 644 000 000 000 000.
  • 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.
  • Lorsque des opérations relatives à un journal éloigné se produisent, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
  • Lorsque le système ne peut pas supprimer un récepteur en raison d'un conflit de verrouillage, d'un programme d'exit indiquant que le récepteur ne peut pas être supprimé ou du fait que le récepteur n'est pas encore dupliqué en totalité dans tous les journaux éloignés, le message CPI70E6 est envoyé et l'opération est relancée toutes les 10 minutes (ou aussi souvent que le paramètre DLTRCVDLY le demande). Si la suppression échoue pour toute autre raison, le message CPI70E1 est envoyé.

Pour définir la valeur de taille limite, reportez-vous à la description de la commande CRTJRNRCV (Créer un récepteur de journal) ou de la commande CHGJRN (Modifier le journal).

Remarque :Une file d'attente de messages de la bibliothèque QTEMP ne peut pas être indiquée pour ce paramètre.

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.

QSYSOPR
Le message est envoyé dans la file d'attente QSYSOPR.
file-attente-messages-journal
Indiquez le nom de la file d'attente dans laquelle les messages du journal sont 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.
*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 file d'attente de messages du journal est recherchée 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 le nom de la bibliothèque contenant la file d'attente de messages du journal.

Gestion des récepteurs (MNGRCV)

Mode de modification des récepteurs de journal (opération qui consiste à détacher le récepteur de journal en cours et en attacher un nouveau).

*SYSTEM
Le système gère la modification des récepteurs de journal (fonction de gestion des modifications de journaux par le système). Lorsqu'un récepteur de journal attaché atteint sa taille limite, le système le détache, en crée un nouveau, puis l'attache. Le message CPF7020 est envoyé à la file d'attente de messages du journal lorsque le récepteur est détaché.

Si le récepteur était attaché au journal défini avec RCVSIZOPT(*MAXOPT1 ou *MAXOPT2), le système tente d'exécuter une commande CHGJRN pour réinitialiser le numéro de séquence du récepteur s'il est supérieur à 9 900 000 000. Si le récepteur était attaché au journal défini avec RCVSIZOPT(*MAXOPT3), le système tente d'exécuter une commande CHGJRN pour réinitialiser le numéro de séquence du récepteur s'il est supérieur à 18 446 644 000 000 000 000. Pour les autres récepteurs, le système tente d'exécuter cette même commande lorsque le numéro de séquence est supérieur à 2 147 000 000.

Par ailleurs, lors d'une IPL ou d'une mise en fonction, le système exécute la commande CHGJRN pour créer et attacher un nouveau récepteur de journal et pour réinitialiser le numéro de séquence des journaux non requis pour le rétablissement du contrôle de validation pour cet IPL ou cette mise en fonction, excepté si RCVSIZOPT prend la valeur *MAXOPT3. Le numéro de séquence ne sera pas réinitialisé et aucun nouveau récepteur de journal ne sera associé si RCVSIZOPT a pour valeur *MAXOPT3, à moins que ce numéro ne dépasse le seuil des numéros de séquence fixé à 18 446 600 000 000 000 000. Si certaines transactions de contrôle de validation en attente sont associées à l'un des journaux, un nouveau récepteur de journal sera attaché mais le numéro de séquence ne sera pas réinitialisé. Si un récepteur attaché comporte moins de trois postes de journal pour l'un des journaux au moment de l'IPL, le système ne tentera pas d'attacher un nouveau récepteur de journal.

Remarques :

  1. Le seuil de récepteur de journal doit être indiqué avant cette valeur.
  2. L'indication du paramètre MNGRCV(*SYSTEM) ne vous empêche pas d'utiliser la commande CHGJRN pour gérer des récepteurs de journal.
*USER
L'utilisateur gère la modification des récepteurs de journal en faisant appel à la commande CHGJRN (Modifier un journal) pour attacher le nouveau récepteur et détacher l'ancien.

Suppression des récepteurs (DLTRCV)

Indique si c'est le système ou l'utilisateur qui supprime les récepteurs de journal lorsqu'ils ne sont plus requis, après qu'ils aient été détachés par la fonction de gestion des modifications de journaux par le système, ou par un utilisateur à l'aide de la commande CHGJRN (Modifier un journal).

Remarque :Ce paramètre peut être indiqué uniquement si MNGRCV(*SYSTEM) est précisé.

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

Lorsque le journal dispose de l'attribut DLTRCV(*YES), les conditions suivantes peuvent empêcher le système de supprimer le récepteur. Lorsque l'une de ces conditions se produit, le système envoie le message CPI70E6 et relance l'opération de suppression toutes les 10 minutes (ou aussi souvent que le paramètre DLTRCVDLY le demande) jusqu'à ce qu'elle aboutisse.

  • Un conflit de verrouillage s'est produit pour le récepteur ou le journal associé à ce dernier.
  • Un programme d'exit enregistré par le biais du point d'exit QIBM_QJO_DLT_JRNRCV indique qu'un récepteur ne peut pas être supprimé.
  • Des journaux éloignés sont associés à un journal et ce récepteur n'est pas totalement dupliqué dans un ou plusieurs de ces journaux.

Options de taille de récepteur (RCVSIZOPT)

Options s'appliquant à la taille du récepteur attaché au journal.

Valeurs uniques

*SYSDFT
Le système utilise les valeurs recommandées en cours. Cette valeur est équivalente à *MAXOPT2 et à *RMVINTENT.
*NONE
Aucune option ne s'applique à la taille des postes de journal attachés au récepteur. Tous les postes de journal placés dans le récepteur sont permanents. Les données à longueur fixe comme indiquées par FIXLENDTA seront incluses dans chaque poste de journal consigné dans le récepteur de journal attaché. Si cette valeur est spécifiée pour le journal, la taille maximale approximative du récepteur qui y est attaché est de 2 gigaoctets (2,147,483,647) et son numéro de séquence ne doit pas excéder 2,147,483,136. En outre, la taille maximale du poste de journal pouvant être consigné est de 15 761 440 octets.

Autres valeurs (trois répétitions au maximum)

*RMVINTENT
La taille du récepteur attaché au journal est réduite par le retrait automatique des postes internes requis uniquement pour l'IPL (procédure de chargement initial) ou la mise en fonction d'ASP indépendant, une fois qu'ils ne sont plus nécessaires.
*MINFIXLEN
La taille des postes de journal consignés dans le récepteur de journal attaché est réduite par la suppression automatique des données à longueur fixe qui ne sont pas jugées nécessaires pour le rétablissement. Cette option est incorrecte lorsque FIXLENDTA est également indiqué.
*MAXOPT1
Si cette valeur est spécifiée pour le journal, la taille maximale approximative du récepteur qui y est attaché est d'un téraoctet (1 099 511 627 776 octets) et son numéro de séquence ne doit pas excéder 9 999 999 999. En outre, la taille maximale du poste de journal pouvant être consigné est de 15 761 440 octets. Cette valeur n'est pas admise si *MAXOPT2 ou *MAXOPT3 figure dans la commande.
*MAXOPT2
Si cette valeur est spécifiée pour le journal, la taille maximale approximative du récepteur qui y est attaché est d'un téraoctet (1 099 511 627 776 octets) et son numéro de séquence ne doit pas excéder 9 999 999 999. En outre, la taille maximale du poste de journal pouvant être consigné est de 4 000 000 000 octets. Cette valeur n'est pas admise si *MAXOPT1 ou *MAXOPT3 figure dans la commande.
*MAXOPT3
Si cette valeur est spécifiée pour le journal, la taille maximale approximative du récepteur qui y est attaché est d'un téraoctet (1 099 511 627 776 octets) et son numéro de séquence ne doit pas excéder 18 446 744 073 709 551 600. En outre, la taille maximale du poste de journal pouvant être consigné est de 4 000 000 000 octets. Ce type de récepteur ne peut pas être sauvegardé et restauré vers des éditions antérieures à la V5R3M0. Il ne peut pas non plus être répliqué vers des journaux éloignés sur des systèmes dont l'édition est antérieure à la V5R3M0. De plus, si MNGRCV(*SYSTEM) est indiqué lors d'un IPL ou de la mise en fonction d'un ASP indépendant, le système n'exécutera pas de commande CHGJRN pour créer et attacher une nouveau récepteur de journal, puis réinitialiser le numéro de séquence de journal sauf si ce dernier excède le seuil de 18 446 600 000 000 000 000. Cette valeur n'est pas admise si *MAXOPT1 ou *MAXOPT2 figure dans la commande.

Réduction de données de poste (MINENTDTA)

Indique quels types d'objets admettent dans les postes de journal des données spécifiques de poste réduites.

Les récepteurs de journal utilisant l'option *FLDBDY pour réduire au minimum les données spécifiques de poste ne peuvent pas être sauvegardés et restaurés vers des éditions antérieures à la V5R4M0. Ils ne peuvent pas non plus être répliqués vers des journaux éloignés sur des systèmes dont l'édition est antérieure à la V5R4M0. Reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ pour connaître les restrictions et l'utilisation des postes de journal avec des données spécifiques de postes réduites.

*NONE
Aucun type d'objet n'admet les postes de journal comportant des données spécifiques de poste réduites. Les postes de journal de tous les objets journalisés seront consignés dans le journal avec des données spécifiques de poste complètes.
*FILE
Les fichiers journalisés peuvent comporter des postes de journal consignés avec des données spécifiques de poste réduites. La réduction n'interviendra pas sur les limites de zones. Par conséquent, il se peut que les données de poste spécifiques ne soient pas consultables et utilisables à des fins d'audit. Cette valeur n'est pas admise si *FLDBDY figure dans la commande.
*FLDBDY
Les fichiers journalisés peuvent comporter des postes de journal consignés avec des données spécifiques de poste réduites. La réduction des fichiers journalisés interviendra sur les limites de zones. Par conséquent, les données de poste spécifiques seront consultables et utilisables à des fins d'audit.
*DTAARA
Les zones de données journalisées peuvent comporter des postes de journal consignés avec des données spécifiques de poste réduites.

Mise en cache du journal (JRNCACHE)

Indique si les postes de journal seront placés dans la mémoire cache avant d'être écrits sur le disque.

*NO
Les postes de journal sont écrits sur le disque immédiatement si nécessaire afin d'assurer un rétablissement de système simple.
*YES
Les postes de journal sont écrits sur la mémoire principale. Lorsque plusieurs postes de journal se trouvent dans la mémoire principale, les postes de journal sont écrits de la mémoire principale vers le disque. Si l'application exécute de nombreuses modifications, les écritures de disque synchrones peuvent être moins nombreuses entraînant une amélioration des performances. Cependant, il n'est pas recommandé d'utiliser cette option si vous jugez inacceptable de perdre ne serait-ce qu'une modification récente lors d'une défaillance du système où le contenu de la mémoire principale n'est pas protégé. Ce type de journalisation est dirigé en premier lieu vers les travaux par lots et peut ne pas convenir aux applications interactives où le rétablissement de système simple est la raison principale de l'utilisation de la journalisation.

Remarque :Les applications utilisant le contrôle de validation devraient voir moins d'améliorations au niveau des performances car le contrôle de validation exécute déjà des mises en mémoire cache de journaux.

Remarque :Les postes qui se trouvent dans le cache ne peuvent pas être affichés à l'aide des commandes DSPJRN (Afficher le journal), RCVJRNE (Recevoir des postes de journal) et RTVJRNE (Récupérer des postes de journal) ou de l'API QjoRetrieveJournalEntries. De plus, les postes résidant dans le cache sont pas envoyés à un système cible avec journal éloigné. Cependant, ces postes de journal sont inclus dans le dernier numéro de séquence du récepteur de journal via la commande DSPJRNRCVA (Afficher les attributs du récepteur de journal) ou l'API QjoRtvJrneReceiverInformation.

Remarque :Cette valeur n'est pas admise pour un nom de journal qui commence par Q et pour une bibliothèque de journal dont le nom commence aussi par Q, sauf s'il s'agit de QGPL.

Gérer temps attente récepteur (MNGRCVDLY)

Indique le temps (en minutes) qui doit être utilisé pour différer la prochaine tentative pour attacher un nouveau récepteur de journal à ce journal si celui-ci est géré par le système (MNGRCV(*SYSTEM)).

10
Lorsque le système ne peut pas allouer un objet requis pour attacher un nouveau récepteur de journal à ce journal, il attendra 10 minutes avant de réessayer.
1-1440
Lorsque le système ne peut pas allouer un objet requis pour attacher un nouveau récepteur de journal à ce journal, il attendra le nombre de minutes indiqué avant de réessayer.

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 et que DLTRCV(*YES) est indiqué, ce paramètre détermine la durée (en minutes) avant de retenter l'opération.

10
Le système attend 10 minutes avant la nouvelle tentative.
1-1440
Le système attend le nombre de minutes indiqué avant la nouvelle tentative.

Données de longueur fixe (FIXLENDTA)

Indique les données comprises dans la portion de longueur fixe des postes de journal consignés dans le récepteur de journal associé. Ce paramètre est incorrect lorsque RCVSIZOPT(*MINFIXLEN) est également indiqué.

*SAME
La valeur ne change pas.
*JOBUSRPGM
Le nom du travail, le nom de l'utilisateur et le nom du programme seront inclus dans les postes de journal consignés dans le récepteur de journal associé.
*JOB
Le nom du travail sera inclus dans les postes de journal consignés dans le récepteur de journal associé.
*USR
Le nom du profil utilisateur effectif sera inclus dans les postes de journal consignés dans le récepteur de journal associé.
*PGM
Le nom du programme sera inclus dans les postes de journal consignés dans le récepteur de journal associé.
*PGMLIB
Le nom de la bibliothèque du programme et le nom de l'unité ASP qui contient la bibliothèque du programme seront inclus dans les postes de journal consignés dans le récepteur de journal associé.
*SYSSEQ
Le numéro de séquence système sera inclus dans les postes de journal consignés dans le récepteur de journal associé. Le numéro de séquence système donne une séquence relative à tous les postes de journal dans tous les récepteurs de journal sur le système.
*RMTADR
S'ils sont appropriés, le port éloigné, l'adresse éloignée et la famille d'adresses seront inclus dans les postes de journal consignés dans les récepteurs de journal associés.
*THD
L'identificateur de l'unité d'exécution sera inclus dans les postes de journal consignés dans le récepteur de journal associé. L'identificateur de l'unité d'exécution aide à distinguer les différentes unités en cours de fonctionnement dans le même travail.
*LUW
S'il est approprié, l'identificateur d'unité d'oeuvre logique (LUWID) sera inclus dans les postes de journal consignés dans les récepteurs de journal associés. L'ID d'unité d'oeuvre logique identifie l'oeuvre relative à des cycles de validation spécifiques.
*XID
S'il est approprié, l'identificateur de transaction sera inclus dans les postes de journal consignés dans le récepteur de journal associé. L'identificateur de transaction identifie les transactions relatives à des cycles de validation spécifiques.

Limite objet journal (JRNOBJLMT)

Indique l'option affectant le nombre maximal d'objets pouvant être consignés dans le journal.

*MAX250K
Le nombre maximal d'objets pouvant être journalisés dans le journal est de 250 000.
*MAX10M
Le nombre maximal d'objets pouvant être journalisés dans le journal est de 10 000 000. Les récepteurs de journal associés à un tel journal ne peuvent être ni sauvegardés ni restaurés vers une version antérieure à la V5R4M0, ni répliqués via la journalisation éloignée vers une version antérieure à la V5R4M0.

Une fois cette valeur indiquée pour le journal, il est impossible d'indiquer une limite inférieure pour JRNOBJLMT.

Les performances d'exécution doivent être prises en compte lors du choix de cette option. Avec ce nouvel attribut, il est possible de journaliser un plus grand nombre d'objets par journal. Par conséquent, le nombre potentiel d'objets susceptibles d'être modifiés activement est plus élevé mais risque d'avoir une incidence sur les performances d'exécution du journal. Par conséquent, si la fréquence de consignations de postes dans ce journal affecte les performances d'exécution, il est préférable de répartir les objets journalisés dans plusieurs journaux.

Attention, l'augmentation du nombre d'objets associés à un même journal peut allonger la durée de l'IPL, de la mise en fonction de l'ASP indépendant ou de la reprise après incident. En règle générale, il est conseillé d'opter pour la journalisation dans plusieurs journaux si le nombre d'objets à journaliser excède 5 000. La durée de rétablissement du journal au moment de l'IPL ou de la mise en fonction d'un ASP indépendant est proportionnelle au nombre d'objets journal en cours de modification pour un journal donné au moment de l'arrêt système.

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.

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

Exemple 1 : Création d'un journal à utiliser avec un pool de mémoire de stockage auxiliaire

CRTJRN   JRN(MYLIB/JRNLA)  JRNRCV(MYLIB/RCV01)  ASP(3)

Cette commande crée le journal JRNLA dans la bibliothèque MYLIB. L'espace mémoire attribué au journal provient du pool de mémoire secondaire (ASP) 3 de l'utilisateur. Le récepteur de journal RCV01 de la bibliothèque MYLIB est attaché au journal JRNLA. Le droit d'accès public du journal est extrait du paramètre CRTAUT pour la bibliothèque MYLIB.

Exemple 2 : Création d'un journal avec un nombre maximal d'objets plus important

CRTJRN   JRN(YOURLIB/JRNLB) JRNRCV(YOURLIB/RCV01)
         RCVSIZOPT(*MAXOPT3 *RMVINTENT)
         JRNOBJLMT(*MAX10M)

Cette commande crée le journal JRNLB dans la bibliothèque YOURLIB autorisant la journalisation de 10 000 000 objets au maximum. Le récepteur de journal RCV01 de la bibliothèque YOURLIB est attaché au journal JRNLB. Le droit d'accès public du journal est extrait du paramètre CRTAUT pour la bibliothèque YOURLIB. L'utilisation du nombre maximal d'objets journalisés nécessite de spécifier l'une des valeurs d'options de valeurs maximales du paramètre d'option de taille de récepteur. Dans le cas présent, *MAXOPT3 a été choisi pour le paramètre d'option de taille de récepteur. Ceci autorise une taille maximale de journal équivalant à un téraoctet, un numéro de séquence maximal égal à 18446744073709551600 et une taille maximale de poste de journal de 4 000 000 000 octets. Les postes utilisés aux seules fins de rétablissement seront retirés une fois devenus inutiles pour le système.

Messages d'erreur

Messages *ESCAPE

CPF70A0
Paramètre FIXLENDTA non admis.
CPF70A1
Paramètre FIXLENDTA non admis avec RCVSIZOPT(*MINFIXLEN).
CPF70B5
JRNOBJLMT(&1) non admis
CPF70B8
Les valeurs définies pour MINENTDTA ne sont pas admises.
CPF70E0
Opération sur &1 non admise.
CPF70E2
DLTRCV(*YES) non admis.
CPF70E5
Valeurs de RCVSIZOPT non admises.
CPF70F1
Seuil de récepteur trop élevé pour le journal.
CPF70F5
Valeur de seuil de récepteur incorrecte.
CPF7003
Poste non journalisé dans &1. Code raison &3.
CPF701A
Récepteur de journal non disponible pour cette opération.
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.
CPF7015
Erreur dans spécifications JRNRCV.
CPF7017
Bibliothèque QTEMP incorrecte pour paramètre file d'attente de messages.
CPF704E
RCVSIZOPT(*MINFIXLEN) non admis.
CPF708A
Journal QAUDJRN de QSYS non créé ni restauré.
CPF708D
Récepteur de journal endommagé au niveau logique.
CPF708E
Récepteur de journal interdit avec *MAXOPT1, *MAXOPT2 ou *MAXOPT3.
CPF709F
Lancement de la mise en cache du journal non admis. Code raison &3.
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.
CPF9806
Impossible d'exécuter fonction pour objet &2 de &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.
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.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.