DSPAPPNINF

La commande DSPAPPNINF (Afficher les informations APPN) permet d'obtenir des informations relatives au réseau APPN, destinées à faciliter l'identification des incidents. Vous pouvez préciser le type d'information que vous désirez afficher, imprimer ou stocker dans un fichier de sortie : contenu de la base de données topologique, contenu du répertoire local ou informations de session. Pour plus d'informations sur les fonctions APPN, reportez-vous au manuel APPN de la catégorie Networking de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Paramètres

Type d'information (INFTYPE)

Indique le type d'information demandé.

Les valeurs possibles sont les suivantes :

*TOPOLOGY

Affiche ou imprime le contenu de la base de données topologiques. La base de données topologiques locale contient l'ensemble de tous les noeuds et leurs caractéristiques et, pour chaque noeud, l'ensemble des noeuds de destination de liaison, ainsi que les caractéristiques des liaisons de connexion.

*LCLNODE

Affiche ou imprime le contenu du répertoire local. Le répertoire local contient le noeud local et les noms de tous les points de contrôle éloigné et de leurs emplacements.

*SSN

Affiche ou imprime les informations sur les sessions intermédiaires ou sur les sessions qui ont pour extrémité le noeud local.

Noeuds (NODES)

Indique l'ensemble de noeuds demandé. Ce paramètre n'est admis que si *TOPOLOGY est indiqué en regard de l'invite Type d'information (paramètre INFTYPE).

Les valeurs possibles sont les suivantes :

*ALL

Affiche ou imprime tous les noeuds de la base de données topologique.

*ACTIVE

Affiche ou imprime les noeuds actifs.

*INACTIVE

Affiche ou imprime les noeuds inactifs.

Type de session (SSNTYPE)

Indique le type d'information de session à afficher. Ce paramètre n'est admis que lorsque *SSN est indiqué en regard de l'invite Type d'information (paramètre INFTYPE).

Les valeurs possibles sont les suivantes :

*ENDPNT

Affiche ou imprime les informations relatives aux sessions qui ont pour extrémité le noeud local.

*INMSSN

Affiche ou imprime les informations relatives aux sessions intermédiaires passant par le noeud local.

Travail (JOB)

Indique le nom du travail pour lequel les informations de session doivent être affichées ou imprimées. Si * est indiqué en regard de l'invite Sortie (paramètre OUTPUT) et qu'aucun nom de travail n'est précisé, le système affiche une liste de travaux APPN exécutés depuis le dernier IPL, à partir de laquelle vous pouvez opérer votre choix. Vous pouvez sélectionner un nom de travail dans cette liste. Si *PRINT ou *OUTFILE est indiqué en regard de l'invite Sortie (paramètre OUTPUT) et qu'aucun nom de travail n'est précisé, les informations de session relatives à tous les travaux APPN sont imprimées ou stockées dans un fichier de sortie spécifique.

Ce paramètre n'est admis que si *ENDPNT est indiqué en regard de l'invite Type de session (paramètre SSNTYPE).

nom-travail

Indiquez le nom du travail pour lequel les informations de session sont affichées ou imprimées.

Description de contrôleur (CTL)

Indique le contrôleur pour lequel les sessions intermédiaires sont demandées. Ce paramètre n'est admis que si *INMSSN est indiqué en regard de l'invite Type de session (paramètre SSNTYPE).

Les valeurs possibles sont les suivantes :

*ALL

Affiche ou imprime les sessions intermédiaires pour tous les contrôleurs.

nom-description-contrôleur

Indiquez le nom du contrôleur pour lequel vous voulez afficher ou imprimer les sessions intermédiaires.

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 :

*

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

Fichier recevant la sortie (OUTFILE)

Indique le nom et la bibliothèque du fichier base de données destiné à recevoir la sortie. Si ce fichier n'existe pas, la commande en crée un dans la bibliothèque précisée.

Remarque :Si un nouveau fichier est créé, le système utilise le fichier QAxxxxx de la bibliothèque QSYS avec le nom de format QLzzzz comme modèle, en fonction de la valeur précisée en regard de l'invite Type d'information (paramètre INFTYPE). La table suivante affiche les valeurs pouvant être indiquées dans ce paramètre, ainsi que le modèle et le fichier de sortie correspondant aux valeurs.

Valeurs de paramètre         Fichier de sortie créé
                             OUTFILE  FORMAT
*TOPOLOGY                    QALSTDB  QLSTDB
*LCLNODE                     QALSDIR  QLSDIR
*SSN - session d'extrémité   QALSEND  QLSEND
*SSN - session intermédiaire QALSINM  QLSINM

Les valeurs possibles pour la bibliothèque sont les suivantes :

*LIBL

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

*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-bibliothèque

Indiquez le nom de la bibliothèque dans laquelle se trouve le fichier.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier de base données vers lequel est dirigé la sortie lorsque *OUTFILE est précisé à l'invite Sortie (paramètre OUTPUT).

Pour le nom du membre de sortie, les valeurs possibles sont :

*FIRST

Les informations APPN demandées sont stockées dans le premier membre. Si OUTMBR(*FIRST) est indiqué et qu'aucun membre n'existe dans le fichier désigné dans le paramètre OUTFILE, le système en créera un.

nom-membre

Indiquez le nom du membre utilisé pour stocker les informations APPN demandées. Si un nom de membre est indiqué alors que le membre n'existe pas, le système le crée. Si le membre indiqué n'existe pas, le système le créera.

Les options possibles sont les suivantes :

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

Exemples

Exemple 1 : impression d'une liste

DSPAPPNINF   INFTYPE(*TOPOLOGY)  NODES(*ALL)  OUTPUT(*PRINT)

Cette commande permet d'imprimer la liste des noeuds présents sur le réseau APPN, la liste des noeuds de destination de liaison associés à chaque noeud ainsi que les caractéristiques de chaque liaison.

Exemple 2 : affichage d'une liste de PCID (Identificateur de session de corrélation de procédures)

DSPAPPNINF   INFTYPE(*SSN)  SSNTYPE(*ENDPNT)
             JOB(APPNJOB/USERPROF/000001)  OUTPUT(*)

Cette commande permet d'afficher la liste des PCID associés au travail APPNJOB/USERPROF/000001. A partir de cette liste, l'utilisateur peut définir une option en vue d'afficher des informations supplémentaires concernant une session.

Exemple 3 : stockage du contenu d'un répertoire

DSPAPPNINF   INFTYPE(*LCLNODE)  OUTPUT(*OUTFILE)
             OUTFILE(USERLIB/APPNFILE)  OUTMBR(*FIRST, *REPLACE)

Cette commande permet de stocker le contenu du répertoire local dans le premier membre d'un fichier de sortie appelé USERLIB/APPNFILE. Dans le cas où des informations existent dans ce membre, celles-ci sont remplacées par les nouvelles informations.

Messages d'erreur

Aucun