WRKCFGSTS

Gérer état de la configuration

En bref

La commande WRKCFGSTS permet d'afficher et de gérer les fonctions relatives à l'état de la configuration.

WRKCFGSTS se lit WRK (Gérer) + CFGSTS. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

WRKCFGSTS CFGTYPE(…)

Paramètres

CFGTYPE Type obligatoire
CFGD Description de configuration
OUTPUT Sortie
RMTLOCNAME Lieu éloigné
RANGE Plage
STATUS Etat
ASTLVL Niveau d'assistance

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

La commande WRKCFGSTS permet d'afficher et de gérer les fonctions relatives à l'état de la configuration. Lorsque vous exécutez cette commande, l'écran Gestion de l'état de la configuration s'affiche.

Pour les descriptions de serveur de réseau, l'état affiché est l'état de configuration de l'objet. Les options d'affichage de l'état des fonctions du serveur intégré et des sessions client sont disponibles dans le menu Gestion de l'état de la configuration. Utilisez ces options pour rechercher les clients actifs avant de mettre hors fonction une description de serveur de réseau.

La vue QSYS2.ASP_INFO renvoie des informations similaires sur les pools de mémoire secondaire (ASP).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
CFGTYPE	Type	NWS, NWI, LIN, CTL, *DEV	Obligatoire, positionnel 1
CFGD	Description de configuration	Nom générique, nom, ALL, CMN, ASYNC, BSC, DDI, ELAN, FAX, FR, IDLC, NET, PPP, SDLC, TDLC, TRLAN, WLS, X25, WS, LWS, RWS, VWS, CRP, DKT, MLB, OPTMLB, TAPMLB, OPT, ASP, NWSH, TAP, DSP, LCLDSP, RMTDSP, VRTDSP, PRT, LANPRT, LCLPRT, RMTPRT, VRTPRT, LOC, SNPT, APPC, FNC, HOST, RTL, INTRA, ATM, ISDN, T1	Facultatif, positionnel 2
OUTPUT	Sortie	, PRINT	Facultatif, positionnel 3
RMTLOCNAME	Lieu éloigné	Nom générique, nom, *NONE	Facultatif
RANGE	Plage	NET, OBJ	Facultatif
STATUS	Etat	ALL, ACTIVE, FAILED, VARYOFF, VARYON, AVAILABLE	Facultatif
ASTLVL	Niveau d'assistance	PRV, USRPRF, BASIC, INTERMED, *ADVANCED	Facultatif

Type (CFGTYPE)

Indique le type de description dont vous désirez visualiser l'état.

*NWS: Affiche l'état des descriptions de serveur de réseau.
*NWI: Affiche l'état des interfaces réseau.
*LIN: Affiche l'état des lignes.
*CTL: Affiche l'état des contrôleurs.
*DEV: Affiche l'état des unités.

Description de configuration (CFGD)

Indique les descriptions que vous désirez visualiser sur l'écran Gestion de l'état de la configuration.

*ALL: Affiche l'état de l'ensemble des interfaces de réseau, lignes, contrôleurs ou unités suivant la valeur du paramètre CFGTYPE (Type). Apparaît également l'état des unités et contrôleurs connectés.
*CMN: Affiche l'état des contrôleurs de communication ou des unités suivant la valeur du paramètre CFGTYPE.
*APPC: Affiche l'état des contrôleurs ou unités APPC (communications évoluées de programme à programme).
*ASP: Affiche l'état des unités ASP (pool de mémoire secondaire).
*ASYNC: Affiche l'état des lignes, des contrôleurs ou des unités asynchrones.
*ATM: Affiche l'état des interfaces réseau en mode de transfert asynchrone (ATM).
*BSC: Affiche l'état des lignes, des contrôleurs ou des unités BSC.
*DDI: Affiche l'état des lignes DDI.
*DKT: Affiche l'état des unités de disquette.
*DSP: Affiche l'état des claviers-écrans.
*ELAN: Affiche l'état des lignes Ethernet.
*FAX: Affiche l'état des lignes télécopie.
*FNC: Affiche l'état des contrôleurs ou unités bancaires.
*FR: Affiche l'état de toutes les interfaces ou lignes de réseau à relais de trame.
*HOST: Affiche l'état de tous les contrôleurs ou unités hôte.
*IDLC: Affiche l'état des lignes IDLC.
*INTRA: Affiche l'état des unités INTRA.
*ISDN: Affiche l'état des interfaces de réseau RNIS (réseau numérique à intégration de services).
*LANPRT: Affiche l'état des imprimantes de réseau local.
*LCLDSP: Affiche l'état des claviers-écrans en local.
*LCLPRT: Affiche l'état des imprimantes locales.
*LOC: Affiche l'état des unités d'un lieu éloigné spécifique. Pour pouvoir spécifier *LOC, vous devez indiquer la valeur *DEV pour le paramètre CFGTYPE.
*LWS: Affiche l'état des contrôleurs de postes de travail en local.
*MLB: Affiche l'état des unités de bandothèque et de bibliothèque optique.
*NET: Affiche l'état des lignes, des contrôleurs ou des unités de réseau.
*NWSH: Affiche l'état des unités d'adaptateur hôte de serveur de réseau.
*OPT: Affiche l'état des unités optiques.
*CRP: Affiche l'état des unités de chiffrement.
*OPTMLB: Affiche l'état des unités de bibliothèque optique.
*PPP: Affiche l'état des descriptions d'état des lignes du protocole point à point (PPP).
*PRT: Affiche l'état de toutes les imprimantes.
*RMTDSP: Affiche l'état des claviers-écrans éloignés.
*RMTPRT: Affiche l'état des imprimantes éloignées.
*RTL: Affiche l'état des contrôleurs ou des unités point de vente.
*RWS: Affiche l'état des contrôleurs de postes de travail éloignés.
*SDLC: Affiche l'état des lignes SDLC.
*SNPT: Affiche l'état des unités passe-système SNA.
*T1: Affiche l'état des interfaces réseau T1.
*TAP: Affiche l'état des contrôleurs ou des unités de bande suivant la valeur du paramètre CFGTYPE.
*TAPMLB: Affiche l'état des unités de bandothèque.
*TDLC: Affiche l'état des lignes TDLC.
*TRLAN: Affiche l'état des lignes de réseau en anneau à jeton.
*VRTDSP: Affiche l'état des claviers-écrans virtuels (passe-système).
*VRTPRT: Affiche l'état des imprimantes virtuelles (passe-système).
*VWS: Affiche l'état des contrôleurs de postes de travail virtuels (passe-système).
*WS: Affiche l'état de tous les contrôleurs de postes de travail.
*X25: Affiche l'état des lignes X.25. Affiche l'état de tous les claviers-écrans éloignés.
nom-générique: Indiquez le nom générique des descriptions de configuration à afficher.
Remarque :Un nom générique est indiqué sous la forme d'une chaîne d'un ou plusieurs caractères suivis d'un astérisque (*). Si un nom générique est spécifié, tous les noms d'objets ayant le même préfixe que le nom générique seront sélectionnés.
nom: Indiquez le nom de la description de configuration à afficher. L'état de cette description et de ses connexions s'affiche.

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.

