RCLACTGRP
Récupérer groupe d'activation
En bref
La commande RCLACTGRP (Récupérer le groupe d'activation) supprime un groupe d'activation défini et libère les ressources qui lui sont associées.
RCLACTGRP se lit RCL
(Récupérer (libérer)) + ACTGRP.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
RCLACTGRP ACTGRP(…)Paramètres
Astuce : dans une session 5250, tapez RCLACTGRP 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 : Tous les environnements (*ALL)
Compatible multitâche : Non
La commande RCLACTGRP (Récupérer le groupe d'activation) supprime un groupe d'activation défini et libère les ressources qui lui sont associées. Elle ne permet pas de récupérer les ressources spécifiques au travail ou au groupe d'activation par défaut. Généralement, cette commande utilisée uniquement dans le programme de contrôle de l'application.
Un groupe d'activation peut être récupéré s'il remplit les conditions suivantes :
- Il n'est pas le groupe d'activation par défaut.
Le groupe d'activation par défaut ne peut pas être récupéré.
- Il n'est pas actif.
Un groupe d'activation ne peut pas être récupéré si certains de ses programmes ou procédures sont en cours d'exécution.
- Il ne fait pas partie des groupes d'activation de débogage.
Lorsque le travail est en mode débogage, les groupes d'activation utilisés ne sont pas signalés comme actifs dans les écrans Liste d'appel ou Groupe d'activation.
- Ce n'est pas un groupe d'activation partagé.
Un groupe d'activation partagé ne peut pas être récupéré, car il se peut qu'il soit en cours d'utilisation par un autre travail.
Lorsqu'un groupe d'activation est récupéré, toutes les ressources qui en dépendent sont récupérées. Ces ressources sont la mémoire statique pour les programmes du groupe d'activation, les fichiers ouverts, les ressources applicatives du Gestionnaire d'interface utilisateur (UIM), les conversations du CPI communications, les ressources du système hiérarchique de fichiers (HFS), les sessions de communication définies par l'utilisateur et les modifications en instance pour la définition de validation.
Une option de fermeture peut être indiquée à cette commande ; elle est utilisée pour fermer des fichiers mixtes, ICF et BSC, et des fichiers de communication. Si une définition de validation de niveau de groupe d'activation est démarrée pour le groupe d'activation, et que des modifications sont en instance de validation, cette option permet également d'indiquer si les modifications en instance sont validées ou invalidées implicitement par le système avant la fin de la définition de validation. Lorsque l'option de fermeture a pour valeur *NORMAL et qu'aucune erreur n'est détectée lors de la fermeture des fichiers à l'aide de la définition de validation de niveau de groupe d'activation, une validation est effectuée. Sinon, une invalidation est exécutée. Reportez-vous au manuel Reprise du système, SC41-5304 pour de plus amples informations sur les opérations d'invalidation exécutées par le système lors d'un contrôle de validation.
Un groupe d'activation doit être récupéré uniquement s'il n'est plus requis au sein du même travail. Sinon, des erreurs et des résultats imprévisibles risquent de se produire lorsque d'autres programmes tenteront ultérieurement d'accéder aux ressources qui ont été récupérées. C'est pourquoi généralement, cette commande doit uniquement être lancée dans le programme de contrôle d'une application. Une connaissance parfaite de l'environnement de travail est nécessaire pour lancer la commande ACTGRP(*ELIGIBLE). Sinon, des résultats imprévisibles peuvent se produire.
Pour plus d'informations sur l'utilisation de cette commande, reportez-vous au manuel IBM System Manager for i.
Restrictions :
- Cette commande n'admet pas les unités d'exécution multiples. Elle n'aboutira pas dans un travail à unités d'exécution multiples.
Groupe d'activation (ACTGRP)
Indique le groupe d'activation à récupérer.
- *ELIGIBLE
- Tous les groupes d'activation éligibles dans ce travail sont supprimés.
- nom-groupe-activation
- Indiquez le groupe d'activation à récupérer, ce qui n'est possible que s'il n'a pas d'appels actifs. S'il en a, un message informe l'utilisateur que la demande a échoué. Si le groupe d'activation n'est pas trouvé, un message en informe l'utilisateur.
Option de fermeture (OPTION)
Indique, pour une définition de validation au niveau groupe d'activation, s'il faut valider ou invalider les modifications en instance, et s'il faut envoyer une notification de fermeture normale ou anormale vers le système hôte connecté, lors de la fermeture des fichiers mixtes, communications, BSC et ICF. Ce paramètre est ignoré pour tous les autres fichiers et objets qui dépendent du groupe d'activation.
- *NORMAL
- Les modifications en instance pour une définition de validation au niveau groupe d'activation sont validées, s'il ne se produit pas d'erreur lors de la fermeture des fichiers à l'aide de cette définition de validation, et une notification de fermeture normale est envoyée vers le système hôte connecté lors de la fermeture des fichiers mixtes, communications, BSC et ICF.
- *ABNORMAL
- Les modifications en instance pour une définition de validation au niveau groupe d'activation sont invalidées, et une notification de fermeture anormale est envoyée vers le système hôte connecté lors de la fermeture des fichiers mixtes, communications, BSC et ICF.
Messages d'erreur
Messages *ESCAPE
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.