DSPJRN

La commande DSPJRN (Afficher un journal) permet de convertir les postes de journal (situés dans un ou plusieurs récepteurs) dans un format propre à une représentation externe. La sortie résultant de l'exécution de cette commande peut être affichée, imprimée avec la sortie spoule du travail, ou dirigée vers un fichier base de données en sortie. Si le fichier base de données en sortie existe, les enregistrements peuvent remplacer les données en cours dans le membre de fichier indiqué ou y être ajoutés. Si le fichier et le membre base de données indiqués n'existent pas, le système les crée. Les fichiers créés par le système sont dans un format standard. Pour les postes de longueur supérieure à la longueur maximale d'enregistrement définie pour les fichiers de sortie, un message d'avertissement est émis et les enregistrements sont tronqués.

Le contenu de postes choisis dans les récepteurs de journal peut être converti pour la sortie. Il est également possible de limiter sélectivement les postes à afficher. Lorsque aucun poste de journal ne répond aux critères de sélection ou de limitation, un message d'arrêt programme est émis.

Des ruptures dans la numérotation des postes convertis peuvent se produire, car certains postes de journal représentent des informations système internes. Les postes internes peuvent être affichés à l'aide de INCHIDENT(*YES).

Il est possible d'afficher les postes de journal dont les numéros de séquence sont réinitialisés dans la chaîne de récepteurs à indiquer.

La fonction de table QSYS2.DISPLAY_JOURNAL renvoie des informations similaires.

Restrictions :

• Le fichier indiqué pour le fichier base de données en sortie ne doit pas être journalisé dans le même journal que ce dernier. Pour plus d'informations sur les formats d'enregistrement des fichiers base de données en sortie, reportez-vous au manuel Rubrique Base de données de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
• 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.
• 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.
• 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 convertis pour la sortie.
  • 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.
• Si le nombre maximal d'objets (32767) est dépassé, une erreur se produit et aucun poste n'est reçu. Cette restriction ne s'applique pas lorsque *ALLFILE est spécifié ou si aucun objet n'est indiqué.
• Lorsque la mise en cache du journal est employée, les postes résidant dans le cache ne sont pas affichables.

Paramètres

Journal (JRN)

Journal duquel sont extraits les postes pour la conversion et la sortie.

Ce paramètre est obligatoire.

Valeurs uniques

*INTSYSJRN

Le journal interne système associé au journal indiqué au paramètre JRNID est utilisé. Les journaux internes système ne sont pas stockés dans des bibliothèques.

Remarque :Indiquez une valeur pour JRNID si le code contient JRN(*INTSYSJRN).

Remarque :Vous devez disposer du droit spécial *ALLOBJ pour indiquer JRN(*INTSYSJRN).

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 les noms qualifiés de fichiers base de données (jusqu'à 300) dont les postes de journal sont convertis pour la sortie. Ce paramètre indique également le nom du membre de fichier physique auquel s'applique cette conversion.

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 à convertir pour la sortie 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ée pour cet identificateur sont convertis pour la sortie.
• 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 convertis pour la sortie. Pour que les postes du fichier soient renvoyés, indiquez le nom de bibliothèque ou *CURLIB.

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

Remarques :

1. L'identificateur de journal est l'identificateur unique associé à l'objet lorsque la journalisation est lancée pour celui-ci. Il reste constant, même si l'objet est renommé, déplacé ou restauré. Pour plus d'informations, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
2. Lors de la spécification d'un fichier de base de données pour ce paramètre, les postes de journal ayant les codes journal ci-après ne sont convertis pour la sortie 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é comme deuxième élément pour ce code journal. Si *ALLSLT est indiqué, aucun poste avec ce code n'est converti pour la sortie.

Valeurs uniques

*ALLFILE

La recherche des postes de journal à recevoir n'est pas limitée à un fichier donné. Tous les postes de journal sont convertis pour la sortie, 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 de base de données 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 convertis pour la sortie. 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 base de données dont les postes de journal sont convertis pour la sortie.

Qualificatif 2 : Bibliothèque.

*LIBL

La recherche porte sur toutes les bibliothèques figurant dans la liste associée au travail jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le fichier 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

Indiquez le nom de la bibliothèque contenant le fichier.

Elément 2 : Membre

*FIRST

Convertit les postes de journal correspondant au fichier base de données physique et au premier membre du fichier pour la sortie. Cette valeur n'est pas valide pour les journaux éloignés.

*ALL

Convertit les postes de journal correspondant au fichier base de données physique et à tous les membres de ce fichier pour la sortie.

*NONE

Seuls les postes correspondant au fichier base de données sont convertis pour la sortie. Les postes correspondant aux membres du fichier ne sont pas convertis pour la sortie.

nom

Indiquez le nom du membre de fichier physique dont les postes de journal doivent être convertis pour la sortie. Si le fichier physique indiqué n'existe pas sur le système, indiquez soit *ALL, soit un nom de membre de fichier physique spécifique.

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

Objets (OBJ)

Indique les noms qualifiés d'objets (jusqu'à 300) dont les postes de journal sont convertis pour la sortie. 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 auquel s'applique cette conversion.

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 à convertir pour la sortie 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 convertis pour la sortie.
• 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 convertis pour la sortie. 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 convertis pour la sortie 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 converti pour la sortie.

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 convertis pour la sortie. 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 d'objet dont les modifications journalisées sont converties pour la sortie.

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 d'objet dont les modifications journalisées sont converties pour la sortie.

*FILE

Les postes correspondant aux fichiers base de données et aux membres de fichier base de données physique sont convertis pour la sortie.

*DTAARA

Les postes correspondant aux zones de données sont convertis pour la sortie.

*DTAQ

Les postes correspondant aux files d'attente de données sont convertis pour la sortie.

*LIB

Les postes correspondant aux bibliothèques sont convertis pour la sortie.

Elément 3 : Membre, si fichier BD

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

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

*FIRST

Convertit les postes de journal correspondant au fichier base de données physique et au premier membre du fichier pour la sortie. Cette valeur n'est pas valide pour les journaux éloignés.

*ALL

Convertit les postes de journal correspondant au fichier base de données physique et à tous les membres de ce fichier pour la sortie.

*NONE

Seuls les postes correspondant au fichier base de données sont convertis pour la sortie. Les postes correspondant aux membres du fichier ne sont pas convertis pour la sortie.

nom

Indiquez le nom du membre de fichier physique dont les postes de journal doivent être convertis pour la sortie. Si le fichier physique indiqué n'existe pas sur le système, indiquez soit *ALL, soit un nom de membre de fichier physique spécifique.

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 convertis pour la sortie.

Objets (OBJPATH)

Indique jusqu'à 300 objets dont les postes de journal sont convertis pour la sortie. 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 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 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 converti pour la sortie.

Elément 1 : Nom

nom-chemin

Les postes des objets identifiés par chemin d'accès sont convertis pour la sortie.

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.

Remarque :Le paramètre SUBTREE indique si les branches doivent être incluses ou non.

*INCLUDE

Les objets correspondant au modèle de nom d'objet doivent être inclus pour déterminer les postes de journal à inclure, 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 quels postes de journal sont convertis pour la sortie. 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 sont convertis pour la sortie.

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 convertis pour la sortie.

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 convertis pour la sortie. 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.

Remarque :Le paramètre SUBTREE indique si les branches doivent être incluses ou non.

*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 dont les postes doivent être convertis dans un format propre à une représentation externe. Le système traite toute la chaîne de récepteurs depuis le récepteur de début jusqu'à celui de fin.

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

Valeurs uniques

*CURRENT

