VRYCFG

La commande VRYCFG (Changer l'état d'une configuration) permet de mettre en fonction ou hors fonction un ou plusieurs objets de configuration, de mettre en fonction les objets dépendants et éventuellement de réinitialiser le processeur d'E-S (IOP) associé à ces objets.

Les objets de configuration qui peuvent être mis en fonction ou hors fonction sont les descriptions de serveur de réseau, les lignes, les contrôleurs et les unités. Cette commande concerne l'ensemble des lignes, contrôleurs et unités du système.

Pour le type d'objet de configuration de la ressource médiathèque, cette commande permet de réinitialiser les unités dans une unité de bandothèque, ou de modifier les attributions d'unités dans une unité de bandothèque ou de bibliothèque optique. Pour consulter les attributions d'unités en cours, lancez la commande WRKMLBSTS (Gérer l'état de médiathèque).

L'état des objets dépendants peut être modifié en même temps que l'objet spécifié, en précisant la valeur *NET au paramètre Plage (RANGE). L'ensemble des contrôleurs et des unités qui leur sont connectés constituent les objets dépendant d'une ligne. L'ensemble des unités connectées constituent les objets dépendant d'un contrôleur. Les unités n'ont pas d'objets dépendants. Le paramètre RANGE n'est pas pris en compte lors du changement d'état des unités.

La mise en fonction d'une ligne en mode synchrone ou asynchrone peut être gérée à l'aide du paramètre VRYWAIT (Attente de mise en fonction). Cela ne s'applique qu'aux descriptions de lignes Ethernet, BSC et asynchrones. Le système attendra la mise en fonction de la ligne ou l'expiration du délai (valeur spécifiée pour ce paramètre) avant d'exécuter la commande de mise en fonction.

La commande VRYCFG peut également servir à réinitialiser les processeurs d'E/S (IOP). Un processeur d'E/S peut être un contrôleur de communication, un contrôleur de postes de travail en local ou un contrôleur d'unités magnétiques. La réinitialisation n'est possible que lors de la mise en fonction des objets suivants :

• Des contrôleurs de communication
• Lignes
• Des contrôleurs de postes de travail en local
• Les unités de bande.

Une description de serveur de réseau de type *ISCSI ne peut pas être mise en fonction :

• Avant que la description d'unité d'adaptateur hôte de serveur de réseau soit en fonction.

Une ligne ne peut pas être mise en fonction :

• Avant que la description de serveur de réseau soit en fonction.
• Tant que l'appel de connexion n'est pas achevé (lignes commutées).

Un contrôleur ne peut pas être mis en fonction :

• Si la ligne à laquelle il est connecté est hors fonction (lignes spécialisées (louées)).
• Tant que l'appel de connexion n'est pas achevé (lignes commutées).

Une unité ne peut pas être mise en fonction :

• Si le contrôleur auquel elle est connectée est hors fonction. Les unités de bande non connectées à un contrôleur ne sont pas concernées.

Une description de serveur de réseau ne peut pas être mise hors fonction :

• Avant que l'ensemble des unités et des contrôleurs connectés soient hors fonction. La mise hors fonction de la description de serveur de réseau désactive également les descriptions de lignes associées.

