DSPLOG

La commande DSPLOG (Afficher l'historique du système) permet d'afficher l'historique du système (QHST). Cet historique contient les informations sur le fonctionnement et l'état du système.

L'écran contient les messages envoyés à l'historique, la date et l'heure d'envoi du message, ainsi que le nom du travail et celui du programme émetteur.

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

Paramètres

Historique (LOG)

Indique l'historique du système qui est affiché.

QHST

L'historique du système QHST est affiché.

Période de sortie historique (PERIOD)

Indique la période pendant laquelle les données que vous souhaitez afficher ont été consignées dans l'historique. Ce paramètre contient deux listes d'éléments comportant deux éléments chacune. Une valeur ou *N doit être indiqué pour un élément si une valeur d'élément suivant doit être indiquée pour conserver sa position dans l'ordre des valeurs de paramètres. Si PERIOD n'est pas indiqué, le système suppose que les valeurs sont les suivantes :

PERIOD((*AVAIL *CURRENT) (*AVAIL *CURRENT))

Elément 1 : Heure et date de démarrage

Elément 1 : Heure de démarrage

Utilisez l'une des valeurs suivantes pour indiquer l'heure de consignation à partir de laquelle vous souhaitez afficher les données de consignation de l'historique. Les données consignées avant l'heure et le jour indiqués ne sont pas affichées.

*AVAIL

Toutes les données consignées et disponibles pour la date de démarrage indiquée, apparaissent.

heure-début

Précisez, pour la date de début indiquée, l'heure de consignation à partir de laquelle vous souhaitez afficher les données de consignation de l'historique. Vous devez entrer cette valeur selon le format 24 heures, avec ou sans séparateurs.

• Si vous n'utilisez pas de séparateur, entrez une chaîne de 4 ou 6 chiffres (hhmm ou hhmmss), où hh = heures, mm = minutes etss = secondes. Chacune des valeurs représentant les heures, les minutes et les secondes doit comporter 2 chiffres. Utilisez des zéros de début si besoin est. Les valeurs admises pour hh sont comprises entre 00 et 23. Les valeurs admises pour mm et ss sont comprises entre 00 et 59.
• Si vous utilisez des séparateurs, indiquez une chaîne de 5 ou 8 chiffres, où le séparateur indiqué dans votre travail permet de distinguer les heures, les minutes et les secondes. Si vous entrez cette commande à partir de la ligne de commande, cette chaîne doit être placée entre apostrophes. Si vous utilisez un séparateur d'heure différent de celui indiqué dans votre travail, la commande n'aboutira pas.

Elément 2 : Date de début

Utilisez l'une des valeurs suivantes pour indiquer le jour de consignation à partir duquel vous souhaitez afficher les données de consignation de l'historique. Les données consignées avant le jour indiqué ne sont pas affichées.

*CURRENT

Les données consignées dans l'historique le jour même, entre l'heure de début indiquée et l'heure de fin (le cas échéant) sont affichées.

*BEGIN

Le début de l'historique est affiché.

date-de-début

Indiquez la date de début avec ou sans séparateurs de date. La date doit être saisie au format de date utilisé par le travail et défini par l'attribut de travail de format de date. Si des séparateurs de date sont utilisés, ils doivent être identiques à ceux utilisés par ce travail, comme indiqué dans l'attribut de travail du format de date.

Elément 2 : Heure et date de fin

Remarque :Les valeurs indiquées pour la date et l'heure de fin sont ignorées si la sortie est affichée. C'est-à-dire que toutes les données se trouvant dans l'historique qui ont été consignées à partir de la date et de l'heure de début indiquée peuvent être affichées, quelle que soit la date et l'heure de fin indiquées.

Elément 1 : Heure de fin

Utilisez l'une des valeurs suivantes pour indiquer l'heure de consignation jusqu'à laquelle vous souhaitez afficher les données de l'historique.

*AVAIL

Les données consignées disponibles pour la date de fin indiquée sont affichées. L'heure peut être entrée sous forme de chaîne de 4 ou 6 chiffres (hhmm ou hhmmss), où hh = heures, mm = minutes et ss = secondes. Si des séparateurs d'heure sont utilisés pour séparer les valeurs d'heure, la chaîne de caractères doit être placée entre apostrophes ('hh:mm:ss'). Si le séparateur d'heure utilisé n'est pas celui qui a été spécifié pour le travail, la commande échoue.

Remarque :Si la sortie est affichée, les valeurs indiquées pour les date et heure de fin sont ignorées. Autrement dit, toutes les données qui sont incluses dans l'historique et qui ont été consignées à partir des date et heure de début indiquées peuvent être affichées, quelles que soient les date et heure de fin indiquées.

heure-fin

Précisez, pour la date de fin indiquée, l'heure de consignation jusqu'à laquelle vous souhaitez imprimer les données de l'historique. Pour connaître les différents formats admis pour l'heure, référez-vous au paragraphe heure-début.

Elément 2 : Date de fin

Utilisez l'une des valeurs suivantes pour indiquer le jour de consignation jusqu'auquel vous voulez afficher le données de l'historique.

*CURRENT

La date du jour est la dernière pour laquelle les données de l'historique sont affichées.

*END

Les données de l'historique sont affichées jusqu'à la fin. Si (PERIOD) *END est indiqué, toute heure de fin autre que *AVAIL est ignorée.

date-fin

Indiquez la date de fin avec ou sans séparateurs de date. La date doit être saisie au format de date utilisé par le travail et défini par l'attribut de travail de format de date. Si des séparateurs de date sont utilisés, ils doivent être identiques à ceux utilisés par ce travail, comme indiqué dans l'attribut de travail du format de date.

Remarque :Si aucune sortie n'est reçue après l'exécution de la commande DSPLOG alors que *PRINT est indiqué, il est possible que certaines données de message ne soient pas classées en ordre chronologique. Dans ce cas, pour imprimer ces données, indiquez :

PERIOD((*AVAIL *BEGIN)(*AVAIL *END)).

Sortie (OUTPUT)

Indique si la sortie de la commande est affichée à l'écran ayant émis la demande ou si elle est imprimée avec la sortie spoule du travail.

*

La sortie demandée par un travail interactif est affichée à l'écran. La sortie demandée par un travail par lots est imprimée avec la sortie spoule du travail.

*PRINT

La sortie est imprimée avec la sortie spoule du travail. N'est imprimée qu'une seule ligne par message. Il s'agit des 105 premiers caractères du texte de message de premier niveau.

*PRTWRAP

La sortie est imprimée avec la sortie spoule du travail. Si le message ne tient pas sur une ligne, des lignes supplémentaires sont imprimées. Ces dernières peuvent contenir jusqu'à 2000 caractères du texte du message de premier niveau.

*PRTSECLVL

La sortie est imprimée avec la sortie spoule du travail. Le premier et le deuxième niveau du message sont tous deux imprimés. Permet l'impression du texte de premier niveau jusqu'à 2000 caractères et du texte de deuxième niveau jusqu'à 6000 caractères.

Lors de l'impression de la sortie, deux ou plusieurs lignes sont imprimées pour chaque message. La dernière ligne contient les informations suivantes :

• Nom du travail qualifié qui a envoyé le message. Il est constitué des trois zones suivantes :
  • Nom du travail
  • Nom de l'utilisateur
  • Numéro du travail
• Nom du programme et numéro de l'instruction à partir desquels le message a été envoyé. Le numéro d'instruction est zéro, excepté si le message envoyé est un message de diagnostic, d'avertissement ou d'arrêt programme.
• La date et l'heure à laquelle le message a été envoyé.
• Le nom du profil utilisateur sous lequel s'exécutait l'unité d'exécution lors de l'envoi du message.

Travaux à afficher (JOB)

Indique le nom des travaux (le cas échéant) associés aux messages de l'historique qui sont affichés. Ces messages ne sont affichés que s'ils ont été consignés dans l'historique durant la période définie par les paramètres de cette commande.

Valeurs uniques

*NONE

Aucun nom de travail n'est utilisé pour indiquer les messages qui doivent être affichés. Tous les messages de tous les travaux sont inclus.

Autres valeurs

Indiquez le nom qualifié de cinq travaux associés aux messages du fichier historique que vous souhaitez afficher. Un nom de travail peut être qualifié à l'aide de trois éléments maximum.

Qualificatif 1 : Travail

*ALL

Les messages de tous les noms de travail incluant le nom d'utilisateur de travail et le numéro de travail spécifiés sont inclus.

nom-générique

Indiquez le nom générique des travaux dont les messages doit être inclus. Un nom générique est une chaîne d'un ou de plusieurs caractères suivis d'un astérisque (*). Si vous utilisez un nom générique, tous les messages des travaux dont le nom comporte le même préfixe que le nom générique sont inclus.

nom

Indiquez le nom du travail dont les messages doivent être inclus.

Qualificatif 2 : Utilisat

*ALL

Les messages de tous les noms d'utilisateur de travail incluant le nom de travail et le numéro de travail spécifiés sont inclus.

nom-générique

Indiquez le nom d'utilisateur générique des travaux dont les messages doit être inclus. Si vous utilisez un nom générique, tous les messages des travaux dont le nom d'utilisateur comporte le même préfixe que le nom générique sont inclus.

nom

Indiquez le nom d'utilisateur du travail dont les messages doivent être inclus.

Qualificatif 3 : Numéro

*ALL

Les messages de tous les numéros de travail incluant le nom de travail et le numéro d'utilisateur de travail spécifiés sont inclus.

000000-999999

Indiquez le numéro du travail dont les messages sont inclus.

Par exemple :

• *NONE
• nom-travail
• nom-utilisateur/nom-travail
• numéro-travail/nom-utilisateur/nom-travail

Vous pouvez indiquer jusqu'à cinq noms de travail. Si le nom du travail n'est pas qualifié, tous les travaux portant le nom indiqué sont pris en compte, ce qui peut entraîner l'affichage de tous les messages qui leur sont associés.

Identificateur de message (MSGID)

Indique jusqu'à 200 identificateurs de message à inclure ou omettre dans la sortie, en fonction de la valeur du paramètre Sélection identificateur msg (MSGIDSLT). Les messages sont pris en compte pour inclusion ou omission uniquement s'ils ont été consignés au cours de la période indiquée au paramètre Période de sortie historique (PERIOD) et dans les travaux spécifiés au paramètre Travaux à afficher (JOB).

Valeurs uniques

*ALL

Tous les messages consignés, quels que soient leurs identificateurs, sont inclus dans la sortie, à condition qu'ils correspondent au travail et à la période précédemment indiqués.

Autres valeurs

identificateur-message

Indiquez jusqu'à 200 identificateurs de message.

Pour indiquer des types génériques de messages, spécifiez le code de 3 caractères, suivi de zéros. Par exemple, CPF0000 représente tous les messages CPF qui répondent aux spécifications des paramètres précédents. Si un identificateur est indiqué sous la forme pppnn00, il fait référence aux messages commençant par les cinq caractères indiqués (pppnn). Pour de plus amples informations sur les identificateurs de message, reportez-vous à la description du paramètre MSGID de la commande ADDMSGD.

Sélection identificateur msg (MSGIDSLT)

Indique si la liste des identificateurs de message doit être incluse ou omise dans la sortie.

*INCLUDE

Les ID message qui correspondent à la liste, indiqués au paramètre MSGID, sont inclus dans la sortie.

*OMIT

Les ID message qui correspondent à la liste, indiqués au paramètre MSGID, ne sont pas inclus dans la sortie.

Exemples

Exemple 1 : Affichage des messages consignés correspondant à la date en cours

DSPLOG   LOG(QHST)

Cette commande affiche tous les messages consignés (ainsi que les données qui leur sont associées) qui sont disponibles dans l'historique système pour la date en cours.

Exemple 2: Affichage des messages consignés pour septembre 2018

DSPLOG   JOB(MYJOB)  PERIOD((*AVAIL 090118) (*AVAIL 093018))
         MSGID(CPF0000)

Cette commande affiche, dans l'historique système de MYJOB, tous les messages CPF qui ont été consignés en septembre 2018.

Exemple 3 : Omission des messages de démarrage de travail et d'arrêt de travail

DSPLOG MSGID(CPF1124 CPF1164) MSGIDSLT(*OMIT)

Cette commande permet d'omettre les ID message CPF1124 (travail démarré) et CPF1164 (travail arrêté) lors de l'affichage de messages à partir de la date en cours.

Exemple 4: Affichage de tous les messages pour un utilisateur

DSPLOG PERIOD((*AVAIL *BEGIN)) JOB(MYUSER/*ALL)

Cette commande affiche tous les messages disponibles dans l'historique qui ont été générés par les travaux ayant démarré avec le profil utilisateur MYUSER.

Messages d'erreur

Messages *ESCAPE

CPF2403

File d'attente de messages &1 non trouvée dans &2.

CPF2447

Aucun poste dans la version en cours de l'historique.

CPF2478

Non autorisé à la version de l'historique demandée.

CPF2480

La version demandée de l'historique est endommagée.

CPF2519

Erreur pendant le traitement d'une liste d'ID message.

CPF2537

Trop d'enreg écrits dans le fichier &2 de &3.

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.