RTVCFGSTS

Extraire état de configuration

En bref

La commande RTVCFGSTS permet à un programme CL de recevoir l'état d'un objet de configuration sous la forme d'un nombre.

RTVCFGSTS se lit RTV (Extraire (récupérer)) + CFGSTS. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RTVCFGSTS CFGD(…) CFGTYPE(…) STSCDE(…)

Paramètres

CFGD Description de configuration obligatoire
CFGTYPE Type obligatoire
STSCDE Variable pour code état obligatoire

Astuce : dans une session 5250, tapez RTVCFGSTS 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 : Compiled CL program or interpreted REXX (*BPGM *IPGM *BREXX *IREXX)
Compatible multitâche : Non

La commande RTVCFGSTS permet à un programme CL de recevoir l'état d'un objet de configuration sous la forme d'un nombre.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
CFGD	Description de configuration	Nom	Obligatoire, positionnel 1
CFGTYPE	Type	NWI, NWS, LIN, CTL, *DEV	Obligatoire, positionnel 2
STSCDE	Variable pour code état	Nombre décimal	Obligatoire, positionnel 3

Description de configuration (CFGD)

Désigne la description de l'objet de configuration dont vous souhaitez extraire l'état.

Ce paramètre est obligatoire.

Type (CFGTYPE)

Indique le type de description dont vous souhaitez extraire l'état.

*NWS: L'objet est une description de serveur de réseau.
*NWI: Etat d'une interface de réseau.
*LIN: Etat d'une ligne.
*CTL: Etat d'un contrôleur.
*DEV: Etat d'une unité.

Ce paramètre est obligatoire.

Variable pour code état (STSCDE)

Nom de la variable CL de longueur (5 0) destinée à recevoir l'état extrait.

Les valeurs suivantes peuvent être renvoyées :

