Aller au contenu

RTVJRNE

Extraire un poste de journal

En bref

La commande RTVJRNE permet d'extraire un poste de journal particulier et de placer les résultats dans des variables CL.

RTVJRNE se lit RTV (Extraire (récupérer)) + JRNE. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RTVJRNE JRN(…)

Paramètres

Astuce : dans une session 5250, tapez RTVJRNE puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Compiled CL program or interpreted REXX (*BPGM *IPGM *BREXX *IREXX)
Compatible multitâche : Non

La commande RTVJRNE permet d'extraire un poste de journal particulier et de placer les résultats dans des variables CL. Ces dernières contiennent des informations telles que le numéro de séquence du poste extrait ; elles sont utiles lors de l'automatisation de certains types de fonctions de reprise. La recherche d'un poste de journal peut être limitée à un objet, à une plage de récepteurs de journal, à une plage de postes de journal, à un code journal, à un type de poste, à un travail, à un programme, à un profil utilisateur ou à un identificateur de cycle de validation. Vous pouvez indiquer plusieurs critères de restriction. Si plusieurs postes de journal répondent aux critères de recherche indiqués, c'est la première occurrence d'un poste de journal répondant à tous les critères de recherche indiqués qui est renvoyée. Si aucun poste de journal ne répond à ces critères, la commande prend fin, un message d'arrêt programme apparaît et les variables CL de retour (RTNSEQNBRLRG, RTNSEQNBR, RTNJRNCDE, RTNENTTYP, RTNRCV, RTNRCVLIB et RTNJRNE) restent inchangées.

La recherche de postes de journal peut se faire dans l'ordre croissant ou décroissant. L'ordre de recherche est déterminé par la valeur indiquée au paramètre SEARCH. La valeur du paramètre FROM doit être inférieure à celle du paramètre TO dans l'ordre de recherche indiqué.

L'invite CL de cette commande répertorie la longueur minimale des variables extraites en regard des paramètres corrects. Dans le cas de variables alphanumériques, un seul nombre s'affiche. Dans le cas de variables décimales, deux nombres s'affichent. Le premier indique la longueur minimale de la variable et le second le nombre minimal de positions décimales.

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 disponibles sont extraits.
    • 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 extrait. 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 extractibles.

Paramètres