Remarque :La commande WRKNWSSTS (Gérer l'état du service réseau), disponible à partir de l'écran Gestion de l'état de la configuration, permet de déterminer l'état des sessions du serveur de réseau avec d'autres clients.

Une ligne ne peut pas être mise hors fonction :

• Avant que l'ensemble des contrôleurs et unités qui lui sont connectés soient hors fonction.

Un contrôleur ne peut pas être mis hors fonction :

• S'il est en cours d'utilisation ou alloué.
• Tant que l'ensemble des unités sont encore en fonction.

Une unité ne peut être mise hors fonction :

• S'il est en cours d'utilisation ou alloué.

Une unité d'adaptateur hôte de serveur de réseau ne peut pas être mise hors fonction :

• Si une description de serveur de réseau qui l'utilise est mise en fonction.

Lorsque le paramètre RANGE est utilisé :

• Pour les unités : la valeur *NET est sans effet, les unités n'ayant pas d'objet dépendant.
• Pour les lignes commutées : la valeur *NET permet uniquement de mettre une ligne et les objets dépendants hors fonction.

Lorsque le paramètre VRYWAIT est utilisé :

• Le délai de mise en fonction d'une ligne correspond notamment au temps nécessaire à la mise en place des tâches de gestion de la ligne, à l'activation du processeur de communication d'E-S (IOP), y compris le téléchargement du programme de processeur d'entrée-sortie, et à l'établissement des communications avec l'Equipement de terminaison de circuit de données (DCE), etc.
• La mise en fonction d'une ligne ne comprend pas le temps nécessaire à la composition du numéro de téléphone, un modem hors tension pouvant, cependant, faire échouer la procédure de mise en fonction et provoquer l'expiration du délai. Quand le délai expire, un message est envoyé dans la file d'attente de messages QSYSOPR, suivi du message d'achèvement de la procédure de mise en fonction.
• Si le paramètre VRYWAIT est spécifié dans la commande VRYCFG pour une description de ligne autre qu'Ethernet, BSC commutée ou asynchrone, le paramètre est accepté mais ignoré.

Paramètres

Objet de configuration (CFGOBJ)

Indique les objets de configuration dont l'état doit être modifié.

Ce paramètre est obligatoire.

Valeurs uniques

*APPN

Tous les objets utilisant l'architecture de réseau APPN sont mis en fonction ou hors fonction. Cette valeur n'est admise que si le paramètre CFGTYPE a pour valeur *CTL ou *DEV.

*PRVCFGTYPE

Permet de traiter tous les objets ayant été traités lors de la dernière exécution de cette commande dans ce travail pour le type d'objets de configuration indiqué.

Autres valeurs (jusqu'à 256 répétitions)

nom-générique

Indiquez le nom générique des objets de configuration dont l'état doit être modifié.

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 l'objet de configuration dont l'état doit être modifié.

Type (CFGTYPE)

Indique le type d'objet dont l'état doit être modifié.

Ce paramètre est obligatoire.

*NWS

La description de serveur de réseau est mise en fonction ou hors fonction.

*LIN

Une description de ligne est mise en fonction ou hors fonction.

*CTL

Une description de contrôleur est mise en fonction ou hors fonction.

*DEV

Une description d'unité est mise en fonction ou hors fonction.

*MLBRSC

L'état des unités d'une médiathèque est modifié.

Etat (STATUS)

Indique si l'objet doit être mis en fonction ou hors fonction.

Ce paramètre est obligatoire.

*ON

L'objet est mis en fonction.

*OFF

L'objet est mis hors fonction.

*RESET

Les ressources de l'unité de bandothèque sont réinitialisées.

Remarque :Les ressources de l'unité doivent être indiquées pour le paramètre RSRCNAME (Nom de ressource).

Cette valeur ne peut être indiquée que si l'unité de bandothèque est en fonction.

*ALLOCATE

Bande : Les ressources de l'unité de bandothèque sont allouées pour être utilisées par ce système uniquement. Si l'unité de bandothèque est partagée par plusieurs systèmes, d'autres systèmes peuvent utiliser ces unités lorsque cette description d'unité en en fonction. Optique : Les ressources de l'unité de bibliothèque optique sont allouées pour utilisation. Les ressources de l'unité de bibliothèque optique sont allouées pour être utilisées par cette dernière uniquement.

Remarque :Les ressources de l'unité doivent être indiquées pour le paramètre RSRCNAME (Nom de ressource).

*UNPROTECTED

Les ressources de l'unité de bandothèque peuvent être utilisées par tous les systèmes partageant cette unité.

Remarque :Les ressources de l'unité doivent être indiquées pour le paramètre RSRCNAME (Nom de ressource).

*DEALLOCATE

Bande : Les ressources de l'unité de bandothèque sont retirées pour ce système. Si la bandothèque est partagée entre plusieurs systèmes, ces unités peuvent être utilisées par d'autres systèmes, mais pas par ce système. Optique : Les ressources d'unités sont retirées pour la ressource bibliothèque optique. Elles ne sont pas disponibles pour être utilisées par une autre unité de bibliothèque optique.

Remarque :Les ressources de l'unité doivent être indiquées pour le paramètre RSRCNAME (Nom de ressource).

Plage (RANGE)

Indique les éléments de configuration dont l'état est modifié.

*NET

L'état de l'ensemble des éléments de configuration dépendants est modifié.

*OBJ

Seul l'état de l'objet spécifié est modifié.

Attente de mise en fonction (VRYWAIT)

Indique si l'objet est mis en fonction en mode asynchrone ou synchrone. Dans le cas d'une mise en fonction synchrone, ce paramètre indique également le délai d'attente du système.

*CFGOBJ

Le système utilise la valeur indiquée pour le paramètre VRYWAIT (Attente de mise en fonction) dans la description de ligne.

*NOWAIT

Ne pas attendre l'achèvement de la mise en fonction. Cette opération s'effectuera en mode asynchrone.

15-180

Indiquez le délai d'attente en secondes. Le système attendra l'expiration du délai ou la mise en fonction de la ligne avant d'exécuter la commande VRYCFG.

Mise hors fonction asynchrone (ASCVRYOFF)

Indique si l'objet est mis hors fonction de manière synchrone ou asynchrone.

*NO

Cet objet est mis hors fonction de manière synchrone.

*YES

Cet objet est mis hors fonction de manière asynchrone.

Réinitialisation (RESET)

Indique si le processeur d'E-S (IOP) associé à l'objet doit être réinitialisé.

*NO

Le processeur d'E-S associé n'est pas réinitialisé.

*YES

Le processeur d'E-S associé est réinitialisé.

Nom de ressource (RSRCNAME)

Indique les unités à réinitialiser ou à réallouer dans l'unité de bandothèque.

Valeurs uniques

*ALL

Toutes les unités de la bandothèque.

Autres valeurs (jusqu'à 16 répétitions)

nom

Indiquez le nom de l'unité à réinitialiser ou à réallouer dans l'unité de bandothèque.

Mise hors fonction forcée (FRCVRYOFF)

Indique si des messages d'interrogation relatifs aux travaux actifs doivent être émis. Ce paramètre n'est pas admis si STATUS(*ON) est indiqué.

Remarques :

1. Ce paramètre est admis pour STATUS(*DEALLOCATE) uniquement lorsqu'un objet de bandothèque est indiqué pour le paramètre CFGOBJ (Objet de configuration).
2. Pour toutes les valeurs autres que *NO, la possibilité de rejet de la demande de changement d'état via un programme d'exit utilisateur est révoquée. Pour plus d'informations sur le changement d'état du traitement de point d'exit d'une configuration, voir la documentation QIBM_QDC_VRYEXIT dans l'i5/OS Information Center.

*NO

Des messages d'interrogation relatifs aux travaux actifs sont générés.

*YES

Aucun message d'interrogation relatif aux travaux actifs n'est généré et les travaux sont arrêtés.

*LOCK

Pour les unités autres que APPC, Intra, NWSH et MLB, le système tente de verrouiller la description d'unité quel que soit son état en cours. Si le verrouillage aboutit, il est transféré au travail système défini pour détenir le verrouillage de description d'unité lorsque celle-ci est à l'état hors fonction. Si l'unité n'est pas à l'état hors fonction, le système tente également de mettre sa description hors fonction.

Soumettre travaux multiples (SBMMLTJOB)

Ce paramètre indique si plusieurs travaux par lots doivent être soumis pour mettre en fonction les objets descriptions de serveurs de réseau ou d'ASP indiqués. Ce paramètre n'est admis que si *NWS ou *DEV est indiqué pour le paramètre CFGTYPE (Type).

*NO

Les descriptions de serveurs de réseau ou d'unités ASP seront mises en fonction de manière synchrone dans le travail dans lequel la commande VRYCFG d'origine a été émise.

*YES

Une commande VRYCFG distincte sera soumise en traitement par lots pour chaque description de serveur de réseau ou d'unité ASP indiquée.

Description de travail (JOBD)

Indique la description de travail à laquelle plusieurs commandes VRYCFG seront soumises par lots. Elle n'est admise que si le paramètre CFGTYPE a pour valeur *NWS ou *DEV, et le paramètre SBMMLTJOB, la valeur *YES.

Qualificatif 1 : Description de travail

QBATCH

La description de travail QBATCH est utilisée comme description du travail soumis. Notez que la description de travail QBATCH livrée avec le système fait appel à la file d'attente de travaux QBATCH, laquelle est configurée pour permettre l'exécution d'un seul travail à la fois.

nom

Indiquez le nom de la description de travail utilisée pour le travail soumis. Si vous voulez effectuer plusieurs mises en fonction en parallèle, vous pouvez créer une description de travail qui place les travaux dans la file d'attente de travaux QSYS/QUSRNOMAX, qui est livrée avec le système et n'impose aucune limite au nombre de travaux actifs :

CRTJOBD JOBD(QSYS/QUSRNOMAX) JOBQ(QSYS/QUSRNOMAX)

Notez également que le sous-système qui alloue la file d'attente de travaux ne doit pas avoir placé celle-ci à l'état suspendu et que le système ne doit pas être à l'état restreint.

Qualificatif 2 : Biblio

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

nom

Indiquez le nom de la bibliothèque contenant la description de travail.

Génération certificat chemin (GENPTHCERT)

Indique la génération éventuelle d'un nouveau jeu de certificats sur un système de serveur de réseau éloigné. Ce paramètre est admis uniquement lorsque le paramètre CFGTYPE prend la valeur *NWS et que le paramètre STATUS prend la valeur *ON.

*NO

Le jeu de certificats n'est pas généré.

*YES

Le jeu de certificats est généré.

Remarque :Pour utiliser cette valeur de paramètre, vous devez disposer du droit spécial *IOSYSCFG (Configuration de système d'entrée-sortie) et *SECADM (Administrateur de la sécurité).

Réinitialiser le système (RESETSYS)

Indique la réinitialisation forcée éventuelle du système de serveur de réseau éloigné, quel que soit l'état d'alimentation en cours. Il s'agit d'une fonction avancée à manipuler avec prudence. Ce paramètre n'est admis que lorsque CFGTYPE prend la valeur *NWS, que la description du serveur de réseau est de type *ISCSI et que le paramètre STATUS prend la valeur *ON.

*NO

Le système n'est pas réinitialisé.

*YES

Le système est réinitialisé.

Remarque :Pour utiliser cette valeur de paramètre, vous devez disposer du droit spécial *ALLOBJ sur tous les objets.

Exemples

Exemple 1 : Mise hors fonction de la ligne et des objets dépendants

VRYCFG   CFGOBJ(LINE1)  CFGTYPE(*LIN)  STATUS(*OFF)

Cette commande permet de mettre hors fonction la ligne et tous les objets dépendants. La valeur par défaut *NET est affectée au paramètre RANGE.

Exemple 2 : Mise en fonction du contrôleur

VRYCFG   CFGOBJ(CONTROLLER1)  CFGTYPE(*CTL)  STATUS(*ON)
         RANGE(*OBJ)

Cette commande permet la mise en fonction du contrôleur uniquement.

Exemple 3 : Mise en fonction de l'unité

VRYCFG   CFGOBJ(DEVICE1)  CFGTYPE(*DEV)
         STATUS(*ON)  RANGE(*NET)

Cette commande permet la mise en fonction de l'unité uniquement. Il est à noter que le paramètre RANGE n'a aucune incidence sur les unités.

Exemple 4 : Mise en fonction de la ligne et réinitialisation du processeur d'entrée-sortie

VRYCFG   CFGOBJ(LINE1)  CFGTYPE(*LIN)  STATUS(*ON)
         RANGE(*OBJ)  RESET(*YES)

Cette commande permet de mettre en fonction uniquement la ligne et de réinitialiser le processeur d'E-S associé.

Exemple 5 : Utilisation de la valeur de délai de mise en fonction de la description de ligne

VRYCFG   CFGOBJ(LINE1)  OJBTYPE(*LIN)  STATUS(*ON)
         RANGE(*OBJ)  VRYWAIT(*CFGOBJ)

Cette commande permet de mettre en fonction la ligne uniquement et utilise la valeur de délai de mise en fonction indiquée dans la description de ligne pour LINE1.

Exemple 6 : Utilisation d'un délai de mise en fonction de 80 secondes

VRYCFG   CFGOBJ(LINE1)  CFGTYPE(*LIN)  STATUS(*ON)
         RANGE(*OBJ)  VRYWAIT(80)

Cette commande permet de mettre en fonction uniquement la ligne avec la valeur 80 secondes pour le délai de mise en fonction

Exemple 7 : Mise en fonction d'une description de serveur de réseau

VRYCFG   CFGOBJ(SERVER1)  CFGTYPE(*NWS)  STATUS(*ON)

Cette commande permet de mettre en fonction la description de serveur de réseau SERVER1 et les descriptions de ligne associées. La valeur de délai de mise en fonction indiquée dans la description de serveur de réseau est utilisée. Il est à noter que les paramètres RANGE et RESET sont ignorés pour les serveurs de réseau s'ils sont indiqués.

Exemple 8 : Réinitialisation des unités d'une médiathèque

VRYCFG   CFGOBJ(MYLIBRARY)  CFGTYPE(*MLBRSC)  STATUS(*RESET)
         RSRCNAME(TAP01 TAP02)

Cette commande permet de réinitialiser les unités TAP01 et TAP02 de la médiathèque MYLIBRARY. Pour effectuer cette opération, vous devez mettre en fonction l'unité MYLIBRARY.

Exemple 9 : Désallocation d'unités d'une médiathèque

VRYCFG   CFGOBJ(MYLIBRARY)  CFGTYPE(*MLBRSC)
         STATUS(*DEALLOCATE)  RSRCNAME(OPT02)

Cette commande permet de désallouer l'unité OPT02 de la médiathèque MYLIBRARY. Pour effectuer cette opération, vous devez mettre en fonction l'unité MYLIBRARY.

Exemple 10 : Mise en fonction de plusieurs descriptions de serveur de réseau en parallèle

VRYCFG   CFGOBJ(IPCS*)  CFGTYPE(*NWS)  STATUS(*ON)
         SBMMLTJOB(*YES) JOBD(*LIBL/QBATCH)

Cette commande permet de soumettre un travail par lots distinct pour la mise en fonction de chaque description de serveur de réseau dont le nom commence par IPCS. Le nombre de travaux qui s'exécutent en parallèle est fonction de la configuration du sous-système utilisé.

Exemple 11 : Réinitialisation des certificats lors de la mise en fonction de la description de serveur de réseau

VRYCFG   CFGOBJ(SERVER1)  CFGTYPE(*NWS)  STATUS(*ON)
         GENPTHCERT(*YES)

Cette commande met en fonction la description de serveur de réseau et demande à ce qu'un nouveau jeu de certificats soit généré lors de cette opération.

Exemple 12 : Redémarrage du serveur intégré éloigné lors de la mise en fonction de la description de serveur

VRYCFG   CFGOBJ(SERVER1)  CFGTYPE(*NWS)  STATUS(*ON)
         RESETSYS(*YES)

Cette commande met en fonction la description de serveur de réseau et demande la réinitialisation du serveur intégré éloigné lors de la mise en fonction de SERVER1.

Messages d'erreur

Messages *ESCAPE

CPF26AF

Etat des ressources de la description d'unité &1 inchangé.

CPF26B6

Le programme d'initialisation s'est terminé avec une erreur permanente.

CPF26B7

Le programme d'initialisation s'est terminé avec une erreur temporaire.

CPF262E

Erreur lors du traitement de l'IPL.

CPF262F

Arrêt de QDCTRF à la suite d'un incident.

CPF2640

Commande de changement d'état non exécutée.

CPF2659

La commande de changement d'état n'a peut-être pas été exécutée.