PWRDWNSYS

La commande PWRDWNSYS (Mettre le système hors tension) permet au système de préparer son arrêt et de démarrer sa procédure de mise hors tension. L'arrêt du système est signalé à l'ensemble des sous-systèmes actifs ; aucun sous-système ne peut démarrer de nouveau travail ou de nouvelle phase d'activation. Ainsi, les travaux présents dans la file d'attente de travaux ne seront pas lancés. En outre, les travaux placés dans une file d'attente suite à l'utilisation de la commande TFRJOB (Transférer un travail) ne seront pas terminés. Ils sont retirés de la file d'attente au cours de l'IPL et les journaux correspondants sont générés.

Lorsque le système est mis hors tension à l'aide de l'option *CNTRLD, la mise hors fonction des objets de configuration est initialisée mais peut ne pas aboutir avant l'arrêt complet du système. Lorsque ce dernier est mis hors tension à l'aide de l'option *IMMED, aucune mise hors fonction des objets de configuration n'est effectuée.

Remarques :

1. Si les descriptions de serveur de réseau sont configurées sur le système, elles doivent toutes être mises hors fonction avant de lancer la commande PWRDWNSYS afin de garantir l'intégrité du système et des données utilisateur associées à chaque serveur de réseau.
2. Si des unités de bande font partie du système, toutes les bandes des unités doivent être déchargées avant l'arrêt du système, de façon à préserver l'intégrité des données stockées sur les bandes.
3. Sur un système possédant une partition principale, la mise hors tension de cette partition entraîne la mise hors tension des autres partitions. Par conséquent, avant de mettre la partition principale hors tension, vérifiez que les autres partitions sont prêtes à l'être.
4. Si les unités de pools de mémoire secondaire indépendants sont configurées sur le système, tous les ASP indépendants doivent être mis hors fonction avant de lancer la commande PWRDWNSYS afin de garantir l'intégrité des données associées à chaque ASP indépendant.
5. Deux formats sont possibles pour le point d'exit QIBM_QWC_PWRDWNSYS. Le format PWRD0100 peut être utilisé pour ajouter un programme appelé lorsque la commande PWRDWNSYS est exécutée. Le format PWRD0200 peut être utilisé pour ajouter un ou plusieurs programmes appelés lorsque la commande PWRDWNSYS est exécutée. Ces programmes d'exit peuvent exécuter des fonctions de nettoyage avant que le système ne soit mis hors tension.
6. Lorsque vous modifiez les valeurs système QENDJOBLMT et QPWRDWNLMT, assurez-vous que QPWRDWNLMT est supérieure à QENDJOBLMT. Les valeurs définies doivent laisser assez de temps à l'exécution des fonctions système d'arrêt du travail, telles que l'achèvement du traitement du contrôle de validation et la fermeture des fichiers base de données.

Restrictions :

1. L'utilisateur doit disposer du droit *JOBCTL pour pouvoir exécuter cette commande.
2. Lorsqu'une valeur autre que *NONE est indiquée au paramètre Installer l'unité PTF (INSPTFDEV), vous devez disposer du droit spécial *ALLOBJ (Tous les objets).
3. Lorsque le paramètre IPLSRC (Source de l'IPL) a pour valeur *IMGCLG, les droits suivants sont requis :
   • Droit *EXECUTE sur la bibliothèque QUSRSYS
   • Droit *USE sur le catalogue d'images de CD-ROM indiqué au paramètre IMGCLG (Catalogue d'images de CD-ROM)
   • Droit *USE sur la description d'unité virtuelle
   • Droit *X sur chaque répertoire du nom de chemin du catalogue d'images de CD-ROM
4. Si un programme d'exit utilisateur est défini sur le point d'exit QIBM_QWC_PWRDWNSYS pour le format PWRD0100, le droit *USE est requis sur ce programme d'exit et le droit *EXECUTE est requis sur la bibliothèque contenant le programme. Si tel n'est pas le cas, ce programme d'exit utilisateur n'est pas appelé et la mise hors tension du système se poursuit.

Paramètres

Type d'arrêt (OPTION)

Indique si le système permet au sous-système actif d'arrêter le traitement des travaux actifs de manière contrôlée (permettant aux programmes d'application de mettre fin au traitement) ou si les travaux sont arrêtés immédiatement. Dans les deux cas, le système exécute des opérations d'apurement des travaux.

*CNTRLD

