RCVJRNE

La commande RCVJRNE permet à un programme d'exit utilisateur indiqué de recevoir en continu des postes de journal. Ce programme peut être configuré, par exemple, pour écrire les postes (1) dans un fichier ICF, en apportant des mises à jour à un fichier figurant dans un système de secours, ou (2) sur une bande, en imitant une fonction journal-bande. Les informations des postes de journal reçus peuvent servir à mettre à jour les objets journalisés afin de minimiser la perte de données au cas où un incident surviendrait sur disque, et à mettre à jour des objets figurant sur un système de secours au cas où un incident surviendrait sur le système principal.

La valeur indiquée au paramètre ENTFMT détermine le format des postes de journal transmis au programme d'exit.

Restrictions :

• Si le numéro de séquence est réinitialisé dans la plage des récepteurs indiquée, la première occurrence de FROMENT ou de FROMENTLRG est utilisée, si ces paramètres sont indiqués. Si TOENTLRG ou TOENT est indiqué et que FROMENTLRG ou FROMENT l'est également, la première occurrence figurant après FROMENTLRG ou FROMENT est employée. Autrement, la première occurrence est employée.
• Vous pouvez utiliser les paramètres FILE, OBJ, OBJPATH, OBJFID, SUBTREE, PATTERN, OBJJID, JRNCDE, ENTTYP, JOB, PGM, USRPRF, CCIDLRG, CMTCYCID et DEPENT pour spécifier un sous-ensemble de tous les postes disponibles dans la plage des postes du journal.
  • Si aucune valeur n'est attribuée à ces paramètres, tous les postes de journal disponibles sont reçus.
  • Si plusieurs de ces paramètres sont indiqués, un poste doit correspondre à toutes les valeurs définies pour ces derniers, sauf si la valeur *IGNFILSLT ou *IGNOBJSLT est spécifiée pour le paramètre JRNCDE.
  • Si un code journal est indiqué au paramètre JRNCDE et que la valeur *IGNFILSLT est spécifiée comme deuxième élément pour ce code, les postes comportant ce code sont sélectionnés s'ils répondent à tous les critères de sélection précisés à l'exception de ceux du paramètre FILE.
  • Si un code journal est indiqué au paramètre JRNCDE et que la valeur *IGNOBJSLT est spécifiée comme deuxième élément pour ce code, les postes comportant ce code sont sélectionnés s'ils répondent à tous les critères de sélection précisés à l'exception de ceux des paramètres OBJ, OBJPATH, OBJFID, SUBTREE, PATTERN et OBJJID.
• Les paramètres JOB, PGM et USRPRF ne peuvent pas être utilisés pour indiquer les critères de sélection si un ou plusieurs récepteurs de journal de la plage indiquée étaient attachés au journal alors qu'une option de taille du récepteur (RCVSIZOPT) ou une option de données à longueur fixe (FIXLENDTA) aurait omis ces données.
• Si le nombre maximal d'objets (32767) est dépassé, une erreur se produit et aucun poste n'est reçu. Cette restriction ne s'applique pas lorsque *ALLFILE est spécifié ou si aucun objet n'est indiqué.
• Lorsque la mise en cache du journal est employée, les postes résidant dans le cache ne sont pas retournés.

Paramètres

Journal (JRN)

Indique le journal émetteur des postes.

Ce paramètre est obligatoire.

Qualificatif 1 : Journal

nom-journal

Indiquez le nom du journal.

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 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 sur laquelle doit porter la recherche.

Programme réception postes (EXITPGM)

Indique un programme d'exit, écrit par l'utilisateur, qui contrôle la réception de chaque poste de journal transmis à l'aide de la commande. Des informations supplémentaires sur l'interface entre cette commande et le programme d'exit sont fournies après la liste des valeurs admises pour ce paramètre et sont décrites dans le manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/. Recherchez "réception des postes de journal dans un programme d'exit".

Ce paramètre est obligatoire.

Qualificatif 1 : Programme réception postes

nom-programme

Indiquez le nom du programme d'exit qui contrôle la réception de chaque poste de journal transmis par la commande.

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 programme est recherché 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 le programme.

Informations complémentaires sur l'interface avec le programme d'exit

Lorsque le programme est appelé, deux paramètres lui sont transmis en même temps. Un seul poste de journal ou un bloc de postes est transmis dans le premier paramètre.

• Lorsqu'un seul poste est transmis au programme et que sa longueur est supérieure à celle du paramètre définie par ce dernier, le poste est tronqué. Dans le cas contraire, les positions du paramètre qui dépassent la longueur du poste ne représentent pas des données essentielles. Le programme de l'utilisateur ne doit pas spécifiquement faire référence aux données de ces positions.
• Si BLKLEN(*NONE) a été indiqué, le programme d'exit peut indiquer au système que plusieurs postes, lors des appels ultérieurs, devraient être retournés vers le programme d'exit en précisant 8 dans le premier octet du second paramètre. Il s'agit du "Mode Bloc" et le programme d'exit doit indiquer la taille du bloc en octets, comme valeur étendue, dans les 5 premiers octets du premier paramètre. En cas d'erreur dans la spécification, le bloc transmis comporte un seul poste. Si BLKLEN(*NONE) n'a pas été indiqué, le fait de préciser 8 dans le premier octet du second paramètre n'aura aucune conséquence et les 5 premiers octets du premier paramètre seront ignorés.
• Si les pointeurs sont retournés, ce premier paramètre doit être aligné sur 16 octets puisque les données spécifiques du poste de journal peuvent inclure des pointeurs réels.

Pour les formats *TYPE1, *TYPE2, *TYPE3 et *TYPE4, des zéros de fin sont ajoutés à la fin du poste de journal ou du bloc de postes transmis dans une zone étendue de longueur de poste de journal. Celle-ci indique que le dernier poste de journal a été transmis. Le format des informations de chaque poste est indiqué par la description du paramètre ENTFMT et celui du premier paramètre est décrit dans le manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :La longueur maximale pour le paramètre dans le programme d'exit est fonction du langage (par exemple, pour CL, la longueur maximale est 9999). Pour plus d'informations sur ces restrictions, reportez-vous au manuel relatif au langage de programmation concerné.

Une variable caractère de LEN(3) est transmise au deuxième paramètre de programme d'exit. Ce paramètre est transmis du système au programme d'exit et peut l'être dans le sens inverse. Les listes suivantes répertorient ses valeurs :

• Information contenue dans le premier octet du deuxième paramètre :

  Alpha(1)

  Transmission au programme d'exit

  0

  Aucun poste de journal n'est transmis lors de cet appel au programme d'exit.

  1

  Un seul poste de journal est transmis au programme d'exit.

  2

  Un bloc d'un ou plusieurs postes de journal est transmis au programme d'exit.

  3

  Aucun poste de journal n'est transmis lors de cet appel au programme d'exit et aucun autre ne pourra l'être car le récepteur connecté lors du début de l'opération de réception des postes n'est plus attaché.

  Remarque :Le système met fin à la commande RCVJRNE après avoir appelé une fois le programme d'exit, avec le code raison 3.

  4

  Aucun poste de journal n'est transmis lors de cet appel au programme d'exit, et aucun autre poste ne peut être transmis tant que le journal éloigné n'est pas activé.

  Remarque :Cette valeur ne peut être transmise au programme d'exit que lors de la réception de postes de travail provenant du récepteur attaché d'un journal éloigné et dont l'état est *INACTIVE.

  Alpha(1)

  Transmission au système à partir du programme d'exit

  8

  Demande au programme de traitement de commande de transmettre un ou plusieurs postes de journal dans un bloc. Si BLKLEN(*NONE) n'a pas été indiqué, le fait de préciser 8 dans le premier octet du second paramètre n'aura aucune conséquence et les 5 premiers octets du premier paramètre seront ignorés.

  9

  Demande l'arrêt de la commande RCVJRNE. Le programme d'exit rend le contrôle au système.

• Information contenue dans le deuxième octet du deuxième paramètre :

  Alpha(1)

  Transmission au programme d'exit

  N

  Après cet appel de programme d'exit, aucun poste de journal supplémentaire ne sera disponible pour transmission, ou la commande RCVJRNE prendra fin.

  O

  Après cet appel de programme d'exit, des postes de journal supplémentaires seront disponibles pour transmission.

  Toute information transmise du programme d'exit au système via ce deuxième caractère sera ignorée.

  Ce deuxième octet du deuxième paramètre du programme d'exit est toujours transmis, que les postes de journal soient transmis un à un ou en bloc lors de chaque appel du programme d'exit.

• Information contenue dans le troisième octet du second paramètre :

  Alpha(1)

  Transmission au programme d'exit

  '00'x

  Au moins un poste de journal est en cours de transmission au programme d'exit et les noms d'objets figurant dans la partie de longueur fixe de chaque poste de journal ne reflètent pas nécessairement le nom de l'objet au moment où le poste de journal a été placé dans le journal.

  Remarque :Cette valeur est renvoyée uniquement lors de la réception de postes de journal provenant d'un récepteur de journal attaché à un journal avant la version V4R2M0.

  0

  Aucun poste de journal n'est en cours de transmission par conséquent, les informations normalement renvoyées dans cet octet ne sont pas applicables.

  1

  Au moins un poste de journal est en cours de transmission au programme d'exit et les noms d'objets figurant dans la partie de longueur fixe de chaque poste de journal reflètent le nom de l'objet au moment où le poste de journal a été placé dans le journal.

  2

  Au moins un poste de journal est en cours de transmission au programme d'exit et les noms d'objets figurant dans la partie de longueur fixe de chaque poste de journal ne reflètent pas nécessairement le nom de l'objet au moment où le poste de journal a été placé dans le journal. Le nom d'objet figurant dans la partie de longueur fixe du poste de journal peut être renvoyé en tant que nom précédemment connu pour l'objet avant que le poste de journal soit placé dans le journal, ou sous la forme de nom *UNKNOWN.

  Remarque :Cette valeur est renvoyée uniquement lors de la réception de postes de journal provenant d'un journal éloigné en cours de mise à niveau à partir de son journal source. Cette opération a lieu lorsque la commande CHGRMTJRN ou que l'API QjochangeJournalState est appelée et effectue une duplication de postes de journal vers le journal éloigné. Lorsque la commande CHGRMTJRN ou l'API QjoChangeJournalState prend fin, la mise à niveau est terminée et le journal éloigné reçoit des postes de journal en mode de livraison synchrone ou asynchrone.

  3

  Au moins un poste de journal est en cours de transmission au programme d'exit et les noms d'objets figurant dans la partie de longueur fixe de chaque poste de journal ne reflètent pas nécessairement le nom de l'objet au moment où le poste de journal a été placé dans le journal. Le nom d'objet figurant dans la partie de longueur fixe du poste de journal peut être renvoyé en tant que *UNKNOWN.

  Les informations transmises à partir du programme d'exit au système dans le troisième octet sont ignorées. Le second octet du second paramètre de programme d'exit est fourni, que les postes de travail soient transmis un par un ou en bloc lors de chaque appel du programme d'exit.

  Remarque :Lorsque N est transmis au programme d'exit dans le second octet du second paramètre, indiquant qu'aucun poste de journal supplémentaire n'est disponible, cela ne signifie pas nécessairement que lorsque le programme d'exit se termine, la commande RCVJRNE doit attendre que d'autres postes de journal soient placés dans le journal. Lorsque le programme d'exit prend fin, il est possible que des postes de journal supplémentaires soient déjà disponibles et, en fonction de ce qui a été indiqué dans le paramètre DELAY, soient ou non transmis immédiatement au programme d'exit. Si DELAY(N) a été indiqué, le système attend N secondes avant de transmettre les postes de journal au programme d'exit. Si DELAY(*NEXTENT) a été indiqué, les postes de journal sont immédiatement transmis au programme d'exit.

  Le troisième octet du second programme d'exit est fourni, que les postes de journal soient traités un par un ou en bloc lors de chaque appel du programme d'exit. Lorsqu'il est renvoyé pour un bloc de postes de journal, l'attribut s'applique aux noms d'objets pour tous les postes de journal renvoyés dans le bloc.

Pour plus d'informations sur le programme d'exit et sur les deux paramètres utilisés pour la réception des postes de journal, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Fichier physique journalisé (FILE)

