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
-
JRNJournal obligatoire -
FILENom du fichier journalisé -
OBJObjets -
OBJPATHObjets -
SUBTREEBranche du répertoire -
PATTERNMasque du nom -
RCVRNGPlage de récepteurs de journal -
FROMENTLRGPremier num. séq. maxi -
FROMTIMEDate et heure de début -
TOENTLRGDern. num. séq. maxi -
TOTIMEDate et heure de fin -
SEARCHRecherche -
JRNCDECodes journal -
ENTTYPTypes de postes de journal -
JOBTravail -
PGMProgramme -
USRPRFProfil utilisateur -
CCIDLRGID cycle valid. étendu -
DEPENTPostes dépendants -
OBJFIDIdentificateur de fichier -
OBJJIDIdentificateur journal objet -
ENTFMTFormat de poste -
NULLINDLENLong indicateurs valeur indéf -
FMTMINDTAFormater données réduites -
INCENTInclure postes -
FROMENTNuméro de séquence de début -
TOENTNuméro de séquence de fin -
CMTCYCIDID cycle de validation -
RTNSEQLRGVar CL pour RTNSEQLRG (20) -
RTNJRNCDEVariable pour RTNJRNCDE (1) -
RTNENTTYPVariable pour RTNENTTYP (2) -
RTNRCVVariable pour RTNRCV (10) -
RTNRCVLIBVariable pour RTNRCVLIB (10) -
RTNJRNEVariable pour RTNJRNE (1) -
RTNSEQNBRVariable pour RTNSEQNBR (10 0)
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 :
- 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/.
- 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 :
- 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/.
- 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 :
- 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/.
- 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 :
- 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/.
- 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 :
- 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/.
- 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 :
- Le fichier physique correspondant comporte des zones admettant des valeurs indéfinies.
- 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.