*: La sortie est affichée pour les travaux interactifs ou imprimée avec la sortie spoule de travaux dans le cas des travaux non interactifs.

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

Lieu éloigné (RMTLOCNAME)

Indique le nom du lieu éloigné des unités. L'écran Gestion de l'état de la configuration n'affiche que les descriptions d'unités pour lesquelles le nom du lieu éloigné est spécifié.

Ce paramètre est nécessaire si la valeur *LOC est spécifiée pour le paramètre CFGD (Description de configuration). Il n'est pas admis si une valeur autre que *LOC est indiquée pour ce paramètre.

*NONE: L'affichage de l'état n'est pas fonction du nom du lieu éloigné. *NONE doit être spécifié si la valeur *NWI, *LIN ou *CTL est indiquée pour le paramètre CFGTYPE (Type) mais également si une valeur autre que *LOC est indiquée pour le paramètre CFGD.
nom-générique: Indiquez un nom de lieu éloigné générique.
Remarque :Un nom générique est indiqué sous la forme d'une chaîne d'un ou plusieurs caractères suivis d'un astérisque (*). Si un nom générique est spécifié, tous les noms d'objets ayant le même préfixe que le nom générique seront sélectionnés.
nom: Indiquez le nom du lieu éloigné des unités.

Plage (RANGE)

Indique si les descriptions de configuration connectées en aval ou en amont s'affichent.

*NET: Si le nom d'une seule description est indiqué au paramètre CFGD (Description de configuration), les descriptions en aval et en amont s'affichent. Si ce paramètre comporte une valeur spéciale ou un nom générique, les descriptions en aval s'affichent.
*OBJ: Seules les objets du type indiqué au paramètre CFGTYPE (Type) s'affichent.

Etat (STATUS)

Etats servant à définir une sous-liste de descriptions. Ce paramètre est ignoré si le nom d'une seule description est indiqué au paramètre CFGD (Description de configuration).

*ALL: Toutes les descriptions sont incluses dans la liste, quel que soit leur état.
*ACTIVE: Toutes les descriptions à l'état actif s'affichent.
*AVAILABLE: Toutes les descriptions à l'état disponible s'affichent.
*FAILED: Toutes les descriptions à l'état en erreur, en rétablissement, arrêté, endommagé ou inconnu s'affichent.
*VARYOFF: Toutes les descriptions à l'état hors fonction ou en instance de mise hors fonction s'affichent.
*VARYON: Toutes les descriptions qui ne sont pas à l'état hors fonction ou en instance de mise hors fonction s'affichent.

Niveau d'assistance (ASTLVL)

Indique l'interface utilisateur à utiliser.

*PRV: L'interface utilisateur précédemment utilisée est affichée.
*USRPRF: L'interface utilisateur indiquée pour le paramètre ASTLVL (Niveau d'assistance) de votre profil utilisateur est utilisée.
*BASIC: L'interface utilisateur d'Assistant est utilisée.
Remarque :La valeur *BASIC est admise pour le paramètre ASTLVL uniquement lorsque *DEV est indiqué pour le paramètre Type (CFGTYPE).
*INTERMED: L'interface utilisateur du système est utilisée.
*ADVANCED: L'interface utilisateur pour expert est affichée.

Exemples

Exemple 1 : Affichage de l'état de tous les claviers-écrans éloignés

WRKCFGSTS   CFGTYPE(*DEV)  CFGD(*RMTDSP)

Cette commande utilise l'écran Gestion de l'état de la configuration pour afficher l'état de tous les claviers-écrans éloignés.

Exemple 2 : Affichage de l'état de tous les serveurs de réseau

WRKCFGSTS   CFGTYPE(*NWS)  CFGD(*ALL)

Cette commande permet à l'utilisateur de faire appel à la commande WRKCFGSTS pour afficher l'état de toutes les descriptions de serveur de réseau du système.

Messages d'erreur

Messages *ESCAPE

CPF1E99: Erreur non prévue.
CPF2602: Contrôleur &1 non trouvé.
CPF2702: Description d'unité &1 non trouvée.
CPF2703: Description de contrôleur &1 non trouvée.
CPF2704: Description de ligne &1 introuvable.
CPF9846: Erreur lors du traitement du fichier &1 de &2.