Commande CL IBM i (AS/400)
TRCASPBAL
Tracer l'équilibrage ASP
En bref
La commande TRCASPBAL contrôle la fonction qui permet de collecter les données statistiques d'utilisation des ASP.
TRCASPBAL se lit TRC
(Tracer) + ASPBAL.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
TRCASPBAL
Paramètres
Astuce : dans une session 5250, tapez TRCASPBAL 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 TRCASPBAL contrôle la fonction qui permet de collecter les données statistiques d'utilisation des ASP. La fonction de trace contrôle la fréquence des accès aux données sur les unités de disques contenues dans l'ASP concerné. Les données à utilisation "élevée" et "faible" sont ainsi identifiées. La trace de l'utilisation des données sur les unités peut être lancée sur un ASP spécifique ou sur plusieurs. La durée d'exécution peut également être définie. La fonction de trace peut être arrêtée en indiquant la valeur *OFF au paramètre Option de trace (SET). Elle peut être stoppée à tout moment et relancée ultérieurement. Les données statistiques collectées sont cumulatives. Par exemple, si la trace est lancée et arrêtée, puis relancée sans mise à blanc des statistiques, le deuxième groupe de statistiques est ajouté au premier.
Une fois les données statistiques collectées, l'équilibrage de l'ASP peut être lancé à l'aide de la commande STRASPBAL, en précisant TYPE(*USAGE) ou TYPE(*HSM). Au terme de celui-ci, les données statistiques sont automatiquement supprimées.
L'équilibrage de l'ASP doit avoir lieu aussitôt après la collecte des statistiques. En effet, son utilité diminue si les informations statistiques ne sont plus récentes. Dans ce cas, vous pouvez effacer ces statistiques en indiquant *CLEAR au paramètre SET.
Un message est envoyé dans l'historique du système (QHST) au démarrage et à l'arrêt de la trace, et lors de la suppression des données de trace.
Pour plus d'informations sur l'équilibrage ASP, consultez le manuel Hierarchical Storage Management Use, SC41-5351.
Restrictions :
- Vous devez disposer des droits spéciaux (*ALLOBJ) pour exécuter cette commande.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| SET | Option de trace | *ON, *OFF, *CLEAR | Facultatif |
| ASP | Numéro d'ASP | Valeurs uniques: *ALL Autres valeurs (jusqu'à 32 répétitions): 1-32 |
Facultatif, positionnel 1 |
| ASPDEV | Unité ASP | Valeurs uniques: *ALLAVL Autres valeurs (jusqu'à 32 répétitions): Nom |
Facultatif, positionnel 2 |
| TIMLMT | Limite de temps | 1-9999, *NOMAX | Facultatif |
Option de trace (SET)
Indique si la collecte des statistiques doit être démarrée, arrêtée, ou si des statistiques d'utilisation préalablement collectées pour un ASP doivent être supprimées.
Remarque :Une valeur doit toujours être indiquée pour ce paramètre.
- *ON
- La fonction de trace des statistiques va être lancée.
- *OFF
- La fonction de trace des statistiques va être arrêtée.
- *CLEAR
- Les statistiques relatives à l'ASP spécifié vont être supprimées.
Numéro d'ASP (ASP)
Indique le nom de l'ASP pour lequel la fonction de trace doit être lancée, arrêtée ou annulée.
Remarque :Une valeur doit être spécifiée au paramètre ASP (Numéro d'ASP) ou ASPDEV (Unité ASP).
Valeurs uniques
- *ALL
- La fonction de trace ASP va être lancée, arrêtée ou annulée pour l'ASP système (ASP numéro 1) ainsi que pour tous les ASP de base (ASP numéros 2 à 32) définis sur le système.
Autres valeurs (jusqu'à 32 répétitions)
- 1-32
- Indique le numéro de l'ASP pour lequel la fonction de trace ASP doit être lancée, arrêtée ou annulée.
Unité ASP (ASPDEV)
Indique l'unité ASP pour laquelle la fonction de trace doit être lancée, arrêtée ou annulée.
Remarque :Une valeur doit être spécifiée au paramètre ASP (Numéro d'ASP) ou ASPDEV (Unité ASP).
Valeurs uniques
- *ALLAVL
- La fonction de trace ASP va être lancée, arrêtée ou annulée pour toutes les unités ASP à l'état "Disponible".
Autres valeurs (jusqu'à 32 répétitions)
- nom
- Indiquez le nom de l'unité ASP indépendante pour laquelle l'équilibrage ASP doit être lancé.
Limite de temps (TIMLMT)
Indique, en minutes, la durée d'exécution admise pour la fonction d'équilibrage ASP. A l'issue de cette durée, la fonction s'arrête. La fonction de trace ne s'exécute pas pendant un IPL.
Remarque :Une valeur doit être indiquée pour ce paramètre lorsque la valeur *ON est spécifiée au paramètre Option de trace (SET).
- 1-9999
- Spécifiez la durée (nombre de minutes) maximale d'exécution de la fonction de trace.
Exemples
Exemple 1 : Démarrage de la fonction de trace pour l'ASP 1
TRCASPBAL ASP(1) SET(*ON) TIMLMT(9999)
Cette commande permet à un utilisateur de démarrer la fonction de trace ASP pour l'ASP 1. Cette fonction s'exécute jusqu'à ce qu'elle soit interrompue par l'utilisateur ou au bout de 9999 minutes.
Exemple 2 : Arrêt de la fonction de trace pour tous les ASP
TRCASPBAL ASP(*ALL) SET(*OFF)
Cette commande permet à un utilisateur d'arrêter la fonction de trace ASP pour chaque ASP sur lequel s'exécute une fonction de trace.
Exemple 3 : Effacement des données de trace pour l'ASP 1
TRCASPBAL ASP(1) SET(*CLEAR)
Cette commande permet à un utilisateur d'effacer les données de trace pour l'ASP 1.
Exemple 4 : Arrêt de la fonction de trace pour toutes les unités ASP
TRCASPBAL ASPDEV(*ALLAVL) SET(*OFF)
Cette commande permet à un utilisateur d'arrêter la fonction de trace ASP pour chaque unité ASP sur laquelle s'exécute une fonction de trace.
Messages d'erreur
Messages *ESCAPE
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.