Le récepteur utilisé est celui qui est attaché lorsque commence la conversion des postes.

*CURCHAIN

Les récepteurs de journal de la chaîne comportant le récepteur attaché lorsque commence la conversion des postes sont utilisés. 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.

*CURAVLCHN

Les récepteurs de journal de la chaîne comportant le récepteur attaché lorsque commence la conversion des postes sont utilisés. 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.

*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

Indiquez le nom du premier récepteur de journal contenant les postes à convertir pour la sortie.

Qualificatif 2 : Date de début

*LIBL

La recherche porte sur toutes les bibliothèques figurant dans la liste associée au travail 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

Indiquez le nom de la bibliothèque contenant le récepteur de journal.

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

Valeurs uniques

*CURRENT

Le récepteur utilisé est celui qui est attaché lorsque commence la conversion des postes.

Qualificatif 1 : Fin au récepteur de journal

nom

Indiquez le nom et la bibliothèque du dernier récepteur de journal contenant les postes à convertir pour la sortie.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques figurant dans la liste associée au travail 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

Indiquez le nom de la bibliothèque contenant le récepteur de journal.

Premier num. séq. maxi (FROMENTLRG)

Indique le premier poste de journal à convertir dans un format propre à une représentation externe.

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 conversion commence à partir du premier poste de la plage de récepteurs indiquée.

numéro-séquence-début

Indiquez le numéro de séquence du premier poste de journal à convertir. 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 premier poste à convertir dans un format propre à une représentation externe.

Elément 1 : Date de début

date

Indiquez la date de début. La conversion 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 de début. La conversion 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 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.

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

Indique le dernier poste de journal à convertir.

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 conversion s'arrête au dernier poste de la plage de récepteurs de journal indiquée.

numéro-séquence-fin

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

Date et heure de fin (TOTIME)

Indique la date et l'heure du dernier poste de journal à convertir dans un format propre à une représentation externe.

Elément 1 : Date de fin

date-fin

Indiquez une date de fin. La conversion 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 de fin. La conversion 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 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.

Nombre de postes de journal (NBRENT)

Indique le nombre total de postes de journal à convertir pour la sortie.

*ALL

La conversion s'applique à tous les postes de journal contenus dans la plage de récepteurs indiquée, qui répondent aux critères de sélection.

nombre-maximum-postes

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

Codes journal (JRNCDE)

Indique les codes journal pour lesquels les postes sont convertis pour la sortie.

Valeurs uniques

*ALL

La sélection des postes à convertir ne s'opère pas en fonction d'un code journal particulier.

*CTL

Convertit uniquement les postes créés pour contrôler les fonctions du journal (codes journal 'J' et 'F').

Elément 1 : Valeur du code de journal

code-journal

Indiquez le code journal pour lequel les postes sont convertis.

Pour afficher la liste des codes journal acceptés pour ce paramètre, appuyez sur la touche F4 (Invite) à partir de l'invite JRNCDE. Pour plus d'informations sur la liste des codes journal disponibles, 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".

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

*ALLSLT

Seuls les postes de journal qui concordent avec les valeurs indiquées pour tous les autres paramètres de cette commande sont convertis pour la sortie.

*IGNFILSLT

Les postes de journal qui concordent avec les valeurs indiquées pour tous les autres paramètres de cette commande, à l'exception de FILE, sont convertis pour la sortie.

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.

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 la sélection des postes de journal à convertir dans un format propre à une représentation externe doit s'opérer en fonction du type de poste indiqué.

Valeurs uniques

*ALL

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

*RCD

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

Autres valeurs

type-poste

Indiquez les types de postes sur lesquels doit s'opérer la sélection des postes à convertir. 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 à convertir doit s'opérer en fonction d'un travail donné. Seuls les postes correspondant au travail indiqué seront convertis.

Valeurs uniques

*ALL

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

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 à convertir doit s'opérer sur les postes créés à l'aide d'un programme donné.

*ALL

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

nom-programme

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

Profil utilisateur (USRPRF)

Indique que la sélection des postes à convertir doit s'opérer en fonction du profil utilisateur à l'origine de leur création. Le nom utilisateur désigne le profil utilisateur sous lequel s'est exécuté le travail à l'origine des modifications journalisées.

*ALL

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

nom-utilisateur

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

ID cycle valid. étendu (CCIDLRG)

Indique que la sélection des postes de journal à convertir 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.

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 à convertir 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 à convertir. La plage de valeurs admises s'étend de 1 à 18 446 744 073 709 551 600.

Postes dépendants (DEPENT)

Indique si les postes de journal à convertir incluent les postes 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 convertis.

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

Format de sortie (OUTFMT)

Indique si la partie données spécifiques d'un poste de journal doit apparaître au format alphanumérique ou au format hexadécimal. Ce mot-clé est ignoré si *OUTFILE est précisé à l'invite Sortie (paramètre OUTPUT).

*CHAR

Représente la partie données spécifiques d'un poste de journal au format alphanumérique.

*HEX

Représente la partie données spécifiques d'un poste de journal au format hexadécimal.

Numéro identification journal (JRNID)

Numéro d'identification (ID) à cinq caractères associé au journal interne système (*INTSYSJRN) à afficher. Les ID journal sont attribués par le système. Les deux premiers caractères représentent le type du journal et les trois derniers l'identificateur de pool de mémoire secondaire (ASP).

Remarque :Le paramètre JRNID peut être indiqué uniquement si JRN(*INTSYSJRN) est précisé.

Les types de journaux possibles sont les suivants :

Types de journaux

10

Protection des chemins d'accès gérée par le système (SMAPP)

20

Répertoire

30

Spoule

Inclusion des postes masqués (INCHIDENT)

Indique si les postes de journal masqués doivent être retournés. Les postes masqués sont générés et utilisés par le système. Lorsque les postes masqués sont retournés, il est possible d'afficher tous les postes de journal de façon que tous les numéros de séquence soit retrouvés.

*NO

Les postes de journal masqués ne sont pas convertis pour la sortie.

*YES

Les postes de journal masqués sont convertis pour la sortie.

Identificateur de fichier (OBJFID)

Indique les noms qualifiés d'identificateurs de fichier (jusqu'à 300) pour lesquels les postes de journal sont convertis pour la sortie. 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 à convertir pour la sortie 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 convertis pour la sortie.
• 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 convertis pour la sortie.

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 convertis pour la sortie que s'ils satisfont aux valeurs indiquées pour les autres paramètres en plus des paramètres FID :
   • 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 converti pour la sortie.

identificateur-fichier

Les postes des objets identifiés par FID sont convertis pour la sortie.

Identificateur journal objet (OBJJID)

Indique jusqu'à 300 identificateurs de journal pour lesquels les postes de journal sont convertis pour la sortie. 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 convertis pour la sortie.

Sortie (OUTPUT)

Indique si la sortie générée par la commande est affichée sur le poste de travail à partir duquel elle a été émise, imprimée avec la sortie spoule du travail, ou envoyée dans le fichier base de données indiqué dans le paramètre Fichier recevant la sortie (OUTFILE).

Lorsque la sortie résultant de l'exécution de la commande est dirigée vers le poste de travail sur lequel cette dernière a été émise, les informations de base concernant les postes de journal sont affichées. Il est possible de sélectionner sur ce même écran une option permettant de visualiser les informations détaillées pour chaque poste de journal affiché.

Si la sortie résultant de l'exécution de la commande est imprimée avec la sortie spoule du travail, toutes les informations affichées sont imprimées. Le fichier QPDSPJRN de QSYS est employé pour la sortie imprimée.

*

