ENDSYS

La commande ENDSYS (Arrêter le système) permet d'arrêter la plupart des travaux du système. Seule la console système demeure active dans le sous-système de contrôle. Ceci permet à l'opérateur d'effectuer des tâches telles que la sauvegarde du système ou le chargement de nouveaux programmes. Cette condition dite "état restreint" s'avère nécessaire pour des opérations de sauvegarde du système ou de récupération de mémoire. Si deux travaux sont actifs sur la console du sous-système de contrôle, l'arrêt de ceux-ci n'est pas obligatoire. L'exécution de la commande ENDSYS ne peut pas s'achever tant que vous n'avez pas arrêté l'un des deux travaux (soit en fermant la session en cours, soit en arrêtant un travail à partir d'un autre).

L'exécution d'une opération d'arrêt du système est signalée à tous les sous-systèmes actifs. Ceux-ci ne peuvent pas prendre en charge de nouveaux travaux ou phases d'activation. Cette commande permet également d'indiquer le type d'arrêt de tous les travaux actifs.

Les travaux interactifs qui sont transférés vers une file d'attente de travaux par la commande TFRJOB (Transférer un travail) prennent fin en cas d'arrêt du sous-système. Si un IPL se produit lorsqu'un travail par lots ou interactif se trouve dans une file d'attente de travaux (en raison de la commande TFRJOB), ce travail est supprimé de la file d'attente de travaux lors de l'IPL, puis son historique est généré.

Restriction : Cette commande peut être entrée uniquement dans un travail interactif du sous-système de contrôle. Pour exécuter cette commande, l'utilisateur doit disposer du droit d'exploitation des travaux (*JOBCTL). Cette commande n'est pas admise dans un travail passe-système ou dans un travail de fonction de poste de travail.

Paramètres

Type d'arrêt (OPTION)

Indique la manière dont les travaux actifs sont arrêtés : contrôlée (les programmes d'application mettent fin au traitement) ou immédiate. Dans l'un ou l'autre des cas, le système exécute des opérations d'épuration.

*CNTRLD

Les travaux sont arrêtés de façon contrôlée. Les programmes en cours d'exécution peuvent ainsi effectuer des opérations de nettoyage (fin de traitement des travaux). Lorsqu'un travail en cours d'arrêt dispose d'une procédure de gestion de signal pour le signal asynchrone SIGTERM, le signal SIGTERM est généré pour ce travail. L'application dispose du temps indiqué dans le paramètre DELAY pour terminer les opérations d'apurement avant la fin du travail.

*IMMED

Les travaux sont arrêtés immédiatement. 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 ne peuvent pas effectuer des opérations d'apurement.

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

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

Indique, en secondes, la durée à prévoir pour l'exécution de la procédure d'arrêt contrôlé. Au terme du délai d'attente imparti, tout travail demeurant en cours de traitement, à l'exception de ceux qui exécutent des instructions de longue durée, sera arrêté immédiatement.

*NOLIMIT

La durée prévue pour effectuer un arrêt contrôlé n'est pas limitée.

0-99999

Indiquez une valeur, en secondes, correspondant à la durée prévue pour effectuer l'arrêt.

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 général, le fait d'indiquer ces options permet d'améliorer les performances de la commande ENDSYS. 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 ENDSYS. 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.

*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 sous-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 sous-système est contrôlé. Toutefois, si le délai expire, elle prend effet immédiatement.

Confirmation (CONFIRM)

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

*ENVVAR

La valeur dans la variable d'environnement QIBM_ENDSYS_CONFIRM est utilisée pour déterminer si la demande doit être confirmée ou non. Si la valeur est définie sur *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, la confirmation n'est pas effectuée.

*YES

Un écran de confirmation est affiché lorsque la commande ENDSYS est lancée.

*NO

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

Exemples

Exemple 1 : arrêt de l'activité du système

ENDSYS

Cette commande permet d'arrêter l'activité du système après que tous les travaux actifs du système ont été autorisés à mettre fin à leur propre traitement. La durée de l'arrêt d'activité n'est pas limitée.

Exemple 2 : arrêt de l'activité du système après l'arrêt des travaux

ENDSYS   OPTION(*IMMED)

Cette commande permet d'arrêter l'activité du système après l'arrêt immédiat de tous les travaux actifs.

Messages d'erreur

Messages *ESCAPE

CPF1001

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

CPF1017

Commande ENDSYS non admise si console hors tension ou hors fonction.

CPF1032

Système en cours d'arrêt avec l'option *CNTRLD.

CPF1033

Système en cours d'arrêt avec l'option *IMMED.

CPF1034

Tous les sous-systèmes sont en cours d'arrêt avec l'option *CNTRLD.

CPF1035

Sous-systèmes en cours d'arrêt avec l'option *IMMED.

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.

CPF1051

La commande ne peut être exécutée que dans le sous-système de contrôle.

CPF1082

Sous-système de contrôle restreint à un seul travail.

CPF1091

Anomalie de fonctionnement dans l'arbitre système.

CPF18C3

Le programme du point de sortie &1 ne peut pas accéder à l'état restreint.