Valeur: Définition
0: HORS FONCTION - La description n'est pas utilisée par le système.
10: EN INSTANCE HORS FONCTION - La description est en cours de mise hors fonction. Le système abandonne les tâches de gestion de la ressource, etc.
20: EN INSTANCE EN FONCTION - La description est en cours de mise en fonction. Le système peut effectuer des opérations telles que : mise en place des tâches de gestion de la ressource concernée, transfert d'un programme vers un processeur d'E-S, communications avec l'Equipement de terminaison de circuit de données (DCE), etc.
30: EN FONCTION - Les tâches de gestion d'interface réseau, de description du serveur de réseau, de ligne, de contrôleur ou d'unité ont été mises en place par le système, qui peut désormais communiquer avec elles.
32: EN INSTANCE EN FONCTION/CONNEXION - Le premier des deux contrôleurs OptiConnect est en fonction mais pas l'unité qui lui est connectée.
40: EN INSTANCE CONNEXION - Concerne uniquement les lignes commutées SDLC, IDLC, BSC ou asynchrones. La ligne attend l'établissement de la connexion (appel ou réponse).
50: OUVERTURE - Concerne uniquement les claviers-écrans. Le système prépare l'unité à recevoir l'écran d'ouverture de session, ou il le lui envoie, ou encore cet écran est affiché sur l'unité.
51: EN INSTANCE ACTIVE/CONNEXION - Le premier des deux contrôleurs OptiConnect ainsi que l'unité qui lui est connectée sont en fonction et en attente de l'établissement du chemin OptiConnect.
60: ACTIVE - L'objet a bien été mis à l'état EN FONCTION. De plus, les conditions suivantes sont vérifiées : pour les interfaces de réseau et les descriptions de serveur de réseau, une ou plusieurs lignes connectées sont au moins à l'état EN INSTANCE EN FONCTION ; pour les lignes, un ou plusieurs contrôleurs connectés sont au moins à l'état EN INSTANCE EN FONCTION ; pour les contrôleurs, une ou plusieurs unités connectées sont au moins à l'état EN INSTANCE EN FONCTION ; en ce qui concerne les unités, l'état ACTIF dépend de leur type. Consultez à ce sujet le manuel Communications Configuration, SC41-5401. D'autre part, toute unité sur laquelle est affichée un second écran d'ouverture de session obtenu à l'aide de la touche d'appel système est considérée à l'état ACTIVE.
63: LECTEUR ACTIVE - L'unité est en cours d'utilisation par un lecteur spoule.
66: EDITEUR ACTIVE - L'unité est en cours d'utilisation par un éditeur spoule.
67: DISPONIBLE - L'ASP indépendant (pool de mémoire secondaire) peut être utilisé sans restrictions de fonction.
70: SUSPENDUE - Concerne uniquement les descriptions d'unités. L'utilisateur ou le système a suspendu l'unité afin de l'empêcher toute communication. L'unité peut être libérée ultérieurement à l'aide de la commande RLSCMNDEV (Libérer une unité de communications).
80: INSTANCE RETABLISSEMENT - Le rétablissement est en instance pour la ligne, le contrôleur ou l'unité. Un message décrivant l'erreur est placé dans la file d'attente de messages QSYSOPR.
90: ARRET RETABLISSEMENT - Le rétablissement a été annulé pour l'interface de réseau, la ligne, le contrôleur ou l'unité. Après une erreur, l'opérateur a soit annulé l'opération en répondant au message d'erreur par un C, soit mis fin au rétablissement à l'aide de la commande ENDNWIRCY, ENDLINRCY, ENDCTRLRCY ou ENDDEVRCY (selon le cas).
95: APPEL SYSTEME - Le système a demandé l'affichage de l'unité écran et le travail associé a été suspendu. Cette opération fait suite à l'utilisation de la touche Appel système par un utilisateur.
100: EN ERREUR - Il s'est produit une erreur nécessitant la mise hors fonction, puis à nouveau en fonction, de l'interface de réseau, de la description de serveur de réseau, de la ligne, du contrôleur ou de l'unité.
103: ECHEC LECTEUR - Une erreur s'est produite au niveau d'une unité utilisée par un lecteur spoule.
106: ECHEC EDITEUR - Une erreur s'est produite au niveau d'une unité utilisée par un éditeur spoule.
107: ARRET - La description de serveur de réseau (NWSD) a été arrêtée à l'aide d'une API (interface de programmation).
110: MODE DIAGNOSTIC - La ressource (interface de réseau, description de serveur de réseau, ligne, contrôleur ou unité) est utilisée par des procédures d'identification d'incidents à des fins de diagnostic et n'est donc pas disponible.
111: ENDOMMAGEE - La description d'interface de réseau, de description de serveur de réseau, de ligne, de contrôleur ou d'unité est endommagée. Il s'agit d'une erreur système. La consultation de l'historique du système (QHST) permet de déterminer à quel moment l'erreur s'est produite. Les historiques de microcode sous licence vertical (VLIC) sont susceptibles de contenir des informations supplémentaires. Pour pouvoir être réutilisée, la description doit être supprimée, puis recréée.
112: VERROUILLEE - L'état actuel de la ressource ne peut être déterminé, sa description ayant fait l'objet d'un verrouillage exclusif par un autre travail. Recommencez ultérieurement ou entrez la commande WRKOBJLCK (Gérer les verrouillages d'objet) pour déterminer quel travail impose le verrouillage.
113: INCONNUE - L'identificateur d'état de la description ne peut être déterminé. Il s'agit d'une erreur système. Entrez la commande DMPOBJ (Clicher un objet) pour obtenir un cliché du contenu ou des attributs de la description dans un fichier d'impression spoule et prenez contact avec votre agent IBM.

Ce paramètre est obligatoire.

Pour plus de détails, consultez le manuel Communications Configuration, SC41-5401.

Exemples

RTVCFGSTS   CFGD(ND01)  CFGTYPE(*LIN)  STSCDE(&STSCODE)

Cette commande extrait l'état de configuration de la description de configuration de ligne ND01 à utiliser dans la variable CL &STSCODE.

Messages d'erreur

Messages *ESCAPE

CPF9801: Objet &2 non trouvé dans la bibliothèque &3.
CPF9802: Non autorisé à l'objet &2 de &3.