La sortie est affichée (s'il s'agit d'un travail interactif) ou imprimée avec la sortie spoule du travail (s'il s'agit d'un travail par lots).

*PRINT

Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

*OUTFILE

La sortie est dirigée vers le fichier base de données indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE).

Format du fichier de sortie (OUTFILFMT)

Indique le format utilisé pour l'écriture des postes de journal dans le fichier de sortie mentionné pour le paramètre Fichier recevant la sortie (OUTFILE). Ce paramètre peut être indiqué uniquement si la valeur *OUTFILE est spécifiée pour le paramètre OUTPUT.

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 *TYPE1, *TYPE2, *TYPE3 et *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. Si, lors de la génération du fichier de sortie employant les formats *TYPE1, *TYPE2, *TYPE3, ou *TYPE4, un numéro de séquence ou un identificateur de cycle de validation d'une taille supérieure à 10 positions est trouvé, la zone est fixée à -1 pour l'enregistrement. A la fin de la génération du fichier de sortie, un message d'information (CPI7013) est ajouté à l'historique des travaux pour indiquer que ce fichier contient des informations incomplètes pour ces zones précises.

*TYPE1

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

Figure : Tableau 1 - Format de poste de journal OUTFILFMT(*TYPE1)

Nom de zone : Longueur : De : A =======================+==========+==========+========== Longueur du poste : 5 : 1 : 5 -----------------------+----------+----------+---------- Numéro de séquence (2) : 10 : 6 : 15 -----------------------+----------+----------+---------- Code journal : 1 : 16 : 16 -----------------------+----------+----------+---------- Type poste de journal : 2 : 17 : 18 -----------------------+----------+----------+---------- Date : 6 : 19 : 24 -----------------------+----------+----------+---------- Heure : 6 : 25 : 30 -----------------------+----------+----------+---------- Nom de travail : 10 : 31 : 40 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 41 : 50 -----------------------+----------+----------+---------- Numéro de travail : 6 : 51 : 56 -----------------------+----------+----------+---------- Nom de programme : 10 : 57 : 66 -----------------------+----------+----------+---------- Nom d'objet : 10 : 67 : 76 -----------------------+----------+----------+---------- Bibliothèque d'objets : 10 : 77 : 86 -----------------------+----------+----------+---------- Nom de membre : 10 : 87 : 96 -----------------------+----------+----------+---------- Nombre/RRN (3) : 10 : 97 : 106 -----------------------+----------+----------+---------- Indicateur : 1 : 107 : 107 -----------------------+----------+----------+---------- ID cycle validation (4): 10 : 108 : 117 -----------------------+----------+----------+---------- Données incomplètes : 1 : 118 : 118 -----------------------+----------+----------+---------- Données spécif. : 1 : 119 : 119 poste réduites : : : -----------------------+----------+----------+---------- Réservé : 6 : 120 : 125 -----------------------+----------+----------+---------- Données spécif. poste : 100 (1) : 126 : 225 ======================================================== Remarque : (1) Il s'agit de la longueur de zone du fichier base de données système QADSPJRN. Cependant, il est possible d'indiquer un longueur maximale de 32641 octets pour cette zone à l'aide du paramètre ENTDTALEN (2) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le numéro de séquence est supérieur à 10 positions. (3) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le nombre de postes appliqués ou enlevés ou le numéro d'enregistrement relatif est supérieur à 10 positions. (4) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si l'identificateur de cycle de validation est supérieur à 10 positions.

*TYPE2

Les postes convertis contiennent les données renvoyées lorsque OUTFILFMT(*TYPE1) est indiqué, ainsi que le nom du profil utilisateur attribué au travail ayant généré les postes affichés et le nom du système sur lequel les enregistrements de sortie ont été générés. Le tableau suivant affiche le format des informations de chaque poste de journal :

Figure : Tableau 2 - Format de poste de journal OUTFILFMT(*TYPE2)

Nom de zone : Longueur : De : A =======================+==========+==========+========== Longueur du poste : 5 : 1 : 5 -----------------------+----------+----------+---------- Numéro de séquence (2) : 10 : 6 : 15 -----------------------+----------+----------+---------- Code journal : 1 : 16 : 16 -----------------------+----------+----------+---------- Type poste de journal : 2 : 17 : 18 -----------------------+----------+----------+---------- Date : 6 : 19 : 24 -----------------------+----------+----------+---------- Heure : 6 : 25 : 30 -----------------------+----------+----------+---------- Nom de travail : 10 : 31 : 40 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 41 : 50 -----------------------+----------+----------+---------- Numéro de travail : 6 : 51 : 56 -----------------------+----------+----------+---------- Nom de programme : 10 : 57 : 66 -----------------------+----------+----------+---------- Nom d'objet : 10 : 67 : 76 -----------------------+----------+----------+---------- Bibliothèque d'objets : 10 : 77 : 86 -----------------------+----------+----------+---------- Nom de membre : 10 : 87 : 96 -----------------------+----------+----------+---------- Nombre/RRN (3) : 10 : 97 : 106 -----------------------+----------+----------+---------- Indicateur : 1 : 107 : 107 -----------------------+----------+----------+---------- ID cycle validation (4): 10 : 108 : 117 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 118 : 127 -----------------------+----------+----------+---------- Nom système : 8 : 128 : 135 -----------------------+----------+----------+---------- Données incomplètes : 1 : 136 : 136 -----------------------+----------+----------+---------- Données spécif. : 1 : 137 : 137 poste réduites : : : -----------------------+----------+----------+---------- Réservé : 18 : 138 : 155 -----------------------+----------+----------+---------- Données spécif. poste : 100 (1) : 156 : 255 ======================================================== Remarque : (1) Il s'agit de la longueur de zone du fichier base de données système QADSPJR2. Cependant, il est possible d'indiquer un longueur maximale de 32611 octets pour cette zone à l'aide du paramètre ENTDTALEN (2) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le numéro de séquence est supérieur à 10 positions. (3) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le nombre de postes appliqués ou enlevés ou le numéro d'enregistrement relatif est supérieur à 10 positions. (4) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si l'identificateur de cycle de validation est supérieur à 10 positions.

*TYPE3

Les postes de journal convertis contiennent toutes les données renvoyées lorsque OUTFILFMT(*TYPE2) est indiqué, ainsi que les indicateurs de valeur indéfinie. Le tableau suivant affiche le format des informations de chaque poste de journal converti :

Figure : Tableau 3 - Format de poste de journal OUTFILFMT(*TYPE3)