Le sous-système arrête l'ensemble des travaux actifs de façon contrôlée dans le laps de temps indiqué par le paramètre Délai d'arrêt contrôlé DELAY ). Pendant ce temps, les programmes en cours d'exécution dans ces travaux peuvent effectuer des fonctions d'apurement (traitement d'arrêt). Lorsqu'un travail en cours d'arrêt utilise une procédure de traitement du signal asynchrone SIGTERM, ce dernier est généré pour le travail en question. Si un travail actif boucle ou envoie un message d'interrogation à QSYSOPR, indiquez un temps d'attente à l'aide du paramètre DELAY.

*IMMED

Le sous-système arrête immédiatement l'ensemble des travaux actifs. Lorsqu'un travail en cours d'arrêt utilise une procédure de traitement du signal asynchrone SIGTERM, ce dernier est généré pour le travail en question et la valeur système QENDJOBLMT indique le délai autorisé. Hormis l'opération de traitement du signal SIGTERM, les programmes en cours d'exécution dans ces travaux ne peuvent pas effectuer des opérations d'apurement. Une durée minimale est nécessaire lorsque *IMMED est indiqué. Cette durée admise pour les opérations d'apurement (lorsque *IMMED est indiqué) est contrôlée par les valeurs système QENDJOBLMT et QPWRDWNLMT.

Remarque :La valeur *IMMED peut générer des résultats inattendus si les données ont été partiellement mises à jour. Cette valeur doit être utilisée uniquement en cas d'échec de l'arrêt contrôlé.

Remarque :Si *IMMED est indiqué quand le système fonctionne sur alimentation de secours, ou si le temps d'attente indiqué pour le paramètre DELAY (Délai d'arrêt contrôlé) expire alors que le système est sur alimentation de secours, le système démarre la procédure d'arrêt sans effectuer d'autres opérations d'apurement.

Délai d'arrêt contrôlé (DELAY)

Indique, en secondes, le délai à prévoir pour l'arrêt contrôlé des sous-systèmes actifs. Si les routines d'arrêt de travail ne sont pas terminées dans le délai d'attente imparti, tous les travaux restants sont immédiatement arrêtés.

3600

Le temps imparti à l'arrêt contrôlé de l'exécution est limité à 3600 secondes.

*NOLIMIT

Le système ne se met pas hors tension avant que le dernier travail soit terminé.

Remarque :Si *NOLIMIT est indiqué, le système ne se met pas hors tension en cas de bouclage d'un travail par lots.

1-99999

Indiquez le délai d'attente maximal, en secondes, pendant lequel un arrêt contrôlé peut être effectué.

Redémarrer après mise HT (RESTART)

Indique si le système s'arrête et se met hors tension ou s'il s'arrête pour redémarrer ensuite sans contrôle opérateur.

La deuxième partie de ce paramètre indique le point de redémarrage de l'IPL. L'indication de *SYS plutôt que *FULL permet de réduire le délai requis pour le redémarrage du système.

Elément 1 : Redémarrer après mise HT

*NO

Le système s'arrête et se met hors tension.

*YES

Si le système est sur alimentation secteur, il s'arrête mais sans mise hors tension. Le système effectue ensuite un IPL abrégé. S'il est sur alimentation de secours, il se met hors tension et un IPL automatique a lieu lorsque l'alimentation secteur est rétablie (si la valeur système QPWRRSTIPL est '1'). Lorsque le système redémarre, ou dans le cas d'un IPL automatique, l'IPL s'exécute sans contrôle opérateur. En mode sans contrôle opérateur, certains écrans tels que l'écran Options IPL ne s'affichent pas.

Elément 2 : Type de redémarrage

*IPLA

La valeur indiquée dans la commande CHGIPLA (Modifier les attributs d'IPL) est utilisée. Pour déterminer cette valeur, utilisez la commande DSPIPLA (Afficher les attributs d'IPL).

*SYS

Le système d'exploitation est redémarré. Le matériel n'est relancé que lorsque le système le demande.

*FULL

Tout le système, y compris le matériel, est redémarré.

Source de l'IPL (IPLSRC)

Indique si l'IPL (procédure de chargement initial) est démarré à partir de la source A, B ou D du système. Ce paramètre permet de contrôler quelle source de stockage du microcode sous licence (LIC) du système doit être utilisée pour l'IPL. De même, la source du système détermine où les PTF de microcode sous licence sont appliquées. Ce paramètre permet également une mise à jour du système vers une nouvelle édition à partir d'une image d'installation sur une unité de disques (DASD).

Remarques sur la source

Le microcode sous licence (LIC) a trois zones de stockage appelées source A, source B et source D. La source D est le support d'installation. Les sources A et B font partie de la mémoire du système. Au départ, les sources A et B sont identiques, mais lorsque des PTF sont appliquées au microcode sous licence, ces modifications provisoires sont sauvegardées dans la source B. Lorsqu'elles deviennent définitives, elles sont copiées de la source B vers la source A et résident donc dans ces deux sources.

