DSPDSTLOG

La commande DSPDSTLOG (Afficher l'historique de distribution) permet d'accéder à l'historique SNADS. Celui-ci (le journal QSNADS) contient les postes relatifs aux opérations SNADS exécutées sur le système, à savoir l'envoi, la réception, le routage des distributions et les modifications de configuration.

Cette commande fournit un grand nombre de critères de sélection facilitant l'accès aux informations souhaitées. Les critères de recherche comprennent le délai, le type de fonction (par exemple, routeur et émetteur/récepteur), le type de poste (normal, erreur et configuration, par exemple) et le nom du travail. Vous pouvez entrer n'importe quel nombre de paramètres de sélection ; la sortie qui en résulte est cumulative, en fonction de tous les paramètres entrés.

Deux sorties (écran et imprimante) peuvent être générées conjointement avec le paramètre d'entrée indiqué. Si l'utilisateur demande une sortie écran, un récapitulatif de tous les postes répondant aux critères de sélection s'affiche. L'écran récapitulatif comporte des informations de base telles que le type de fonction, le type de poste, l'heure/date de consignation, le nom du travail et l'ID utilisateur de départ. Dans l'écran récapitulatif, vous pouvez choisir l'un des postes pour visualiser les détails de ce poste de journal. L'écran détaillé affiche plus d'informations spécifiques relatives à ce poste de journal particulier. Si l'utilisateur demande une sortie imprimante, une impression détaillée de chaque poste de journal de la sélection est généré.

L'utilisateur peut indiquer les critères de sélection appropriés pour déterminer les types d'informations suivants :

• Les modifications apportées à la configuration, le moment et l'auteur des modifications apportées à toutes les tables ou à des tables spécifiques.
• Les modifications de configuration correspondant aux distributions ou aux postes d'erreur acheminés et/ou transmis.
• Liste des postes d'erreur relatifs à toutes les fonctions à des fonctions spécifiques (par exemple, erreurs de routage)
• Toutes les distributions reçues, acheminées ou envoyées pendant un certain intervalle de temps
• Activité d'un certain travail émetteur ou récepteur

Restrictions :

1. Cette commande est fournie avec le droit public *EXCLUDE.
2. Cette commande ne permet pas d'afficher les informations sur le poste de travail (*DS2) ou sur la console (*DS1) de taille 12 x 80.

Paramètres

Période de sortie historique (PERIOD)

Indique la période choisie pour l'affichage des postes de l'historique. Les valeurs suivantes peuvent être affectées à ce paramètre qui comporte deux listes de deux valeurs chacune.

Pour l'heure de début, vous pouvez indiquer l'une des valeurs suivantes :

*AVAIL

Affiche tous les postes de l'historique compris entre la date de début et la date de fin.

heure-début

Indiquez l'heure de début de la période choisie. Vous pouvez entrer cette valeur avec ou sans séparateurs.

• Si vous n'utilisez pas de séparateur, indiquez une chaîne de 4 ou 6 chiffres (hhmm ou hhmmss), où hh = heures, mm = minutes, ss = secondes.
• Si vous utilisez un séparateur, indiquez une chaîne de 5 ou 8 chiffres dans laquelle le séparateur défini pour votre travail est utilisé pour séparer les heures, les minutes et les secondes. Si vous entrez cette commande sur la ligne de commande, la chaîne doit être placée entre apostrophes. Si vous utilisez un séparateur autre que celui défini pour votre travail, cette commande échouera.

Pour la date de début, vous pouvez entrer l'une des valeurs suivantes :

*CURRENT

Affiche les postes de l'historique disponibles à ce jour et compris dans la plage horaire indiquée, le cas échéant.

*BEGIN

Affiche les postes à partir du début de l'historique. Si vous avez indiqué *BEGIN, l'heure de début ne sera pas prise en compte.

date-début

Indiquez la date de début de la période choisie, en respectant le format de la date système.

Pour l'heure de fin, vous pouvez indiquer l'une des valeurs suivantes :

*AVAIL

Affiche les postes de l'historique compris entre la date de début et la date de fin.

heure-fin

Indiquez l'heure de fin de la période choisie. Consultez la section relative à l'heure de début dans cette description de paramètres pour plus de détails sur la saisie des valeurs.

Pour la date de fin, vous pouvez indiquer l'une des valeurs suivantes :

*CURRENT

Affiche les postes de l'historique disponibles à ce jour et compris dans la plage horaire indiquée, le cas échéant.

*END

Affiche les postes jusqu'à la fin de l'historique. Si vous avez indiqué *END, l'heure de fin ne sera pas prise en compte.

date-fin

Indiquez la date de fin de la période choisie, en respectant le format de la date système.

Type de fonction (FNCTYP)

Indique la fonction SNADS qui était en cours d'exécution lors de la création des postes dans le journal QSNADS. Vous pouvez entrer huit fonctions au maximum si la valeur par défaut *ALL n'est pas indiquée.

Ce paramètre admet des valeurs multiples.

Les valeurs possibles sont les suivantes :

*ALL

Toutes les fonctions SNADS qui ont généré les postes de l'historique.

*RCV

Fonction de réception SNADS.

*RTR

Fonction de routage SNADS.

*SND

Fonction d'envoi SNADS.

*ORG

Fonction d'origine SNADS.

*ARV

Fonction d'arrivée SNADS.

*CFG

Fonction de configuration SNADS. Si *CFG est indiqué pour ce paramètre, vous ne pouvez entrer aucune valeur en regard des invites ID utilisateur (paramètre ORGUSRID) et Groupe de système (paramètre ORGSYSNAME).

*OPR

Fonction d'opération SNADS.

*SYS

Fonction système SNADS.

Type de poste (ENTTYP)

Indique le type des postes de l'historique qui sont affichés. Vous pouvez entrer cinq types au maximum si la valeur *ALL ou *ALLDST n'est pas indiquée.

Ce paramètre admet des valeurs multiples.

Les valeurs possibles sont les suivantes :

*ALLDST

Tous les types de postes de l'historique à l'exception de *SYS.

*ALL

Tous les types de postes.

*NRM

Postes normaux (ne signalant pas d'erreur).

*ERR

Postes signalant des erreurs.

*RTG

Postes d'historique de la table de routage ou la table des noms secondaires du système.

*DSQ

Postes d'historique des files d'attente de distribution.

*SYS

Postes du journal QSNADS.

ID utilisateur d'origine (ORGUSRID)

Indique l'ID utilisateur et l'adresse d'origine des distributions consignées. Ce paramètre vous permet d'afficher ou d'imprimer les postes consignés suite aux distributions occasionnées par un utilisateur dont l'ID ou l'adresse correspond aux valeurs que vous avez indiquées. L'ID utilisateur et l'adresse sont convertis au jeu de caractères et à la page de codes '697 500' à l'aide du CCSID du travail.

Les valeurs possibles pour l'ID utilisateur sont les suivantes :

*ALL

Tous les postes de l'historique sont affichés, quel que soit l'ID utilisateur d'origine.

*BLANK

Seuls les postes d'historique avec un ID utilisateur d'origine à blanc (dans les cas de distributions d'état SNADS) sont affichés.

ID-utilisateur

Indiquez l'ID utilisateur d'origine auquel sont associés les postes d'historique à afficher.

Les valeurs possibles pour l'adresse sont les suivantes :

*ALL

Tous les postes d'historique sont affichés quelle que soit leur adresse d'origine.

*BLANK

Seuls les postes d'historique avec une adresse d'origine à blanc (dans le cas des distributions d'état SNADS) sont affichés.

adresse

Indiquez l'adresse d'origine à laquelle sont associés les postes d'historique à afficher.

Nom du système d'origine (ORGSYSNAME)

Indique le nom de système et le nom de groupe du système d'origine des distributions consignées. Ce paramètre vous permet d'afficher ou d'imprimer les seuls postes consignés suite aux distributions provenant du système ou du groupe indiqué.

Il n'existe pas de groupe de systèmes pour les systèmes IBM i, IBM 38 et IBM 36. Le nom de groupe de systèmes d'origine des distributions provenant de ces systèmes est toujours à blanc.

Le nom et le groupe sont convertis au jeu de caractères et à la page de codes '697 500' à l'aide du CCSID du travail.

Les valeurs possibles pour le nom du système sont les suivantes :

*ALL

Tous les postes d'historique sont affichés quel que soit leur système d'origine.

nom-système

Indiquez le nom du système d'origine auquel correspondent les postes d'historique à afficher.

Les valeurs possibles pour le nom de groupe sont les suivantes :

*ALL

Tous les postes d'historique sont affichés quel que soit le nom de groupe de leur système d'origine.

*BLANK

Seuls les postes d'historique avec une adresse d'origine à blanc sont affichés.

nom-groupe-système

Indiquez le nom de groupe du système d'origine auquel correspondent les postes d'historique à afficher.

Travail (JOB)

Indique le nom du travail SNADS à l'origine des postes de l'historique. Ce paramètre vous permet d'afficher ou d'imprimer les seuls postes de l'historique consignés par le travail indiqué.

Les valeurs possibles sont les suivantes :

*ALL

Tous les travaux SNADS ayant créé des postes dans l'historique.

nom-travail (nom de l'utilisateur (numéro du travail))

Indiquez le nom du travail SNADS à l'origine des postes.

Plage de récepteurs de journal (RCVRNG)

Indique les récepteurs de journal qui contiennent les historiques SNADS. Ce paramètre permet d'afficher les postes des historiques SNADS conservés dans les récepteurs de journal qui ne sont plus actifs.

Les valeurs possibles sont les suivantes :

*CURRENT

Permet d'afficher l'historique SNADS en cours.

premier-récepteur-journal

Indiquez le nom du premier récepteur (nom de bibliothèque/nom du premier récepteur). Les historiques SNADS stockés dans l'ensemble des récepteurs de journal compris entre le premier et le dernier récepteur s'affichent.

Pour la bibliothèque, les valeurs possibles sont les suivantes :

*LIBL

Le récepteur de journal est recherché dans la liste des bibliothèques.

*CURLIB

Le récepteur de journal est recherché dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

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

dernier-récepteur-journal

Indiquez le nom du dernier récepteur (nom de bibliothèque/nom du dernier récepteur). Les historiques SNADS stockés dans l'ensemble des récepteurs de journal compris entre le premier et le dernier récepteur s'affichent.

Pour la bibliothèque, les valeurs possibles sont les suivantes :

*LIBL

Le récepteur de journal est recherché dans la liste des bibliothèques.

*CURLIB

Le récepteur de journal est recherché dans la bibliothèque en cours utilisée pour le travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

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

Sortie (OUTPUT)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

Les valeurs possibles sont les suivantes :

*

Le résultat est affiché (si demandé par un travail interactif) ou placé dans un fichier spoule de la file d'attente en sortie (si demandé par un travail en traitement par lots).

*PRINT

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

Exemples

Exemple 1 : Impression d'un historique de distribution

DSPDSTLOG   OUTPUT(*PRINT)

Cette commande dirige les informations du journal de distribution dans la file d'attente de spoule d'impression du travail. Si vous indiquez OUTPUT(*) et si la commande est saisie à partir d'un poste de travail, les informations concernant le journal de distribution sont affichées sur ce poste.

Exemple 2 : Obtention d'un journal de distribution SNADS

DSPDSTLOG   ENTTYPE(*SYS)

Cette commande dirige les entrées du journal de distribution SNADS qui doivent être affichées sur l'écran du poste de travail pour un travail interactif, ou imprimées avec la sortie spoulée du travail dans le cas d'un travail par lots.

Messages d'erreur

Messages *ESCAPE

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.

CPF9851

Valeur de ligne fin de page trop faible pour fichier &1 dans &2.