Aller au contenu

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

CPF1890
Droit *ALLOBJ requis pour l'opération demandée.
CPF18B2
Fonction d'équilibrage en cours d'exécution pour l'ASP &1 &2.
CPF9829
Pool de mémoire secondaire &1 non trouvé.
CPF9899
Erreur lors du traitement de la commande.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.