Pour appliquer des PTF provisoirement sur la source B, vous devez lancer le système à partir de la source A ; ces modifications seront alors envoyées dans la source B.

Lorsque vous lancez le système à partir de la source A, vous utilisez les modifications définitives. Lorsque vous le lancez à partir de la source B, vous utilisez des modifications provisoires et des modifications définitives. A partir de la source D, vous utilisez le microcode sous licence qui figure sur le support d'installation.

Pour être complètement sûr que la source appropriée de chargement du système est effectivement utilisée, mentionnez également le paramètre RESTART(*YES).

*PANEL

Lance le système à partir de la source actuellement affichée sur le panneau opérateur, c'est-à-dire la source A, la source B ou la source D.

A

Lance le système à partir de la source A.

B

Lance le système à partir de la source B.

D

Lance le système à partir de la source D (support d'installation).

*IMGCLG

Lance le système à partir du catalogue image indiqué avec le paramètre IMGCLG (Catalogue d'images de CD-ROM). RESTART(*YES) doit être utilisé lorsque cette option est sélectionnée.

Catalogue d'images de CD-ROM (IMGCLG)

Indique le catalogue image utilisé lorsque IPLSRC(*IMGCLG) est sélectionné. Après la mise hors tension du système, une installation utilisant le catalogue image indiqué est exécutée. Pour plus d'informations, reportez-vous à la commande WRKIMGCLGE (Gérer les postes de catalogue). RESTART(*YES) doit être utilisé lorsque ce paramètre est indiqué.

nom

Indiquez le nom du catalogue image de la bibliothèque QUSRSYS.

Type à vérifier (VFYTYPE)

Indique le type de catalogue d'images de CD-ROM qui doit être vérifié.

*UPGRADE

Le catalogue d'images de CD-ROM de type optique qui doit être vérifié est destiné à une mise à jour logicielle complète. Le système vérifie que les images nécessaires pour une mise à jour logicielle existent et peuvent être chargées dans l'unité optique virtuelle. La liste ci-dessous affiche les images optiques dans l'ordre pour IBM i :

1. Microcode sous licence (requis)
2. Système d'exploitation (requis)
3. Bibliothèque QGPL (requise)
4. Bibliothèque QUSRSYS (requise)
5. Options gratuites
6. Logiciels sous licence et options gratuits (bonus)
7. Produits avec clés
8. Produits indépendants
9. Langues secondaires
10. Modifications provisoires de logiciel (PTF)

La liste ci-dessous affiche les images de bande requises dans l'ordre pour IBM i :

1. Microcode sous licence
2. Système d'exploitation
3. Bibliothèque QGPL
4. Bibliothèque QUSRSYS

*LIC

Le catalogue d'images de CD-ROM qui doit être vérifié est destiné à une installation de microcode sous licence uniquement. Le système vérifie que l'image de microcode sous licence existe et peut être chargée dans l'unité optique virtuelle. Pour spécifier *LIC, le verrou doit être en position MANUEL.

Option d'arrêt de sous-système (ENDSBSOPT)

Indique les options à sélectionner lors de l'arrêt des sous-systèmes actifs. En règle générale, le fait d'indiquer ces options permet d'améliorer les performances de la commande PWRDWNSYS. Chaque option comporte quelques effets secondaires que vous devez analyser avant utilisation.

Ce paramètre n'a aucun effet sur les travaux qui sont déjà en cours d'arrêt.

*DFT

Les sous-systèmes s'arrêtent sans qu'aucune option de fin particulière ne soit définie.

• Des historiques de travaux seront produits.
• La priorité d'exécution n'est pas modifiée.
• La valeur de tranche de temps n'est pas modifiée.

*NOJOBLOG

Aucun historique n'est créé pour les travaux arrêtés à l'aide de cette commande, y compris les travaux de moniteur de sous-système et tous les travaux utilisateur du sous-système. Cette option peut réduire de façon significative le temps nécessaire à l'exécution de la commande PWRDWNSYS. Cependant, si un incident se produit au cours de l'exécution d'un travail, il n'est consigné dans aucun historique, rendant ainsi le diagnostic difficile, voire impossible.

Remarque :Si OPTION(*IMMED) est indiqué, aucun historique de travail n'est généré pendant l'exécution de la commande PWRDWNSYS, quelle que soit la valeur du paramètre ENDSBSOPT (Option d'arrêt de sous-système). Toutefois, ces historiques seront générés lors de l'IPL suivant du système, à moins que l'option *NOJOBLOG ne soit indiquée. Par conséquent, si vous indiquez OPTION(*IMMED) ENDSBSOPT(*NOJOBLOG), le système ne sera pas mis hors tension plus rapidement, mais l'IPL suivant sera plus rapide.

*CHGPTY

La priorité du traitement en unité centrale des travaux en cours d'arrêt est remplacée par une valeur supérieure (priorité inférieure). Les autres travaux actifs sur le système sont peut-être plus performants lorsque *CHGPTY est indiqué. Cependant, les travaux en cours d'arrêt risquent de mettre plus de temps à se terminer. Cette option est ignorée si l'arrêt du système est contrôlé. Toutefois, si le délai expire, elle prend effet immédiatement.

*CHGTSL

La tranche de temps associée aux travaux en cours d'arrêt est remplacée par une valeur inférieure. Les autres travaux actifs sur le système sont peut-être plus performants lorsque *CHGTSL est indiqué. Cependant, les travaux en cours d'arrêt risquent de mettre plus de temps à se terminer. Cette option est ignorée si l'arrêt du système est contrôlé. Toutefois, si le délai expire, elle prend effet immédiatement.

Option de délai d'attente (TIMOUTOPT)

Indique l'option à choisir lorsque le système ne s'arrête pas dans le délai indiqué par la valeur système QPWRDWNLMT. Si le délai est dépassé, l'IPL suivant s'exécute de façon anormale, quelle que soit la valeur indiquée pour ce paramètre.

*CONTINUE

Le système ignore le dépassement du délai et poursuit la mise hors tension du système. Si RESTART(*YES) est indiqué, le système redémarre automatiquement. Un minimum d'informations est disponible pour permettre à la maintenance de déboguer le système.

*MSD

Le système génère un cliché de mémoire principale que la maintenance peut utiliser pour déboguer le système. Si le gestionnaire de clichés de mémoire principale est configuré correctement, le système redémarre une fois le cliché terminé.

*SYSREFCDE

Le système affiche le code SRC B900 3F10 et s'arrête. Ceci permet à la maintenance de procéder au débogage du système.

Confirmation (CONFIRM)

Indique si la demande doit être confirmée ou non avant que le système ne soit mis hors tension.

*ENVVAR

La valeur dans la variable d'environnement QIBM_PWRDWNSYS_CONFIRM est utilisée pour déterminer si la demande doit être confirmée ou non. Si la valeur est définie sur *INTERACT, *YES ou *NO, l'action décrite ci-dessous pour la valeur est effectuée. Si la variable d'environnement n'est pas définie ou n'est pas fixée sur une de ces valeurs, un écran de confirmation est affiché lorsque la commande PWRDWNSYS est lancée dans un travail interactif. Les mises hors tension démarrées par le système n'utilisent pas la variable d'environnement.

*INTERACT

Un écran de confirmation est affiché lorsque la commande PWRDWNSYS est lancée dans un travail interactif. Aucune confirmation n'est effectuée lorsque la commande PWRDWNSYS est lancée dans un travail non interactif.

*YES

Un écran de confirmation est affiché lorsque la commande PWRDWNSYS est lancée dans un travail interactif. Aucun message d'interrogation n'est envoyé lorsque la commande PWRDWNSYS est lancée dans un travail non interactif.

*NO

Aucune confirmation n'est effectuée lorsque la commande PWRDWNSYS est lancée.

Installer l'unité PTF (INSPTFDEV)

Indique si les modifications provisoires du logiciel (PTF) doivent être installées avant que le système ne soit mis hors tension. Les PTF sont chargées à partir de l'unité indiquée pour tous les produits installés. Si une unité optique ou une unité de bande est indiquée, les groupes de PTF sont copiés du support sur le système lorsqu'ils n'existent pas déjà sur le système ou lorsque le niveau du groupe de PTF sur le support est supérieur à celui sur le système. Les PTF de traitement spécial répertoriées dans les groupes de PTF sont utilisées lors de l'installation de PTF. L'attribut de maintenance CPYPTF (Copier des PTF) permet de déterminer si les fichiers sauvegarde et les lettres d'accompagnement des PTF seront copiés dans *SERVICE une fois les PTF chargées à partir d'une unité optique ou d'une unité de bande. Une fois les PTF chargées, toutes les PTF sont marquées pour une application différée et seront appliquées au prochain IPL sans contrôle opérateur normal.

Remarque :Un nom d'unité ou *SERVICE ne peut pas être indiqué au paramètre Catalogue d'images de CD-ROM (IMGCLG), IPLSRC(D), ou IPLSRC(*IMGCLG).

*NONE

Aucune PTF n'est installée avant que le système ne soit mis hors tension.

*SERVICE

Les PTF envoyées par le système du service de maintenance sont installées avant que le système ne soit mis hors tension.

nom

Spécifiez le nom de l'unité optique ou de l'unité de bande à partir de laquelle les PTF sont installées avant que le système ne soit mis hors tension.

Exemples

Exemple 1 : arrêt immédiat du système

PWRDWNSYS   OPTION(*IMMED)

Cette commande permet d'arrêter immédiatement le système sans que les travaux actifs aient le temps d'effectuer les opérations d'apurement. Une fois les fonctions d'arrêt terminées, le système démarre la phase de mise hors tension.

Exemple 2 : spécification d'un arrêt contrôlé

SBMJOB   JOB(LASTJOB)  JOBD(QBATCH)  JOBPTY(9)  JOBQ(QBATCH)
         RQSDTA('PWRDWNSYS *CNTRLD 3600')

Cette commande permet de soumettre un travail par lots de priorité faible qui, lorsqu'il est exécuté, provoque un arrêt contrôlé du système. L'arrêt contrôlé dispose d'une heure (3600 secondes) pour s'exécuter avant l'arrêt des travaux restants. Cette méthode, qui consiste à utiliser la commande PWRDWNSYS, peut permettre l'exécution des autres travaux de priorité élevée situés dans la file d'attente des travaux QBATCH (y compris ceux qui sont dans la file d'attente en raison de l'utilisation de la commande TFRJOB (Transférer un travail)) avant l'exécution de la commande PWRDWNSYS. Il doit exister un sous-système actif dont la file d'attente des travaux QBATCH représente une source de travail.

Exemple 3 : spécification d'un arrêt contrôlé sans limite de temps

PWRDWNSYS   OPTION(*CNTRLD)  RESTART(*YES)

Cette commande permet au système d'effectuer un arrêt contrôlé sans limite de temps. Lorsque tous les travaux du système sont terminés, le système prépare sa mise hors tension et démarre un IPL.

Après l'entrée de l'option PWRDWNSYS OPTION(*CNTRLD) et avant la fin du temps d'attente, cette commande peut être substituée par l'option PWRDWNSYS OPTION(*IMMED). Dans ce cas, les valeurs indiquées ou par défaut du paramètre RESTART de la seconde commande substituent également les valeurs indiquées ou par défaut de la première commande.

Exemple 4 : modification de la source de l'IPL après l'arrêt immédiat

PWRDWNSYS   OPTION(*IMMED)  RESTART(*YES)  IPLSRC(A)

Cette commande permet au système de s'arrêter immédiatement et de modifier la source de l'IPL en A. Lorsque le système redémarre, il le fait à partir de la source A.

Exemple 5 : détermination du point de redémarrage par le système d'exploitation

PWRDWNSYS   OPTION(*IMMED)  RESTART((*YES *SYS))

Cette commande permet à l'IPL de redémarrer au point de redémarrage déterminé par le système d'exploitation.

Exemple 6 : modification de l'option de délai

PWRDWNSYS   OPTION(*IMMED)  TIMOUTOPT(*MSD)

Cette commande permet au système de s'arrêter immédiatement. Si la valeur système QPWRDWNLMT est dépassée, le système va clicher la mémoire principale. Si le gestionnaire de clichés de mémoire principale est configuré correctement, le système redémarrera. Dans le cas inverse, le code SRC B900 3F10 s'affichera et le système s'arrêtera.

Exemple 7 : installation d'une nouvelle édition du système d'exploitation

PWRDWNSYS   RESTART(*YES)  IPLSRC(*IMGCLG)  IMGCLG(MYCAT1)

Cette commande permet au système d'arrêter et de démarrer l'installation d'une nouvelle édition du système d'exploitation à partir du catalogue image MYCAT1.

Messages d'erreur

Messages *ESCAPE

CPF1001

Délai d'attente expiré pour réponse système.

CPF1036

Mise hors tension du système avec l'option *CNTRLD.

CPF1037

Mise hors tension du système avec l'option *IMMED.

CPF1038

Vous n'êtes pas autorisé à utiliser la commande indiquée.

CPF1091

Anomalie de fonctionnement dans l'arbitre système.

CPF18C7

Poursuite de PWRDWNSYS non admise.

CPF222E

Le droit spécial &1 est requis.

CPF3615

L'installation des PTF a échoué.

CPFBC42

Echec de la vérification pour le catalogue d'images de CD-ROM &1.