DSPHDWRSC

Afficher ressources matériel

En bref

La commande DSPHDWRSC (Afficher les ressources matérielles) permet d'afficher, d'imprimer ou de sauvegarder dans un fichier de sortie les différents types d'informations SRM (Gestion des ressources du système).

DSPHDWRSC se lit DSP (Afficher) + HDWRSC. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

DSPHDWRSC TYPE(…)

Paramètres

TYPE Type obligatoire
OUTPUT Sortie
OUTFILE Fichier recevant la sortie
OUTMBR Options pour membre de sortie
OUTFILFMT Format du fichier de sortie
LINETYPE Type de ligne

Astuce : dans une session 5250, tapez DSPHDWRSC 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 : Non

Restriction : La commande WRKLANADPT (Gérer les adaptateurs LAN) doit être lancée avant la commande DSPHDWRSC ; dans le cas contraire, les informations ne s'affichent pas.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
TYPE	Type	AHW, CMN, CRP, CSA, LAN, LWS, PRC, STG	Obligatoire, positionnel 1
OUTPUT	Sortie	, PRINT, *OUTFILE	Facultatif, positionnel 2
OUTFILE	Fichier recevant la sortie	Nom d'objet qualifié	Facultatif, positionnel 3
	Qualificatif 1: Fichier recevant la sortie	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
OUTMBR	Options pour membre de sortie	Liste d'éléments	Facultatif, positionnel 4
	Élément 1: Membre recevant la sortie	Nom, *FIRST
	Élément 2: Remplacement ou ajout enregs	REPLACE, ADD
OUTFILFMT	Format du fichier de sortie	TYPE1, TYPE2	Facultatif, positionnel 5
LINETYPE	Type de ligne	ALL, DDI, *TRN	Facultatif, positionnel 6

Type (TYPE)

Indique le type d'information à afficher, imprimer, ou écrire dans un fichier de sortie.

Les valeurs possibles sont les suivantes :

*AHW: Entraîne l'affichage, l'impression ou l'écriture dans un fichier de sortie du contenu de l'ensemble des enregistrements de ressource matérielles, à savoir des enregistrements *CMN, *CRP, *CSA, *LWS, *PRC et *STG.
*CMN: Entraîne l'affichage, l'impression ou l'écriture dans un fichier de sortie des informations relatives aux ressources de communication. Ces informations comprennent le nom, le type, le numéro de série, l'emplacement, l'état, l'adresse, la description de configuration et la description de chaque unité.
*CRP: Entraîne l'affichage, l'impression ou l'écriture dans un fichier en sortie des informations relatives aux ressources de chiffrement. Ces informations comprennent le nom, le type, le numéro de série, l'emplacement, l'état, l'adresse, la description de configuration et la description de chaque unité.
*CSA: Entraîne l'affichage, l'impression ou le placement dans un fichier de sortie des informations relatives aux ressources adaptateur couplé. Ces informations comprennent le nom, le modèle, l'état, le lieu et la description de la ressource, ainsi que le système auquel l'adaptateur est lié.
*LAN: Entraîne l'affichage, l'impression ou le placement dans un fichier de sortie des informations relatives aux ressources adaptateur de réseau local en anneau à jeton ou de l'interface de données réparties (DDI). Ces informations comprennent l'adresse de l'adaptateur de contrôleur LAN, le nom et la description de l'adaptateur et le type de ligne.
*LWS: Entraîne l'affichage, l'impression ou l'écriture dans un fichier de sortie des informations relatives aux postes de travail locaux. Ces informations comprennent le nom, le type, le numéro de série, l'emplacement, l'état, l'adresse, la description de configuration et la description de chaque unité.
*PRC: Entraîne l'affichage, l'impression ou l'écriture dans un fichier de sortie des informations relatives aux ressources processeur. Ces informations comprennent le nom, le type, le numéro de série, l'emplacement, l'état et la description de chaque ressource.
*STG: Entraîne l'affichage, l'impression ou l'écriture dans un fichier de sortie des informations relatives aux ressources de stockage. Ces informations comprennent le nom, le type, le numéro de série, l'emplacement, l'état, l'adresse, la description de configuration et la description de chaque unité. Pour les cartes Fibre Channel, les informations incluent également le nom de port universel, l'état du port, le protocole, la vitesse du port et le nombre de cibles détectées.

Ce paramètre est obligatoire.

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 demandée par un travail interactif est affichée sur l'écran. La sortie demandée par un travail par lots est imprimée avec la sortie spoule du travail.

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

*OUTFILE: Les données demandées sont stockées dans un fichier base de données en sortie.

Fichier recevant la sortie (OUTFILE)