Nom de zone : Longueur : De : A =======================+==========+==========+========== Longueur du poste : 5 : 1 : 5 -----------------------+----------+----------+---------- Numéro de séquence (5) : 10 : 6 : 15 -----------------------+----------+----------+---------- Code journal : 1 : 16 : 16 -----------------------+----------+----------+---------- Type poste de journal : 2 : 17 : 18 -----------------------+----------+----------+---------- Horodatage (1) : 26 : 19 : 44 -----------------------+----------+----------+---------- Nom de travail : 10 : 45 : 54 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 55 : 64 -----------------------+----------+----------+---------- Numéro de travail : 6 : 65 : 70 -----------------------+----------+----------+---------- Nom de programme : 10 : 71 : 80 -----------------------+----------+----------+---------- Nom d'objet : 10 : 81 : 90 -----------------------+----------+----------+---------- Bibliothèque d'objets : 10 : 91 : 100 -----------------------+----------+----------+---------- Nom de membre : 10 : 101 : 110 -----------------------+----------+----------+---------- Nombre/RRN (6) : 10 : 111 : 120 -----------------------+----------+----------+---------- Indicateur : 1 : 121 : 121 -----------------------+----------+----------+---------- ID cycle validation (7): 10 : 122 : 131 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 132 : 141 -----------------------+----------+----------+---------- Nom système : 8 : 142 : 149 -----------------------+----------+----------+---------- Données incomplètes : 1 : 150 : 150 -----------------------+----------+----------+---------- Données spécif. : 1 : 151 : 151 poste réduites : : : -----------------------+----------+----------+---------- Réservé : 18 : 152 : 169 -----------------------+----------+----------+---------- Ind. valeur indéfinie : 52 (2,3) : 170 : 221 -----------------------+----------+----------+---------- Données spécif. poste : 102 (3,4): 222 : 323 ======================================================== Remarques : (1) La date et l'heure du poste figurent dans le format d'horodatage SAA 26 bits et non pas dans des zones de date et d'heure distinctes comme dans les formats *TYPE1 et *TYPE2. (2) Il s'agit d'une zone à longueur variable de 50 caractères du fichier base de données système, QADSPJR4. Cependant, une longueur maximale de 8000 caractères peut être indiquée pour cette zone à l'aide du paramètre NULLINDLEN. (3) Les deux premiers octets correspondent à la longueur de la zone de longueur variable suivis des données proprement dites si les zones sont de longueur variable. (4) Il s'agit d'une zone à longueur variable de 100 caractères du fichier base de données système, QADSPJR4. Cependant, une longueur maximale de 32596 caractères peut être indiquée pour cette zone à l'aide du paramètre ENTDTALEN s'il s'agit d'une zone de longueur fixe ; la zone des indicateurs de valeur indéfinie est également de longueur fixe. (5) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le numéro de séquence est supérieur à 10 positions. (6) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le nombre de postes appliqués ou enlevés ou le numéro d'enregistrement relatif est supérieur à 10 positions. (7) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si l'identificateur de cycle de validation est supérieur à 10 positions.

*TYPE4

Les postes de journal convertis contiennent les informations renvoyées lorsque OUTFILFMT(*TYPE3) est indiqué, l'identificateur de journal, l'indicateur de déclencheur de fichier physique et l'indicateur de contrainte référentielle. Le tableau suivant affiche le format des informations de chaque poste de journal converti :

Figure : Tableau 4 - Format de poste de journal OUTFILFMT(*TYPE4)

Nom de zone : Longueur : De : A =======================+==========+==========+========== Longueur du poste : 5 : 1 : 5 -----------------------+----------+----------+---------- Numéro de séquence (5) : 10 : 6 : 15 -----------------------+----------+----------+---------- Code journal : 1 : 16 : 16 -----------------------+----------+----------+---------- Type poste de journal : 2 : 17 : 18 -----------------------+----------+----------+---------- Horodatage (1) : 26 : 19 : 44 -----------------------+----------+----------+---------- Nom de travail : 10 : 45 : 54 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 55 : 64 -----------------------+----------+----------+---------- Numéro de travail : 6 : 65 : 70 -----------------------+----------+----------+---------- Nom de programme : 10 : 71 : 80 -----------------------+----------+----------+---------- Nom d'objet : 10 : 81 : 90 -----------------------+----------+----------+---------- Bibliothèque d'objets : 10 : 91 : 100 -----------------------+----------+----------+---------- Nom de membre : 10 : 101 : 110 -----------------------+----------+----------+---------- Nombre/RRN (6) : 10 : 111 : 120 -----------------------+----------+----------+---------- Indicateur : 1 : 121 : 121 -----------------------+----------+----------+---------- ID cycle validation (7): 10 : 122 : 131 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 132 : 141 -----------------------+----------+----------+---------- Nom système : 8 : 142 : 149 -----------------------+----------+----------+---------- Id. de journal : 10 : 150 : 159 -----------------------+----------+----------+---------- Contrainte : 1 : 160 : 160 référentielle : : : -----------------------+----------+----------+---------- Déclencheur : 1 : 161 : 161 -----------------------+----------+----------+---------- Données incomplètes : 1 : 162 : 162 -----------------------+----------+----------+---------- Ignorer pdt APYJRNCHG : 1 : 163 : 163 ou RMVJRNCHG : : : -----------------------+----------+----------+---------- Données spécif. : 1 : 164 : 164 poste réduites : : : -----------------------+----------+----------+---------- Réservé : 5 : 165 : 169 -----------------------+----------+----------+---------- Ind. valeur indéfinie : 52 : 170 (2,3): 221 -----------------------+----------+----------+---------- Données spécif. poste : 102 : 222 (3,4): 323 ======================================================== Remarques : (1) La date et l'heure du poste figurent dans le format d'horodatage SAA 26 bits et non pas dans des zones de date et d'heure distinctes comme dans les formats *TYPE1 et *TYPE2. (2) Il s'agit d'une zone à longueur variable de 50 caractères du fichier base de données système, QADSPJR4. Cependant, une longueur maximale de 8000 caractères peut être indiquée pour cette zone à l'aide du paramètre NULLINDLEN. (3) Les deux premiers octets correspondent à la longueur de la zone de longueur variable suivis des données proprement dites si les zones sont de longueur variable. (4) Il s'agit d'une zone à longueur variable de 100 caractères du fichier base de données système, QADSPJR4. Cependant, une longueur maximale de 32596 caractères peut être indiquée pour cette zone à l'aide du paramètre ENTDTALEN s'il s'agit d'une zone de longueur fixe ; la zone des indicateurs de valeur indéfinie est également de longueur fixe. (5) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le numéro de séquence est supérieur à 10 positions. (6) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si le nombre de postes appliqués ou enlevés ou le numéro d'enregistrement relatif est supérieur à 10 positions. (7) Quand la valeur de RCVSIZOPT est *MAXOPT3, cette zone prend la valeur -1 si l'identificateur de cycle de validation est supérieur à 10 positions.

*TYPE5

Les postes convertis 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, et du type d'objet. Le tableau suivant affiche le format des informations de chaque poste de journal converti :

Figure : Tableau 5 - Format de poste de journal OUTFILFMT(*TYPE5)

