ENDSBS

La commande ENDSBS (Arrêter un sous-système) arrête le sous-système indiqué (ou tous les sous-systèmes actifs) et indique ce qu'il advient des travaux en cours de traitement. Aucun travail ou aucune phase d'activation n'est démarré dans le ou les sous-systèmes arrêtés après l'exécution de cette commande.

Les travaux interactifs transférés dans une file d'attente de travaux par la commande TFRJOB (Transférer un travail) sont arrêtés en même temps que le 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é.

Vous pouvez demander un délai pour que les programmes d'application exécutés dans le sous-système puissent contrôler la fin des travaux. En l'absence de délai ou si le ménage ne peut pas être effectué dans le temps imparti, le système met fin aux travaux en appliquant la procédure minimale, à savoir :

• la fermeture des fichiers base de données,
• la création de l'historique du travail dans une file d'attente en sortie,
• le ménage des objets internes du système d'exploitation,
• affichage de la fin des travaux (pour les travaux interactifs),
• le traitement de contrôle de validation.

Restrictions :

1. Pour exécuter cette commande, vous devez disposer des droits spéciaux d'exploitation des travaux (*JOBCTL).
2. Si le sous-système de contrôle est arrêté, parce que son nom ou *ALL est indiqué au paramètre SBS (Sous-système), cette commande peut être exécutée uniquement
   • dans le cadre d'un travail interactif du sous-système de contrôle et à partir d'un poste de travail (associé au travail interactif) pour lequel *SIGNON est indiqué dans la description du sous-système au paramètre AT (Affectation). Pour plus d'informations, reportez-vous à la commande ADDWSE (Ajouter poste écran à s-syst).
   • ou dans le cadre d'un travail par lots dans le sous-système de contrôle, initié par une file d'attente de travaux avec le paramètre BCHTIMLMT et SBS(*ALL) indiqués.

   ENDSBS SBS(*ALL) n'est pas admis dans un travail TELNET, en passe-système ou dans le cadre de la fonction postes de travail.

3. ENDSBS SBS(*ALL) n'est pas admis dans un travail par lots qui admet plusieurs unités d'exécution.

Paramètres

Sous-système (SBS)

Indique le nom du sous-système devant être arrêté, ou indique que tous les sous-systèmes actifs doivent être arrêtés.

Ce paramètre est obligatoire.

*ALL

Tous les sous-systèmes actuellement actifs sont arrêtés. Tous les travaux sont arrêtés, à l'exception du travail où s'exécute la commande. Lorsque cette valeur est indiquée, la file d'attente de messages QSYSOPR doit être en mode interruption dans le travail émettant la commande (Arrêter un sous-système).

nom

Indiquez le nom du sous-système à arrêter. S'il s'agit du sous-système de contrôle, le travail interactif d'où provient la commande reste actif. De même, si le sous-système indiqué est le sous-système de contrôle, et si le travail émettant cette commande est l'un des deux travaux secondaires actifs dans le poste de travail, l'arrêt de ces travaux n'est pas forcé. Le sous-système de contrôle ne s'arrête pas tant que vous n'avez pas arrêté l'un des travaux (soit en fermant la session en cours, soit en arrêtant un travail à partir d'un autre).

Type d'arrêt (OPTION)

Indique la manière dont les travaux du sous-système sont arrêtés : contrôlée (les programmes d'application mettent fin au traitement des travaux) ou immédiate.

*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é du sous-système. Au terme du délai d'attente imparti, tout travail demeurant en cours de traitement dans le sous-système 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 ENDSBS. 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 ENDSBS. 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.

Remarque :Le fait d'indiquer *CHGPTY et *CHGTSL permet de réduire l'impact de l'arrêt du sous-système sur les autres travaux en cours sur le système, mais risque d'entraîner des retards indésirables si des postes de travail actifs ont été affectés au sous-système en cours d'arrêt. Le réaffichage de l'écran d'ouverture de session sur ces postes de travail risque de prendre plus de temps, car le travail utilisant l'écran doit s'arrêter avant que le poste de travail ne soit disponible pour être affecté à un autre sous-système.

Délai du lot (BCHTIMLMT)

Indique (en minutes) le temps d'exécution du système à l'état restreint. Ce paramètre est correct uniquement lorsque tous les sous-systèmes d'un travail par lots sont arrêtés dans le sous-système de contrôle. Dans cette condition, vous devez affecter une valeur au paramètre. Lorsque ce paramètre est indiqué, le système passe en état restreint, où seul le travail par lots exécute la commande ENDSBS active. Tant que le système est en état restreint, le code de référence A900 3C70 est affiché. Si le délai est atteint, le travail par lots est arrêté et le sous-système de contrôle redémarre. Lorsque le travail est terminé, le sous-système de contrôle démarre.

Remarque :Ce paramètre est recommandé uniquement pour une application qui n'admet aucune intervention de l'utilisateur.

*NOMAX

Il n'y a pas de limite de temps pour la fonction de restriction. Le système demeure à l'état restreint jusqu'à l'arrêt du travail,la commande STRSBS (Démarrer un sous-système) est utilisée ou l'option Outils de maintenance en mode dédié est utilisée pour arrêter l'état restreint du lot.

5-9999

Indiquez la durée maximale (en minutes) de l'exécution de la fonction de restriction des lots.

Délai de fin anormal (ABNENDDLY)

Indique, en minutes, la durée à prévoir pour l'exécution de la procédure d'arrêt immédiat du sous-système. Au terme du délai d'attente imparti, tout travail demeurant en cours de traitement dans le sous-système sera arrêté de façon anormale. Si un travail est arrêté de façon anormale, l'arrêt de système suivant est marqué comme anormal. Le délai d'attente peut être prolongé si des travaux avec des gestionnaires SIGTERM actifs ne sont pas terminés.

*NOLIMIT

La durée prévue pour effectuer un arrêt immédiat n'est pas limitée.

10-999

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

Exemples

ENDSBS   SBS(QBATCH)  OPTION(*CNTRLD)  DELAY(60)

Cette commande permet d'arrêter tous les travaux actifs du sous-système QBATCH ainsi que le sous-système. Les travaux actifs ont 60 secondes pour mettre fin au traitement des travaux à l'aide de l'application.

Messages d'erreur

Messages *ESCAPE

CPF1001

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

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.

CPF1052

ENDSBS *ALL non permis dans environnement en cours.

CPF1053

Arrêt du sous-système de contrôle &1 non permis.

CPF1054

Le sous-système &1 n'est pas actif.

CPF1055

Sous-système &1 en cours d'arrêt avec l'option *CNTRLD.

CPF1056

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

CPF1081

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.