Indique le nom et la bibliothèque du fichier de sortie destiné à recevoir les données SRM demandées. Chaque fichier ne peut contenir qu'un seul type de données (*CMN, *CRP, *CSA, *LWS, *PRC, *STG ou *LAN). Si le fichier de sortie n'existe pas, la commande le crée dans la bibliothèque indiquée. Dans ce cas, le système utilise comme modèle l'un des noms de fichier et de format suivants, en fonction de la valeur indiquée en regard de l'invite Type (paramètre TYPE).

  Paramètre TYPE       Fichier de sortie créé
      Valeur          Fichier de sortie    Format
      *CMN                QARZDCMN         QRZDCMN
      *CRP                QARZDCRP         QRZDCRP
      *CSA                QARZDCSA         QRZDCSA
      *LWS                QARZDLWS         QRZDLWS
      *PRC                QARZDPRC         QRZDPRC
      *STG                QARZDSTG         QRZDSTG
      *LAN                QARZDTRA         QRZDTRA

Ce paramètre n'est admis que si la valeur *OUTFILE est indiquée en regard de l'invite Sortie (paramètre OUTPUT).

Les valeurs possibles sont les suivantes :

*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 fichier de sortie est recherché dans la bibliothèque en cours du travail. Si aucune bibliothèque n'est définie comme étant la bibliothèque en cours du travail, QGPL est utilisée.
nom-bibliothèque: Entrez le nom de la bibliothèque contenant le fichier de sortie.
nom-fichier: Entrez le nom du fichier destiné à recevoir les informations demandées.

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

Les valeurs possibles sont les suivantes :

*FIRST: Le premier membre reçoit les données SRM demandées.
nom-membre: Indiquez le nom du membre utilisé pour stocker les données SRM demandées. Si le membre indiqué n'existe pas, le système le créera.

Les options possibles sont les suivantes :

*REPLACE: Si le membre existe, le système le met à blanc et ajoute les nouvelles informations.
*ADD: Si le membre existe, le système ajoute les nouvelles informations à la suite de celles déjà présentes.

Format du fichier de sortie (OUTFILFMT)

Indique le modèle de fichier physique utilisé pour formater le fichier de sortie.

Remarque :Ce paramètre n'est pas utilisé lorsque TYPE(*LAN) est indiqué.

Les valeurs possibles sont les suivantes :

*TYPE1: Le format du fichier de sortie est identique à celui des modèles de fichier physique QARZDCMN, QARZDCRP, QARZDCSA, QARZDLWS, QARZDPRC et QARZDSTG.
*TYPE2: Le format du fichier de sortie est identique à celui du modèle de fichier physique QARZALLF et au modèle de format d'enregistrement qui lui est associé, QRZALL. Cette valeur est l'équivalent fonctionnel du fichier physique QARZHWOF, utilisé par la commande DSPLCLHDW dans des éditions antérieures à la V3R6M0.

Type de ligne (LINETYPE)

Indique le type de réseau local (LAN) pour lequel l'information sera affichée, imprimée ou dirigée dans un fichier de sortie.

Ce paramètre doit être indiqué si TYPE(*LAN) était spécifié.

Les valeurs possibles sont les suivantes :

*ALL: Les informations relatives aux ressources adaptateur de l'interface de données réparties (DDI) et de réseau en anneau à jeton sont affichées, imprimées ou dirigées dans un fichier de sortie.
*DDI: Toutes les informations relatives aux ressources adaptateur de l'interface de données réparties (DDI) sont affichées, imprimées ou dirigées dans un fichier de sortie.
*TRN: Toutes les informations relatives aux ressources adaptateur de réseau en anneau à jeton sont affichées, imprimées ou dirigées dans un fichier de sortie.

Exemples

DSPHDWRSC  TYPE(*STG)
           OUTPUT(*OUTFILE)  OUTFILE(STG)  OUTFILFMT(*TYPE2)

Cette commande permet de placer des informations SRM sur les ressources mémoire dans le fichier en sortie STG, de même format que celui du modèle de fichier physique QARZALLF. Si le fichier en sortie STG se trouve dans la liste de bibliothèques, les enregistrements de son premier membre sont remplacés par les nouveaux enregistrements. Dans le cas contraire, ce fichier est créé dans la bibliothèque en cours avec pour premier membre STG. Ce membre contient les nouveaux enregistrements.

Messages d'erreur

Messages *ESCAPE

CPF8B75: Aucun poste d'adaptateur dans le fichier d'adaptateurs du réseau.
CPF9812: Fichier &1 non trouvé dans la bibliothèque &2.
CPF9815: Membre &5 du fichier &2 dans &3 non trouvé.
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.
CPF9860: Erreur lors du traitement du fichier de sortie.