Nom de zone : Longueur : De : A =======================+==========+==========+========== Longueur du poste : 5 : 1 : 5 -----------------------+----------+----------+---------- Numéro de séquence : 20 : 6 : 25 -----------------------+----------+----------+---------- Code journal : 1 : 26 : 26 -----------------------+----------+----------+---------- Type poste de journal : 2 : 27 : 28 -----------------------+----------+----------+---------- Horodatage (1) : 26 : 29 : 54 -----------------------+----------+----------+---------- Nom de travail : 10 : 55 : 64 -----------------------+----------+----------+---------- Nom d'utilisateur : 10 : 65 : 74 -----------------------+----------+----------+---------- Numéro de travail : 6 : 75 : 80 -----------------------+----------+----------+---------- Nom de programme : 10 : 81 : 90 -----------------------+----------+----------+---------- Nom biblio. programme : 10 : 91 : 100 -----------------------+----------+----------+---------- Nom unité ASP : 10 : 101 : 110 biblio. programme : : : -----------------------+----------+----------+---------- Numéro ASP biblio. : 5 : 111 : 115 programme : : : -----------------------+----------+----------+---------- Nom d'objet : 10 : 116 : 125 -----------------------+----------+----------+---------- Bibliothèque d'objets : 10 : 126 : 135 -----------------------+----------+----------+---------- Nom de membre : 10 : 136 : 145 -----------------------+----------+----------+---------- Nombre/RRN : 20 : 146 : 165 -----------------------+----------+----------+---------- Indicateur : 1 : 166 : 166 -----------------------+----------+----------+---------- ID cycle validation : 20 : 167 : 186 -----------------------+----------+----------+---------- Profil utilisateur : 10 : 187 : 196 -----------------------+----------+----------+---------- Nom système : 8 : 197 : 204 -----------------------+----------+----------+---------- Id. de journal : 10 : 205 : 214 -----------------------+----------+----------+---------- Contrainte : 1 : 215 : 215 référentielle : : : -----------------------+----------+----------+---------- Déclencheur : 1 : 216 : 216 -----------------------+----------+----------+---------- Données incomplètes : 1 : 217 : 217 -----------------------+----------+----------+---------- Ignorer pdt APYJRNCHG : 1 : 218 : 218 ou RMVJRNCHG : : : -----------------------+----------+----------+---------- Données spécif. : 1 : 219 : 219 poste réduites : : : -----------------------+----------+----------+---------- Indicateur objet : 1 : 220 : 220 -----------------------+----------+----------+---------- Numéro séq. système : 20 : 221 : 240 -----------------------+----------+----------+---------- Nom récepteur : 10 : 241 : 250 -----------------------+----------+----------+---------- Nom biblio. récepteur : 10 : 251 : 260 -----------------------+----------+----------+---------- Nom unité ASP biblio. : 10 : 261 : 270 biblio. programme : : : -----------------------+----------+----------+---------- Numéro ASP biblio. : 5 : 271 : 275 programme : : : -----------------------+----------+----------+---------- Numéro ARM : 5 : 276 : 280 -----------------------+----------+----------+---------- ID unité exécution : 8 : 281 : 288 -----------------------+----------+----------+---------- ID unité exécution : 16 : 289 : 304 formaté : : : -----------------------+----------+----------+---------- Famille adresses : 1 : 305 : 305 -----------------------+----------+----------+---------- Port éloigné : 5 : 306 : 310 -----------------------+----------+----------+---------- Adresse éloignée : 46 : 311 : 356 -----------------------+----------+----------+---------- Unité logique travail : 39 : 357 : 395 -----------------------+----------+----------+---------- ID transaction : 140 : 396 : 535 -----------------------+----------+----------+---------- Type objet : 7 : 536 : 542 -----------------------+----------+----------+---------- Indic. type fichier : 1 : 543 : 543 -----------------------+----------+----------+---------- Niveau valid. imbriqué : 7 : 544 : 550 -----------------------+----------+----------+---------- Réservé : 5 : 551 : 555 -----------------------+----------+----------+---------- Ind. valeur indéfinie : 52 (2,3) : 556 : 607 -----------------------+----------+----------+---------- Données spécif. poste : 102 (3,4): 608 : 709 ======================================================== Remarques : (1) La date et l'heure du poste figurent dans le format d'horodatage SAA 26 bits et non pas dans des zones de date et d'heure distinctes comme dans les formats *TYPE1 et *TYPE2. (2) Il s'agit d'une zone à longueur variable de 50 caractères du fichier base de données système, QADSPJR5. Cependant, une longueur maximale de 8000 caractères peut être indiquée pour cette zone à l'aide du paramètre NULLINDLEN. (3) Les deux premiers octets correspondent à la longueur de la zone de longueur variable suivis des données proprement dites si les zones sont de longueur variable. (4) Il s'agit d'une zone à longueur variable de 100 caractères du fichier base de données système, QADSPJR5. Cependant, une longueur maximale de 32210 caractères peut être indiquée pour cette zone à l'aide du paramètre ENTDTALEN s'il s'agit d'une zone de longueur fixe ; la zone des indicateurs de valeur indéfinie est également de longueur fixe.

Fichier recevant la sortie (OUTFILE)

Indique le nom et la bibliothèque du fichier base de données destiné à recevoir le résultat de la commande. Si le fichier de sortie existe déjà, le système tente de l'utiliser. Les enregistrements peuvent remplacer les données du membre de fichier ou y être ajoutés. Si aucun enregistrement n'est écrit dans le fichier base de données (en raison des valeurs de sélection indiquées), et si la valeur *REPLACE est spécifiée pour le paramètre OUTMBR, les enregistrements sont mis à blanc dans le fichier base de données existant. Si le fichier n'existe pas, cette commande crée un fichier base de données dans la bibliothèque indiquée.

• Si un nouveau fichier est créé et que *TYPE1 est indiqué pour le paramètre OUTFILFMT, le système utilise comme modèle QADSPJRN de QSYS avec un nom de format QJORDJE.
• Si un nouveau fichier est créé et que *TYPE2 est indiqué pour le paramètre OUTFILFMT, le système utilise comme modèle QADSPJR2 de QSYS avec un nom de format QJORDJE2.
• Si un nouveau fichier est créé et que *TYPE3 est indiqué pour le paramètre OUTFILFMT, le système utilise comme modèle QADSPJR3 de QSYS avec un nom de format QJORDJE3.
• Si un nouveau fichier est créé et que *TYPE4 est indiqué pour le paramètre OUTFILFMT, le système utilise comme modèle QADSPJR4 de QSYS avec un nom de format QJORDJE4.
• Si un nouveau fichier est créé et que *TYPE5 est indiqué pour le paramètre OUTFILFMT, le système utilise comme modèle QADSPJR5 de QSYS avec un nom de format QJORDJE5.

Qualificatif 1 : Fichier recevant la sortie

nom-fichier

Indiquez le nom du fichier.

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.

Membre recevant la sortie (OUTMBR)

Indique le nom du membre de fichier base de données dans lequel est envoyée la sortie de la commande.

Elément 1 : Membre recevant la sortie

*FIRST

Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système en crée un du nom indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE). Si le membre existe, vous avez la possibilité d'ajouter de nouveaux enregistrements à la fin du membre existant ou de le mettre à blanc et de lui ajouter les nouveaux enregistrements.

nom

Indiquez le nom du membre de fichier destiné à recevoir la sortie. Si aucun membre de ce nom n'existe, le système le crée.

Elément 2 : Remplacement ou ajout enregs

*REPLACE

Le système met à blanc le membre existant et ajoute les nouveaux enregistrements.

*ADD

Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

Longueur données du poste (ENTDTALEN)

Indique la longueur de zone maximale admise pour la partie données spécifiques d'un poste de journal lorsque le fichier de sortie est créé par le système. Cette zone contient une portion de la partie variable des postes de journal (telle que l'image après des enregistrements pour les postes de mise à jour). Si le fichier de sortie existe déjà, ce paramètre n'est pas pris en compte.

Pour ce paramètre, une valeur particulière ou une liste de trois éléments peut être indiquée.

Remarque :Ce paramètre n'est correct que si OUTPUT(*OUTFILE) est spécifié.

Valeurs uniques

*OUTFILFMT

La longueur de la zone des données spécifiques d'un poste dans le fichier de sortie est définie par la valeur du paramètre Format du fichier de sortie (OUTFILFMT). Les attributs de cette zone sont identiques à ceux de la zone du même nom figurant dans le modèle de fichier de sortie correspondant fourni par le système.

Si *TYPE1 ou *TYPE2 est indiqué comme valeur du paramètre Format du fichier de sortie (OUTFILFMT), la zone des données spécifiques d'un poste dans le fichier base de données de sortie a une longueur fixe de 100 caractères.

Si *TYPE1 et *TYPE2 ne sont pas indiqués comme valeur du paramètre en regard de l'invite Format du fichier de sortie (OUTFILFMT), la zone des données spécifiques d'un poste dans le fichier de sortie est de longueur variable (100 caractères au maximum) et la longueur allouée est de 100 caractères. La capacité de la mémoire tampon est supérieure de 2 octets à la longueur maximale afin que la partie de la zone correspondant à la longueur soit prise en compte.

