WRKJRNA

La commande WRKJRNA (Gérer les attributs de journal) permet d'afficher ou d'imprimer les attributs de création et les attributs en vigueur d'un journal, y compris le noms du récepteur en cours. Lorsque vous entrez cette commande, l'écran principal qui apparaît vous propose des options ou des fonctions vous permettant d'afficher les noms des objets en cours de journalisation, les noms de tous les journaux éloignés associés à ce journal et des informations détaillées sur un journal éloigné, le répertoire de récepteurs, ou des informations détaillées sur un récepteur de journal. Vous pouvez également supprimer des récepteurs du répertoire.

La commande permet également de générer un fichier de sortie dressant la liste des objets journalisés.

Si la sortie est imprimée avec la sortie spoule du travail alors que DETAIL(*OUTPUT) est indiqué, toutes les informations éventuellement affichées s'impriment, sauf :

• les informations détaillées sur des récepteurs de journal ; pour les consulter, utilisez la commande DSPJRNRCVA.
• les informations détaillées sur les entrées de répertoire de base de données relationnelle associées aux journaux éloignés.

Lorsque OUTPUT(*PRINT) est choisi, le paramètre DETAIL permet de créer des sous-ensembles d'informations imprimées. Il est possible d'indiquer une ou plusieurs valeurs pour *CURATR, *RCVDIR, *RMTJRN, *JRNFILE, *JRNAP, *JRNDTAQ, *JRNDTAARA, *JRNLIB et *JRNIFS.

Si la sortie est dirigée vers un fichier, seules les informations journalisées y sont écrites. Lorsque OUTPUT(*OUTFILE) est choisi, le paramètre DETAIL permet de créer des sous-ensembles d'informations envoyées au fichier d'imprimante. Il est possible d'indiquer une ou plusieurs valeurs pour *JRNFILE, *JRNAP, *JRNDTAQ, *JRNDTAARA, *JRNIFS, *JRNLIB et *IMPLICIT.

Paramètres

Journal (JRN)

Indique le journal dont les attributs doivent être affichés.

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 :Vous devez disposer du droit spécial d'accès à tous les objets (*ALLOBJ) pour indiquer JRN(*INTSYSJRN).

Remarque :Le paramètre DETAIL(*OUTPUT) est obligatoire mais le paramètre OUTPUT(*OUTFILE) est interdit si la valeur *INTSYSJRN est indiquée.

Remarque :Les paramètres OUTFILE et DETAIL sont interdits si la valeur *INTSYSJRN est indiquée.

Qualificatif 1 : Journal

nom

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.

Sortie (OUTPUT)

Indique la destination de la sortie générée par la commande.

*

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

Remarque :Le fichier QPDSPJNA est employé pour la sortie imprimée. Le fichier QAWRKJRNA est employé pour la sortie des modèles. Le nom du format est QJOWRKJRNA.

Détail (DETAIL)

Indique le type des informations dirigées vers le fichier imprimante ou le fichier de sortie.

Valeurs uniques

*OUTPUT

Les informations envoyées vers le fichier imprimante ou le fichier de sortie dépendront de la valeur indiquée dans le paramètre OUTPUT. Lorsque *OUTPUT est sélectionné, il se peut que le paramètre DETAIL n'ait pas d'autres valeurs.

Si OUTPUT(*PRINT) a été sélectionné, indiquer DETAIL(*OUTPUT) a le même effet que sélectionner toutes les valeurs de paramètre suivantes pour DETAIL : *CURATR, *RCVDIR, *RMTJRN, *JRNFILE, *JRNAP, *JRNDTAQ, *JRNDTAARA, *JRNLIB et *JRNIFS.

Si OUTPUT(*OUTFILE) a été sélectionné, indiquer DETAIL(*OUTPUT) a le même effet que sélectionner toutes les valeurs de paramètres suivantes pour DETAIL : *JRNFILE, *JRNAP, *JRNDTAQ, *JRNDTARA, *JRNLIB et *JRNIFS.

