SNDJRNE

Envoyer un poste dans journal

En bref

La commande SNDJRNE permet d'écrire un seul poste dans un journal spécifique.

SNDJRNE se lit SND (Envoyer) + JRNE. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

SNDJRNE JRN(…)

Paramètres

JRN Journal obligatoire
TYPE Type de poste de journal
ENTDTA Donnée du poste
FILE Fichier physique journalisé
OBJ Objet
OBJPATH Objet
OBJFID Identificateur de fichier
FORCE Forcer poste journal
OVRSTATE Substitution état du journal
OVRRMTFTR Substituer le filtre éloigné

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

Aide IBM i de la commande

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

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Oui

La commande SNDJRNE permet d'écrire un seul poste dans un journal spécifique. Le poste peut contenir des informations. L'utilisateur peut attribuer un type au poste de journal et associer le poste de journal à un objet journalisé indiqué.

Si l'état du journal est *STANDBY, le poste de journal ne sera pas consigné à moins que OVRSTATE(*STANDBY) ne soit indiqué.

Le code journal du poste est U qui indique un poste de journal défini par l'utilisateur.

Remarque :L'API QJOSJRNE (envoi de poste de journal) peut également être utilisée pour écrire un poste spécifié par l'utilisateur dans un journal spécifique. Le recours à cette API peut améliorer les performances et fournir des fonctions non disponibles avec cette commande. Pour plus d'informations, reportez-vous au manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Restrictions :

Si un objet autre qu'un fichier est indiqué, il doit être en cours de transmission vers le journal indiqué.
Si un objet de type fichier est indiqué, il doit être en cours de transmission vers le journal indiqué ou sa dernière journalisation doit avoir été effectuée vers celui-ci.
Vous ne pouvez pas indiquer de journal éloigné.
Le journal indiqué ne peut pas être défini sur l'état *INACTIVE.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
JRN	Journal	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Journal	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
TYPE	Type de poste de journal	Valeur caractère, 00	Facultatif, positionnel 2
ENTDTA	Donnée du poste	Valeur caractère, *BLANK	Facultatif, positionnel 3
FILE	Fichier physique journalisé	Valeurs uniques: NONE Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Fichier physique	Nom d'objet qualifié
	Qualificatif 1: Fichier physique	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
	Élément 2: Membre	Nom, FIRST, NONE
OBJ	Objet	Valeurs uniques: NONE Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Objet	Nom d'objet qualifié
	Qualificatif 1: Objet	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
	Élément 2: Type d'objet	FILE, DTAARA, DTAQ, LIB
	Élément 3: Membre	Nom, FIRST, NONE
OBJPATH	Objet	Chemin d'accès, *NONE	Facultatif
OBJFID	Identificateur de fichier	Valeur hexadécimale, *NONE	Facultatif
FORCE	Forcer poste journal	NO, YES	Facultatif
OVRSTATE	Substitution état du journal	NONE, STANDBY	Facultatif
OVRRMTFTR	Substituer le filtre éloigné	NONE, FTROBJ	Facultatif

Journal (JRN)

Indique le journal devant contenir le nouveau poste de journal.

Ce paramètre est obligatoire.

Qualificatif 1 : Journal

nom-journal: Indiquez le nom du journal devant contenir le nouveau poste de 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.

Type de poste de journal (TYPE)

Indique le type de ce poste de journal.

00: Le poste de journal a pour type '00' (hex F0F0).
type-poste: Indiquez une valeur de 2 caractères ou une valeur hexadécimale représentant le type du poste. Celle-ci doit être supérieure ou égale à la valeur hexadécimale C000.
Si la valeur hexadécimale indiquée ne correspond pas à des caractères alphanumériques, elle n'apparaîtra ni sur l'écran Afficher un journal (DSPJRN), ni sur la sortie imprimante.

Donnée du poste (ENTDTA)

Indique les données utilisateur à placer dans la partie données du poste de journal.

*BLANK: Aucune donnée utilisateur n'est placée dans le poste de journal.
'données spécifiques-du-poste': Indiquez, entre apostrophes, une chaîne de 3000 caractères au maximum.

Fichier physique journalisé (FILE)

Indique le fichier base de données et le membre de fichier physique auxquels le poste est associé.

Si ce paramètre est indiqué, vous ne pouvez pas conjointement indiquer le paramètre OBJ, OBJPATH ou OBJFID.

Valeurs uniques

*NONE: Aucun fichier n'est associé au poste.

Elément 1 : Fichier physique

Qualificatif 1 : Fichier physique

nom-fichier: Indiquez le nom du fichier physique ou logique auquel le poste est associé.
Remarque :Si le fichier indiqué est un fichier logique, le nom de membre doit être *NONE.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: Le système effectue la recherche dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom-bibliothèque: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Elément 2 : Membre

*FIRST: Le poste est associé au premier membre du fichier physique.
*NONE: Le poste est associé au fichier, et non pas à un membre du fichier.
nom-membre: Indiquez le nom du membre de fichier physique auquel le poste est associé.

Objet (OBJ)

Indique l'objet auquel le poste est associé.

Si ce paramètre est indiqué, vous ne pouvez pas conjointement indiquer le paramètre FILE, OBJPATH ou OBJFID

Valeurs uniques

*NONE: Aucun objet n'est associé au poste.