*CALC

Le système calcule la longueur de la zone des données spécifiques de façon à prendre en compte les données les plus longues parmi tous les postes de journal figurant dans la plage des récepteurs. La zone des données spécifiques est une zone alphanumérique de longueur fixe d'au minimum 130 caractères. Si la longueur calculée fait que celle du format d'enregistrement dépasse la longueur maximale d'enregistrement, un message est envoyé et la zone des données spécifiques est tronquée.

Si la longueur calculée par le système provoque le dépassement des 32766 octets admis pour la longueur du format d'enregistrement, un message de diagnostic est émis et la zone des données spécifiques est tronquée. Si *TYPE1 et *TYPE2 ne sont pas indiqués en regard de l'invite Format du fichier de sortie (paramètre OUTFILFMT), et si la zone des indicateurs de valeur indéfinie est à longueur variable, la longueur du format d'enregistrement ne doit pas dépasser 32740 octets.

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

*VARLEN

La zone des données spécifiques est une zone de longueur variable. Cette valeur ne peut être indiquée que lorsque OUTFILFMT(*TYPE1) ou OUTFILFMT(*TYPE2) ne sont pas mentionnés. Vous pouvez alors spécifier une valeur pour la longueur maximale de la zone ainsi que la longueur attribuée à la zone des données spécifiques.

longueur-zone

Indiquez une longueur de zone pour la partie du fichier de sortie réservée aux données spécifiques. Si *TYPE1 est indiqué pour le paramètre Format du fichier de sortie (OUTFILFMT), les valeurs correctes sont comprises entre 1 et 32641. Si *TYPE2 est indiqué sur le paramètre OUTFILFMT, les valeurs correctes sont comprises entre 1 et 32611. Si *TYPE3 ou *TYPE4 est indiqué sur le paramètre OUTFILFMT et que la zone des indicateurs de valeur indéfinie est à longueur fixe, les valeurs correctes sont comprises entre 1 et 32596. Si *TYPE5 est indiqué sur le paramètre OUTFILFMT et que la zone des indicateurs de valeur indéfinie est à longueur fixe, les valeurs correctes sont comprises entre 1 et 32210. Si *TYPE3 ou *TYPE4 est indiqué et que la zone des indicateurs de valeur indéfinie est à longueur variable, les valeurs correctes sont comprises entre 1 et 32570. Si *TYPE5 est indiqué et que la zone des indicateurs de valeur indéfinie est à longueur variable, les valeurs correctes sont comprises entre 1 et 32184.

Remarque :La somme des valeurs indiquées pour le paramètre Longueur données du poste (ENTDTALEN) et le paramètre Long indicateurs valeur indéf (NULLINDLEN) ne doit pas dépasser la longueur maximale d'enregistrement définie pour un fichier base de données (32740 ou 32766, selon que le fichier comporte des zones à longueur variable ou à longueur fixe respectivement).

Elément 2 : Longueur de zone variable

*CALC

Le système calcule la longueur maximale pour la zone des données spécifiques de façon à prendre en compte les données les plus longues parmi tous les postes de journal indiqués pour le récepteur. La longueur minimale de cette zone est de 130 octets. La capacité de la mémoire tampon correspondante est de 132 octets : 130 octets pour les données et 2 octets pour la partie de la zone correspondant à la longueur variable.

longueur-zone

Indiquez le nombre de caractères correspondant à la longueur maximale de zone. Si la zone des indicateurs de valeur indéfinie est de longueur fixe, les valeurs correctes sont comprises entre 1 et 32570. Si la zone des indicateurs de valeur indéfinie est à longueur variable, les valeurs correctes sont comprises entre 1 et 32185.

Elément 3 : Longueur allouée

*FLDLEN

La longueur allouée est égale à la longueur maximale de la zone.

longueur-allouée

Indiquez la longueur allouée. Si *CALC est mentionné pour la longueur maximale de la zone et si la valeur calculée pour cette dernière par le système est inférieure à la valeur allouée, la longueur maximale est adoptée. La valeur allouée ne peut dépasser la longueur maximale lorsque cette dernière est indiquée.

Le tableau suivant décrit l'intervalle de valeurs du paramètre ENTDTALEN :

Format    : Format    : Format    : Longueur  : Longueur
fichier   : données   : indic     : données   : enregistrement
sortie    : spécif    : valeur    : poste     : maximale
          :           :           :           :
==========+===========+===========+===========+===========
*TYPE1    : Fixe      : Non       : 1 à 32641 : 32766
          :           : applicable:           :
          :           :           :           :
----------+-----------+-----------+-----------+-----------
*TYPE2    : Fixe      : Non       : 1 à 32611 : 32766
          :           : applicable:           :
          :           :           :           :
----------+-----------+-----------+-----------+-----------
*TYPE3    : Fixe      : Fixe      : 1 à 32596 : 32766
----------+-----------+-----------+-----------+-----------
*TYPE3    : Fixe      : Variable  : 1 à 32570 : 32740
----------+-----------+-----------+-----------+-----------
*TYPE3    : Variable  : Fixe      : 1 à 32570 : 32740
----------+-----------+-----------+-----------+-----------
*TYPE3    : Variable  : Variable  : 1 à 32568 : 32738
----------+-----------+-----------+-----------+-----------
*TYPE4    : Fixe      : Fixe      : 1 à 32596 : 32766
----------+-----------+-----------+-----------+-----------
*TYPE4    : Fixe      : Variable  : 1 à 32570 : 32740
----------+-----------+-----------+-----------+-----------
*TYPE4    : Variable  : Fixe      : 1 à 32570 : 32740
----------+-----------+-----------+-----------+-----------
*TYPE4    : Variable  : Variable  : 1 à 32568 : 32738
----------+-----------+-----------+-----------+-----------
*TYPE5    : Fixe      : Fixe      : 1 à 32210 : 32766
----------+-----------+-----------+-----------+-----------
*TYPE5    : Fixe      : Variable  : 1 à 32184 : 32740
----------+-----------+-----------+-----------+-----------
*TYPE5    : Variable  : Fixe      : 1 à 32184 : 32740
----------+-----------+-----------+-----------+-----------
*TYPE5    : Variable  : Variable  : 1 à 32182 : 32738
==========================================================
Remarque :
Quand le fichier contient des zones de longueur variable,
la longueur d'enregistrement maximale n'inclut pas les deux octets de
chaque zone de longueur variable.

Long indicateurs valeur indéf (NULLINDLEN)

Indique la longueur réservée à la zone des indicateurs de valeur indéfinie lorsque le fichier de sortie est créé par le système. Ce paramètre ne peut être indiqué que lorsque OUTFILFMT(*TYPE1) ou OUTFILFMT(*TYPE2) ne sont pas mentionnés.

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

Valeurs uniques

*OUTFILFMT

La zone des indicateurs de valeur indéfinie possède les mêmes attributs que la zone correspondante dans le modèle de fichier de sortie fourni par le système (QADSPJR3, QADSPJR4 ou QADSPJR5). Cette zone alphanumérique de longueur variable présente une longueur maximale et une longueur allouée de 50 caractères chacune. La capacité de la mémoire tampon est supérieure de 2 octets à la longueur maximale afin que la partie de la zone correspondant à la longueur soit prise en compte.

*CALC