Indique les noms qualifiés de fichiers (jusqu'à 300) dont les postes de journal sont reçus. Ce paramètre indique également les noms des membre de fichier physique dont les postes de journal doivent être reçus.

Vous pouvez spécifier le paramètre FILE ou l'un ou plusieurs des paramètres sur les objets (OBJ, OBJPATH, OBJFID ou OBJJID), mais pas les deux.

Les postes de journal à recevoir sont déterminés de l'une des façons suivantes, selon le nom de fichier ou le nom de membre de fichier physique indiqué :

• Si le journal est en local et si le fichier ou le membre de fichier physique indiqué existe sur le système, l'identificateur du journal est déterminé à partir de ce fichier ou membre de fichier. Tous les postes de journal compris dans la plage de récepteurs indiquée pour cet identificateur sont reçus.
• Si le journal est un journal éloigné ou si le fichier ou le membre de fichier physique indiqué n'existe pas sur le système, une recherche est effectuée dans la plage de récepteurs spécifiée afin de retrouver tous les identificateurs de journal associés à ce fichier ou membre de fichier. Tous les postes de journal compris dans la plage de récepteurs indiquée pour ces identificateurs sont reçus. Pour que les postes du fichier soient renvoyés, indiquez le nom de bibliothèque ou *CURLIB.

  Il se peut qu'il y ait plusieurs identificateurs de journal associés à un objet précis dans l'intervalle de récepteurs indiqué. Ceci peut se produire lors de la suppression d'un objet journalisé ; un nouvel objet est alors créé avec le même nom et consigné dans le même journal.

Remarques :

1. L'identificateur de journal est l'identificateur unique associé à l'objet lorsque la journalisation est lancée pour celui-ci. Il reste constant, même si l'objet est renommé, déplacé ou restauré. Pour plus d'informations, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
2. Lors de la spécification d'un fichier de base de données pour ce paramètre, les postes de journal ayant les codes journal ci-après ne sont reçus que s'ils satisfont aux valeurs indiquées pour les autres paramètres :
   • Code journal D (postes d'information niveau-fichier base de données)
   • Code journal F (postes d'information niveau-membre de fichier).
   • Code journal R (postes d'information niveau-enregistrement)
   • Code journal U (postes générés par l'utilisateur)
   • Autres codes journal, si *IGNFILSLT est indiqué. Si la valeur spécifiée est *ALLSLT, aucun poste de journal avec ce code n'est reçu.

Valeurs uniques

*ALLFILE

La recherche des postes de journal à recevoir n'est pas limitée à un fichier donné. Tous les postes de journal sont reçus, indépendamment des objets auxquels sont associées les objets le cas échéant.

Elément 1 : Fichier physique journalisé

Qualificatif 1 : Fichier physique journalisé

*ALL

Les postes de journal de tous les fichiers physiques et logiques de la bibliothèque indiquée (le nom de la bibliothèque est obligatoire), dont les modifications journalisées se trouvent dans le récepteur de journal, sont reçus. Si *ALL est indiqué et que l'utilisateur ne dispose pas des droits nécessaires sur tous les fichiers, une erreur provoque la fin de la commande.

nom-fichier

Indiquez le nom du fichier physique ou logique base de données correspondant aux postes de journal à recevoir.

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 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 sur laquelle doit porter la recherche.

Elément 2 : Membre

*FIRST

Reçoit les postes correspondant au fichier base de données physique et au premier membre du fichier. Cette valeur n'est pas valide pour les journaux éloignés.

*ALL

Reçoit les postes de journal correspondant au fichier base de données physique et à tous les membres du fichier.

*NONE

Seuls les postes correspondant au fichier base de données sont reçus. Les postes correspondant aux membres du fichier ne le sont pas.

nom-membre

Indiquez le nom du membre correspondant aux postes de journal à recevoir.

Si *ALL est indiqué pour l'élément nom-fichier, le nom de membre est utilisé pour tous les fichiers physiques correspondants de la bibliothèque. Par exemple, si nom-bibliothèque/*ALL *FIRST est indiqué pour le paramètre FILE, les postes de journal des premiers membres de tous les fichiers physiques correspondants de la bibliothèque indiquée sont reçus.

Objets (OBJ)

Indique les noms qualifiés d'objets (jusqu'à 300) dont les postes de journal doivent être reçus. Les types d'objet possibles sont *FILE, *DTAARA, *DTAQ et *LIB. Avec *FILE, ce paramètre indique également le nom du membre de fichier physique dont les postes de journal doivent être reçus.

Vous pouvez spécifier le paramètre FILE ou l'un ou plusieurs des paramètres sur les objets (OBJ, OBJPATH, OBJFID ou OBJJID), mais pas les deux.

Les postes de journal à recevoir sont déterminés de l'une des façons suivantes, selon le nom d'objet indiqué :

• Si le journal est en local et si l'objet indiqué existe sur le système, l'identificateur du journal est déterminé à partir de cet objet. Tous les postes de journal compris dans la plage de récepteurs indiquée pour cet identificateur sont reçus.
• Si le journal est un journal éloigné ou si l'objet indiqué n'existe pas sur le système, une recherche est effectuée dans la plage de récepteurs spécifiée afin de retrouver tous les identificateurs de journal associés à cet objet. Tous les postes de journal compris dans la plage de récepteurs indiquée pour ces identificateurs sont reçus. Pour que les postes de l'objet soient renvoyés, indiquez le nom de bibliothèque ou *CURLIB.

  Il se peut qu'il y ait plusieurs identificateurs de journal associés à un objet précis dans l'intervalle de récepteurs indiqué. Ceci peut se produire lors de la suppression d'un objet journalisé ; un nouvel objet est alors créé avec le même nom et consigné dans le même journal.

Remarques :

1. L'identificateur de journal est l'identificateur unique associé à l'objet lorsque la journalisation est lancée pour celui-ci. Il reste constant, même si l'objet est renommé, déplacé ou restauré. Pour plus d'informations, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
2. Lors de la spécification d'un objet pour ce paramètre, les postes de journal ayant les codes journal ci-après ne sont reçus que s'ils satisfont aux valeurs indiquées pour les autres paramètres :
   • Code journal D (postes d'information niveau-fichier base de données)
   • Code journal E (postes d'information niveau-zone de données).
   • Code journal F (postes d'information niveau-membre de fichier).
   • Code journal Q (postes d'information niveau-file d'attente de données).
   • Code journal R (postes d'information niveau-enregistrement)
   • Code journal U (postes générés par l'utilisateur)
   • Code journal Y (postes d'information de bibliothèque).
   • Autres codes journal, si *IGNOBJSLT est indiqué comme deuxième élément pour ce code journal. Si *ALLSLT est indiqué, aucun poste avec ce code n'est reçu.

Elément 1 : Objet

Qualificatif 1 : Objet

*ALL

Les postes de journal de tous les objets de la bibliothèque indiquée (le nom de la bibliothèque est obligatoire), dont les modifications journalisées se trouvent dans le récepteur de journal, sont reçus. Le nom de bibliothèque doit être indiqué. Si *ALL est indiqué alors que l'utilisateur ne possède pas les droits requis sur tous les objets de la bibliothèque, un message est émis et la commande prend fin.

nom-objet

Indiquez le nom de l'objet dont les modifications journalisées vont être reçues.

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 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 sur laquelle doit porter la recherche.

Elément 2 : Type d'objet

Indiquez le type de l'objet dont les modifications journalisées doivent être reçues.

*FILE

Les postes correspondant aux fichiers base de données et aux membres de fichier base de données physique sont reçus.

*DTAARA

Les postes correspondant aux zones des données sont reçus.

*DTAQ

Les postes correspondant aux files d'attente sont reçus.

*LIB

Les postes correspondant aux bibliothèques sont reçus.

Elément 3 : Membre, si fichier BD

Indiquez le nom du membre du fichier physique dont les postes de journal doivent être reçus. Si *ALL est indiqué pour la première partie du paramètre, la valeur indiquée pour le nom de membre est utilisée pour tous les fichiers physiques correspondants de la bibliothèque. Par exemple, si *FIRST est indiqué, les postes de journal du premier membre de tous les fichiers physiques correspondants de la bibliothèque indiquée sont reçus.

Remarque :Si le type d'objet indiqué n'est pas *FILE, la valeur de l'élément nom de membre est ignorée.

*FIRST

Reçoit les postes correspondant au fichier base de données physique et au premier membre du fichier. Cette valeur n'est pas valide pour les journaux éloignés.

*ALL

Reçoit les postes de journal correspondant au fichier base de données physique et à tous les membres du fichier.

*NONE

Seuls les postes correspondant au fichier base de données sont reçus. Les postes correspondant aux membres du fichier ne le sont pas.

nom-membre

Indiquez le nom du membre correspondant aux postes de journal à recevoir.

Si *ALL est indiqué pour l'élément nom d'objet, le nom de membre est utilisé pour tous les fichiers physiques correspondants de la bibliothèque. Par exemple, si nom-bibliothèque/*ALL *FILE *FIRST est indiqué pour le paramètre OBJ, les postes de journal des premiers membres de tous les fichiers physiques correspondants de la bibliothèque indiquée sont reçus.

Objets (OBJPATH)

Indique jusqu'à 300 objets dont les postes de journal doivent être reçus. Seuls les objets dont le nom de chemin identifie un objet de type *STMF, *DIR ou *SYMLNK présents sur les systèmes de fichiers root (/) et QOpenSys et sur celui défini par l'utilisateur sont pris en charge. Tous les autres objets sont ignorés.

Ce paramètre n'est pas valide pour les journaux éloignés.

Vous pouvez spécifier le paramètre FILE ou l'un ou plusieurs des paramètres sur les objets (OBJ, OBJPATH, OBJFID ou OBJJID), mais pas les deux.

Seuls les objets actuellement liés au chemin d'accès indiqué et ayant un identificateur de journal associé sont utilisés dans la sélection de poste de journal. Si l'objet indiqué n'existe pas, l'identificateur de journal associé au lien est employé pour la sélection de poste de journal. Si un objet indiqué n'existe pas ou ne possède pas d'identificateur de journal, ce lien n'est pas utilisé pour la sélection de postes de journal et aucune erreur n'est envoyée.

Remarques :

1. L'identificateur de journal est l'identificateur unique associé à l'objet lorsque la journalisation est lancée pour celui-ci. Il reste constant, même si l'objet est renommé, déplacé ou restauré. Pour plus d'informations, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
2. Lors de la spécification d'un objet pour ce paramètre, les postes de journal ayant les codes journal ci-après ne sont reçus que s'ils satisfont aux valeurs indiquées pour les autres paramètres :
   • Code journal B (postes d'information niveau-système de fichiers intégrés).
   • Code journal U (postes générés par l'utilisateur)
   • Autres codes journal, si *IGNOBJSLT est indiqué comme deuxième élément pour ce code journal. Si *ALLSLT est indiqué, aucun poste avec ce code n'est reçu.

Elément 1 : Nom

nom-chemin

Les postes des objets identifiés par chemin d'accès sont reçus.

Il est possible d'indiquer un modèle dans la dernière partie du nom de chemin. Un astérisque (*) correspond à un nombre quelconque de caractères, alors qu'un point d'interrogation (?) désigne un seul caractère. Si le nom de chemin est qualifié ou contient un modèle, il doit figurer entre apostrophes. Les liens symboliques du nom de chemin ne seront pas suivis. S'il figure au début du nom de chemin, le caractère tilde indique que le chemin d'accès est relatif au répertoire personnel approprié.

Pour plus d'informations sur les modèles de noms de chemins, reportez-vous au manuel Rubriques Système de fichiers intégré de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Elément 2 : Inclure ou omettre

Le deuxième élément indique si les noms correspondant au modèle doivent être inclus ou non dans le motif. Lors de l'opération permettant de déterminer si un nom correspond à un modèle, on considère toujours que les modèles de noms relatifs se rapportent au répertoire de travail en cours.

*INCLUDE

Les objets correspondant au modèle de nom d'objet doivent être inclus pour déterminer les postes de journal à recevoir, sauf si la valeur *OMIT se substitue à cette valeur.

*OMIT

Les objets correspondant au modèle de nom d'objet ne doivent pas être inclus pour déterminer les postes de journal à recevoir. Cette valeur se substitue à la valeur *INCLUDE et doit être utilisée pour omettre un sous-ensemble d'un modèle préalablement sélectionné.

Branche du répertoire (SUBTREE)

Indique si les branches de répertoire sont incluses pour déterminer les objets pour lesquels des postes de journal doivent être reçus.

Remarque :Ce paramètre n'est admis que si au moins un nom de chemin a été indiqué dans le paramètre OBJPATH.

*NONE

Seuls les objets correspondant aux critères de sélection sont traités. Les objets contenus dans les répertoires sélectionnés ne sont pas traités implicitement.

*ALL

Tous les objets qui correspondent aux critères de sélection sont traités, ainsi que l'ensemble de la branche de chaque répertoire correspondant à ces critères. La branche inclut tous les sous-répertoires et les objets contenus dans ces derniers.

Une fois que la commande a commencé à traiter une branche d'un répertoire spécifique, les objets localisés et traités peuvent être affectés par les opérations qui mettent à jour l'organisation des objets dans l'arborescence de répertoire spécifiée. Cela inclut, sans caractère limitatif, les éléments suivants :

• Ajout, suppression ou nouvelle dénomination des liens d'objet
• Montage ou démontage des systèmes de fichiers
• Mise à jour du répertoire racine effectif pour le processus qui appelle la commande
• Mise à jour du contenu d'un lien symbolique

Pour traiter la branche du répertoire, le code du système peut augmenter le nombre maximal de descripteurs de fichier, dans la portée du processus, qui peuvent être ouverts lors du traitement. Cette opération est effectuée afin que la commande ne soit pas susceptible d'échouer en raison d'un manque de descripteurs. Cette valeur maximale de portée de processus n'est pas réinitialisée à la fin de la commande.

Masque du nom (PATTERN)

Indique au maximum 20 modèles à utiliser pour inclure ou exclure des objets pour lesquels des postes de journal sont reçus.

Seule la dernière partie du nom de chemin sera prise en compte pour déterminer si ce nom correspond au modèle. Les délimiteurs de nom de chemin ne sont pas admis dans le modèle de nom. Un astérisque (*) correspond à un nombre quelconque de caractères, alors qu'un point d'interrogation (?) désigne un seul caractère. Si le nom de chemin est qualifié ou contient un modèle, il doit figurer entre apostrophes.

Si le paramètre Modèle de nom n'est pas indiqué, le nom devra correspondre par défaut à tous les modèles.

Remarque :Ce paramètre n'est admis que si au moins un nom de chemin a été indiqué dans le paramètre OBJPATH.

Elément 1 : Masque

'*'

Tous les objets correspondant au paramètre OBJPATH en entrée doivent être inclus.

nom-modèle

Indiquez le modèle à utiliser pour inclure ou exclure des objets pour lesquels des postes de journal sont reçus. Seule la dernière partie du nom de chemin sera prise en compte pour déterminer si ce nom correspond au modèle. Les délimiteurs de nom de chemin ne sont pas admis dans le modèle de nom.

Si le paramètre Modèle de nom n'est pas indiqué, le nom devra correspondre par défaut à tous les modèles.

Pour plus d'informations sur les modèles de noms de chemins, reportez-vous au manuel Rubriques Système de fichiers intégré de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Elément 2 : Inclure ou omettre

Le deuxième élément indique si les noms correspondant au modèle doivent être inclus ou non dans l'opération. Lors de l'opération permettant de déterminer si un nom correspond à un modèle, on considère toujours que les modèles de noms relatifs se rapportent au répertoire de travail en cours.

*INCLUDE

Les objets correspondant au modèle de nom d'objet sont inclus dans l'opération, sauf si la valeur *OMIT se substitue à cette valeur.

*OMIT

Les objets correspondant au modèle de nom d'objet ne doivent pas être inclus dans l'opération. Cette valeur se substitue à la valeur *INCLUDE et doit être utilisée pour omettre un sous-ensemble d'un modèle préalablement sélectionné.

Plage de récepteurs de journal (RCVRNG)

Indique le premier (début) et le dernier récepteur (fin) de journal utilisés pour rechercher les modifications journalisées reçues. Le système traite toute la chaîne de récepteurs depuis le récepteur de début (indiqué par la première valeur) jusqu'à celui de fin (indiqué par la dernière valeur).

Si un incident (récepteurs endommagés ou introuvables) est détecté dans la chaîne de récepteurs avant le début de la recherche, le système tente d'utiliser le second récepteur. Si ce dernier est également endommagé ou introuvable, l'opération prend fin.

Valeurs uniques

*CURRENT

Le récepteur de journal utilisé est celui qui est attaché lorsque débute l'opération de réception des postes de journal.

*CURCHAIN

Les récepteurs de la chaîne comprenant le récepteur attaché lorsque débute l'opération de réception sont utilisés. Cette chaîne de récepteurs ne peut pas comporter de rupture. Dans le cas d'une rupture de chaîne, les valeurs de la plage de récepteurs sont comprises entre la dernière rupture et le récepteur attaché au début de l'opération de réception des postes de journal.

*CURAVLCHN

Les récepteurs de la chaîne comprenant le récepteur attaché lorsque débute l'opération de réception sont utilisés. Cette chaîne de récepteurs ne peut pas comporter de rupture. Dans le cas d'une rupture de chaîne, les valeurs de la plage de récepteurs sont comprises entre la dernière rupture et le récepteur attaché au début de l'opération de réception des postes de journal. Si des récepteurs de la chaîne de récepteurs ne sont pas disponibles car ils ont été sauvegardés avec l'option de libération de mémoire, ils ne sont pas pris en compte et les postes sont reçus en commençant par le premier récepteur de journal disponible de la chaîne.

*CURSEQCHN

Les récepteurs de journal de la chaîne comportant le récepteur attaché lorsque commence la conversion des postes sont utilisés, en commençant par le récepteur de journal le plus récent dans lequel le numéro de séquence de journal a été réinitialisé si cette réinitialisation a été effectuée dans la chaîne de récepteurs. Cette chaîne de récepteurs ne peut pas comporter de rupture. Dans le cas de rupture, la chaîne est alors comprise entre la rupture la plus récente et le récepteur attaché lorsque commence la conversion des postes. Si des récepteurs de la chaîne de récepteurs ne sont pas disponibles car ils ont été sauvegardés avec l'option de libération de mémoire, ils ne sont pas pris en compte et les postes sont convertis en commençant par le premier récepteur de journal disponible de la chaîne.

Elément 1 : Début au récepteur de journal

Qualificatif 1 : Début au récepteur de journal

nom-récepteur-journal-départ

Indiquez le nom du premier récepteur de journal contenant les postes de journal à recevoir.

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 récepteur de journal est recherché 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 le récepteur de journal.

Elément 2 : Fin au récepteur de journal

Valeurs uniques

*CURRENT

Le récepteur de journal utilisé est celui qui est attaché lorsque débute l'opération de réception des postes de journal.

Qualificatif 1 : Début au récepteur de journal

nom-dernier-récepteur-journal

Indiquez le nom du dernier récepteur de journal contenant les postes pouvant être reçus. Si la fin de la chaîne de récepteurs est atteinte avant que le récepteur indiqué n'ait été trouvé, un message d'erreur est émis et aucun poste n'est reçu.

Remarque :Le nombre maximal de récepteurs dans la plage est égal à 2045. Si un nombre supérieur est indiqué, une erreur est signalée et aucun poste de journal n'est reçu.

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 récepteur de journal est recherché 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 le récepteur de journal.

Premier num. séq. maxi (FROMENTLRG)

Indique le premier poste de journal à recevoir.

Remarque :Vous pouvez indiquer une valeur pour le paramètre Numéro de séquence de début (FROMENT) ou le paramètre Premier num. séq. maxi (FROMENTLRG), jamais pour les deux.

*FIRST

La recherche des postes de journal à recevoir commence à partir du premier poste de la plage de récepteurs indiquée.

numéro-séquence-début

Indiquez le numéro de séquence du premier poste de journal à recevoir. La plage de valeurs admises s'étend de 1 à 18 446 744 073 709 551 600.

Date et heure de début (FROMTIME)

Indique la date et l'heure associées au premier poste à recevoir. La réception commence à partir du premier poste de journal créé à la date de début indiquée ou à la date postérieure la plus proche.

Elément 1 : Date de début

date-début

Indiquez une date de début.

Elément 2 : Heure de début

heure-début

Indiquez une heure de début. Vous pouvez indiquer l'heure au format 24 heures avec ou sans séparateur :

• Si vous utilisez un séparateur, indiquez une chaîne de 5 ou 8 chiffres en insérant entre les heures, les minutes et les secondes le séparateur défini pour votre travail. Si vous entrez cette commande à partir de la ligne de commande, placez la chaîne entre apostrophes. Si vous utilisez un séparateur d'heure autre que celui qui a été défini pour votre travail, la commande n'aboutira pas.
• Si vous n'utilisez pas de séparateur d'heure, indiquez une chaîne au format hhmm ou hhmmss (4 ou 6 chiffres), où hh = heures, mm = minutes et ss = secondes.

Dern. num. séq. maxi (TOENTLRG)

Indique le dernier poste de journal à recevoir.

Remarque :Vous pouvez indiquer une valeur pour le paramètre Numéro de séquence de fin (TOENT) ou le paramètre Dern. num. séq. maxi (TOENTLRG), jamais pour les deux.

*NONE

Aucun poste de journal n'est indiqué. Les postes sont transmis un par un au programme d'exit jusqu'à l'annulation de la commande (par une demande d'annulation ou une commande d'annulation de travail) ou jusqu'à l'émission d'un code raison de fin (9) par le programme d'exit. En l'absence de postes à transmettre, la commande RCVJRNE attend la durée exprimée en secondes dans le paramètre DELAY avant de rechercher des postes à transmettre.

Remarque :TOENTLRG(*NONE) n'est correct que si le paramètre RCVRNG indique un récepteur attaché au début de la réception des postes de journal.

*LAST

La recherche des postes de journal à recevoir s'arrête au dernier poste de la plage de récepteurs indiquée.

numéro-séquence-fin

Indiquez le numéro de séquence du dernier poste de journal à recevoir. La plage de valeurs admises s'étend de 1 à 18 446 744 073 709 551 600.

Remarque :Les valeurs indiquées pour les invites expéditeur (from) et destinataire (to) peuvent être identiques. Il est possible d'indiquer FROMENTLRG(234) et TOENTLRG(234), par exemple.

Date et heure de fin (TOTIME)

Indique la date et l'heure associées au dernier poste de journal à recevoir. La réception s'arrête au premier poste de journal créé à l'heure indiquée ou à l'heure antérieure la plus proche.

Elément 1 : Date de fin

date-fin

Indiquez la date associée au dernier poste à recevoir.

Elément 2 : Heure de fin

heure-fin

Indiquez l'heure de création du dernier poste à recevoir. Vous pouvez indiquer l'heure au format 24 heures avec ou sans séparateur :

• Si vous n'utilisez pas de séparateur d'heure, indiquez une chaîne au format hhmm ou hhmmss (4 ou 6 chiffres), où hh = heures, mm = minutes et ss = secondes.
• Si vous utilisez un séparateur, indiquez une chaîne de 5 ou 8 chiffres en insérant entre les heures, les minutes et les secondes le séparateur défini pour votre travail. Si vous entrez cette commande à partir de la ligne de commande, placez la chaîne entre apostrophes. Si vous utilisez un séparateur d'heure autre que celui qui a été défini pour votre travail, la commande n'aboutira pas.

Nombre de postes de journal (NBRENT)

Indique le nombre total des postes de journal à recevoir.

*ALL

Tous les postes contenus dans la plage de récepteurs de journal indiquée qui répondent aux critères de sélection définis seront reçus.

valeur

Indiquez le nombre maximal de postes de journal à recevoir. Si le poste identifié par le paramètre TOENTLRG, TOENT ou TOTIME est atteint avant la valeur spécifiée pour le paramètre NBRENT, la commande se termine normalement.

Codes journal (JRNCDE)

Indique que la sélection des postes de journal à recevoir doit s'opérer en fonction du code journal indiqué.

Valeurs uniques

*ALL

Les postes de journal reçus ne se limitent pas à ceux contenant un code indiqué.

*CTL

Les postes de journal reçus sont ceux qui sont écrits pour contrôler les fonctions du journal (codes journal 'J' ou 'F').

Elément 1 : Valeur du code de journal

code-journal

Indiquez le code journal en fonction duquel les postes sont sélectionnés. Seuls sont reçus les postes comportant le code journal indiqué.

Vous trouverez des explications sur les codes journal admis dans le manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/. Recherchez "programme de recherche de poste de journal".

Elément 2 : Sélection du code de journal

*ALLSLT

Les postes de journal qui comportent le code journal indiqué sont reçus seulement si tous les autres paramètres de sélection concordent.

*IGNFILSLT

Les postes de journal qui comportent le code journal indiqué sont reçus seulement si tous les paramètres de sélection, à l'exception du paramètre FILE, concordent.

Remarque :Cette valeur n'est pas admise pour les codes journal D, F et R. Elle n'est pas valide si les paramètres OBJ, OBJPATH, OBJFID ou OBJJID sont indiqués.

*IGNOBJSLT

Les postes de journal qui concordent avec les valeurs indiquées pour tous les autres paramètres de cette commande, à l'exception de OBJ, OBJPATH, OBJFID, SUBTREE, PATTERN et OBJJID, sont reçus.

Remarque :Cette valeur n'est pas valide pour les codes de journal B, D, E, F, Q, R et Y. Elle n'est pas correcte si le paramètre FILE est indiqué.

Types de postes de journal (ENTTYP)

Indique que la sélection des postes de journal à recevoir doit s'opérer en fonction du type de poste indiqué.

Valeurs uniques

*ALL

La sélection des postes à recevoir ne s'opère pas en fonction d'un type de poste donné.

*RCD

Seuls les postes associés à un type de poste pour les opérations au niveau des enregistrements sont reçus. Les types possibles sont BR, DL, DR, IL, PT, PX, UB, UP et UR.

Autres valeurs

type-poste

Indiquez le type de poste en fonction duquel les postes de journal sont reçus. Seuls les postes de journal comportant le type de poste indiqué sont reçus. Il est possible d'indiquer jusqu'à 300 types de postes corrects. Pour plus d'informations sur les types de postes, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/. Recherchez "programme de recherche de poste de journal".

Travail (JOB)

Indique que la sélection des postes de journal à recevoir doit s'opérer en fonction d'un travail donné.

Valeurs uniques

*ALL

La sélection des postes à recevoir ne s'opère pas en fonction d'un travail donné.

*

Reçoit les postes de journal correspondant au travail en cours.

Autres valeurs

identificateur-travail

Indiquez le nom du travail, le nom de l'utilisateur et le numéro du travail à utiliser. Vous pouvez également spécifier uniquement le nom du travail ou les noms du travail et de l'utilisateur.

nom-travail

Indiquez le nom du travail.

nom-utilisateur

Indiquez le nom de l'utilisateur du travail.

numéro-travail

Indiquez le numéro de travail attribué par le système.

Programme (PGM)

Indique que la sélection des postes de journal à recevoir doit s'opérer en fonction des programmes qui leur sont associés.

*ALL

La sélection des postes de journal à recevoir ne s'opère pas en fonction du programme qui les a créés.

nom-programme

Indiquez le nom du programme sur lequel doit s'opérer la sélection des postes de journal à recevoir.

Profil utilisateur (USRPRF)

Indique que seuls sont pris en compte pour réception les postes de journal créés pour le profil utilisateur indiqué.

*ALL

La sélection des postes de journal à recevoir ne s'opère pas en fonction d'un profil utilisateur donné.

nom-profil-utilisateur

Indiquez le nom du profil utilisateur sur lequel doit s'opérer la sélection des postes de journal à recevoir.

ID cycle valid. étendu (CCIDLRG)

Indique que la sélection des postes de journal à recevoir doit s'opérer en fonction d'un cycle de validation donné. Un cycle de validation comprend tous les postes de journal partageant le même identificateur. Vous pouvez afficher cet identificateur à l'aide de la commande DSPJRN (Afficher un journal) et de l'option 5.

Remarque :Vous pouvez indiquer une valeur pour la zone ID cycle de validation (CMTCYCID) ou pour la zone ID cycle valid. étendu (CCIDLRG), jamais pour les deux.

*ALL

La sélection des postes à recevoir ne s'opère pas en fonction d'un identificateur de cycle de validation indiqué.

ID-cycle-validation

Indiquez l'identificateur de cycle de validation des postes de journal à recevoir. La plage de valeurs admises s'étend de 1 à 18 446 744 073 709 551 600.

Postes dépendants (DEPENT)

Indique si la réception doit inclure les postes de journal contenant des actions

• provoquées par des programmes déclencheurs
• et des actions qui se sont produites sur des enregistrements faisant partie d'une contrainte référentielle,
• qui seront ignorées pendant une opération APYJRNCHG (Appliquer les modifications journalisées) ou RMVJRNCHG (Enlever des modifications journalisées).

*ALL

Les postes de journal relatifs à des programmes déclencheurs ou à des contraintes référentielles et ceux qui seront ignorés lors de l'application ou du retrait des modifications journalisées sont reçus.

*NONE

Les postes de journal relatifs à des programmes déclencheurs ou à des contraintes référentielles et ceux qui seront ignorés lors de l'application ou du retrait des modifications journalisées ne sont pas reçus.

Identificateur de fichier (OBJFID)

Indique les noms qualifiés d'identificateurs de fichier (jusqu'à 300) dont les postes de journal doivent être reçus. Les FID sont des identificateurs uniques associés à des objets liés au système de fichiers intégré. Cette zone admet les entrées au format hexadécimal. Seuls les objets dont le FID identifie un objet de type *STMF, *DIR ou *SYMLNK présents sur les systèmes de fichiers root (/) et QOpenSys et sur celui défini par l'utilisateur sont pris en charge. Tous les autres objets sont ignorés.

Vous pouvez spécifier le paramètre FILE ou l'un ou plusieurs des paramètres sur les objets (OBJ, OBJPATH, OBJFID ou OBJJID), mais pas les deux.

Les postes de journal à recevoir sont déterminés de l'une des façons suivantes, selon l'identificateur de fichier indiqué :

• Si le journal est en local et si l'objet indiqué existe sur le système, l'identificateur du journal est déterminé à partir de cet objet. Tous les postes de journal compris dans la plage de récepteurs indiquée pour cet identificateur sont reçus.
• Si le journal est un journal éloigné ou si l'objet indiqué n'existe pas sur le système, une recherche est effectuée dans la plage de récepteurs spécifiée afin de retrouver tous les identificateurs de journal associés à cet objet. Tous les postes de journal compris dans la plage de récepteurs indiquée pour ces identificateurs sont reçus.

Remarques :

1. L'identificateur de journal est l'identificateur unique associé à l'objet lorsque la journalisation est lancée pour celui-ci. Il reste constant, même si l'objet est renommé, déplacé ou restauré. Pour plus d'informations, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
2. Lors de la spécification d'un objet pour ce paramètre, les postes de journal ayant les codes journal ci-après ne sont reçus que s'ils satisfont aux valeurs indiquées pour les autres paramètres :
   • Code journal B (postes d'information niveau-système de fichiers intégrés).
   • Code journal U (postes générés par l'utilisateur)
   • Autres codes journal, si *IGNOBJSLT est indiqué comme deuxième élément pour ce code journal. Si *ALLSLT est indiqué, aucun poste avec ce code n'est reçu.

identificateur-fichier

Les postes des objets identifiés par FID sont reçus.

Identificateur journal objet (OBJJID)

Indique des identificateurs de journal (jusqu'à 300) pour lesquels les postes de journal doivent être reçus. Cette zone admet les entrées au format hexadécimal. Le zéro hexadécimal n'est pas valide.

Vous pouvez spécifier le paramètre FILE ou l'un ou plusieurs des paramètres sur les objets (OBJ, OBJPATH, OBJFID ou OBJJID), mais pas les deux.

Remarques :

1. L'identificateur de journal est l'identificateur unique associé à l'objet lorsque la journalisation est lancée pour celui-ci. Il reste constant, même si l'objet est renommé, déplacé ou restauré. Pour plus d'informations, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
2. Lors de la spécification d'un identificateur de journal pour ce paramètre, les postes de journal ayant les codes journal ci-après ne sont convertis pour la sortie que s'ils satisfont aux valeurs indiquées pour les autres paramètres :
   • Code journal B (postes d'information niveau-système de fichiers intégrés).
   • Code journal D (postes d'information niveau-fichier base de données)
   • Code journal E (postes d'information niveau-zone de données).
   • Code journal F (postes d'information niveau-membre de fichier).
   • Code journal J (postes d'information du récepteur de journal).
   • Code journal Q (postes d'information niveau-file d'attente de données).
   • Code journal R (postes d'information niveau-enregistrement)
   • Code journal U (postes générés par l'utilisateur)
   • Code journal Y (postes d'information de bibliothèque).
   • Autres codes journal, si *IGNOBJSLT est indiqué comme deuxième élément pour ce code journal. Si *ALLSLT est indiqué, aucun poste avec ce code n'est converti pour la sortie.

identificateur-journal

Les postes des objets associés à l'identificateur de journal spécifié sont reçus.

Format de poste (ENTFMT)

Indique le format des postes de journal reçus. Pour une description de chaque zone d'un poste de journal, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/. Recherchez "programme de recherche de poste de journal".

Remarque :Le paramètre NULLINDLEN est obligatoire si ENTFMT(*TYPE1) ou ENTFMT(*TYPE2) est indiqué.

Remarque :Si la zone RCVSIZOPT de Options de taille de récepteur a pour valeur *MAXOPT3, les zones numéro de séquence, identificateur de cycle de validation, nombre de postes appliqués ou retirés et numéro relatif d'enregistrement peuvent avoir pour valeur maximale 18 446 744 073 709 551 600. Dans les formats ENTFMT(*TYPE1), ENTFMT(*TYPE2), ENTFMT(*TYPE3) et ENTFMT(*TYPE4), la longueur de ces zones est limitée à 10 chiffres. Si un numéro de séquence, un identificateur de cycle de validation, un nombre de postes appliqués ou retirés ou un nombre relatif d'enregistrement d'une taille supérieure à 10 positions est trouvé, la zone est fixée à -1 pour l'enregistrement.

*TYPE1

Le format des postes de journal reçus ne permet d'y indiquer que le minimum de données possible. Le tableau suivant répertorie les zones d'informations et le format de chaque poste de journal :

Figure : Tableau 1 - Format de poste de journal *TYPE1

Nom de zone : Longueur : De : A =======================+==========+==========+========== Longueur du poste : 5 : 1 : 5 -----------------------+----------+----------+---------- Numéro de séquence (2) : 10 : 6 : 15 -----------------------+----------+----------+---------- Code journal : 1 : 16 : 16 -----------------------+----------+----------+---------- Type poste de journal : 2 : 17 : 18 -----------------------+----------+----------+---------- Date : 6 : 19 : 24 -----------------------+----------+----------+---------- Heure : 6 : 25 : 30 -----------------------+----------+----------+---------- Nom de travail : 10 : 31 : 40 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 41 : 50 -----------------------+----------+----------+---------- Numéro de travail : 6 : 51 : 56 -----------------------+----------+----------+---------- Nom de programme : 10 : 57 : 66 -----------------------+----------+----------+---------- Nom d'objet : 10 : 67 : 76 -----------------------+----------+----------+---------- Bibliothèque d'objets : 10 : 77 : 86 -----------------------+----------+----------+---------- Nom de membre : 10 : 87 : 96 -----------------------+----------+----------+---------- Nombre/RRN (3) : 10 : 97 : 106 -----------------------+----------+----------+---------- Indicateur : 1 : 107 : 107 -----------------------+----------+----------+---------- ID cycle validation (4): 10 : 108 : 117 -----------------------+----------+----------+---------- Données incomplètes : 1 : 118 : 118 -----------------------+----------+----------+---------- Données spécif. : 1 : 119 : 119 poste réduites : : : -----------------------+----------+----------+---------- Réservé : 6 : 120 : 125 -----------------------+----------+----------+---------- Données spécif. poste : N (1) : 126 : N+125 ======================================================== Remarques : (1) La longueur de la zone de données spécifiques au poste varie d'un poste à un autre. Elle est suffisante pour contenir toutes les données spécifiques de chaque poste de journal reçu. (2) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le numéro de séquence est supérieur à 10 positions. (3) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le nombre de postes appliqués ou enlevés ou le numéro d'enregistrement relatif est supérieur à 10 positions. (4) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si l'identificateur de cycle de validation est supérieur à 10 positions.

*TYPE2

Les postes de journal reçus contiennent les données renvoyées lorsque ENTFMT(*TYPE1) est indiqué, le profil utilisateur, qui fournit le nom de l'utilisateur à l'origine de la consignation des postes reçus, ainsi que le nom du système sur lequel le poste a été envoyé. Le format des postes de journal *TYPE2 est décrit ci-dessous :

Figure : Tableau 2 - Format de poste de journal *TYPE2

Nom de zone : Longueur : De : A =======================+==========+==========+========== Longueur du poste : 5 : 1 : 5 -----------------------+----------+----------+---------- Numéro de séquence (2) : 10 : 6 : 15 -----------------------+----------+----------+---------- Code journal : 1 : 16 : 16 -----------------------+----------+----------+---------- Type poste de journal : 2 : 17 : 18 -----------------------+----------+----------+---------- Date : 6 : 19 : 24 -----------------------+----------+----------+---------- Heure : 6 : 25 : 30 -----------------------+----------+----------+---------- Nom de travail : 10 : 31 : 40 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 41 : 50 -----------------------+----------+----------+---------- Numéro de travail : 6 : 51 : 56 -----------------------+----------+----------+---------- Nom de programme : 10 : 57 : 66 -----------------------+----------+----------+---------- Nom d'objet : 10 : 67 : 76 -----------------------+----------+----------+---------- Bibliothèque d'objets : 10 : 77 : 86 -----------------------+----------+----------+---------- Nom de membre : 10 : 87 : 96 -----------------------+----------+----------+---------- Nombre/RRN (3) : 10 : 97 : 106 -----------------------+----------+----------+---------- Indicateur : 1 : 107 : 107 -----------------------+----------+----------+---------- ID cycle validation (4): 10 : 108 : 117 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 118 : 127 -----------------------+----------+----------+---------- Nom système : 8 : 128 : 135 -----------------------+----------+----------+---------- Données incomplètes : 1 : 136 : 136 -----------------------+----------+----------+---------- Données spécif. : 1 : 137 : 137 poste réduites : : : -----------------------+----------+----------+---------- Réservé : 18 : 138 : 155 -----------------------+----------+----------+---------- Données spécif. poste : N (1) : 156 : N+155 ======================================================== Remarques : (1) La longueur de la zone de données spécifiques au poste varie d'un poste à un autre. Elle est suffisante pour contenir toutes les données spécifiques de chaque poste de journal reçu. (2) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le numéro de séquence est supérieur à 10 positions. (3) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le nombre de postes appliqués ou enlevés ou le numéro d'enregistrement relatif est supérieur à 10 positions. (4) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si l'identificateur de cycle de validation est supérieur à 10 positions.

*TYPE3

Les postes de journal reçus contiennent les données renvoyées lorsque ENTFMT(*TYPE2) est indiqué, ainsi que les indicateurs de valeur indéfinie. Le format des postes reçus dépend de la valeur associée au paramètre NULLINDLEN. Les tableaux de description du paramètre NULLINDLEN représentent les trois formats de *TYPE3.

*TYPE4

Les postes de journal reçus contiennent les données renvoyées lorsque ENTFMT(*TYPE3) est indiqué, ainsi que l'identificateur de journal, l'indicateur de déclencheur de fichier physique et l'indicateur de contrainte référentielle. Le format des postes reçus dépend de la valeur associée au paramètre NULLINDLEN. Les tableaux de description du paramètre NULLINDLEN représentent les trois formats de *TYPE4.

*TYPEPTR

Les postes de journal reçus contiennent les informations comme si ENTFMT(*JRNENTFMT) JRNENTFMT(RJNE0100) RTNPTR(*SYSMNG) étaient indiqués, et les données spécifiques au poste peuvent contenir des pointeurs correspondant aux types de poste de journal spécifiques. Etant donné que ENTFMT(*TYPEPTR) n'admet pas RTNPTR(*USRMNG), les pointeurs ne seront plus valides lorsque le programme d'exit aura rendu le contrôle au système. Le format des postes reçus dépend de la valeur associée au paramètre NULLINDLEN. Les tableaux de description du paramètre NULLINDLEN représentent les deux formats de *TYPEPTR.

Remarque :NULLINDLEN(*VARLEN) et ENTFMT(*TYPEPTR) sont incompatibles.

*JRNENTFMT

Le format des postes de journal reçus est déterminé par le paramètre JRNENTFMT. Le paramètre RTNPTR indique si les postes de journal peuvent contenir des pointeurs. Si RTNPTR(*USRMNG) est indiqué, les pointeurs seront toujours valides lorsque le programme d'exit aura rendu le contrôle au système. Le format des postes reçus dépend de la valeur associée au paramètre NULLINDLEN. Les tableaux de description du paramètre NULLINDLEN représentent les six formats de *JRNENTFMT.

Formater données réduites (FMTMINDTA)

Indique si des données de poste spécifiques ayant été réduites sur des limites de zone seront renvoyées dans un format lisible.

*NO

Les postes de journal ayant des données réduites sur des limites de zone ne seront pas renvoyés dans un format lisible. Par conséquent, il se peut que les données de poste spécifiques ne soient pas consultables.

*YES

Les postes de journal ayant des données réduites sur des limites de zone seront renvoyés dans un format lisible. Par conséquent, les données de poste spécifiques sont consultables et utilisables à des fins d'audit. Les zones ayant été modifiées sont signalées. Les zones non modifiées et non enregistrées comportent des données par défaut et sont signalées par la valeur 'F9'X dans la zone des indicateurs de valeur indéterminée.

Long indicateurs valeur indéf (NULLINDLEN)

Indique la longueur (en octets) utilisée pour la partie correspondant aux indicateurs de valeur indéfinie du poste de journal reçu par l'utilisateur. Ce paramètre n'est admis que si ENTFMT(*TYPE1) ou ENTFMT(*TYPE2) est indiqué.

Des indicateurs de valeur indéfinie sont présents dans les postes de journal pour les opérations au niveau des enregistrements :

1. Le fichier physique correspondant comporte des zones admettant des valeurs indéfinies.
2. L'image de l'enregistrement a été réduite dans les données spécifiques de poste.

Si l'image de l'enregistrement n'a pas été réduite dans les données spécifiques de poste, un indicateur de valeur par défaut apparaît pour chaque zone du fichier physique. Chaque indicateur est constitué d'un seul caractère et peut prendre l'une des valeurs suivantes :

• 'F0'X = La zone correspondante n'accepte pas les valeurs indéfinies.
• 'F1'X = La zone correspondante accepte les valeurs indéfinies.

Si l'image de l'enregistrement a été réduite sur les limites de zone de fichier dans les données spécifiques de poste et que FMTMINDTA(*YES) a été indiqué avec la commande RCVJRNE, un indicateur de valeur par défaut apparaît pour chaque zone du fichier physique. Chaque indicateur est constitué d'un seul caractère et peut prendre l'une des valeurs suivantes :

• 'F0'X = La zone correspondante n'accepte pas les valeurs indéfinies.
• 'F1'X = La zone correspondante accepte les valeurs indéfinies.
• 'F9'X = La zone correspondante n'a pas été modifiée et la valeur par défaut de la zone est renvoyée.

Si l'image de l'enregistrement a été réduite sur les limites de zone de fichier dans les données spécifiques de poste et que FMTMINDTA(*NO) a été indiqué avec la commande RCVJRNE, une valeur interne est renvoyée pour l'indicateur de valeur indéterminée.

Valeurs uniques

*ENTFMT

La zone des indicateurs de valeur indéfinie est suffisamment longue pour inclure tous les indicateurs des postes de journal reçus. Le nombre des indicateurs de valeur indéfinie étant différent pour chaque poste, la longueur de la zone correspondante varie en fonction de ce nombre.

Remarques :

Si l'utilisateur sélectionne le format *TYPE3, les informations suivantes ne seront pas disponibles :

1. Données incomplètes. Indique si les données du poste de journal sont incomplètes à cause des zones LOB ou des opérations d'écriture sur le fichier STREAM.
2. Données spécifiques de poste réduites. Indique si le poste de journal contient des données spécifiques de poste réduites parce que le type d'objet MINENTDTA est indiqué.

Pour plus d'informations sur l'indicateur de données incomplètes et de données spécifiques de poste réduites et sur les postes de journal, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Quand NULLINDLEN(*ENTFMT) est indiqué, le format des postes de journal *TYPE3 se présente ainsi :

Figure : Tableau 3 - Format de poste de journal NULLINDLEN(*ENTFMT) pour ENTFMT(*TYPE3)

Nom de zone : Longueur : De : A =======================+==========+==========+========== Longueur du poste : 5 : 1 : 5 -----------------------+----------+----------+---------- Numéro de séquence (5) : 10 : 6 : 15 -----------------------+----------+----------+---------- Code journal : 1 : 16 : 16 -----------------------+----------+----------+---------- Type poste de journal : 2 : 17 : 18 -----------------------+----------+----------+---------- Horodatage : 26 : 19 : 44 -----------------------+----------+----------+---------- Nom de travail : 10 : 45 : 54 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 55 : 64 -----------------------+----------+----------+---------- Numéro de travail : 6 : 65 : 70 -----------------------+----------+----------+---------- Nom de programme : 10 : 71 : 80 -----------------------+----------+----------+---------- Nom d'objet : 10 : 81 : 90 -----------------------+----------+----------+---------- Bibliothèque d'objets : 10 : 91 : 100 -----------------------+----------+----------+---------- Nom de membre : 10 : 101 : 110 -----------------------+----------+----------+---------- Nombre/RRN (6) : 10 : 111 : 120 -----------------------+----------+----------+---------- Indicateur : 1 : 121 : 121 -----------------------+----------+----------+---------- ID cycle validation (7): 10 : 122 : 131 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 132 : 141 -----------------------+----------+----------+---------- Nom système : 8 : 142 : 149 -----------------------+----------+----------+---------- Nombre indicateurs : 5 : 150 : 154 valeur indéfinie (1) : : : -----------------------+----------+----------+---------- Indic. valeur indéf. : M (2) : 155 : 154 + M -----------------------+----------+----------+---------- Longueur données : 5 : 155 + M : 159 + M spécifiques poste (3) : : : -----------------------+----------+----------+---------- Données spécif. poste : N (4) : 160 + M : 159 + M : : : + N ======================================================== Remarques : (1) Cette zone indique le nombre d'indicateurs de valeur indéfinie (en positions décimales) dans le poste de journal reçu. (2) La longueur des indicateurs de valeur indéfinie peut varier d'un poste à un autre ; elle est désignée par la variable M. (3) Cette zone indique la longueur des données spécifiques du poste (en positions décimales) dans le poste reçu. (4) La longueur des données spécifiques peut varier d'un poste à un autre ; elle est désignée par la variable N. (5) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le numéro de séquence est supérieur à 10 positions. (6) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le nombre de postes appliqués ou enlevés ou le numéro d'enregistrement relatif est supérieur à 10 positions. (7) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si l'identificateur de cycle de validation est supérieur à 10 positions.

Quand NULLINDLEN(*ENTFMT) est indiqué, le format des postes de journal *TYPE4 se présente ainsi :

Figure : Tableau 4 - Format de poste de journal NULLINDLEN(*ENTFMT) pour ENTFMT(*TYPE4)

Nom de zone : Longueur : De : A =======================+==========+==========+========== Longueur du poste : 5 : 1 : 5 -----------------------+----------+----------+---------- Numéro de séquence (5) : 10 : 6 : 15 -----------------------+----------+----------+---------- Code journal : 1 : 16 : 16 -----------------------+----------+----------+---------- Type poste de journal : 2 : 17 : 18 -----------------------+----------+----------+---------- Horodatage : 26 : 19 : 44 -----------------------+----------+----------+---------- Nom de travail : 10 : 45 : 54 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 55 : 64 -----------------------+----------+----------+---------- Numéro de travail : 6 : 65 : 70 -----------------------+----------+----------+---------- Nom de programme : 10 : 71 : 80 -----------------------+----------+----------+---------- Nom d'objet : 10 : 81 : 90 -----------------------+----------+----------+---------- Bibliothèque d'objets : 10 : 91 : 100 -----------------------+----------+----------+---------- Nom de membre : 10 : 101 : 110 -----------------------+----------+----------+---------- Nombre/RRN (6) : 10 : 111 : 120 -----------------------+----------+----------+---------- Indicateur : 1 : 121 : 121 -----------------------+----------+----------+---------- ID cycle validation (7): 10 : 122 : 131 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 132 : 141 -----------------------+----------+----------+---------- Nom système : 8 : 142 : 149 -----------------------+----------+----------+---------- Id. de journal : 10 : 150 : 159 -----------------------+----------+----------+---------- Contrainte : 1 : 160 : 160 référentielle : : : -----------------------+----------+----------+---------- Déclencheur : 1 : 161 : 161 -----------------------+----------+----------+---------- Données incomplètes : 1 : 162 : 162 -----------------------+----------+----------+---------- Ignorer pdt APYJRNCHG : 1 : 163 : 163 ou RMVJRNCHG : : : -----------------------+----------+----------+---------- Données spécif. : 1 : 164 : 164 poste réduites : : : -----------------------+----------+----------+---------- Réservé : 5 : 165 : 169 -----------------------+----------+----------+---------- Nombre indicateurs : 5 : 170 : 174 valeur indéfinie (1) : : : -----------------------+----------+----------+---------- Indic. valeur indéf. : M (2) : 175 : 174 + M -----------------------+----------+----------+---------- Longueur données : 5 : 175 + M : 179 + M spécifiques poste (3) : : : -----------------------+----------+----------+---------- Données spécif. poste : N (4) : 180 + M : 179 + M : : : + N ======================================================== Remarques : (1) Cette zone indique le nombre d'indicateurs de valeur indéfinie (en positions décimales) dans le poste de journal reçu. (2) La longueur des indicateurs de valeur indéfinie peut varier d'un poste à un autre ; elle est désignée par la variable M. (3) Cette zone indique la longueur des données spécifiques du poste (en positions décimales) dans le poste reçu. (4) La longueur des données spécifiques peut varier d'un poste à un autre ; elle est désignée par la variable N. (5) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le numéro de séquence est supérieur à 10 positions. (6) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le nombre de postes appliqués ou enlevés ou le numéro d'enregistrement relatif est supérieur à 10 positions. (7) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si l'identificateur de cycle de validation est supérieur à 10 positions.

En présence de NULLINDLEN(*ENTFMT), JRNENTFMT(RJNE0100) et RTNPTR(*SYSMNG), le format des postes *TYPEPTR ou *JRNENTFMT se présente ainsi :

Figure : Tableau 5 - Format de NULLINDLEN(*ENTFMT) pour ENTFMT(*TYPEPTR) ou ENTFMT(*JRNENTFMT) quand JRNENTFMT(RJNE0100) est indiqué

Nom de zone : Longueur : De : A =======================+==========+==========+========== Déplacement vers : 4 : 0 : 3 en-tête de poste de : : : journal suivant (1) : : : -----------------------+----------+----------+---------- Déplacement vers indic.: 4 : 4 : 7 valeur indéf. du : : : poste (1) : : : -----------------------+----------+----------+---------- Déplacement vers : 4 : 8 : 11 données spécifiques : : : du poste (1) : : : -----------------------+----------+----------+---------- Descript. pointeur (2) : 4 : 12 : 15 -----------------------+----------+----------+---------- Numéro de séquence : 20 : 16 : 35 -----------------------+----------+----------+---------- Code journal : 1 : 36 : 36 -----------------------+----------+----------+---------- Type de poste : 2 : 37 : 38 -----------------------+----------+----------+---------- Horodatage : 26 : 39 : 64 -----------------------+----------+----------+---------- Nom de travail : 10 : 65 : 74 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 75 : 84 -----------------------+----------+----------+---------- Numéro de travail : 6 : 85 : 90 -----------------------+----------+----------+---------- Nom de programme : 10 : 91 : 100 -----------------------+----------+----------+---------- Objet : 30 : 101 : 130 -----------------------+----------+----------+---------- Nombre/RRN : 10 : 131 : 140 -----------------------+----------+----------+---------- Indicateur : 1 : 141 : 141 -----------------------+----------+----------+---------- ID cycle validation : 20 : 142 : 161 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 162 : 171 -----------------------+----------+----------+---------- Nom système : 8 : 172 : 179 -----------------------+----------+----------+---------- Id. de journal : 10 : 180 : 189 -----------------------+----------+----------+---------- Contr. référentielle : 1 : 190 : 190 -----------------------+----------+----------+---------- Déclencheur : 1 : 191 : 191 -----------------------+----------+----------+---------- Données incomplètes : 1 : 192 : 192 -----------------------+----------+----------+---------- Indic. nom objet : 1 : 193 : 193 -----------------------+----------+----------+---------- Ignorer pdt APYJRNCHG : 1 : 194 : 194 ou RMVJRNCHG : : : -----------------------+----------+----------+---------- Données spécif. : 1 : 195 : 195 poste réduites : : : -----------------------+----------+----------+---------- Longueur indicateurs : 4 : NVI : NVI valeur indéfinie (1) : : (3) : + 3 -----------------------+----------+----------+---------- Indic. valeur indéf. : M (4) : NVI : NVI : : + 4 : + 3 : : : + M -----------------------+----------+----------+---------- Longueur données : 5 : ESD : ESD spécif. poste : : (5) : + 4 -----------------------+----------+----------+---------- Réservé : 11 : ESD Disp : ESD Disp : : + 5 : + 15 -----------------------+----------+----------+---------- Données spécif. poste : N (6) : ESD : ESD : : + 16 : + 15 + N ======================================================== Remarques : (1) Cette zone est représentée en BINARY(4). (2) Cette zone est représentée en UNSIGNED BINARY(4). (3) NVI est fonction de la valeur de la zone "Déplacement vers indicateur de valeur indéfinie du poste". (4) La longueur des indicateurs de valeur indéfinie peut varier d'un poste à un autre ; elle est désignée par la variable M. (5) ESD est fonction de la valeur de la zone "Déplacement vers les données spécifiques du poste". (6) La longueur des données spécifiques peut varier d'un poste à un autre ; elle est désignée par la variable N.

En présence de NULLINDLEN(*ENTFMT) et de JRNENTFMT(RJNE0200), le format des postes *JRNENTFMT se présente ainsi :

Figure : Tableau 6 - Format de NULLINDLEN(*ENTFMT) pour ENTFMT(*JRNENTFMT) quand JRNENTFMT(RJNE0200) est indiqué

Nom de zone : Longueur : De : A =======================+==========+==========+========== Déplacement vers : 4 : 0 : 3 en-tête de poste de : : : journal suivant (5) : : : -----------------------+----------+----------+---------- Déplacement vers indic.: 4 : 4 : 7 valeur indéf. du : : : poste (5) : : : -----------------------+----------+----------+---------- Déplacement vers : 4 : 8 : 11 données spécifiques : : : du poste (5) : : : -----------------------+----------+----------+---------- Déplacement vers : 4 : 12 : 15 ID transaction : : : du poste (1) : : : -----------------------+----------+----------+---------- Déplacement vers : 4 : 16 : 19 unité logique travail : : : du poste (1) : : : -----------------------+----------+----------+---------- Déplacement vers infos : 4 : 20 : 23 en-tête de poste de : : : journal (1) : : : -----------------------+----------+----------+---------- Numéro de séquence (1) : 8 : 24 : 31 -----------------------+----------+----------+---------- Horodatage non formaté : 8 : 32 : 39 (1) : : : -----------------------+----------+----------+---------- ID unité exécution (1) : 8 : 40 : 47 -----------------------+----------+----------+---------- Numéro séq. système : 8 : 48 : 55 (1) : : : -----------------------+----------+----------+---------- Nombre/RRN (1) : 8 : 56 : 63 -----------------------+----------+----------+---------- ID cycle valid. (1) : 8 : 64 : 71 -----------------------+----------+----------+---------- Descript. pointeur (1) : 4 : 72 : 75 -----------------------+----------+----------+---------- Port éloigné (1) : 2 : 76 : 77 -----------------------+----------+----------+---------- Numéro ARM (1) : 2 : 78 : 79 -----------------------+----------+----------+---------- Numéro ASP biblio. : 2 : 80 : 81 programme (1) : : : -----------------------+----------+----------+---------- Adresse distante : 16 : 82 : 97 -----------------------+----------+----------+---------- Code journal : 1 : 98 : 98 -----------------------+----------+----------+---------- Type de poste : 2 : 99 : 100 -----------------------+----------+----------+---------- Nom de travail : 10 : 101 : 110 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 111 : 120 -----------------------+----------+----------+---------- Numéro de travail : 6 : 121 : 126 -----------------------+----------+----------+---------- Nom de programme : 10 : 127 : 136 -----------------------+----------+----------+---------- Nom biblio. programme : 10 : 137 : 146 -----------------------+----------+----------+---------- Nom unité ASP : 10 : 147 : 156 biblio. programme : : : -----------------------+----------+----------+---------- Objet : 30 : 157 : 186 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 187 : 196 -----------------------+----------+----------+---------- Id. de journal : 10 : 197 : 206 -----------------------+----------+----------+---------- Famille d'adresses : 1 : 207 : 207 -----------------------+----------+----------+---------- Nom système : 8 : 208 : 215 -----------------------+----------+----------+---------- Indicateur : 1 : 216 : 216 -----------------------+----------+----------+---------- Indic. nom objet : 1 : 217 : 217 -----------------------+----------+----------+---------- Contr. référentielle : 1/8 : 218 1/8 : 218 1/8 (2) : : : -----------------------+----------+----------+---------- Déclencheur (2) : 1/8 : 218 2/8 : 218 2/8 -----------------------+----------+----------+---------- Données incomplètes (2): 1/8 : 218 3/8 : 218 3/8 -----------------------+----------+----------+---------- Ignorer pdt APYJRNCHG : 1/8 : 218 4/8 : 218 4/8 ou RMVJRNCHG (2) : : : -----------------------+----------+----------+---------- Données spécif. : 1/8 : 218 5/8 : 218 5/8 poste réduites (2) : : : -----------------------+----------+----------+---------- Ind. type fichier (2) : 1/8 : 218 6/8 : 218 6/8 -----------------------+----------+----------+---------- Réduit sur : 1/8 : 218 7/8 : 218 7/8 limites de zone (2) : : : -----------------------+----------+----------+---------- Réservé (2) : 1/8 : 218 8/8 : 218 8/8 -----------------------+----------+----------+---------- Type objet : 10 : 219 : 228 -----------------------+----------+----------+---------- Réservé : 3 : 229 : 231 -----------------------+----------+----------+---------- Niv. valid. imbriqué(1): 4 : 232 : 235 -----------------------+----------+----------+---------- ID format transaction : 4 : XID : XID : : (10) : + 3 -----------------------+----------+----------+---------- Longueur ID : 4 : XID : XID transaction globale (5): : + 4 : + 7 -----------------------+----------+----------+---------- Longueur qualificatif : 4 : XID : XID branche (5) : : + 8 : + 11 -----------------------+----------+----------+---------- ID branche : 128 : XID : XID transaction : : + 12 : + 139 -----------------------+----------+----------+---------- Unité logique travail : 39 : LUW : LUW : : (3) : + 38 -----------------------+----------+----------+---------- Nom récepteur : 10 : RCV : RCV : : (4) : + 9 -----------------------+----------+----------+---------- Nom biblio. récepteur : 10 : RCV : RCV : : + 10 : + 19 -----------------------+----------+----------+---------- Nom unité ASP biblio. : 10 : RCV : RCV récepteur : : + 20 : + 29 -----------------------+----------+----------+---------- Numéro ASP biblio. : 2 : RCV : RCV récepteur (5) : : + 30 : + 31 -----------------------+----------+----------+---------- Longueur indicateurs : 4 : NVI : NVI valeur indéfinie (5) : : (6) : + 3 -----------------------+----------+----------+---------- Indic. valeur indéf. : M (7) : NVI : NVI : : + 4 : + 3 : : : + M -----------------------+----------+----------+---------- Longueur données : 5 : ESD : ESD spécif. poste : : (8) : + 4 -----------------------+----------+----------+---------- Réservé : 11 : ESD Disp : ESD Disp : : + 5 : + 15 -----------------------+----------+----------+---------- Données spécif. poste : N (9) : ESD : ESD : : + 16 : + 15 + N ======================================================== Remarques : (1) Cette zone est représentée en UNSIGNED BINARY. (2) Cette zone est représentée par un BIT. (3) LUW est fonction de la valeur de la zone "Déplacement vers l'unité logique de travail du poste". (4) RCV est fonction de la valeur de la zone "Déplacement vers les informations du récepteur du poste". (5) Cette zone est représentée en BINARY. (6) NVI Disp est fonction de la valeur de la zone "Déplacement vers indicateur de valeur indéfinie du poste". (7) La longueur des indicateurs de valeur indéfinie peut varier d'un poste à un autre ; elle est désignée par la variable M. (8) ESD Disp est fonction de la valeur de la zone "Déplacement vers les données spécifiques du poste". (9) La longueur des données spécifiques peut varier d'un poste à un autre ; elle est désignée par la variable N. (10) XID est fonction de la valeur de la zone "Déplacement vers identificateur de transaction du poste".

longueur-zone

Indiquez la longueur de zone réservée aux indicateurs de valeur indéfinie dans le poste de journal reçu. Les valeurs admises sont comprises entre 1 et 8000 caractères.

Quand NULLINDLEN(longueur-zone) est indiqué, le format des postes de journal *TYPE3 se présente ainsi :

Figure : Tableau 7 - Format de poste de journal NULLINDLEN(longueur-zone) pour ENTFMT(*TYPE3)

Nom de zone : Longueur : De : A =======================+==========+==========+========== Longueur du poste : 5 : 1 : 5 -----------------------+----------+----------+---------- Numéro de séquence (3) : 10 : 6 : 15 -----------------------+----------+----------+---------- Code journal : 1 : 16 : 16 -----------------------+----------+----------+---------- Type poste de journal : 2 : 17 : 18 -----------------------+----------+----------+---------- Horodatage : 26 : 19 : 44 -----------------------+----------+----------+---------- Nom de travail : 10 : 45 : 54 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 55 : 64 -----------------------+----------+----------+---------- Numéro de travail : 6 : 65 : 70 -----------------------+----------+----------+---------- Nom de programme : 10 : 71 : 80 -----------------------+----------+----------+---------- Nom d'objet : 10 : 81 : 90 -----------------------+----------+----------+---------- Bibliothèque d'objets : 10 : 91 : 100 -----------------------+----------+----------+---------- Nom de membre : 10 : 101 : 110 -----------------------+----------+----------+---------- Nombre/RRN (4) : 10 : 111 : 120 -----------------------+----------+----------+---------- Indicateur : 1 : 121 : 121 -----------------------+----------+----------+---------- ID cycle validation (5): 10 : 122 : 131 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 132 : 141 -----------------------+----------+----------+---------- Nom système : 8 : 142 : 149 -----------------------+----------+----------+---------- Indic. valeur indéf. : longueur : 150 : 149 + : zone : : longueur : (1) : : zone -----------------------+----------+----------+---------- Données spécif. poste : M (2) : 150 + : 149 + M + : : longueur : longueur : : zone : zone ======================================================== Remarques : (1) La longueur de la zone de valeur indéfinie est la longueur indiquée dans le paramètre NULLINDLEN. (2) La longueur de la zone de données spécifiques au poste varie d'un poste à un autre ; elle est désignée par la variable M. Cette longueur convient à toutes les données spécifiques de chaque poste de journal (3) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le numéro de séquence est supérieur à 10 positions. (4) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le nombre de postes appliqués ou enlevés ou le numéro d'enregistrement relatif est supérieur à 10 positions. (5) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si l'identificateur de cycle de validation est supérieur à 10 positions.

Quand NULLINDLEN(longueur-zone) est indiqué, le format des postes de journal *TYPE4 se présente ainsi :

Figure : Tableau 8 - Format de poste de journal NULLINDLEN(longueur-zone) pour ENTFMT(*TYPE4)

Nom de zone : Longueur : De : A =======================+==========+==========+========== Longueur du poste : 5 : 1 : 5 -----------------------+----------+----------+---------- Numéro de séquence (3) : 10 : 6 : 15 -----------------------+----------+----------+---------- Code journal : 1 : 16 : 16 -----------------------+----------+----------+---------- Type poste de journal : 2 : 17 : 18 -----------------------+----------+----------+---------- Horodatage : 26 : 19 : 44 -----------------------+----------+----------+---------- Nom de travail : 10 : 45 : 54 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 55 : 64 -----------------------+----------+----------+---------- Numéro de travail : 6 : 65 : 70 -----------------------+----------+----------+---------- Nom de programme : 10 : 71 : 80 -----------------------+----------+----------+---------- Nom d'objet : 10 : 81 : 90 -----------------------+----------+----------+---------- Bibliothèque d'objets : 10 : 91 : 100 -----------------------+----------+----------+---------- Nom de membre : 10 : 101 : 110 -----------------------+----------+----------+---------- Nombre/RRN (4) : 10 : 111 : 120 -----------------------+----------+----------+---------- Indicateur : 1 : 121 : 121 -----------------------+----------+----------+---------- ID cycle validation (5): 10 : 122 : 131 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 132 : 141 -----------------------+----------+----------+---------- Nom système : 8 : 142 : 149 -----------------------+----------+----------+---------- Id. de journal : 10 : 150 : 159 -----------------------+----------+----------+---------- Contrainte : 1 : 160 : 160 référentielle : : : -----------------------+----------+----------+---------- Déclencheur : 1 : 161 : 161 -----------------------+----------+----------+---------- Données incomplètes : 1 : 162 : 162 -----------------------+----------+----------+---------- Ignorer pdt APYJRNCHG : 1 : 163 : 163 ou RMVJRNCHG : : : -----------------------+----------+----------+---------- Données spécif. : 1 : 164 : 164 poste réduites : : : -----------------------+----------+----------+---------- Réservé : 5 : 165 : 169 -----------------------+----------+----------+---------- Indic. valeur indéf. : longueur : 170 : 169 + : zone : : longueur : (1) : : zone -----------------------+----------+----------+---------- Données spécif. poste : M (2) : 170 + : 169 + M + : : longueur : longueur : : zone : zone ======================================================== Remarques : (1) La longueur de la zone de valeur indéfinie est la longueur indiquée dans le paramètre NULLINDLEN. (2) La longueur de la zone de données spécifiques au poste varie d'un poste à un autre ; elle est désignée par la variable M. Cette longueur convient à toutes les données spécifiques de chaque poste de journal (3) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le numéro de séquence est supérieur à 10 positions. (4) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le nombre de postes appliqués ou enlevés ou le numéro d'enregistrement relatif est supérieur à 10 positions. (5) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si l'identificateur de cycle de validation est supérieur à 10 positions.

En présence de NULLINDLEN(longueur-zone) et de JRNENTFMT(RJNE0100), le format des postes *TYPEPTR ou *JRNENTFMT se présente ainsi :

Figure : Tableau 9 - Format de poste NULLINDLEN(longueur-zone) pour ENTFMT(*TYPEPTR) ou ENTFMT(*JRNENTFMT) quand JRNENTFMT(RJNE0100) est indiqué

Nom de zone : Longueur : De : A =======================+==========+==========+========== Déplacement vers : 4 : 0 : 3 en-tête de poste de : : : journal suivant (1) : : : -----------------------+----------+----------+---------- Déplacement vers indic.: 4 : 4 : 7 valeur indéf. du : : : poste (1) : : : -----------------------+----------+----------+---------- Déplacement vers : 4 : 8 : 11 données spécifiques : : : du poste (1) : : : -----------------------+----------+----------+---------- Descript. pointeur (2) : 4 : 12 : 15 -----------------------+----------+----------+---------- Numéro de séquence : 20 : 16 : 35 -----------------------+----------+----------+---------- Code journal : 1 : 36 : 36 -----------------------+----------+----------+---------- Type de poste : 2 : 37 : 38 -----------------------+----------+----------+---------- Horodatage : 26 : 39 : 64 -----------------------+----------+----------+---------- Nom de travail : 10 : 65 : 74 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 75 : 84 -----------------------+----------+----------+---------- Numéro de travail : 6 : 85 : 90 -----------------------+----------+----------+---------- Nom de programme : 10 : 91 : 100 -----------------------+----------+----------+---------- Objet : 30 : 101 : 130 -----------------------+----------+----------+---------- Nombre/RRN : 10 : 131 : 140 -----------------------+----------+----------+---------- Indicateur : 1 : 141 : 141 -----------------------+----------+----------+---------- ID cycle validation : 20 : 142 : 161 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 162 : 171 -----------------------+----------+----------+---------- Nom système : 8 : 172 : 179 -----------------------+----------+----------+---------- Id. de journal : 10 : 180 : 189 -----------------------+----------+----------+---------- Contr. référentielle : 1 : 190 : 190 -----------------------+----------+----------+---------- Déclencheur : 1 : 191 : 191 -----------------------+----------+----------+---------- Données incomplètes : 1 : 192 : 192 -----------------------+----------+----------+---------- Indic. nom objet : 1 : 193 : 193 -----------------------+----------+----------+---------- Ignorer pdt APYJRNCHG : 1 : 194 : 194 ou RMVJRNCHG : : : -----------------------+----------+----------+---------- Données spécif. : 1 : 195 : 195 poste réduites : : : -----------------------+----------+----------+---------- Indic. valeur indéf. : longueur : NVI : NVI : zone : (4) : + longueur : (3) : : zone : : : - 1 -----------------------+----------+----------+---------- Longueur données : 5 : ESD : ESD spécif. poste : : (5) : + 4 -----------------------+----------+----------+---------- Réservé : 11 : ESD Disp : ESD Disp : : + 5 : + 15 -----------------------+----------+----------+---------- Données spécif. poste : N (6) : ESD : ESD : : + 16 : + 15 + N ======================================================== Remarques : (1) Cette zone est représentée en BINARY(4). (2) Cette zone est représentée en UNSIGNED BINARY(4). (3) La longueur de la zone d'indicateurs de valeur indéfinie est la longueur indiquée dans le paramètre NULLINDLEN. (4) NVI est fonction de la valeur de la zone "Déplacement vers indicateur de valeur indéfinie du poste". (5) ESD est fonction de la valeur de la zone "Déplacement vers les données spécifiques du poste". (6) La longueur des données spécifiques peut varier d'un poste à un autre ; elle est désignée par la variable N.

En présence de NULLINDLEN(longueur-zone) et de JRNENTFMT(RJNE0200), le format des postes *JRNENTFMT se présente ainsi :

Figure : Tableau 10 - Format de poste NULLINDLEN(longueur-zone) pour ENTFMT(*JRNENTFMT) quand JRNENTFMT(RJNE0200) est indiqué

Nom de zone : Longueur : De : A =======================+==========+==========+========== Déplacement vers : 4 : 0 : 3 en-tête de poste de : : : journal suivant (5) : : : -----------------------+----------+----------+---------- Déplacement vers indic.: 4 : 4 : 7 valeur indéf. du : : : poste (5) : : : -----------------------+----------+----------+---------- Déplacement vers : 4 : 8 : 11 données spécifiques : : : du poste (5) : : : -----------------------+----------+----------+---------- Déplacement vers : 4 : 12 : 15 ID transaction : : : du poste (1) : : : -----------------------+----------+----------+---------- Déplacement vers : 4 : 16 : 19 unité logique travail : : : du poste (1) : : : -----------------------+----------+----------+---------- Déplacement vers infos : 4 : 20 : 23 en-tête de poste de : : : journal (1) : : : -----------------------+----------+----------+---------- Numéro de séquence (1) : 8 : 24 : 31 -----------------------+----------+----------+---------- Horodatage non formaté : 8 : 32 : 39 (1) : : : -----------------------+----------+----------+---------- ID unité exécution (1) : 8 : 40 : 47 -----------------------+----------+----------+---------- Numéro séq. système : 8 : 48 : 55 (1) : : : -----------------------+----------+----------+---------- Nombre/RRN (1) : 8 : 56 : 63 -----------------------+----------+----------+---------- ID cycle valid. (1) : 8 : 64 : 71 -----------------------+----------+----------+---------- Descript. pointeur (1) : 4 : 72 : 75 -----------------------+----------+----------+---------- Port éloigné (1) : 2 : 76 : 77 -----------------------+----------+----------+---------- Numéro ARM (1) : 2 : 78 : 79 -----------------------+----------+----------+---------- Numéro ASP biblio. : 2 : 80 : 81 programme (1) : : : -----------------------+----------+----------+---------- Adresse distante : 16 : 82 : 97 -----------------------+----------+----------+---------- Code journal : 1 : 98 : 98 -----------------------+----------+----------+---------- Type de poste : 2 : 99 : 100 -----------------------+----------+----------+---------- Nom de travail : 10 : 101 : 110 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 111 : 120 -----------------------+----------+----------+---------- Numéro de travail : 6 : 121 : 126 -----------------------+----------+----------+---------- Nom de programme : 10 : 127 : 136 -----------------------+----------+----------+---------- Nom biblio. programme : 10 : 137 : 146 -----------------------+----------+----------+---------- Nom unité ASP : 10 : 147 : 156 biblio. programme : : : -----------------------+----------+----------+---------- Objet : 30 : 157 : 186 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 187 : 196 -----------------------+----------+----------+---------- Id. de journal : 10 : 197 : 206 -----------------------+----------+----------+---------- Famille d'adresses : 1 : 207 : 207 -----------------------+----------+----------+---------- Nom système : 8 : 208 : 215 -----------------------+----------+----------+---------- Indicateur : 1 : 216 : 216 -----------------------+----------+----------+---------- Indic. nom objet : 1 : 217 : 217 -----------------------+----------+----------+---------- Contr. référentielle : 1/8 : 218 1/8 : 218 1/8 (2) : : : -----------------------+----------+----------+---------- Déclencheur (2) : 1/8 : 218 2/8 : 218 2/8 -----------------------+----------+----------+---------- Données incomplètes (2): 1/8 : 218 3/8 : 218 3/8 -----------------------+----------+----------+---------- Ignorer pdt APYJRNCHG : 1/8 : 218 4/8 : 218 4/8 ou RMVJRNCHG (2) : : : -----------------------+----------+----------+---------- Données spécif. : 1/8 : 218 5/8 : 218 5/8 poste réduites (2) : : : -----------------------+----------+----------+---------- Ind. type fichier (2) : 1/8 : 218 6/8 : 218 6/8 -----------------------+----------+----------+---------- Réduit sur : 1/8 : 218 7/8 : 218 7/8 limites de zone (2) : : : -----------------------+----------+----------+---------- Réservé (2) : 1/8 : 218 8/8 : 218 8/8 -----------------------+----------+----------+---------- Type objet : 10 : 219 : 228 -----------------------+----------+----------+---------- Réservé : 3 : 229 : 231 -----------------------+----------+----------+---------- Niv. valid. imbriqué(1): 4 : 232 : 235 -----------------------+----------+----------+---------- ID format transaction : 4 : XID : XID : : (10) : + 3 -----------------------+----------+----------+---------- Longueur ID : 4 : XID : XID transaction globale (5): : + 4 : + 7 -----------------------+----------+----------+---------- Longueur qualificatif : 4 : XID : XID branche (5) : : + 8 : + 11 -----------------------+----------+----------+---------- ID branche : 128 : XID : XID transaction : : + 12 : + 139 -----------------------+----------+----------+---------- Unité logique travail : 39 : LUW : LUW : : (3) : + 38 -----------------------+----------+----------+---------- Nom récepteur : 10 : RCV : RCV : : (4) : + 9 -----------------------+----------+----------+---------- Nom biblio. récepteur : 10 : RCV : RCV : : + 10 : + 19 -----------------------+----------+----------+---------- Nom unité ASP biblio. : 10 : RCV : RCV récepteur : : + 20 : + 29 -----------------------+----------+----------+---------- Numéro ASP biblio. : 2 : RCV : RCV récepteur (5) : : + 30 : + 31 -----------------------+----------+----------+---------- Indic. valeur indéf. : longueur : NVI : NVI : zone : (7) : + longueur : (6) : : zone : : : - 1 -----------------------+----------+----------+---------- Longueur données : 5 : ESD : ESD spécif. poste : : (8) : + 4 -----------------------+----------+----------+---------- Réservé : 11 : ESD Disp : ESD Disp : : + 5 : + 15 -----------------------+----------+----------+---------- Données spécif. poste : N (9) : ESD : ESD : : + 16 : + 15 + N ======================================================== Remarques : (1) Cette zone est représentée en UNSIGNED BINARY. (2) Cette zone est représentée par un BIT. (3) LUW est fonction de la valeur de la zone "Déplacement vers l'unité logique de travail du poste". (4) RCV est fonction de la valeur de la zone "Déplacement vers les informations du récepteur du poste". (5) Cette zone est représentée en BINARY. (6) La longueur de la zone de valeur indéfinie est la longueur indiquée dans le paramètre NULLINDLEN. (7) NVI Disp est fonction de la valeur de la zone "Déplacement vers indicateur de valeur indéfinie du poste". (8) ESD Disp est fonction de la valeur de la zone "Déplacement vers les données spécifiques du poste". (9) La longueur des données spécifiques peut varier d'un poste à un autre ; elle est désignée par la variable N. (10) XID est fonction de la valeur de la zone "Déplacement vers identificateur de transaction du poste".

Elément 1 : Format de données pour la zone

*VARLEN

La zone des indicateurs de valeur indéfinie est de longueur variable.

longueur-zone

Indiquez la longueur de zone réservée aux indicateurs de valeur indéfinie dans le poste de journal reçu. Les valeurs admises sont comprises entre 1 et 8000 caractères.

Elément 2 : Longueur de zone variable

longueur-zone-maximale

Indiquez la longueur de zone maximale réservée aux indicateurs de valeur indéfinie du poste de journal reçu. Les valeurs admises sont comprises entre 1 et 8000 caractères. Si un poste contient un nombre d'indicateurs supérieur à la valeur indiquée et si la troncature entraîne la perte d'une valeur d'indicateur différent de 'F0'X, la demande RCVJRNE n'aboutit pas.

Vous ne pouvez indiquer cette valeur que si *VARLEN est également indiqué comme premier élément de ce paramètre.

Remarque :NULLINDLEN(*VARLEN) et ENTFMT(*TYPEPTR) sont incompatibles.

Remarque :NULLINDLEN(*VARLEN) et RTNPTR(*SYSMNG) ou RTNPTR(*USRMNG) sont incompatibles.

En présence de NULLINDLEN(*VARLEN longueur-zone), le format des postes de journal *TYPE3 se présente ainsi :

Figure : Tableau 11 - Format de poste de journal NULLINDLEN(*VARLEN longueur-zone) pour ENTFMT(*TYPE3)

Nom de zone : Longueur : De : A =======================+==========+==========+========== Longueur du poste : 5 : 1 : 5 -----------------------+----------+----------+---------- Numéro de séquence (4) : 10 : 6 : 15 -----------------------+----------+----------+---------- Code journal : 1 : 16 : 16 -----------------------+----------+----------+---------- Type poste de journal : 2 : 17 : 18 -----------------------+----------+----------+---------- Horodatage : 26 : 19 : 44 -----------------------+----------+----------+---------- Nom de travail : 10 : 45 : 54 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 55 : 64 -----------------------+----------+----------+---------- Numéro de travail : 6 : 65 : 70 -----------------------+----------+----------+---------- Nom de programme : 10 : 71 : 80 -----------------------+----------+----------+---------- Nom d'objet : 10 : 81 : 90 -----------------------+----------+----------+---------- Bibliothèque d'objets : 10 : 91 : 100 -----------------------+----------+----------+---------- Nom de membre : 10 : 101 : 110 -----------------------+----------+----------+---------- Nombre/RRN (5) : 10 : 111 : 120 -----------------------+----------+----------+---------- Indicateur : 1 : 121 : 121 -----------------------+----------+----------+---------- ID cycle validation (6): 10 : 122 : 131 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 132 : 141 -----------------------+----------+----------+---------- Nom système : 8 : 142 : 149 -----------------------+----------+----------+---------- Nombre indicateurs : 2 : 150 : 151 valeur indéfinie (1) : : : -----------------------+----------+----------+---------- Indic. valeur indéf. : longueur : 152 : 151 + : zone : : longueur : : : zone -----------------------+----------+----------+---------- Longueur données : 5 : 152 + : 156 + spécifiques poste (2) : : longueur : longueur : : zone : zone -----------------------+----------+----------+---------- Données spécifiques : M (3) : 157 + : 156 + M + : : longueur : longueur : : zone : zone ======================================================== Remarques : (1) Cette zone indique le nombre d'indicateurs de valeur indéfinie (en positions décimales) dans le poste de journal reçu. (2) Cette zone indique la longueur des données spécifiques du poste (en positions décimales) dans le poste reçu. (3) La longueur des données spécifiques peut varier d'un poste à un autre ; elle est désignée par la variable M. (4) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le numéro de séquence est supérieur à 10 positions. (5) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le nombre de postes appliqués ou enlevés ou le numéro d'enregistrement relatif est supérieur à 10 positions. (6) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si l'identificateur de cycle de validation est supérieur à 10 positions.

Quand NULLINDLEN(*VARLEN longueur-zone) est indiqué, le format des postes de journal *TYPE4 se présente ainsi :

Figure : Tableau 12 - Format de poste de journal NULLINDLEN(*VARLEN longueur-zone) pour ENTFMT(*TYPE4)

Nom de zone : Longueur : De : A =======================+==========+==========+========== Longueur du poste : 5 : 1 : 5 -----------------------+----------+----------+---------- Numéro de séquence (4) : 10 : 6 : 15 -----------------------+----------+----------+---------- Code journal : 1 : 16 : 16 -----------------------+----------+----------+---------- Type poste de journal : 2 : 17 : 18 -----------------------+----------+----------+---------- Horodatage : 26 : 19 : 44 -----------------------+----------+----------+---------- Nom de travail : 10 : 45 : 54 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 55 : 64 -----------------------+----------+----------+---------- Numéro de travail : 6 : 65 : 70 -----------------------+----------+----------+---------- Nom de programme : 10 : 71 : 80 -----------------------+----------+----------+---------- Nom d'objet : 10 : 81 : 90 -----------------------+----------+----------+---------- Bibliothèque d'objets : 10 : 91 : 100 -----------------------+----------+----------+---------- Nom de membre : 10 : 101 : 110 -----------------------+----------+----------+---------- Nombre/RRN (5) : 10 : 111 : 120 -----------------------+----------+----------+---------- Indicateur : 1 : 121 : 121 -----------------------+----------+----------+---------- ID cycle validation (6): 10 : 122 : 131 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 132 : 141 -----------------------+----------+----------+---------- Nom système : 8 : 142 : 149 -----------------------+----------+----------+---------- Id. de journal : 10 : 150 : 159 -----------------------+----------+----------+---------- Contrainte : 1 : 160 : 160 référentielle : : : -----------------------+----------+----------+---------- Déclencheur : 1 : 161 : 161 -----------------------+----------+----------+---------- Données incomplètes : 1 : 162 : 162 -----------------------+----------+----------+---------- Ignorer pdt APYJRNCHG : 1 : 163 : 163 ou RMVJRNCHG : : : -----------------------+----------+----------+---------- Données spécif. : 1 : 164 : 164 poste réduites : : : -----------------------+----------+----------+---------- Réservé : 5 : 165 : 169 -----------------------+----------+----------+---------- Nombre indicateurs : 2 : 170 : 171 valeur indéfinie (1) : : : -----------------------+----------+----------+---------- Indic. valeur indéf. : longueur : 172 : 171 + : zone : : longueur : : : zone -----------------------+----------+----------+---------- Longueur données : 5 : 172 + : 176 + spécifiques poste (2) : : longueur : longueur : : zone : zone -----------------------+----------+----------+---------- Données spécif. poste : M (3) : 177 + : 176 + M + : : longueur : longueur : : zone : zone ======================================================== Remarques : (1) Cette zone indique le nombre d'indicateurs de valeur indéfinie (en positions décimales) dans le poste de journal reçu. (2) Cette zone indique la longueur des données spécifiques du poste (en positions décimales) dans le poste reçu. (3) La longueur des données spécifiques peut varier d'un poste à un autre ; elle est désignée par la variable M. (4) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le numéro de séquence est supérieur à 10 positions. (5) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le nombre de postes appliqués ou enlevés ou le numéro d'enregistrement relatif est supérieur à 10 positions. (6) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si l'identificateur de cycle de validation est supérieur à 10 positions.

En présence de NULLINDLEN(*VARLEN longueur-zone) et de JRNENTFMT(RJNE0100), le format des postes *JRNENTFMT se présente ainsi :

Figure : Tableau 13 - Format de NULLINDLEN(*VARLEN longueur-zone) pour ENTFMT(*JRNENTFMT) quand JRNENTFMT(RJNE0100) est indiqué

Nom de zone : Longueur : De : A =======================+==========+==========+========== Déplacement vers : 4 : 0 : 3 en-tête de poste de : : : journal suivant (1) : : : -----------------------+----------+----------+---------- Déplacement vers indic.: 4 : 4 : 7 valeur indéf. du : : : poste (1) : : : -----------------------+----------+----------+---------- Déplacement vers : 4 : 8 : 11 données spécifiques : : : du poste (1) : : : -----------------------+----------+----------+---------- Descript. pointeur (2) : 4 : 12 : 15 -----------------------+----------+----------+---------- Numéro de séquence : 20 : 16 : 35 -----------------------+----------+----------+---------- Code journal : 1 : 36 : 36 -----------------------+----------+----------+---------- Type de poste : 2 : 37 : 38 -----------------------+----------+----------+---------- Horodatage : 26 : 39 : 64 -----------------------+----------+----------+---------- Nom de travail : 10 : 65 : 74 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 75 : 84 -----------------------+----------+----------+---------- Numéro de travail : 6 : 85 : 90 -----------------------+----------+----------+---------- Nom de programme : 10 : 91 : 100 -----------------------+----------+----------+---------- Objet : 30 : 101 : 130 -----------------------+----------+----------+---------- Nombre/RRN : 10 : 131 : 140 -----------------------+----------+----------+---------- Indicateur : 1 : 141 : 141 -----------------------+----------+----------+---------- ID cycle validation : 20 : 142 : 161 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 162 : 171 -----------------------+----------+----------+---------- Nom système : 8 : 172 : 179 -----------------------+----------+----------+---------- Id. de journal : 10 : 180 : 189 -----------------------+----------+----------+---------- Contr. référentielle : 1 : 190 : 190 -----------------------+----------+----------+---------- Déclencheur : 1 : 191 : 191 -----------------------+----------+----------+---------- Données incomplètes : 1 : 192 : 192 -----------------------+----------+----------+---------- Indic. nom objet : 1 : 193 : 193 -----------------------+----------+----------+---------- Ignorer pdt APYJRNCHG : 1 : 194 : 194 ou RMVJRNCHG : : : -----------------------+----------+----------+---------- Données spécif. : 1 : 195 : 195 poste réduites : : : -----------------------+----------+----------+---------- Longueur indicateurs : 4 : NVI : NVI valeur indéfinie (1) : : (3) : + 3 -----------------------+----------+----------+---------- Indic. valeur indéf. : longueur : NVI : NVI : zone : + 4 : + 3 : : : + longueur : : : zone -----------------------+----------+----------+---------- Longueur données : 5 : ESD : ESD spécif. poste : : (4) : + 4 -----------------------+----------+----------+---------- Réservé : 11 : ESD Disp : ESD Disp : : + 5 : + 15 -----------------------+----------+----------+---------- Données spécif. poste : M (5) : ESD : ESD : : + 16 : + 15 + M ======================================================== Remarques : (1) Cette zone est représentée en BINARY(4). (2) Cette zone est représentée en UNSIGNED BINARY(4). (3) NVI est fonction de la valeur de la zone "Déplacement vers indicateur de valeur indéfinie du poste". (4) ESD est fonction de la valeur de la zone "Déplacement vers les données spécifiques du poste". (5) La longueur des données spécifiques peut varier d'un poste à un autre ; elle est désignée par la variable M.

En présence de NULLINDLEN(*VARLEN longueur-zone) et de JRNENTFMT(RJNE0200), le format des postes *JRNENTFMT se présente ainsi :

Figure : Tableau 14 - Format de NULLINDLEN(*VARLEN longueur-zone) pour ENTFMT(*JRNENTFMT) quand JRNENTFMT(RJNE0200) est indiqué

Nom de zone : Longueur : De : A =======================+==========+==========+========== Déplacement vers : 4 : 0 : 3 en-tête de poste de : : : journal suivant (5) : : : -----------------------+----------+----------+---------- Déplacement vers indic.: 4 : 4 : 7 valeur indéf. du : : : poste (5) : : : -----------------------+----------+----------+---------- Déplacement vers : 4 : 8 : 11 données spécifiques : : : du poste (5) : : : -----------------------+----------+----------+---------- Déplacement vers : 4 : 12 : 15 ID transaction : : : du poste (1) : : : -----------------------+----------+----------+---------- Déplacement vers : 4 : 16 : 19 unité logique travail : : : du poste (1) : : : -----------------------+----------+----------+---------- Déplacement vers infos : 4 : 20 : 23 en-tête de poste de : : : journal (1) : : : -----------------------+----------+----------+---------- Numéro de séquence (1) : 8 : 24 : 31 -----------------------+----------+----------+---------- Horodatage non formaté : 8 : 32 : 39 (1) : : : -----------------------+----------+----------+---------- ID unité exécution (1) : 8 : 40 : 47 -----------------------+----------+----------+---------- Numéro séq. système : 8 : 48 : 55 (1) : : : -----------------------+----------+----------+---------- Nombre/RRN (1) : 8 : 56 : 63 -----------------------+----------+----------+---------- ID cycle valid. (1) : 8 : 64 : 71 -----------------------+----------+----------+---------- Descript. pointeur (1) : 4 : 72 : 75 -----------------------+----------+----------+---------- Port éloigné (1) : 2 : 76 : 77 -----------------------+----------+----------+---------- Numéro ARM (1) : 2 : 78 : 79 -----------------------+----------+----------+---------- Numéro ASP biblio. : 2 : 80 : 81 programme (1) : : : -----------------------+----------+----------+---------- Adresse distante : 16 : 82 : 97 -----------------------+----------+----------+---------- Code journal : 1 : 98 : 98 -----------------------+----------+----------+---------- Type de poste : 2 : 99 : 100 -----------------------+----------+----------+---------- Nom de travail : 10 : 101 : 110 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 111 : 120 -----------------------+----------+----------+---------- Numéro de travail : 6 : 121 : 126 -----------------------+----------+----------+---------- Nom de programme : 10 : 127 : 136 -----------------------+----------+----------+---------- Nom biblio. programme : 10 : 137 : 146 -----------------------+----------+----------+---------- Nom unité ASP : 10 : 147 : 156 biblio. programme : : : -----------------------+----------+----------+---------- Objet : 30 : 157 : 186 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 187 : 196 -----------------------+----------+----------+---------- Id. de journal : 10 : 197 : 206 -----------------------+----------+----------+---------- Famille d'adresses : 1 : 207 : 207 -----------------------+----------+----------+---------- Nom système : 8 : 208 : 215 -----------------------+----------+----------+---------- Indicateur : 1 : 216 : 216 -----------------------+----------+----------+---------- Indic. nom objet : 1 : 217 : 217 -----------------------+----------+----------+---------- Contr. référentielle : 1/8 : 218 1/8 : 218 1/8 (2) : : : -----------------------+----------+----------+---------- Déclencheur (2) : 1/8 : 218 2/8 : 218 2/8 -----------------------+----------+----------+---------- Données incomplètes (2): 1/8 : 218 3/8 : 218 3/8 -----------------------+----------+----------+---------- Ignorer pdt APYJRNCHG : 1/8 : 218 4/8 : 218 4/8 ou RMVJRNCHG (2) : : : -----------------------+----------+----------+---------- Données spécif. : 1/8 : 218 5/8 : 218 5/8 poste réduites (2) : : : -----------------------+----------+----------+---------- Ind. type fichier (2) : 1/8 : 218 6/8 : 218 6/8 -----------------------+----------+----------+---------- Réduit sur : 1/8 : 218 7/8 : 218 7/8 limites de zone (2) : : : -----------------------+----------+----------+---------- Réservé (2) : 1/8 : 218 8/8 : 218 8/8 -----------------------+----------+----------+---------- Type objet : 10 : 219 : 228 -----------------------+----------+----------+---------- Réservé : 3 : 229 : 231 -----------------------+----------+----------+---------- Niv. valid. imbriqué(1): 4 : 232 : 235 -----------------------+----------+----------+---------- ID format transaction : 4 : XID : XID : : (9) : + 3 -----------------------+----------+----------+---------- Longueur ID : 4 : XID : XID transaction globale (5): : + 4 : + 7 -----------------------+----------+----------+---------- Longueur qualificatif : 4 : XID : XID branche (5) : : + 8 : + 11 -----------------------+----------+----------+---------- ID branche : 128 : XID : XID transaction : : + 12 : + 139 -----------------------+----------+----------+---------- Unité logique travail : 39 : LUW : LUW : : (3) : + 38 -----------------------+----------+----------+---------- Nom récepteur : 10 : RCV : RCV : : (4) : + 9 -----------------------+----------+----------+---------- Nom biblio. récepteur : 10 : RCV : RCV : : + 10 : + 19 -----------------------+----------+----------+---------- Nom unité ASP biblio. : 10 : RCV : RCV récepteur : : + 20 : + 29 -----------------------+----------+----------+---------- Numéro ASP biblio. : 2 : RCV : RCV récepteur (5) : : + 30 : + 31 -----------------------+----------+----------+---------- Longueur indicateurs : 4 : NVI : NVI valeur indéfinie (5) : : (6) : + 3 -----------------------+----------+----------+---------- Indic. valeur indéf. : longueur : NVI : NVI : zone : + 4 : + 3 : : : + longueur : : : zone -----------------------+----------+----------+---------- Longueur données : 5 : ESD : ESD spécif. poste : : (7) : + 4 -----------------------+----------+----------+---------- Réservé : 11 : ESD Disp : ESD Disp : : + 5 : + 15 -----------------------+----------+----------+---------- Données spécif. poste : M (8) : ESD : ESD : : + 16 : + 15 + M ======================================================== Remarques : (1) Cette zone est représentée en UNSIGNED BINARY. (2) Cette zone est représentée par un BIT. (3) LUW est fonction de la valeur de la zone "Déplacement vers l'unité logique de travail du poste". (4) RCV est fonction de la valeur de la zone "Déplacement vers les informations du récepteur du poste". (5) Cette zone est représentée en BINARY. (6) NVI Disp est fonction de la valeur de la zone "Déplacement vers indicateur de valeur indéfinie du poste". (7) ESD est fonction de la valeur de la zone "Déplacement vers les données spécifiques du poste". (8) La longueur des données spécifiques peut varier d'un poste à un autre ; elle est désignée par la variable M. (9) XID est fonction de la valeur de la zone "Déplacement vers identificateur de transaction du poste".

Délai (DELAY)

Indique le nombre de secondes pendant lesquelles le programme de traitement de commande doit attendre l'arrivée d'un nouveau poste de journal après réception du dernier. Une fois ce dernier poste reçu et transmis au programme d'exit, le programme de traitement de commande tente de recevoir le suivant. S'il n'y a pas de poste, la valeur 0 est transmise au programme dans le premier octet du deuxième paramètre.

Remarque :Ce paramètre est admis uniquement si TOENTLRG(*NONE) ou TOENT(*NONE) est indiqué et si le dernier récepteur spécifié par le paramètre RCVRNG désigne le récepteur de journal attaché lorsque la réception des postes commence.

Lorsque le dernier poste de journal a été transmis au programme d'exit et qu'aucun poste de journal n'est disponible, on distingue les cas suivants :

• Lorsqu'un délai en secondes est indiqué comme premier élément de la liste, le programme d'exit est immédiatement appelé et '0' est transmis comme premier octet du deuxième paramètre d'exit, indiquant qu'aucun poste de journal n'est disponible. Lorsque le programme d'exit rend le contrôle à la commande, le système respecte le délai d'attente indiqué.

  A expiration du délai d'attente, le système recherche tout poste de journal disponible pour le transmettre au programme d'exit. Les postes ainsi trouvés sont transmis par ordre séquentiel jusqu'à épuisement. Le programme d'exit est alors appelé et '0' est transmis comme premier octet du deuxième paramètre du programme, indiquant qu'aucun poste de journal n'est disponible. Lorsque le programme d'exit rend le contrôle à la commande, le système attend à nouveau pendant le nombre de secondes indiqué.

  S'il n'y a plus de poste de journal à transmettre au programme d'exit après le délai d'attente, le programme est appelé et '0' est transmis comme premier octet du deuxième paramètre pour indiquer qu'aucun poste n'est disponible. Le programme d'exit transmet alors la valeur '9' comme premier octet du deuxième paramètre, indiquant la fin de la commande.

• Si *NEXTENT est indiqué comme premier élément de la liste, des postes de journal supplémentaires sont transmis au programme d'exit au fur et à mesure qu'ils sont disponibles. Lorsque cette option est utilisée, le deuxième élément de la liste indique le nombre maximal de secondes entre les appels du programme d'exit. S'il n'y a plus de poste après le temps d'attente indiqué, le programme d'exit est appelé et '0' est transmis comme premier octet du deuxième paramètre, indiquant qu'aucun poste n'est disponible.

  Le temps d'attente maximum peut désigner :

  • Le temps entre un appel du programme d'exit après le dernier poste disponible et un appel ultérieur au programme d'exit indiquant qu'aucun poste de journal nouveau n'est disponible.
  • Le temps entre les appels au programme d'exit indiquant qu'il n'y a plus d'autre poste de journal disponible.

  Si le programme d'exit est appelé après l'expiration du délai maximal, il peut transmettre la valeur '9' comme premier octet du deuxième paramètre pour indiquer que la commande doit prendre fin.

Remarque :La description antérieure du paramètre DELAY considère que le récepteur de journal attaché au début de l'exécution de la commande RCVJRNE est toujours attaché. Si le récepteur de journal a été détaché, le programme d'exit reçoit le code raison 3 lorsqu'il a réceptionné tous les postes de journal et la commande RCVJRNE prend fin.

Elément 1 : Valeur du temps d'attente

30

La commande attend 30 secondes avant de rechercher si d'autres postes de journal sont disponibles pour passer dans le programme d'exit.

*NEXTENT

Un délai d'attente fixe n'est pas utilisé. De nouveaux postes de journal sont transmis au programme d'exit au fur et à mesure qu'ils sont disponibles.

Remarque :Dans le cas où le programme d'exit de RCVJRNE entraîne d'autres appels de la commande RCVJRNE, ces autres appels ne peuvent pas indiquer DELAY(*NEXTENT) si un appel précédent comportait TOENTLRG(*NONE) ou TOENT(*NONE).

Remarque :INCENT(*ALL) et DELAY(*NEXTENT) sont incompatibles.

secondes

Indiquez, en secondes, la durée pendant laquelle la commande attend avant de rechercher si d'autres postes de journal sont disponibles pour passer dans le programme d'exit. Les valeurs admises sont comprises entre 1 et 99999.

Elément 2 : Valeur temps d'attente maximal

Cet élément indique le nombre maximum de secondes entre les appels du programme d'exit lorsqu'un délai d'attente fixe n'est pas indiqué comme premier élément. Il n'est admis que lorsque *NEXTENT est indiqué comme premier élément.

*CLS

Le délai d'attente par défaut du traitement est utilisé comme nombre maximum de secondes entres les appels du programme d'exit.

secondes

Indiquez le temps d'attente maximal en secondes entre les appels au programme d'exit. Les valeurs admises sont comprises entre 1 et 99999.

Longueur de bloc (BLKLEN)

Indique si le système enverra ou non un ou plusieurs postes de journal au programme d'exit et indique la longueur de bloc de la mémoire tampon transmise au programme d'exit. Le paramètre EXITPGM est doté de plus amples détails relatifs à la sémantique du mode bloc.

*NONE

Au maximum un poste de journal sera envoyé au programme d'exit.

*CALC

Un ou plusieurs postes de journal seront transmis au programme d'exit dans un bloc. La longueur du bloc transmis (le premier paramètre transmis au programme d'exit) est définie par le système et sera optimale.

longueur-bloc

Indique la longueur en kilo-octets de la mémoire tampon transmise au programme d'exit (paramètre EXITPGM). Les valeurs correctes sont comprises entre 32 et 4000.

Format de poste de journal (JRNENTMFT)

Indique le format des postes de journal reçus par la programme d'exit. Les formats sont décrits dans l'API QjoRetrieveJournalEntries (Extraction de postes de journal). Pour de plus amples informations sur ces formats, 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/).

Ce paramètre est uniquement correct lorsque ENTFMT(*JRNENTFMT) est également indiqué.

RJNE0100

Les postes de journal reçus sont au format RJNE0100.

RJNE0200

Les postes de journal reçus sont au format RJNE0200. En mode bloc, un bloc de postes simple ne proviendra pas de plusieurs récepteurs.

Pointeurs de retour (RTNPTR)

Indique si les postes de journal reçus incluent ou non des données propres aux postes pouvant contenir des pointeurs correspondant aux types de postes de journal spécifiques.

Ce paramètre est uniquement correct lorsque ENTFMT(*JRNENTFMT) est également indiqué.

*NONE

Les postes de journal reçus n'incluent pas les pointeurs.

*SYSMNG

Indique que les postes de journal reçus incluent des données propres aux postes pouvant contenir des pointeurs correspondant aux types de postes de journal spécifiques. Le système va gérer l'édition des ressources relatives aux pointeurs qui sont reçues dans les postes de journal. Les pointeurs, leurs descripteurs associés et toutes les mémoires correspondantes vont être édités lorsque le programme d'exit renverra le contrôle au système.

Remarque :NULLINDLEN(*VARLEN) et RTNPTR(*SYSMNG) ou RTNPTR(*USRMNG) sont incompatibles.

*USRMNG

Indique que les postes de journal reçus incluent des données propres aux postes pouvant contenir des pointeurs correspondant aux types de postes de journal spécifiques. L'utilisateur va gérer l'édition des ressources relatives aux pointeurs qui sont reçues dans les postes de journal. Ni les pointeurs, ni leurs descripteurs associés ni les mémoires correspondantes ne seront édités lorsque le programme d'exit renverra le contrôle au système. L'utilisateur doit utiliser l'API QjoDeletePointerHandle (Suppression du descripteur de pointeur) pour éditer ces ressources. Pour de plus amples informations sur cet 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/).

Remarque :NULLINDLEN(*VARLEN) et RTNPTR(*SYSMNG) ou RTNPTR(*USRMNG) sont incompatibles.

Inclure postes (INCENT)

Indique si le postes de journal confirmés uniquement, ou les postes de journal confirmés et les postes non confirmés, sont reçus. Ce paramètre s'applique uniquement lors de la réception de postes de journal pour la sortie à partir d'un journal éloigné.

Les postes de journal confirmés sont ceux qui ont été envoyés à ce journal éloigné et pour lesquels l'état des entrées-sorties relatives à la mémoire secondaire pour les mêmes postes de journal dans le journal local est connu.

Les postes de journal non confirmés sont ceux qui ont été envoyés à ce journal éloigné, mais pour lesquels l'état des entrées-sorties relatives à la mémoire secondaire pour les mêmes postes de journal dans le journal local n'est pas connu, ou pour lesquels le journal éloigné ne connaît pas encore le nom d'objet. Les postes de journal non confirmés peuvent exister uniquement au sein du récepteur attaché d'un journal éloigné. Cela s'applique uniquement si le mode de livraison synchrone est utilisé pour un journal éloigné particulier.

*CONFIRMED

Seuls les postes de journal confirmés sont reçus.

*ALL

Tous les postes de journal (confirmés ou non confirmés) sont reçus.

Remarque :INCENT(*ALL) et DELAY(*NEXTENT) sont incompatibles.

Numéro de séquence de début (FROMENT)

Indique le premier poste de journal à recevoir.

Remarque :Vous pouvez indiquer une valeur pour le paramètre Numéro de séquence de début (FROMENT) ou le paramètre Premier num. séq. maxi (FROMENTLRG), jamais pour les deux.

*FIRST

La recherche des postes de journal à recevoir commence à partir du premier poste de la plage de récepteurs indiquée.

numéro-séquence-début

Indiquez le numéro de séquence du premier poste de journal à recevoir. La plage de valeurs admises s'étend de 1 à 9 999 999 999.

Numéro de séquence de fin (TOENT)

Indique le dernier poste de journal à recevoir.

Remarque :Vous pouvez indiquer une valeur pour le paramètre Numéro de séquence de fin (TOENT) ou le paramètre Dern. num. séq. maxi (TOENTLRG), jamais pour les deux.

*NONE

Aucun poste de journal n'est indiqué. Les postes sont transmis un par un au programme d'exit jusqu'à l'annulation de la commande (par une demande d'annulation ou une commande d'annulation de travail) ou jusqu'à l'émission d'un code raison de fin (9) par le programme d'exit. En l'absence de postes à transmettre, la commande RCVJRNE attend la durée exprimée en secondes dans le paramètre DELAY avant de rechercher des postes à transmettre.

Remarque :TOENT(*NONE) n'est correct que si le paramètre RCVRNG indique un récepteur attaché au début de la réception des postes de journal.

*LAST

La recherche des postes de journal à recevoir s'arrête au dernier poste de la plage de récepteurs indiquée.

numéro-séquence-fin

Indiquez le numéro de séquence du dernier poste de journal à recevoir. La plage de valeurs admises s'étend de 1 à 9 999 999 999.

Remarque :Les valeurs indiquées pour les invites expéditeur (from) et destinataire (to) peuvent être identiques. Il est possible d'indiquer FROMENT(234) et TOENT(234), par exemple.

ID cycle de validation (CMTCYCID)

Indique que la sélection des postes de journal à recevoir doit s'opérer en fonction d'un cycle de validation donné. Un cycle de validation comprend tous les postes de journal partageant le même identificateur. Vous pouvez afficher cet identificateur à l'aide de la commande DSPJRN (Afficher un journal) et de l'option 5.

Remarque :Vous pouvez indiquer une valeur pour la zone ID cycle de validation (CMTCYCID) ou pour la zone ID cycle valid. étendu (CCIDLRG), jamais pour les deux.

*ALL

La sélection des postes à recevoir ne s'opère pas en fonction d'un identificateur de cycle de validation indiqué.

ID-cycle-validation

Indiquez l'identificateur de cycle de validation des postes de journal à recevoir. La plage de valeurs admises s'étend de 1 à 9 999 999 999.

Exemples

Exemple 1 : Réception de postes de journal

RCVJRNE   JRN(APPLIB/JRN1)  EXITPGM(MYLIB/RCVPGM)
          FILE(APPLIB/FILE3)  TOENT(*LAST)  ENTFMT(*TYPE3)
          NULLINDLEN(*ENTFMT)

Cette commande reçoit des postes de journal du récepteur de journal attaché (lors de l'exécution de la commande) au journal JRN1 de la bibliothèque APPLIB, puis les transmet un à un au programme RCVPGM de la bibliothèque MYLIB. Seuls sont reçus les postes des informations de niveau fichier du premier membre du fichier FILE2 de la bibliothèque APPLIB. Le format de chaque poste transmis au programme d'exit s'affiche dans le tableau du format du poste de journal NULLINDLEN(*ENTFMT) pour ENTFMT(*TYPE3), représenté dans la description du paramètre NULLINDLEN.

Exemple 2 : Réception de postes de journal

RCVJRNE   JRN(JRNLIB/MYJRN)  EXITPGM(RCVLIB/PGMA)
          FILE(FILELIB/PFILEB MBRONE)
          TOENT(*LAST)  ENTFMT(*TYPE3)  NULLINDLEN(*VARLEN 30)

Cette commande reçoit des postes de journal comprenant des informations de niveau fichier pour le membre MBRONE du fichier PFILEB de la bibliothèque FILELIB qui émanent du récepteur de journal attaché, lors de l'exécution de la commande, au journal MYJRN de la bibliothèque JRNLIB et les envoie un par un au programme PGMA de la bibliothèque RCVLIB. Le format de chaque poste transmis au programme d'exit s'affiche dans le tableau du format de poste de journal NULLINDLEN(*VARLEN longueur-zone) pour ENTFMT(*TYPE3), à la fin de la description de paramètre NULLINDLEN. La partie indicateurs de valeur indéfinie de chaque poste reçu a une longueur de 30 caractères.

Exemple 3 : Réception de postes de journal à l'aide de DELAY(*NEXTENT)

RCVJRNE   JRN(JRNLIB/MYJRN)  EXITPGM(RCVLIB/PGMA)
          RCVRNG(*CURCHAIN)  TOENT(*NONE)  DELAY(*NEXTENT)

Cette commande reçoit tous les postes de journal disponibles émanant de la chaîne de récepteurs de journal, qui comprend le récepteur de journal attaché au début de la réception, associé au journal MYJRN de la bibliothèque JRNLIB. Ces postes de journal sont envoyés séquentiellement au programme d'exit PGMA de la bibliothèque RCVLIB, à mesure qu'ils deviennent disponibles. La durée maximale entre les appels du programme d'exit est égale à durée d'attente par défaut des processus.

Exemple 4 : Réception de postes journal pour les objets zone de données, file d'attente de données et système de fichiers intégrés

RCVJRNE   JRN(LIBPROD/PRODJRN) EXITPGM(RCVLIB/PGMA)
          OBJ((APPLIB/D1 *DTAARA) (APPLIB/D2 *DTAQ)
          (APPLIB/D3 *FILE *NONE))
          OBJPATH(('/mydirectory')) SUBTREE(*YES)
          TOENT(*LAST) ENTFMT(*JRNENTFMT) JRNENTFMT(RJNE0200)

Cette commande reçoit des postes de journal du récepteur de journal attaché (lors de l'exécution de la commande) au journal PRODJRN de la bibliothèque LIBPROD, puis les transmet un à un au programme PGMA de la bibliothèque RCVLIB. Le format de chaque poste transmis au programme d'exit s'affiche dans le tableau du format de poste de journal NULLINDLEN(*ENTFMT) pour ENTFMT(*JRNENTFMT), à la fin de la description de paramètre NULLINDLEN. Seuls les postes associés aux objets indiqués sont convertis. Ces objets constituent une zone de données dans la bibliothèque APPLIB appelée D1, une file d'attente dans la bibliothèque APPLIB appelée D2, et un fichier base de données D3 dans la bibliothèque APPLIB, ainsi que le répertoire '/mydirectory' et tous les répertoires, fichiers de flux et liens symboliques dans ce répertoire ou dans l'un de ces sous-répertoires.

Messages d'erreur

Messages *ESCAPE

CPF70A9

Le paramètre OBJPATH n'est pas valide pour un journal éloigné.

CPF70AC

Objet de l'ID-fichier &1 introuvable.

CPF70AE

Le membre *FIRST n'est pas admis pour un journal éloigné.

CPF70C3

&1 de &2 n'est pas un fichier base de données.

CPF7002

Le fichier &1 de la bibliothèque &2 n'est pas un fichier physique.

CPF7006

Membre &3 non trouvé dans le fichier &1 de &2.

CPF7007

Impossible d'allouer membre &3 du fichier &1 de &2.

CPF701B

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

CPF705C

INCENT(*ALL) non admis pour un journal local.

CPF7053

Valeurs du paramètre RCVRNG incorrectes. Code raison &1.

CPF7054

Valeurs des paramètres FROM et TO incorrectes.

CPF7055

Nombre maximal d'objets dépassé.

CPF7057

*LIBL n'est pas admis avec *ALL, *ALLLIB ou un nom générique.

CPF706A

Indicateur de valeur indéfinie significatif tronqué.

CPF706D

Echec du programme d'exit &1 de &2 lors de l'exécution de la commande RCVJRNE.

CPF7060

Objet non journalisé dans l'intervalle de récepteur défini.

CPF7061

Erreur au cours du traitement des postes de journal.

CPF7062

Aucun poste du journal &1 n'a été traité ou reçu.

CPF7065

Type de poste (ENTTYP) incorrect pour code journal (JRNCDE).

CPF707B

DELAY(*NEXTENT) non admis.

CPF7074

RCVRNG et SEARCH incompatibles.

CPF708C

DELAY(*NEXTENT) non admis avec INCENT(*ALL).

CPF708D

Récepteur de journal endommagé au niveau logique.

CPF709C

JOB, PGM ou USRPRF incorrect pour la plage de récepteurs.

CPF7096

RCVRNG et le paramètre TOENTLRG ou TOENT ne correspondent pas.

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.

CPF9809

Accès à la bibliothèque &1 impossible.

CPF9810

Bibliothèque &1 non trouvée.

CPF9820

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

CPF9822

Non autorisé au fichier &1 de &2.

CPF9825

Accès non autorisé à l'unité &1.