Elément 1 : Objet

Qualificatif 1 : Objet

nom-objet

Indiquez le nom de l'objet auquel le poste est associé.

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

Remarque :Si l'objet indiqué est un fichier logique, le nom de membre doit être *NONE.

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

*FILE: Le poste est associé à un fichier base de données ou à un membre de fichier base de données physique.
*DTAARA: Le poste est associé à une zone de données.
*DTAQ: Le poste est associé à une file d'attente de données.
*LIB: Le poste est associé à une bibliothèque.

Elément 3 : Membre

*FIRST: Le poste est associé au premier membre du fichier physique.
*NONE: Le poste est associé au fichier, et non pas à un membre du fichier.
nom-membre: Indiquez le nom du membre de fichier physique auquel le poste est associé.

Objet (OBJPATH)

Indique le nom d'objet qualifié par un chemin et auquel le poste est associé. Seuls sont pris en charge les objets dont le nom de chemin identifie un objet de type *STMF, *DIR ou *SYMLNK présent sur les systèmes de fichiers root (/) et QOpenSys et sur le système de fichiers par l'utilisateur.

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

Si ce paramètre est indiqué, vous ne pouvez pas conjointement indiquer FILE, OBJ ou OBJFID.

*NONE: Aucun objet n'est associé au poste.
nom-chemin: Indiquez le nom de l'objet auquel le poste est associé.

Identificateur de fichier (OBJFID)

Indique l'identificateur de fichier auquel le poste est associé. 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ésent sur les systèmes de fichiers root (/) et QOpenSys et sur celui défini par l'utilisateur sont pris en charge.

Si ce paramètre est indiqué, vous ne pouvez pas conjointement indiquer le paramètre FILE, OBJ ou OBJPATH.

*NONE: Aucun objet n'est associé au poste.
identificateur-fichier: Indiquez le FID de l'objet auquel le poste est associé.

Forcer poste journal (FORCE)

Indique si le récepteur de journal doit être forcé en mémoire secondaire chaque fois qu'il reçoit un nouveau poste.

*NO: Le récepteur de journal n'est pas écrit en mémoire secondaire.
*YES: Le récepteur de journal est écrit en mémoire secondaire.

Substitution état du journal (OVRSTATE)

Indique si le poste de journal sera consigné ou non, avec substitution de l'état en cours du journal.

*NONE

Aucune valeur d'état du journal n'est remplacée. Par conséquent,

Le poste de journal est consigné si l'état du journal est *ACTIVE.
Le poste de journal n'est pas consigné et une erreur n'est pas envoyée si l'état du journal est *STANDBY.

*STANDBY

Le poste de journal est consigné même si l'état du journal est *STANDBY.

Substituer le filtre éloigné (OVRRMTFTR)

Indique si le poste de journal sera envoyé ou non aux journaux éloignés, avec substitution des critères de filtrage.

*NONE: Aucune valeur de filtrage de journal éloigné n'est remplacée.
*FTROBJ: L'entrée de journal sera envoyée aux journaux éloignés, même si l'objet indiqué pour le paramètre Fichier physique journalisé (FILE), Objet (OBJ), Objet (OBJPATH) ou Identificateur de fichier (OBJFID) est marqué pour filtrage des objets journal éloigné et si un journal éloigné filtre les postes de journal par objet.

Exemples

Exemple 1 : Sauvegarde de récepteurs de journal en mémoire secondaire

SNDJRNE   JRN(JRNLA)  TYPE(AB)  ENTDTA('PROGRAM COMPLETE')
          FILE(MYLIB/ORDERENT MBR1)  FORCE(*YES)

Si l'état actuel du journal est *ACTIVE, cette commande place un poste de type AB (de valeur hexadécimale C1C2) avec les données 'PROGRAM COMPLETE' (programme terminé) dans les récepteurs de journal attachés au journal JRNLA (la liste de recherche des bibliothèques est employée). Le poste est associé au membre MBR1 du fichier ORDERENT de la bibliothèque MYLIB. Le récepteur de journal est sauvegardé en mémoire secondaire une fois qu'il a reçu le poste.

Exemple 2 : Envoi d'un poste de journal

SNDJRNE   JRN(JRNLA)  TYPE(x'C1F1')  OVRSTATE(*STANDBY)

Si l'état actuel du journal est *ACTIVE, cette commande place un poste de type A1 (de valeur hexadécimale C1F1) vide dans le récepteur de journal attaché au journal JRNLA (la liste de recherche des bibliothèques est employée). Le poste n'est associé à aucun membre de fichier physique.

Messages d'erreur

Messages *ESCAPE

CPFA0D4: Une erreur s'est produite dans le système de fichiers. Code erreur &1.
CPF70C3: &1 de &2 n'est pas un fichier base de données.
CPF7003: Poste non journalisé dans &1. Code raison &3.
CPF7007: Impossible d'allouer membre &3 du fichier &1 de &2.
CPF7037: Objet non journalisé dans &3.
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.
CPF9812: Fichier &1 non trouvé dans la bibliothèque &2.
CPF9815: Membre &5 du fichier &2 dans &3 non trouvé.
CPF9820: Non autorisé à utiliser la bibliothèque &1.
CPF9822: Non autorisé au fichier &1 de &2.