Le système calcule la longueur de la zone de façon à prendre en compte le nombre maximal d'indicateurs de valeur indéfinie parmi tous les postes de journal indiqués pour le récepteur. Il s'agit ici d'une zone alphanumérique de longueur fixe. Pour être prise en compte lors de la création du fichier de sortie, cette zone doit comporter au moins un caractère. Si la longueur calculée par le système provoque le dépassement des 32766 octets admis pour la longueur du format d'enregistrement, un message de diagnostic est émis et la zone des indicateurs de valeur indéfinie est tronquée. Si la zone des données spécifiques est de longueur variable, la longueur du format d'enregistrement ne doit pas dépasser 32740 octets.

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

*VARLEN

Pour une zone à longueur variable, indiquez *VARLEN comme premier élément et les longueurs de zone pour les deux derniers éléments (ou laissez le système utiliser les valeurs par défaut). La zone des indicateurs de valeur indéfinie est de longueur variable. Lorsque vous utilisez *VARLEN, vous devez également indiquer la longueur maximale et la longueur allouée de la zone.

longueur-zone

Indiquez la longueur de la zone. Les valeurs admises sont comprises entre 1 et 8000 caractères. Pour que cette zone soit prise en compte lors de la création du fichier de sortie, le système requiert qu'elle comporte une valeur définie. Dans ce cas, la zone des indicateurs de valeur indéfinie est à longueur fixe.

Elément 2 : Longueur de zone variable

*CALC

Le système calcule la longueur de la zone des indicateurs de valeur indéfinie de façon à prendre en compte le nombre maximal d'indicateurs parmi tous les postes de journal indiqués pour le récepteur. Pour être prise en compte lors de la création du fichier de sortie, cette zone doit comporter au moins un caractère. La capacité de la mémoire tampon correspondante est de 3 octets : 1 octet pour les données et 2 octets pour la partie de la zone correspondant à la longueur.

longueur-zone

Indiquez la longueur de zone maximale. Les valeurs admises sont comprises entre 1 et 8000 caractères.

Elément 3 : Longueur allouée

*FLDLEN

La longueur allouée est égale à la longueur de zone maximale.

longueur-allouée

Indiquez la longueur allouée. Les valeurs admises sont comprises entre 1 et 8000 caractères. Si *CALC est indiqué pour la longueur de zone maximale, et si la longueur calculée par le système est inférieure à la longueur allouée que vous indiquez, cette dernière prend la valeur de la longueur maximale. Si une longueur de zone maximale est explicitement indiquée, la longueur allouée ne doit pas lui être supérieure.

Le tableau suivant décrit l'intervalle de valeurs du paramètre NULLINDLEN :

Format    : Format    : Format    : Longueur  : Longueur
fichier   : données   : indic     : indic     : maximale
sortie    : spécif    : valeur    : ligne     : enr
          :           :           :           :
==========+===========+===========+===========+===========
*TYPE3    : Fixe      : Fixe      : 1 à 8000  : 32766
----------+-----------+-----------+-----------+-----------
*TYPE3    : Fixe      : Variable  : 1 à 8000  : 32740
----------+-----------+-----------+-----------+-----------
*TYPE3    : Variable  : Fixe      : 1 à 8000  : 32740
----------+-----------+-----------+-----------+-----------
*TYPE3    : Variable  : Variable  : 1 à 8000  : 32738
----------+-----------+-----------+-----------+-----------
*TYPE4    : Fixe      : Fixe      : 1 à 8000  : 32766
----------+-----------+-----------+-----------+-----------
*TYPE4    : Fixe      : Variable  : 1 à 8000  : 32740
----------+-----------+-----------+-----------+-----------
*TYPE4    : Variable  : Fixe      : 1 à 8000  : 32740
----------+-----------+-----------+-----------+-----------
*TYPE4    : Variable  : Variable  : 1 à 8000  : 32738
----------+-----------+-----------+-----------+-----------
*TYPE5    : Fixe      : Fixe      : 1 à 8000  : 32766
----------+-----------+-----------+-----------+-----------
*TYPE5    : Fixe      : Variable  : 1 à 8000  : 32740
----------+-----------+-----------+-----------+-----------
*TYPE5    : Variable  : Fixe      : 1 à 8000  : 32740
----------+-----------+-----------+-----------+-----------
*TYPE5    : Variable  : Variable  : 1 à 8000  : 32738
==========================================================
Remarque :
Quand le fichier contient des zones de longueur variable,
la longueur d'enregistrement maximale n'inclut pas les deux octets de
chaque zone de longueur variable.

Inclure postes (INCENT)

Indique si seuls les postes de journal confirmés ou ceux-ci ainsi que les postes non confirmés sont convertis pour la sortie. 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 ayant été confirmés sont convertis pour la sortie.

*ALL

Tous les postes de journal (confirmés ou non confirmés) sont convertis pour la sortie.

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

Indique le premier poste de journal à convertir dans un format propre à une représentation externe.

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 conversion commence à partir du premier poste de la plage de récepteurs indiquée.

numéro-séquence-début

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

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

Indique le dernier poste de journal à convertir.

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 conversion s'arrête au dernier poste de la plage de récepteurs de journal indiquée.

numéro-séquence-fin

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

ID cycle de validation (CMTCYCID)

Indique que la sélection des postes de journal à convertir 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.

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 à convertir 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 à convertir. La plage de valeurs admises s'étend de 1 à 9 999 999 999.

Unité ASP (ASPDEV)

Indique l'unité ASP (pool de mémoire secondaire) dans lequel se trouve le journal.

*

La recherche de la bibliothèque s'effectue dans tous les ASP présents dans l'espace de nom de bibliothèque de l'unité d'exécution. Cela inclut le l'ASP système (ASP 1), tous les ASP utilisateur de base définis (ASP 2-32) et, si l'unité d'exécution comporte un groupe ASP, tous les ASP primaires et secondaires du groupe ASP.

nom