Mot-clé Description Valeurs possibles Remarques
JRN Journal Nom d'objet qualifié Obligatoire, positionnel 1
Qualificatif 1: Journal Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
FILE Nom du fichier journalisé Valeurs uniques: *ALLFILE
Autres valeurs (jusqu'à 300 répétitions): Liste d'éléments
Facultatif, positionnel 2
Élément 1: Fichier Nom d'objet qualifié
Qualificatif 1: Fichier Nom, *ALL
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
Élément 2: Membre Nom, *FIRST, *ALL, *NONE
OBJ Objets Values (jusqu'à 300 répétitions): Liste d'éléments Facultatif
Élément 1: Objet Nom d'objet qualifié
Qualificatif 1: Objet Nom, *ALL
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
Élément 2: Type d'objet *FILE, *DTAARA, *DTAQ, *LIB
Élément 3: Membre, si fichier BD Nom, *FIRST, *ALL, *NONE
OBJPATH Objets Values (jusqu'à 300 répétitions): Liste d'éléments Facultatif
Élément 1: Nom Chemin d'accès
Élément 2: Inclure ou omettre *INCLUDE, *OMIT
SUBTREE Branche du répertoire *NONE, *ALL Facultatif
PATTERN Masque du nom Values (jusqu'à 20 répétitions): Liste d'éléments Facultatif
Élément 1: Masque Valeur caractère, *
Élément 2: Inclure ou omettre *INCLUDE, *OMIT
RCVRNG Plage de récepteurs de journal Valeurs uniques: *CURRENT, *CURCHAIN, *CURAVLCHN, *CURSEQCHN
Autres valeurs: Liste d'éléments
Facultatif, positionnel 3
Élément 1: Début au récepteur de journal Nom d'objet qualifié
Qualificatif 1: Début au récepteur de journal Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
Élément 2: Fin au récepteur de journal Valeurs uniques: *CURRENT
Autres valeurs: Nom d'objet qualifié
Qualificatif 1: Fin au récepteur de journal Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
FROMENTLRG Premier num. séq. maxi Valeur caractère, *FIRST, *LAST Facultatif
FROMTIME Date et heure de début Liste d'éléments Facultatif
Élément 1: Date de début Date
Élément 2: Heure de début Heure
TOENTLRG Dern. num. séq. maxi Valeur caractère, *LAST, *FIRST Facultatif
TOTIME Date et heure de fin Liste d'éléments Facultatif
Élément 1: Date de fin Date
Élément 2: Heure de fin Heure
SEARCH Recherche *ASCEND, *DESCEND Facultatif
JRNCDE Codes journal Valeurs uniques: *ALL, *CTL
Autres valeurs (jusqu'à 16 répétitions): Liste d'éléments
Facultatif
Élément 1: Valeur du code de journal A, B, C, D, E, F, J, L, M, P, Q, R, S, T, U, Y
Élément 2: Sélection du code de journal *ALLSLT, *IGNFILSLT, *IGNOBJSLT
ENTTYP Types de postes de journal Valeurs uniques: *ALL, *RCD
Autres valeurs (jusqu'à 300 répétitions): Valeur caractère
Facultatif
JOB Travail Valeurs uniques: *ALL, *
Autres valeurs: Nom de travail qualifié
Facultatif
Qualificatif 1: Travail Nom
Qualificatif 2: Utilisat Nom
Qualificatif 3: Numéro 000000-999999
PGM Programme Nom, *ALL Facultatif
USRPRF Profil utilisateur Nom, *ALL Facultatif
CCIDLRG ID cycle valid. étendu Valeur caractère, *ALL Facultatif
DEPENT Postes dépendants *ALL, *NONE Facultatif
OBJFID Identificateur de fichier Values (jusqu'à 300 répétitions): Valeur hexadécimale Facultatif
OBJJID Identificateur journal objet Values (jusqu'à 300 répétitions): Valeur hexadécimale Facultatif
ENTFMT Format de poste *TYPE1, *TYPE2, *TYPE3, *TYPE4, *TYPE5 Facultatif
NULLINDLEN Long indicateurs valeur indéf 1-8000 Facultatif
FMTMINDTA Formater données réduites *NO, *YES Facultatif
INCENT Inclure postes *CONFIRMED, *ALL Facultatif
FROMENT Numéro de séquence de début 1-9999999999, *FIRST, *LAST Facultatif
TOENT Numéro de séquence de fin 1-9999999999, *LAST, *FIRST Facultatif
CMTCYCID ID cycle de validation 1-9999999999, *ALL Facultatif
RTNSEQLRG Var CL pour RTNSEQLRG (20) Valeur caractère Facultatif
RTNJRNCDE Variable pour RTNJRNCDE (1) Valeur caractère Facultatif
RTNENTTYP Variable pour RTNENTTYP (2) Valeur caractère Facultatif
RTNRCV Variable pour RTNRCV (10) Valeur caractère Facultatif
RTNRCVLIB Variable pour RTNRCVLIB (10) Valeur caractère Facultatif
RTNJRNE Variable pour RTNJRNE (1) Valeur caractère Facultatif
RTNSEQNBR Variable pour RTNSEQNBR (10 0) Nombre décimal Facultatif

Journal (JRN)

Indique le journal d'où est extrait le poste.

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.

Fichier physique journalisé (FILE)

Indique jusqu'à 300 fichiers dont les postes de journal sont extraits. Ce paramètre indique également les membres de fichier physique dont les postes de journal doivent être extraits.

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 à extraire 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 spécifiés pour cet identificateur sont extraits.
  • 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 spécifiée pour ces identificateurs sont extraits. 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 le code journal suivant ne sont extraits 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 *ALLSLT est spécifié pour le code journal, aucun poste de journal avec ce code n'est extrait.

Valeurs uniques

*ALLFILE
La recherche du poste à extraire n'est pas limitée à un fichier particulier. Tous les postes de journal sont extraits, indépendamment des objets auxquels sont associées les objets le cas échéant.

Elément 1 : Fichier

Qualificatif 1 : Fichier

*ALL
Les postes de journal de tous les fichiers physiques ou 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 extraits. 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 à extraire.

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
Extrait les postes de journal 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
Extrait les postes de journal correspondant au fichier base de données physique et et à tous les membres de ce fichier.
*NONE
Seuls les postes correspondant au fichier base de données sont extraits. Les postes correspondant aux membres du fichier ne le sont pas.
nom-membre
Indiquez le nom du membre correspondant aux postes à 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 physique correspondants de la bibliothèque indiquée sont extraits.

Objets (OBJ)

Indique les noms qualifiés d'objet (jusqu'à 300) dont les postes de journal doivent être extraits. 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 extraits.

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 à extraire 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 spécifiée pour cet identificateur sont extraits.
  • 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 spécifiée pour ces identificateurs sont extraits. 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 extraits 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 extrait.

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 extraits. 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 extraites.

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 vont être extraites.

*FILE
Les postes correspondant aux fichiers base de données et aux membres de fichier base de données physique sont extraits.
*DTAARA
Les postes correspondant aux zones des données sont extraits.
*DTAQ
Les postes correspondant aux files d'attente sont extraits.
*LIB
Les postes correspondant aux bibliothèques sont extraits.

Elément 3 : Membre, si fichier BD

Indiquez le nom du membre du fichier physique dont les postes de journal doivent être extraits.

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

*FIRST
Extrait les postes de journal 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
Extrait les postes de journal correspondant au fichier base de données physique et et à tous les membres de ce fichier.
*NONE
Seuls les postes correspondant au fichier base de données sont extraits. Les postes correspondant aux membres du fichier ne le sont pas.
nom-membre
Indiquez le nom du membre correspondant aux postes à 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 extraits.

Objets (OBJPATH)

Indique jusqu'à 300 objets dont les postes de journal doivent être extraits. 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 extraits 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 extrait.

Elément 1 : Nom

nom-chemin
Les postes des objets identifiés par chemin d'accès sont extraits.

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 à extraire, 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 à extraire. 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 extraits.

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

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 extraits. 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 (fin) récepteur de journal délimitant la plage de récepteurs dans laquelle doit s'effectuer la recherche du poste de journal à extraire. 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 *ASCEND est entré en regard de l'invite Recherche (paramètre SEARCH), le récepteur de journal le plus ancien devra être indiqué en premier. Si la valeur du paramètre Recherche (SEARCH) est *DESCEND, les récepteurs de journal doivent être classés du plus récent au plus ancien.

Remarque :Si le nombre maximal des récepteurs (2045) constituant la plage est dépassé, une erreur se produit et aucun poste n'est extrait.

Valeurs uniques

*CURRENT
Le récepteur utilisé est celui qui est attaché lorsque débute l'extraction des postes.
*CURCHAIN
Les récepteurs de journal de la chaîne comportant le récepteur attaché en cours lorsque commence l'extraction des postes sont utilisés. Cette chaîne de récepteurs ne peut pas comporter de rupture. La plage de récepteurs est alors comprise entre la rupture la plus récente et le récepteur attaché en cours au début de l'extraction.
*CURAVLCHN
Les récepteurs de journal de la chaîne comportant le récepteur attaché lorsque commence l'extraction des postes sont utilisés. Cette chaîne de récepteurs ne peut pas comporter de rupture. La plage de récepteurs est alors comprise entre la rupture la plus récente et le récepteur attaché en cours au début de l'extraction. 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 extraits 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 dans lequel doit s'effectuer la recherche du poste à extraire.

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

Qualificatif 1 : Fin au récepteur de journal

*CURRENT
Le récepteur utilisé est celui qui est attaché lorsque débute l'extraction des postes.
nom-dernier-récepteur
Indiquez le nom du dernier récepteur de journal dans lequel doit s'effectuer la recherche du poste à extraire. 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 extrait.

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 numéro de séquence du poste de journal marquant le début de la recherche du poste à extraire.

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 du poste de journal à extraire s'effectue à partir du premier poste de la plage de récepteurs indiquée. Si SEARCH(*DESCEND) est indiqué, FROMENT(*FIRST) n'est admis que si TOENTLRG(*FIRST) ou TOENT(*FIRST) est également indiqué.
*LAST
La recherche du poste de journal à extraire s'effectue à partir du dernier poste de la plage de récepteurs indiquée. Si SEARCH(*ASCEND) est indiqué, FROMENT(*LAST) n'est admis que si TOENTLRG(*LAST) ou TOENT(*LAST) est également indiqué.
numéro-séquence-début
Indiquez le numéro de séquence du poste de journal marquant le début de la recherche du poste à extraire. 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 du poste de journal marquant le début de la recherche du poste à extraire. La recherche commence à partir du premier poste de journal correspondant à cette date et à cette heure ou à partir du poste de journal suivant.

Elément 1 : Date de début

date-début
Indiquez une date de début. La recherche commence à partir du premier poste de journal associé à la date de début indiquée ou à la date postérieure la plus proche.

Elément 2 : Heure de début

heure-début
Indiquez l'heure. La recherche commence à partir du premier poste de journal associé à la date de début indiquée ou à la date postérieure la plus proche.

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 numéro de séquence du poste de journal marquant la fin de la recherche.

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.

*LAST
La recherche s'arrête une fois traité le dernier poste de journal figurant dans la plage de récepteurs indiquée. Si SEARCH(*DESCEND) est indiqué, TOENT(*LAST) n'est admis que si FROMENTLRG(*LAST) ou FROMENT(*LAST) est également indiqué.
*FIRST
La recherche s'arrête une fois traité le premier poste de journal figurant dans la plage de récepteurs indiquée. Si SEARCH(*ASCEND) est indiqué, TOENT(*FIRST) n'est admis que si FROMENTLRG(*LAST) ou FROMENT(*FIRST) est également indiqué.
numéro-séquence-fin
Indiquez le numéro de séquence du poste de journal marquant la fin de la recherche. La plage de valeurs admises s'étend de 1 à 18 446 744 073 709 551 600.

Remarque :Les valeurs indiquées aux paramètres FROMENT et TOENT peuvent être identiques. Il est possible d'indiquer FROMENT(234) et TOENT(234), par exemple.

Date et heure de fin (TOTIME)

Indique la date et l'heure du poste de journal marquant la fin de la recherche du poste à extraire. La recherche se termine au premier poste de journal correspondant à cette date et à cette heure ou au poste de journal précédent.

Elément 1 : Date de fin

date-fin
Indiquez une date de fin. La recherche s'arrête au premier poste de journal associé à la date de fin indiquée ou à la date antérieure la plus proche.

Elément 2 : Heure de fin

heure-fin
Indiquez l'heure. La recherche s'arrête au premier poste de journal associé à la date de fin indiquée ou à la date antérieure la plus proche.

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.

Recherche (SEARCH)

Indique l'ordre dans lequel doit s'effectuer la recherche du poste à extraire.

*ASCEND
Les postes de journal sont traités par ordre croissant (du plus ancien au plus récent).
*DESCEND
Les postes de journal sont traités par ordre décroissant (du plus récent au plus ancien).

Codes journal (JRNCDE)

Indique les codes journal devant déterminer les postes à extraire.

Valeurs uniques

*ALL
La sélection des postes à extraire ne s'opère pas en fonction d'un code journal indiqué.
*CTL
L'extraction porte uniquement sur les postes de journal utilisés pour contrôler les fonctions du journal. Les codes journal sont J et 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 les postes comportant le code journal indiqué sont extraits.

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 extraits uniquement si tous les autres paramètres de sélection concordent.
*IGNFILSLT
Les postes de journal qui comportent le code journal indiqué sont extraits 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 extraits.

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 si l'extraction doit être limitée aux types de postes de journal indiqués.

Valeurs uniques

*ALL
La sélection des postes à extraire ne s'opère pas en fonction d'un type de poste particulier.
*RCD
Seuls les postes associés à un type pour les opérations au niveau des enregistrements sont extraits. Les types possibles sont BR, DL, DR, IL, PT, PX, UB, UP et UR.

Autres valeurs

type-poste
Indiquez le type de poste sur lequel porte la recherche. Seuls les postes de journal comportant le type de poste indiqué sont extraits. 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 à extraire doit s'opérer en fonction du travail indiqué.

Valeurs uniques

*ALL
La sélection des postes de journal à extraire ne s'opère pas en fonction d'un travail donné.
*
La sélection des postes de journal à extraire s'opère en fonction du 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 à extraire doit s'opérer en fonction d'un programme donné.

*ALL
La sélection des postes de journal à extraire ne s'opère pas en fonction d'un programme donné.
nom-programme
Indiquez le nom du programme sur lequel doit s'opérer la sélection des postes de journal à extraire.

Profil utilisateur (USRPRF)

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

*ALL
La sélection des postes de journal à extraire 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 à extraire.

ID cycle valid. étendu (CCIDLRG)

Indique que la sélection des postes de journal à extraire 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 de journal à extraire 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 à extraire. La plage de valeurs admises s'étend de 1 à 18 446 744 073 709 551 600.

Postes dépendants (DEPENT)

Indique si l'extraction 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 extraits.
*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 extraits.

Identificateur de fichier (OBJFID)

Indique les noms qualifiés d'identificateurs de fichier (jusqu'à 300) dont les postes de journal doivent être extraits. 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 spécifiée pour cet identificateur sont extraits.
  • 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 extraits.

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 extraits 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 extrait.
identificateur-fichier
Les postes des objets identifiés par FID sont extraits.

Identificateur journal objet (OBJJID)

Indique jusqu'à 300 identificateurs de journal pour lesquels les postes de journal doivent être extraits. 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 extraits.

Format de poste (ENTFMT)

Indique le format du poste de journal extrait. 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".

Des listes contenant des informations détaillées sur le format des postes de journal extraits, figurent dans la description du paramètre RTNJRNE.

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. Seul le format *TYPE5 possède des zones plus importantes capables de contenir cette valeur maximale. Quand 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 extraits ne permet d'y indiquer que le minimum de données possible.
*TYPE2
Les postes de journal extraits contiennent les données renvoyées lorsque ENTFMT(*TYPE1) est indiqué, ainsi que le profil utilisateur, qui fournit le nom de l'utilisateur à l'origine de la consignation des postes extraits et le nom du système sur lequel a été envoyé le poste.
*TYPE3
Les postes de journal extraits contiennent les données renvoyées lorsque ENTFMT(*TYPE2) est indiqué, ainsi que les indicateurs de valeur indéfinie.
*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.
*TYPE5
Les postes extraits comprennent les informations retournés lorsque OUTFILFMT(*TYPE4) est indiqué, en plus du nom de la bibliothèque de programme, du nom d'unité ASP de la bibliothèque de programme, du numéro d'ASP de la bibliothèque de programme, du numéro de séquence système, de l'unité d'oeuvre logique, de l'identificateur de transaction, de l'identificateur d'unité d'exécution, de l'adresse éloignée, de la famille d'adresses, du port éloigné, du numéro de bras, du numéro de récepteur, du nom de la bibliothèque du récepteur, du nom d'unité ASP de la bibliothèque du récepteur et du numéro d'ASP de la bibliothèque du récepteur.

Long indicateurs valeur indéf (NULLINDLEN)

Indiquez la longueur utilisée pour la partie du poste extrait correspondant aux indicateurs de valeur indéfinie. Ce paramètre n'est admis que si ENTFMT(*TYPE1) ou ENTFMT(*TYPE2) est indiqué. Les valeurs admises sont comprises entre 1 et 8000 octets. Si le nombre des indicateurs du poste représente une longueur inférieure à la longueur indiquée, la valeur 'X est attribuée aux octets de fin de la zone.

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 RTVJRNE, une valeur interne est renvoyée pour l'indicateur de valeur indéterminée.

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.

Inclure postes (INCENT)

Indique si seuls les postes de journal confirmés ou ceux-ci ainsi que les postes non confirmés sont extraits. Ce paramètre s'applique uniquement lors de la conversion 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 extraits.
*ALL
Tous les postes de journal (confirmés ou non confirmés) sont extraits.

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

Indique le numéro de séquence du poste de journal marquant le début de la recherche du poste à extraire.

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 du poste de journal à extraire s'effectue à partir du premier poste de la plage de récepteurs indiquée. Si SEARCH(*DESCEND) est indiqué, FROMENT(*FIRST) n'est admis que si TOENTLRG(*FIRST) ou TOENT(*FIRST) est également indiqué.
*LAST
La recherche du poste de journal à extraire s'effectue à partir du dernier poste de la plage de récepteurs indiquée. Si SEARCH(*ASCEND) est indiqué, FROMENT(*LAST) n'est admis que si TOENTLRG(*LAST) ou TOENT(*LAST) est également indiqué.
numéro-séquence-début
Indiquez le numéro de séquence du poste de journal marquant le début de la recherche du poste à extraire. La plage de valeurs admises s'étend de 1 à 9 999 999 999.

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

Indique le numéro de séquence du poste de journal marquant la fin de la recherche.

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.

*LAST
La recherche s'arrête une fois traité le dernier poste de journal figurant dans la plage de récepteurs indiquée. Si SEARCH(*DESCEND) est indiqué, TOENT(*LAST) n'est admis que si FROMENTLRG(*LAST) ou FROMENT(*LAST) est également indiqué.
*FIRST
La recherche s'arrête une fois traité le premier poste de journal figurant dans la plage de récepteurs indiquée. Si SEARCH(*ASCEND) est indiqué, TOENT(*FIRST) n'est admis que si FROMENTLRG(*LAST) ou FROMENT(*FIRST) est également indiqué.
numéro-séquence-fin
Indiquez le numéro de séquence du poste de journal marquant la fin de la recherche. La plage de valeurs admises s'étend de 1 à 9 999 999 999.

Remarque :Les valeurs indiquées aux paramètres FROMENT et TOENT 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 à extraire 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 de journal à extraire 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 à extraire. La plage de valeurs admises s'étend de 1 à 9 999 999 999.

Var CL pour RTNSEQLRG (20) (RTNSEQLRG)

Indique le nom de la variable CL de type alphanumérique destinée à recevoir le numéro de séquence du poste de journal extrait. Si aucun nom n'est indiqué, le numéro de séquence du poste de journal n'est pas copié dans le programme. La variable indiquée doit être de type alphanumérique et d'une longueur minimale de 20 caractères. Si le numéro de séquence extrait est plus court que la zone, il est complété par des espaces à droite.

Variable pour RTNJRNCDE (1) (RTNJRNCDE)

Indique le nom de la variable CL de type alphanumérique destinée à recevoir le code journal du poste de journal extrait. Si aucun nom n'est indiqué, le code journal du poste de journal n'est pas copié dans le programme. La variable indiquée doit être de type alphanumérique et d'une longueur minimale de 1 caractère alphanumérique. Si la longueur de la variable est supérieure, des blancs sont ajoutés à droite.

Variable pour RTNENTTYP (2) (RTNENTTYP)

Indique le nom de la variable CL de type alphanumérique destinée à recevoir le type du poste de journal extrait. Si aucun nom n'est indiqué, le type du poste de journal extrait n'est pas copié dans le programme. La variable indiquée doit être de type alphanumérique et d'une longueur minimale de 2 caractères. Si la longueur de la variable est supérieure, des blancs sont ajoutés à droite.

Variable pour RTNRCV (10) (RTNRCV)

Indique le nom de la variable CL de type alphanumérique destinée à recevoir le nom du récepteur dont provient le poste de journal extrait. Si aucun nom n'est indiqué, le nom du récepteur n'est pas copié dans le programme. La variable indiquée doit être de type alphanumérique et d'une longueur minimale de 10 caractères. Si la longueur de la variable est supérieure, des blancs sont ajoutés à droite.

Variable pour RTNRCVLIB (10) (RTNRCVLIB)

Indique le nom de la variable CL de type alphanumérique destinée à recevoir le nom de la bibliothèque contenant le récepteur dont provient le poste de journal extrait. Si aucun nom n'est indiqué, le nom de la bibliothèque n'est pas copié dans le programme. La variable indiquée doit être de type alphanumérique et d'une longueur minimale de 10 caractères. Si la longueur de la variable est supérieure, des blancs sont ajoutés à droite.

Variable pour RTNJRNE (1) (RTNJRNE)

Indique le nom de la variable CL de type alphanumérique destinée à recevoir la copie du poste de journal extrait. Si aucun nom n'est indiqué, le poste de journal extrait n'est pas copié dans le programme. La variable indiquée doit être de type alphanumérique. Si la longueur du poste de journal extrait est supérieure à celle de la zone réservée à la variable, le poste est tronqué. S'il est de longueur inférieure, des blancs sont ajoutés à droite.

Les listes suivantes affichent des informations détaillées sur le format des postes de journal extraits.

Les formats suivants sont possibles pour extraire des postes de journal:

Si ENTFMT(*TYPE1) est indiqué, le format des zones du poste se présente ainsi :

Nom de zone            Attributs de zone
---------------------  ----------------------------
LONGUEUR POSTE         TYPE(*DEC) LEN(5 0)
NUMERO SEQUENCE (1)    TYPE(*DEC) LEN(10 0)
CODE JOURNAL           TYPE(*CHAR) LEN(1)
TYPE POSTE             TYPE(*CHAR) LEN(2)
DATE                   TYPE(*CHAR) LEN(6)
HEURE                  TYPE(*DEC) LEN(6 0)
NOM TRAVAIL            TYPE(*CHAR) LEN(10)
NOM UTILISATEUR        TYPE(*CHAR) LEN(10)
NUMERO TRAVAIL         TYPE(*DEC) LEN(6 0)
NOM PROGRAMME          TYPE(*CHAR) LEN(10)
NOM OBJET              TYPE(*CHAR) LEN(10)
BIBLIO. OBJET          TYPE(*CHAR) LEN(10)
NOM MEMBRE             TYPE(*CHAR) LEN(10)
NOMBRE/RRN (2)         TYPE(*DEC) LEN(10 0)
INDICATEUR             TYPE(*CHAR) LEN(1)
ID CYCLE VALID. (3)    TYPE(*DEC) LEN(10 0)
DONNEES INCOMPLETES    TYPE(*CHAR) LEN(1)
DONNEES POSTE REDUITES TYPE(*CHAR) LEN(1)
RESERVE                TYPE(*CHAR) LEN(6)
DONNEES SPECIF. POSTE  TYPE(*CHAR) LEN(jusqu'à 32642)
Remarques :
(1)  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.
(2)  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.
(3)  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.

Si ENTFMT(*TYPE2) est indiqué, le format des zones du poste se présente ainsi :

Nom de zone            Attributs de zone
---------------------  ----------------------------
LONGUEUR POSTE         TYPE(*DEC) LEN(5 0)
NUMERO SEQUENCE (1)    TYPE(*DEC) LEN(10 0)
CODE JOURNAL           TYPE(*CHAR) LEN(1)
TYPE POSTE             TYPE(*CHAR) LEN(2)
DATE                   TYPE(*CHAR) LEN(6)
HEURE                  TYPE(*DEC) LEN(6 0)
NOM TRAVAIL            TYPE(*CHAR) LEN(10)
NOM UTILISATEUR        TYPE(*CHAR) LEN(10)
NUMERO TRAVAIL         TYPE(*DEC) LEN(6 0)
NOM PROGRAMME          TYPE(*CHAR) LEN(10)
NOM OBJET              TYPE(*CHAR) LEN(10)
BIBLIO. OBJET          TYPE(*CHAR) LEN(10)
NOM MEMBRE             TYPE(*CHAR) LEN(10)
NOMBRE/RRN (2)         TYPE(*DEC) LEN(10 0)
INDICATEUR             TYPE(*CHAR) LEN(1)
ID CYCLE VALID. (3)    TYPE(*DEC) LEN(10 0)
PROFIL UTILISATEUR     TYPE(*CHAR) LEN(10)
NOM SYSTEME            TYPE(*CHAR) LEN(8)
DONNEES INCOMPLETES    TYPE(*CHAR) LEN(1)
DONNEES POSTE REDUITES TYPE(*CHAR) LEN(1)
RESERVE                TYPE(*CHAR) LEN(18)
DONNEES SPECIF. POSTE  TYPE(*CHAR) LEN(jusqu'à 32612)
Remarques :
(1)  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.
(2)  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.
(3)  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.

Remarque :Si ENTFMT(*TYPE3) est indiqué, les informations suivantes ne sont pas disponibles dans ce format :

  • Données incomplètes. Indique si les données du poste de journal sont incomplètes à cause des zones LOB ou des opérations sur le fichier STREAM.
  • 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/.

Si ENTFMT(*TYPE3)est indiqué et que le paramètre NULLINDLEN comporte une valeur, le format du poste se présente ainsi :

Nom de zone            Attributs de zone
---------------------  ----------------------------
LONGUEUR POSTE         TYPE(*DEC) LEN(5 0)
NUMERO SEQUENCE (3)    TYPE(*DEC) LEN(10 0)
CODE JOURNAL           TYPE(*CHAR) LEN(1)
TYPE POSTE             TYPE(*CHAR) LEN(2)
HORODATAGE             TYPE(*TIMESTAMP) LEN(26)
NOM TRAVAIL            TYPE(*CHAR) LEN(10)
NOM UTILISATEUR        TYPE(*CHAR) LEN(10)
NUMERO TRAVAIL         TYPE(*DEC) LEN(6 0)
NOM PROGRAMME          TYPE(*CHAR) LEN(10)
NOM OBJET              TYPE(*CHAR) LEN(10)
BIBLIO. OBJET          TYPE(*CHAR) LEN(10)
NOM MEMBRE             TYPE(*CHAR) LEN(10)
NOMBRE/RRN (4)         TYPE(*DEC) LEN(10 0)
INDICATEUR             TYPE(*CHAR) LEN(1)
ID CYCLE VALID. (5)    TYPE(*DEC) LEN(10)
PROFIL UTILISATEUR     TYPE(*CHAR) LEN(10)
NOM SYSTEME            TYPE(*CHAR) LEN(8)
INDIC. VAL. INDEFINIE   TYPE(*CHAR) longueur-zone (1)
DONNEES SPECIF. POSTE  TYPE(*CHAR) ((jusqu'à 32618)
                         moins (longueur zone))  (2)
Remarques :
(1) La longueur de cette zone est la longueur
indiquée dans le paramètre NULLINDLEN.
(2) La longueur de cette partie du poste
dépend de la longueur indiquée dans le paramètre RTNJRNE
et de la longueur indiquée dans le
paramètre NULLINDLEN.
(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.

Si ENTFMT(*TYPE4)est indiqué et que le paramètre NULLINDLEN comporte une valeur, le format du poste se présente ainsi :

Nom de zone            Attributs de zone
---------------------  ----------------------------
LONGUEUR POSTE         TYPE(*DEC) LEN(5 0)
NUMERO SEQUENCE (3)    TYPE(*DEC) LEN(10 0)
CODE JOURNAL           TYPE(*CHAR) LEN(1)
TYPE POSTE             TYPE(*CHAR) LEN(2)
HORODATAGE             TYPE(*TIMESTAMP) LEN(26)
NOM TRAVAIL            TYPE(*CHAR) LEN(10)
NOM UTILISATEUR        TYPE(*CHAR) LEN(10)
NUMERO TRAVAIL         TYPE(*DEC) LEN(6 0)
NOM PROGRAMME          TYPE(*CHAR) LEN(10)
NOM OBJET              TYPE(*CHAR) LEN(10)
BIBLIO. OBJET          TYPE(*CHAR) LEN(10)
NOM MEMBRE             TYPE(*CHAR) LEN(10)
NOMBRE/RRN (4)         TYPE(*DEC) LEN(10 0)
INDICATEUR             TYPE(*CHAR) LEN(1)
ID CYCLE VALID. (5)    TYPE(*DEC) LEN(10)
PROFIL UTILISATEUR     TYPE(*CHAR) LEN(10)
NOM SYSTEME            TYPE(*CHAR) LEN(8)
ID JOURNAL             TYPE(*CHAR) LEN(10)
CONTRAINTE REFERENT.   TYPE(*CHAR) LEN(1)
DECLENCHEUR            TYPE(*CHAR) LEN(1)
DONNEES INCOMPLETES    TYPE(*CHAR) LEN(1)
IGNORER PENDANT        TYPE(*CHAR) LEN(1)
APYJRNCHG OU RMVJRNCHG
DONNEES POSTE REDUITES TYPE(*CHAR) LEN(1)
RESERVE                TYPE(*CHAR) LEN(5)
INDIC. VAL. INDEFINIE   TYPE(*CHAR) longueur-zone (1)
DONNEES SPECIF. POSTE  TYPE(*CHAR) ((jusqu'à 32598)
                         moins (longueur zone))  (2)
Remarques :
(1) La longueur de cette zone est la longueur
indiquée dans le paramètre NULLINDLEN.
(2) La longueur de cette partie du poste
dépend de la longueur indiquée dans le paramètre RTNJRNE
et de la longueur indiquée dans le
paramètre NULLINDLEN.
(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.

Si ENTFMT(*TYPE5)est indiqué et que le paramètre NULLINDLEN comporte une valeur, le format du poste se présente ainsi :

Nom de zone            Attributs de zone
---------------------  ----------------------------
LONGUEUR POSTE         TYPE(*DEC) LEN(5 0)
NUMERO SEQUENCE        TYPE(*CHAR) LEN(20)
CODE JOURNAL           TYPE(*CHAR) LEN(1)
TYPE POSTE             TYPE(*CHAR) LEN(2)
HORODATAGE             TYPE(*TIMESTAMP) LEN(26)
NOM TRAVAIL            TYPE(*CHAR) LEN(10)
NOM UTILISATEUR        TYPE(*CHAR) LEN(10)
NUMERO TRAVAIL         TYPE(*DEC) LEN(6 0)
NOM PROGRAMME          TYPE(*CHAR) LEN(10)
NOM BIBLIO. PROGRAMME  TYPE(*CHAR) LEN(10)
NOM UNITE ASP          TYPE(*CHAR) LEN(10)
NOM
NUMERO ASP PROGRAMME   TYPE(*DEC)  LEN(5 0)
NOM OBJET              TYPE(*CHAR) LEN(10)
BIBLIO. OBJET          TYPE(*CHAR) LEN(10)
NOM MEMBRE             TYPE(*CHAR) LEN(10)
NOMBRE/RRN             TYPE(*CHAR) LEN(20)
INDICATEUR             TYPE(*CHAR) LEN(1)
ID CYCLE VALIDATION    TYPE(*CHAR) LEN(20)
PROFIL UTILISATEUR     TYPE(*CHAR) LEN(10)
NOM SYSTEME            TYPE(*CHAR) LEN(8)
ID JOURNAL             TYPE(*CHAR) LEN(10)
CONTRAINTE REFERENT.   TYPE(*CHAR) LEN(1)
DECLENCHEUR            TYPE(*CHAR) LEN(1)
DONNEES INCOMPLETES    TYPE(*CHAR) LEN(1)
IGNORER PENDANT        TYPE(*CHAR) LEN(1)
APYJRNCHG OU RMVJRNCHG
DONNEES POSTE REDUITES TYPE(*CHAR) LEN(1)
INDIC. OBJET           TYPE(*CHAR) LEN(1)
NUMERO SEQUENCE        TYPE(*CHAR) LEN(20)
SYSTEME
NOM RECEPTEUR          TYPE(*CHAR) LEN(10)
NOM BIBLIO. RECEPTEUR  TYPE(*CHAR) LEN(10)
NOM UNITE ASP          TYPE(*CHAR) LEN(10)
NOM
NUMERO ASP RECEPTEUR   TYPE(*DEC)  LEN(5 0)
NUMERO ARM             TYPE(*DEC)  LEN(5 0)
ID UNITE EXECUTION     TYPE(*CHAR) LEN(8)
ID UNITE EXEC HEXA     TYPE(*CHAR) LEN(16)
FAMILLE ADRESSES       TYPE(*CHAR) LEN(1)
PORT ELOIGNE           TYPE(*DEC)  LEN(5 0)
ADRESSE ELOIGNEE       TYPE(*CHAR) LEN(46)
UNITE LOGIQUE TRAVAIL  TYPE(*CHAR) LEN(39)
ID TRANSACTION         TYPE(*CHAR) LEN(140)
TYPE OBJET             TYPE(*CHAR) LEN(7)
INDIC. TYPE FICHIER    TYPE(*CHAR) LEN(1)
NIV. VALID. IMBRIQUE   TYPE(*DEC)  LEN(7 0)
RESERVE                TYPE(*CHAR) LEN(5)
INDIC. VAL. INDEFINIE   TYPE(*CHAR) longueur-zone (1)
DONNEES SPECIF. POSTE  TYPE(*CHAR) ((jusqu'à 32212)
                         moins (longueur zone))  (2)
Remarques :
(1) La longueur de cette zone est la longueur
indiquée dans le paramètre NULLINDLEN.
(2) La longueur de cette partie du poste
dépend de la longueur indiquée dans le paramètre RTNJRNE
et de la longueur indiquée dans le
paramètre NULLINDLEN.

Variable pour RTNSEQNBR (10 0) (RTNSEQNBR)

Indique le nom de la variable CL de type décimal destinée à recevoir le numéro de séquence du poste de journal extrait. Si aucun nom n'est indiqué, le numéro de séquence du poste de journal n'est pas copié dans le programme. La variable indiquée doit être de type décimal et d'une longueur de dix chiffres (sans décimale). Si le numéro de séquence est supérieur à 9 999 999 999, cette valeur est fixée à -1, alignée à gauche, puis complétée par des espaces à droite. Pour récupérer une valeur supérieure à 9 999 999 999, optez pour le paramètre Var CL pour RTNSEQLRG (20) (RTNSEQLRG).

Exemples

Exemple 1

Supposons que les variables suivantes soient indiquées :

DCL  &SEQ      TYPE(*DEC)  LEN(10 0)
DCL  &JRNENT   TYPE(*CHAR) LEN(200)
DCL   &RCVNAME  TYPE(*CHAR) LEN(10)
DCL   &RCVLIB   TYPE(*CHAR) LEN(10)

et que cette commande soit exécutée :

RTVJRNE   JRN(MYLIB/JRNA)  ENTTYP(PR)
          RTNSEQNBR(&SEQ)  RTNJRNE(&JRNENT)

En l'absence d'indication précise dans la commande, le premier poste émanant du récepteur de journal actuellement attaché au journal JRNA de la bibliothèque MYLIB au début de la récupération des postes, est considéré comme un poste à extraire. Le premier poste du récepteur est toujours l'identificateur du récepteur attaché précédemment . Le premier poste est de type PR et contient le nom du récepteur attaché précédent. Le poste PR est le premier élément de la liste croissante du récepteur attaché ; lorsqu'elle le trouve, la commande le place dans la variable CL &JRNENT.

La commande CHG (Modifier une variable) peut alors être employée pour séparer le nom et la bibliothèque du récepteur de journal précédent figurant dans le poste, comme suit :

CHGVAR   &RCVNAME  (%SST(&JRNENT 126 10))
CHGVAR   &RCVLIB   (%SST(&JRNENT 136 10))

Exemple 2

Supposons que les variables suivantes soient indiquées :

DCL   &ENTNO    TYPE(*DEC)  LEN(10 0)
DCL   &JCODE    TYPE(*CHAR) LEN(1)
DCL   &ETYPE    TYPE(*CHAR) LEN(2)
DCL   &RCVNAME  TYPE(*CHAR) LEN(10)
DCL   &RCVLIB   TYPE(*CHAR) LEN(10)
DCL   &JENTRY   TYPE(*CHAR) LEN(205)

et que cette commande soit exécutée :

RTVJRNE   JRN(MYLIB/JRNLA)  OBJ(LIB1/A *FILE MBR3)
          RCVRNG(RCVLIB/RCV30 RCVLIB/RCV27)  ORDER(*DESCEND)
          JRNCDE(R)  ENTTYP(UP DL)  JOB(000666/QPGMR/PRESTRT)
          PGM(WAKEUP)  USRPRF(MAC7)  ENTFMT(*TYPE2)
          RTNSEQNBR(&ENTNO)  RTNJRNCDE(&JCODE)
          RTNENTTYP(&ETYPE)  RTNRCV(&RCVNAME)
          RTNRCVLIB(&RCVLIB)  RTNJRNE(&JENTRY)

Cette commande récupère un poste de journal en effectuant une recherche par ordre décroissant dans le récepteur de journal, depuis le récepteur RCV30 de RCVLIB jusqu'au récepteur RCV27 de RCVLIB ; ce poste figure dans le journal JRNLA, puis ce poste est copié dans les variables CL indiquées. Le poste, extrait du membre MBR3 du fichier A de la bibliothèque LIB1, est un poste UPDATE ou DELETE créé dans le travail 000666/QPGMR/PRESTRT du programme WAKEUP par le profil utilisateur MAC7. Le poste de journal extrait comprend la zone profil utilisateur. Le numéro de séquence de ce poste est copié dans la variable CL &ENTNO. Le code journal du poste est copié dans la variable CL &JCODE. Le type du poste extrait est copié dans la variable CL &ETYPE. Le nom du récepteur de journal duquel le poste a été extrait est copié dans &RCVNAME. Le nom de la bibliothèque du récepteur de journal duquel le poste a été extrait est copié dans &RCVLIB.

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.
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).
CPF7072
L'extraction de poste de journal a échoué.
CPF7073
Aucun poste extrait du journal &1 de &2.
CPF7074
RCVRNG et SEARCH incompatibles.
CPF708D
Récepteur de journal endommagé au niveau logique.
CPF709C
JOB, PGM ou USRPRF incorrect pour la plage de récepteurs.
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.

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