Autres valeurs (jusqu'à 9 répétitions)

*CURATR

Le fichier imprimante contiendra les attributs de création et de fonctionnement du journal. Cette valeur est incompatible avec OUTPUT(*OUTFILE).

*RCVDIR

Le fichier imprimante contiendra les noms des récepteurs de journal actuellement associés au journal. Ce poste contiendra également certaines informations d'attributs sur le récepteur de journal. Cette valeur est incompatible avec OUTPUT(*OUTFILE).

*RMTJRN

Le fichier imprimante affiche les attributs de journal éloigné en cours définis pour ce journal ainsi que des informations sur le ou les journaux éloignés qui lui sont associés. Cette valeur est incompatible avec OUTPUT(*OUTFILE).

*JRNFILE

Le fichier imprimante ou le fichier de sortie contiendra la liste des noms de fichier physique et logique et des noms de bibliothèque des fichiers en cours de journalisation. De plus, le fichier imprimante comportera un nombre de fichiers et un nombre de membres consignés dans ce journal.

*JRNAP

Le fichier imprimante ou le fichier de sortie contiendra la liste des noms de fichier et des noms de bibliothèque des fichiers pour tous les chemins d'accès en cours de journalisation. De plus, le fichier imprimante comportera un nombre de fichiers et un nombre de chemins d'accès consignés dans ce journal.

*JRNDTAARA

Le fichier imprimante ou le fichier de sortie contiendra la liste des zones de données et des noms de bibliothèque des fichiers pour toutes les zones de données en cours de journalisation. De plus, le fichier imprimante comportera un nombre de zones de données consignées dans ce journal.

*JRNDTAQ

Le fichier imprimante ou le fichier de sortie contiendra la liste des files d'attente de données et des noms de bibliothèque pour toutes les files d'attente de données en cours de journalisation. De plus, le fichier imprimante comportera un nombre de files d'attente de données consignées dans ce journal.

*JRNIFS

Le fichier ou le fichier de sortie contiendra la liste des objets IFS pour tous les objets IFS en cours de journalisation. De plus, le fichier imprimante comportera un nombre d'objets IFS consignés dans ce journal.

*JRNLIB

Le fichier imprimante ou le fichier de sortie contiendra la liste de tous les noms des bibliothèques en cours de journalisation. De plus, le fichier imprimante comportera le nombre de bibliothèques consignées dans ce journal.

*IMPLICIT

Le fichier de sortie comportera la liste de tous les objets consignés implicitement dans le journal. Il contiendra des objets tels que des récepteurs de journal, des définitions de validation et des objets requis à des fins de rétablissement système. Cette valeur est incompatible avec OUTPUT(*PRINT).

Remarque :Cette valeur doit être indiquée avec le paramètre DETAIL pour permettre l'extraction de ces informations.

Fichier recevant la sortie (OUTFILE)

Indique le fichier de base de données vers lequel la sortie générée par la commande est dirigée. Si ce fichier n'existe pas, la commande en crée un dans la bibliothèque précisée. S'il existe déjà, les droits publics sur le fichier sont les mêmes que le droit de création de la pour la bibliothèque contenant le fichier. Pour afficher ce droit, utilisez la commande DSPLIBD (Afficher une description de bibliothèque).

Qualificatif 1 : Fichier recevant la sortie

nom

Indiquez le nom du fichier de base de données vers lequel la sortie générée de la commande est dirigée.

Qualificateur 2: Biblio

*LIBL

Le fichier est recherché dans la liste des bibliothèques. Si le système ne le trouve pas, il en crée un dans la bibliothèque en cours. S'il n'existe pas de bibliothèque en cours, le fichier est créé dans la bibliothèque QGPL.

*CURLIB

Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Remarque :Si un fichier est créé, le système utilise QAWRKJRNA de QSYS avec le nom de format QJOWRKJRNA comme modèle.

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.

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

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 : Exemple simple de commande

WRKJRNA   JRN(MYLIB/JRNLA)

Cette commande permet de gérer les attributs actuels du journal JRNLA de la bibliothèque MYLIB.

Exemple 2 : Commandes plus complexes pour *PRINT

WRKJRNA   JRN(YOURLIB2/JRNLB) OUTPUT(*PRINT)
          DETAIL(*OUTPUT)
WRKJRNA   JRN(YOURLIB2/JRNLB) OUTPUT(*PRINT)
          DETAIL(*CURATR *RCVDIR *JRNFILE *JRNAP
                 *JRNDTAQ *JRNDTAARA *JRNIFS *RMTJRN)

Ces deux commandes affichent des informations relatives au journal JRNLB de la bibliothèque YOURLIB2. Plus particulièrement, elles impriment des informations relatives aux attributs de journal, des informations sur les récepteurs associés au journal, des informations de journal éloigné, une liste de fichiers en cours de journalisation, une liste de chemins d'accès en cours de journalisation, une liste de files d'attente en cours de journalisation, une liste de zones de données en cours de journalisation et une liste d'objets IFS en cours de journalisation.

Exemple 3 : Commandes plus complexes pour *OUTFILE

WRKJRNA   JRN(YOURLIB3/JRNLC) OUTPUT(*OUTFILE)
          OUTFILE(YOURLIB3/MYOUTFILE)
          DETAIL(*OUTPUT)
WRKJRNA   JRN(YOURLIB3/JRNLC) OUTPUT(*OUTFILE)
          OUTFILE(YOURLIB3/MYOUTFILE)
          DETAIL(*JRNFILE *JRNAP *JRNDTAQ
                 *JRNDTAARA *JRNIFS)

Ces deux commandes créent le fichier de sortie MYOUTFILE dans la bibliothèque YOURLIB3 contenant des informations relatives au journal JRNLC dans la bibliothèque YOURLIB3. Spécifiquement, les informations écrites dans le fichier de sortie comprennent plusieurs listes d'éléments en course fichiers en cours de journalisation : fichiers, chemins d'accès, files d'attente de données, zones de données, objets IFS.

Exemple 4 : Sélection d'informations spécifiques à imprimer

WRKJRNA   JRN(YOURLIB4/JRNLD) OUTPUT(*PRINT)
          DETAIL(*CURATR *JRNFILE)

Cette commande imprime des informations liées au journal JRNLD de la bibliothèque YOURLIB4. Les informations collectées sont un sous-ensemble d'informations relatives au journal. Il s'agit particulièrement des attributs de journal et d'une liste de fichiers en cours de journalisation.

Exemple 5 : Sélection d'informations spécifiques à envoyer à un fichier

WRKJRNA   JRN(YOURLIB5/JRNLE) OUTPUT(*OUTFILE)
          OUTFILE(YOURLIB5/MYOUTFILE)
          DETAIL(*JRNFILE *JRNDTAARA *IMPLICIT)

Cette commande crée le fichier de sortie MYOUTFILE dans la bibliothèque YOURLIB5 contenant des informations relatives au journal JRNLE dans la bibliothèque YOURLIB5. Les informations collectées sont un sous-ensemble d'informations relatives au journal. En particulier, les informations sur les fichiers journalisés, les zones de données journalisées et les objets en cours de journalisation implicite.

Messages d'erreur

Messages *ESCAPE

CPF69A7

La valeur DETAIL définie n'est pas admise avec la valeur OUTPUT.

CPF69A9

Erreur interne détectée, code raison &2.

CPF70FF

Echec de la fonction de journal système interne.

CPF701B

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

CPF702C

Un récepteur attaché a été détruit.

CPF706B

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

CPF706C

Valeur &1 incorrecte pour le paramètre JRNID.

CPF708D

Récepteur de journal endommagé au niveau logique.

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.

CPF9810

Bibliothèque &1 non trouvée.

CPF9820

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

CPF9825

Accès non autorisé à l'unité &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.