Indiquez le nom de l'unité ASP primaire et secondaire dans lequel rechercher la bibliothèque. L'ASP primaire ou secondaire doit être activé (en mettant l'unité ASP en fonction) et être à l'état Disponible. L'ASP système (ASP 1) est les ASP utilisateur de base définis (ASP 2 à 32) ne seront pas recherchés.

Remarque :Pour indiquer le nom d'unité d'un pool de mémoire secondaire (ASP) particulier, vous devez utiliser le droits d'accès (*USE) pour chaque unité ASP du groupe ASP.

Exemples

Exemple 1 : Conversion de poste de journal en vue de leur affichage

DSPJRN   JRN(MYLIB/JRNLA)

Quand elle est exécutée à un poste de travail, cette commande convertit et affiche les premiers postes du journal dans le récepteur de journal qui était attaché, au moment lors du lancement de la conversion des postes, au journal JRNLA de la bibliothèque MYLIB. Les postes suivants s'affichent quand on appuie sur la touche Page Suivante. Quand elle s'exécute à partir d'un travail par lots, la commande suivante imprime tous les postes de journal convertis vers la sortie imprimante spoule du travail. Représente la partie données spécifiques des poste de journal au format alphanumérique.

Exemple 2 : Conversion de postes de journal vers un fichier de sortie

DSPJRN   JRN(MYLIB/JRNLA)
         FILE((LIB1/A MBR3) (LIB1/C) (LIB2/*ALL *ALL))
         RCVRNG((RCVLIB/RCV27 RCVLIB/RCV30))
         FROMENT(4736)  ENTTYP(UP DL)
         JOB(000666/QPGMR/WORKST01)
         PGM(TSTPGMA)  ENTDTALEN(280)
         OUTPUT(*OUTFILE)  OUTFILE(MYLIB/JRNENTFIL1)

Cette commande convertit les postes de journal sélectionnés dans la chaîne de récepteurs de journal (du récepteur RCV27 de la bibliothèque RCVLIB au récepteur RCV30 de la bibliothèque RCVLIB) associé à JRNLA dans la bibliothèque MYLIB, et les place dans le premier membre du fichier base de données JRNENTFIL1 de la bibliothèque MYLIB. Si le fichier base de données n'existe pas, il est créé avec le format de QJORDJE. La dernière zone du format a une longueur de 280 octets. Le premier poste de journal écrit dans le fichier de sortie porte le numéro de séquence 4736. Seuls les postes correspondant à des mises à jour et à des suppressions effectuées par le programme TSTPGMA du travail 000666/QPGMR/WORKST01 dans le membre MBR3 du fichier A de la bibliothèque LIB1, le premier membre du fichier C de la bibliothèque LIB1, et tous les membres de tous les fichiers de la bibliothèque LIB2 sont écrits dans le fichier de sortie.

Exemple 3 : Conversion de postes de journal pour un profil utilisateur précis

DSPJRN   JRN(SS/J)  FILE(SS1/PF)  RCVRNG((SS/R1  *CURRENT))
         JRNCDE(F)  USRPRF(MAC7)
         OUTFILE(FMTLIB/ENTFILE)  OUTFILFMT(*TYPE2)

Cette commande convertit des postes de journal sélectionnés dans la plage de récepteurs de journal. La plage est comprise entre le récepteur de journal R1 de la bibliothèque SS et le récepteur de journal attaché au journal J de la bibliothèque (au moment du lancement de la conversion). Les postes sont placés dans le premier membre du fichier base de données ENTFILE de la bibliothèque FMTLIB. Si le fichier n'existe pas, il est créé avec le format QJORDJE2. La dernière zone du format a une longueur de 100 octets. Seuls les postes créées par l'utilisateur MAC7 dans le premier membre du fichier PF de la bibliothèque SS1 sont écrits dans le fichier de sortie.

Exemple 4 : Conversion de postes de journal avec indication de longueur de zone de données indéfinie

DSPJRN   JRN(LIBPROD/PRODJRN)  FILE(APPLIB/PFILE)
         OUTFILFMT(*TYPE5)  OUTFILE(JRNLIB/ENTFILE)
         ENTDTALEN(*VARLEN 500 100)  NULLINDLEN(25)

Cette commande convertit les postes de journal sélectionné depuis le récepteur attaché (lors du lancement de l'opération) dans le journal PRODJRN de la bibliothèque LIBPROD. Les postes sont placés dans le premier membre du fichier base de données ENTFILE de la bibliothèque JRNLIB. Si le fichier n'existe pas, il est créé avec le format QJORDJE5. La zone de données spécifiques d'un poste a une longueur variable maximale de 500 caractères et une longueur allouée de 100 caractères. La zone des indicateurs de valeur indéfinie est fixée à 25 caractères. Seuls les postes du fichier PFILE de la bibliothèque APPLIB et du premier membre du fichier sont écrits dans le fichier de sortie.

Exemple 5 : Conversion de postes de journal avec indication de longueur de zone de données indéfinie calculée

DSPJRN   JRN(JRNLIB/JRNA)  FILE(FILLIB/FILEA)
         ENTTYP(UP DL)  OUTPUT(*OUTFILE)
         OUTFILFMT(*TYPE5)  OUTFILE(ENTLIB/ENTFILE)
         ENTDTALEN(*CALC)  NULLINDLEN(*VARLEN *CALC *FLDLEN)

Cette commande convertit uniquement les postes de journal UP (mise à jour d'enregistrement) et DL (suppression d'enregistrement) pour le premier membre du fichier PFILEA de la bibliothèque FILLIB depuis le récepteur de journal attaché (lors du lancement de l'opération) vers le journal JRNA de la bibliothèque JRNLIB. Les postes sont écrits dans le premier membre du fichier base de données ENTFILE de la bibliothèque ENTLIB. Si le fichier n'existe pas, il est créé avec le format QJORDJE5. Le système calcule la longueur de la zone de données de longueur fixe spécifique au poste. Il calcule également la longueur de la zone d'indicateurs de valeur indéfinie de longueur variable. La longueur allouée est égale à la longueur maximale de la zone.

Exemple 6 : Conversion de postes de journal à l'aide de *IGNFILSLT et de *CURCHAIN

DSPJRN   JRN(JRNLIB/JRNA)  FILE(FILLIB/FILEA)
         RCVRNG(*CURCHAIN)
         JRNCDE((F *ALLSLT) (R *ALLSLT) (U *IGNFILSLT))
         OUTPUT(*PRINT)

Cette commande convertit des postes de journal avec :

• des informations de niveau fichier pour le fichier FILEA de la bibliothèque FILLIB et pour le premier membre du fichier.
• des informations de niveau enregistrement pour le premier membre du fichier FILEA de la bibliothèque FILLIB,
• des postes de journal générés par l'utilisateur même si le poste est associé à un membre de fichier journalisé.

Les postes de journal sont convertis à partir de la chaîne de récepteurs de journal, qui appartiennent à la plage de récepteurs compris entre la dernière rupture de chaîne et le récepteur de journal qui était attaché lors du lancement de la conversion des postes, associée au journal JRNA de la bibliothèque JRNLIB. Les postes convertis sont écrits dans un fichier d'impression.

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

DSPJRN   JRN(LIBPROD/PRODJRN)
         OBJ((APPLIB/D1 *DTAARA) (APPLIB/D2 *DTAQ)
         (APPLIB/D3 *FILE *NONE))
         OBJPATH(('/mydirectory')) SUBTREE(*YES)
         OUTFILFMT(*TYPE5)  OUTFILE(JRNLIB/ENTFILE)

Cette commande convertit les postes de journal sélectionné depuis le récepteur attaché (lors du lancement de l'opération) dans le journal PRODJRN de la bibliothèque LIBPROD. Les postes sont placés dans le premier membre du fichier base de données ENTFILE de la bibliothèque JRNLIB. Si le fichier n'existe pas, il est créé avec le format QJORDJE5. Seuls les postes associés aux objets indiqués sont convertis. Ces objets constituent une zone de données dans la bibliothèque APPLIB appelée D1, une file d'attente dans la bibliothèque APPLIB appelée D2, et un fichier base de données D3 dans la bibliothèque APPLIB, ainsi que le répertoire '/mydirectory' et tous les répertoires, fichiers de flux et liens symboliques dans ce répertoire ou dans l'un de ces sous-répertoires.

Messages d'erreur

Messages *ESCAPE

CPF70A9

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

CPF70AC

Objet de l'ID-fichier &1 introuvable.

CPF70AE

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

CPF70C3

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

CPF7002

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

CPF7006

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

CPF7007

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

CPF701B

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

CPF705C

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

CPF7053

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

CPF7054

Valeurs des paramètres FROM et TO incorrectes.

CPF7055

Nombre maximal d'objets dépassé.

CPF7057

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

CPF706B

Non autorisé à indiquer le paramètre JRN(*INTSYSJRN).

CPF706C

Valeur &1 incorrecte pour le paramètre JRNID.

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

CPF707A

Valeur incorrecte pour ENTDTALEN.

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.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9846

Erreur lors du traitement du fichier &1 de &2.

CPF9847

Erreur lors de la fermeture du fichier &1 de bibliothèque &2.

CPF9850

Substitution non admise pour fichier imprimante &1.

CPF9860

Erreur lors du traitement du fichier de sortie.

CPF9871

Erreur lors du traitement.

CPF9875

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