ADDDWDFN

Ajouter définition Disk Watcher

Add Disk Watcher Definition

En bref

La commande Ajouter une définition Disk Watcher (ADDDWDFN) ajoute une nouvelle définition Disk Watcher au système. The Add Disk Watcher Definition (ADDDWDFN) command adds a new Disk Watcher definition to the system.

ADDDWDFN se lit ADD (Ajouter) + DWDFN. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ADDDWDFN DFN(…)

Paramètres

DFN Définition obligatoire
TEXT Texte 'descriptif'
COLITV Intervalle de collecte Collection interval
ASP Numéro d'ASP
ASPDEV Unité ASP
DSKUNIT Identificateur d'unité de disque Disk unit identifier
POOLID Identificateur de pool de mémoire Storage pool identifier
TYPE Type
IOTYPE Type d'E/S I/O type
OBJINF Informations sur les objets Object information
COLCOND Condition de collecte Collection condition
COLRNG Plage de collecte Collection range
FRCRCD Forcer écriture enregistrement
TOASPTHLD Seuil d'ASP du fichier To file ASP threshold
SYSASPTHLD Seuil d'ASP système System ASP threshold

Astuce : dans une session 5250, tapez ADDDWDFN 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 Ajouter une définition Disk Watcher (ADDDWDFN) ajoute une nouvelle définition Disk Watcher au système. Une définition Disk Watcher identifie les données de performance à collecter lors d'une collecte Disk Watcher. Une session peut être démarrée à l'aide de la commande Démarrer Disk Watcher (STRDW). Une définition est requise pour démarrer une nouvelle collecte Disk Watcher. The Add Disk Watcher Definition (ADDDWDFN) command adds a new Disk Watcher definition to the system. A Disk Watcher definition identifies the performance data that is to be collected during a Disk Watcher collection. A session can be started using the Start Disk Watcher (STRDW) command. A definition is required when starting a new Disk Watcher collection.

Restrictions:

Pour utiliser cette commande, vous devez posséder le droit spécial de service (*SERVICE) ou être autorisé à la fonction Disk Watcher du système d'exploitation. La commande Modifier l'utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_SERVICE_DISK_WATCHER, permet de modifier la liste des utilisateurs autorisés à utiliser cette commande. To use this command, you must have service (*SERVICE) special authority, or be authorized to the Disk Watcher function of the operating system. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_DISK_WATCHER, can be used to change the list of users that are allowed to use this command.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DFN	Définition	Nom	Obligatoire, positionnel 1
TEXT	Texte 'descriptif'	Valeur caractère, *BLANK	Facultatif
COLITV	Intervalle de collecteCollection interval	1-3600, *DYN	Facultatif
ASP	Numéro d'ASP	Valeurs uniques: ALL, ASPDEV Autres valeurs (jusqu'à 10 répétitions): 1-255, *SYS	Facultatif
ASPDEV	Unité ASP	Nom	Facultatif
DSKUNIT	Identificateur d'unité de disqueDisk unit identifier	Valeurs uniques: *ALL Autres valeurs (jusqu'à 10 répétitions): 1-6047	Facultatif
POOLID	Identificateur de pool de mémoireStorage pool identifier	1-64, *ALL	Facultatif
TYPE	Type	STATS, ALL, *TRACE	Facultatif
IOTYPE	Type d'E/SI/O type	ALL, READ, *WRITE	Facultatif
OBJINF	Informations sur les objetsObject information	NONE, ALL, *RESIDENT	Facultatif
COLCOND	Condition de collecteCollection condition	Valeurs uniques: NONE Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Type de données	RESPTIME, QTIME, *SERVTIME
	Élément 2: Opérateur relationnel	LT, GT, LE, GE
	Élément 3: Valeur	Entier
COLRNG	Plage de collecteCollection range	Valeurs uniques: NONE Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Type de données	RESPTIME, QTIME, *SERVTIME
	Élément 2: Valeur inférieure	Entier
	Élément 3: Valeur supérieure	Entier
FRCRCD	Forcer écriture enregistrement	ITVEND, CALC	Facultatif
TOASPTHLD	Seuil d'ASP du fichierTo file ASP threshold	1-99, *SYSTEM	Facultatif
SYSASPTHLD	Seuil d'ASP systèmeSystem ASP threshold	1-99, *SYSTEM	Facultatif

Définition (DFN)

Indique le nom de la définition Disk Watcher ajoutée. Si la définition indiquée existe déjà, une condition d'erreur se produit. Ce paramètre est obligatoire. Specifies the name of the Disk Watcher definition being added. If the specified definition already exists an error condition will occur. This is a required parameter.

nom: Indiquez le nom de la nouvelle définition Disk Watcher. Specify the name of the new Disk Watcher definition.

Texte 'descriptif' (TEXT)

Description textuelle de la définition Disk Watcher à ajouter. The text description of the Disk Watcher definition to be added.

*BLANK: La définition Disk Watcher n'aura pas de description textuelle. The Disk Watcher definition will have no text description.
valeur-caractère: Indiquez la description textuelle de cette définition Disk Watcher. La description ne doit pas dépasser 50 caractères, placés entre apostrophes. Specify the text description for this Disk Watcher definition. The description should be no more that 50 characters of text, enclosed in apostrophes.

Intervalle de collecte (COLITV)Collection interval (COLITV)

Indique l'intervalle entre deux extractions des données d'E/S disque. Specifies the interval between retrieval of disk I/O data.

Remarque : Les données de disque sont collectées à partir d'un enregistreur de vol à rebouclage. Si la valeur indiquée pour ce paramètre est trop grande, des opérations d'E/S peuvent être manquées. Le format d'enregistrement du fichier de base de données Disk Watcher QAPYDWINTI comporte une zone ('Data missed') qui indique si des opérations d'E/S ont été manquées pendant l'intervalle. Remarque :Disk data is collected from a wrapping flight recorder. If the value specified for this parameter is too large, I/O operations may be missed. The record format for Disk Watcher database file QAPYDWINTI includes a field ('Data missed') which indicates whether I/O operations were missed during the interval.

*DYN: L'intervalle de temps entre les échantillons est dynamique. Cela signifie que l'intervalle en secondes est ajusté à la valeur optimale et peut changer pendant la collecte. La valeur optimale est l'intervalle le plus long pouvant être utilisé sans perte de données. The time interval between samples is dynamic. This indicates that the interval seconds will be adjusted to the optimal value and may change during the collection. The optimal value is the largest interval time that can be used without missing data.
1-3600: Indiquez le nombre de secondes entre les intervalles. Specify the number of seconds between intervals.

Numéro d'ASP (ASP)

Indique les pools de mémoire secondaire pour lesquels les informations d'E/S disque sont collectées. Les ASP sélectionnés doivent être mis en fonction pour que la collecte de données ait lieu. Specifies the auxiliary storage pools for which disk I/O information will be collected. Selected ASPs must be varied on in order for data collection to occur.

Valeurs uniques

*ALL: Les informations d'E/S disque sont collectées pour tous les ASP du système. Disk I/O information will be collected for all ASPs on the system.
*ASPDEV: Disk I/O information will be collected for the independent ASP specified for the Unité ASP (ASPDEV) parameter.
Remarque : Une valeur doit être indiquée pour le paramètre ASPDEV si cette valeur est indiquée. Remarque :A value must be specified for the ASPDEV parameter if this value is specified.

Autres valeurs (jusqu'à 10 répétitions)

*SYS: Les informations d'E/S disque sont collectées uniquement pour l'ASP système (ASP 1). Disk I/O information will be collected for only the system ASP (ASP 1).
1-255: Indiquez le numéro d'ASP pour lequel les informations d'E/S disque sont collectées. Specify the ASP number for which disk I/O information will be collected.

Unité ASP (ASPDEV)

Indique l'unité de pool de mémoire secondaire (ASP) indépendant pour laquelle les informations d'E/S disque doivent être collectées. Specifies the independent auxiliary storage pool (ASP) device for which disk I/O information should be collected.

Remarque : Une valeur doit être indiquée pour ce paramètre si *ASPDEV est indiqué pour le paramètre Numéro d'ASP (ASP). Remarque :A value must be specified for this parameter if *ASPDEV is specified for the Numéro d'ASP (ASP) parameter.

nom: Indiquez le nom de l'unité d'ASP indépendant pour laquelle les informations d'E/S disque doivent être collectées. La description d'unité associée à l'ASP indépendant doit être mise en fonction et avoir le statut 'Disponible' pour que la collecte de données ait lieu. Specify the name of the independent ASP device for which disk I/O information should be collected. The device description associated with the independent ASP must be varied on and have a status of 'Available' in order for data collection to occur.

Identificateur d'unité de disque (DSKUNIT)Disk unit identifier (DSKUNIT)

Indique les unités de disque pour lesquelles les informations d'E/S doivent être collectées. Les identificateurs d'unité de disque de 4001 à 6047 sont réservés aux pools de mémoire secondaire indépendants. Specifies the disk units for which I/O information should be collected. Disk unit identifiers from 4001 through 6047 are reserved for independent auxiliary storage pools.

Valeurs uniques

*ALL: Les informations d'E/S disque sont collectées pour toutes les unités de disque des pools de mémoire secondaire indiqués par le paramètre Numéro d'ASP (ASP) ou Unité d'ASP (ASPDEV). Disk I/O information will be collected for all disk units in the auxiliary storage pools specified by the Numéro d'ASP (ASP) or Unité ASP (ASPDEV) parameter.

Autres valeurs (jusqu'à 10 répétitions)

1-6047: Indiquez l'identificateur numérique de chaque unité de disque pour laquelle les informations d'E/S disque sont collectées. Specify the numeric identifier of each disk unit for which disk I/O information will be collected.

Identificateur de pool de mémoire (POOLID)Storage pool identifier (POOLID)

Indique le pool de mémoire principale pour lequel les informations d'E/S disque doivent être collectées lorsque des données sont lues du disque vers la mémoire ou réécrites de la mémoire vers le disque. Ce paramètre est une valeur comprise entre 1 et 64, où le pool 1 est le pool machine et le pool 2 est le pool de base. Cette valeur correspond également à l'identificateur affiché sur l'écran Gestion de l'état du système (WRKSYSSTS). Specifies the main memory storage pool for which disk I/O information should be collected as data is read from disk into memory or written from memory back to disk. This parameter is a value ranging from 1 through 64, where pool 1 is the machine pool, and pool 2 is the base pool. This value also corresponds to the identifier shown on the Work with System Status (WRKSYSSTS) display.

Valeurs uniques

*ALL: Les informations d'E/S disque sont collectées pour tous les pools de mémoire. Disk I/O information will be collected for all storage pools.

Autres valeurs

1-64: Indiquez le numéro du pool de mémoire pour lequel les informations d'E/S disque sont collectées. Specify the pool number of the storage pool for which disk I/O information will be collected.

Type (TYPE)

Indique le type de collecte d'E/S disque à effectuer. Il détermine le niveau de détail des données collectées. Specifies the type of disk I/O collection to be performed. This determines the detail level of the data which will be collected.

Remarque : Les données de disque sont collectées à partir d'un enregistreur de vol à rebouclage. Si la valeur indiquée pour le paramètre Intervalle de collecte (COLITV) est trop grande, des opérations d'E/S peuvent être manquées. Le format d'enregistrement du fichier de base de données Disk Watcher QAPYDWINTI comporte une zone ('Data missed') qui indique si des opérations d'E/S ont été manquées pendant l'intervalle. Remarque :Disk data is collected from a wrapping flight recorder. If the value specified for the Collection interval (COLITV) parameter is too large, I/O operations may be missed. The record format for Disk Watcher database file QAPYDWINTI includes a field ('Data missed') which indicates whether I/O operations were missed during the interval.

*STATS: A statistics collection will be performed. This type of collection will summarize the I/O data into a set of counters based on the type of I/O operation. A statistics collection will always include all I/O operations on the system. This means that the I/O operations included in the statistics data will not be limited by values specified for the Collection condition (COLCOND) or Collection range (COLRNG) parameters.
Les données d'une collecte de statistiques sont écrites dans les fichiers de base de données QAPYDWRUNI, QAPYDWINTI et QAPYDWSTAT de la bibliothèque indiquée par le paramètre Biblio (LIB). Data for a statistics collection is written to database files QAPYDWRUNI, QAPYDWINTI, and QAPYDWSTAT in the library specified for the Biblio (LIB) parameter.
*ALL: Les données de statistiques et de trace sont collectées et écrites dans les fichiers de base de données Disk Watcher. Both statistics and trace data will be collected and written to the Disk Watcher database files.
*TRACE: A trace collection will be performed. This type of collection will gather data for every I/O which occurred on the specified ASP or disk unit(s). The trace data collected with this option may be limited to I/O operations which meet a certain condition. To collect a limited set of trace data, either specify a condition on the Collection condition (COLCOND) parameter or a range on the Collection range (COLRNG) parameter.
Les données d'une collecte de trace sont écrites dans les fichiers de base de données QAPYDWRUNI, QAPYDWINTI, QAPYDWTRC et QAPYDWTDER de la bibliothèque indiquée par le paramètre Biblio (LIB). De plus, des données sont écrites dans les fichiers de base de données QAPYDWPGMR et QAPYDWOBJR si *ALL ou *RESIDENT est indiqué pour le paramètre Informations sur les objets (OBJINF). Data for a trace collection is written to the database files QAPYDWRUNI, QAPYDWINTI, QAPYDWTRC, and QAPYDWTDER in the library specified for the Biblio (LIB) parameter. Additionally, data will be written to the database files QAPYDWPGMR and QAPYDWOBJR if *ALL or *RESIDENT is specified for the Object information (OBJINF) parameter.

Type d'E/S (IOTYPE)I/O type (IOTYPE)

Indique si les données de trace d'E/S collectées doivent être limitées à un type particulier d'opération d'E/S. Specifies whether the I/O trace data collected should be limited to a particular type of I/O operation.

Remarque : Ce paramètre limite uniquement la collecte des données de trace d'E/S. Les données de statistiques incluent toujours toutes les opérations d'E/S. Remarque :This parameter will only limit the collection of I/O trace data. Statistics data will always include all I/O operations.

*ALL: Tous les types d'opérations d'E/S disque sont inclus dans les données de trace d'E/S disque. All types of disk I/O operations will be included in the disk I/O trace data.
*READ: Seules les opérations qui lisent des données sur le stockage disque sont incluses dans les données de trace d'E/S disque. Only operations that read data from disk storage will be included in the disk I/O trace data.
*WRITE: Seules les opérations qui écrivent des données sur le stockage disque sont incluses dans les données de trace d'E/S disque. Only operations that write data to disk storage will be included in the disk I/O trace data.

Informations sur les objets (OBJINF)Object information (OBJINF)

Indique si Disk Watcher rassemble des informations sur les objets et les programmes, telles que le nom de l'objet et le nom du programme, et si cette collecte de données est limitée aux objets et programmes qui se trouvent en mémoire résidente. Specifies whether Disk Watcher will gather object and program information, such as the object name and program name, and whether this data collection will be limited to objects and programs which are in resident storage.

Lors des collectes *TRACE, Disk Watcher collecte des informations relatives à l'objet sur lequel l'opération d'E/S a été effectuée. Lorsque cet objet se trouve en mémoire résidente, le temps nécessaire pour rassembler les données est relativement court. En revanche, si l'objet ne se trouve pas en mémoire résidente, la collecte de ces informations a un impact plus important sur les performances. Il en va de même pour la collecte d'informations relatives au programme ou à la procédure qui a lancé l'opération d'E/S. During *TRACE collections, Disk Watcher collects information related to the object on which the I/O operation was performed. When this object is in resident storage, the time required to gather the data is relatively small. However, if the object is not in resident storage, there will be a more significant performance impact associated with gathering this information. The same is true when collecting information related to the program or procedure which initiated the I/O operation.

*NONE: Les informations sur les objets et les programmes ne sont collectées pour aucun objet ni programme. Object and program information will not be collected for any objects or programs.
*ALL: Les informations sur les objets et les programmes sont collectées pour tous les objets et programmes. Cela inclut les données des objets et programmes qui ne se trouvent pas en mémoire résidente. Object and program information will be collected for all objects and programs. This includes data for objects and programs which are not in resident storage.
*RESIDENT: Les informations sur les objets et les programmes sont collectées uniquement pour les objets et programmes qui se trouvent en mémoire résidente. Object and program information will only be collected for objects and programs which are in resident storage.

Condition de collecte (COLCOND)Collection condition (COLCOND)

Indique si les données de trace d'E/S collectées doivent être limitées aux opérations d'E/S qui répondent à une condition indiquée. Specifies whether the I/O trace data collected should be limited to I/O operations which meet a specified condition.

Remarque : Vous pouvez indiquer soit une valeur limite unique pour ce paramètre, soit une plage pour le paramètre COLRNG. Vous ne pouvez pas indiquer de valeurs pour les deux paramètres. Remarque :Either a single limiting value may be specified for this parameter or a range may be specified for the COLRNG parameter. You cannot specify values for both parameters.

Valeurs uniques

*NONE: Aucune condition limitative n'est indiquée. No limiting condition is specified.

Élément 1: Type de données

*RESPTIME: La collecte conditionnelle des données de trace est fondée sur le temps de réponse total de l'opération d'E/S. The conditional trace data collection will be based on the total response time of the I/O operation.
*QTIME: La collecte conditionnelle des données de trace est fondée sur le temps de file d'attente (attente) de l'opération d'E/S. The conditional trace data collection will be based on the queue (wait) time of the I/O operation.
*SERVTIME: La collecte conditionnelle des données de trace est fondée sur le temps de service de l'opération d'E/S. The conditional trace data collection will be based on the service time of the I/O operation.

Élément 2: Opérateur relationnel

*LT: Collecte les enregistrements de trace des opérations d'E/S disque dont la durée a été inférieure au nombre de microsecondes indiqué pour l'élément 3 de ce paramètre. Collect trace records for disk I/O operations that took less than the number of microseconds specified for element 3 of this parameter.
*GT: Collecte les enregistrements de trace des opérations d'E/S disque dont la durée a été supérieure au nombre de microsecondes indiqué pour l'élément 3 de ce paramètre. Collect trace records for disk I/O operations that took more than the number of microseconds specified for element 3 of this parameter.
*LE: Collecte les enregistrements de trace des opérations d'E/S disque dont la durée n'a pas été supérieure au nombre de microsecondes indiqué pour l'élément 3 de ce paramètre. Collect trace records for disk I/O operations that took not more than the number of microseconds specified for element 3 of this parameter.
*GE: Collecte les enregistrements de trace des opérations d'E/S disque dont la durée n'a pas été inférieure au nombre de microsecondes indiqué pour l'élément 3 de ce paramètre. Collect trace records for disk I/O operations that took not less than the number of microseconds specified for element 3 of this parameter.

Élément 3: Valeur

entier: Indiquez le nombre de microsecondes à utiliser pour limiter la collecte des enregistrements de trace. Specify the number of microseconds to use to limit trace record collection.

Plage de collecte (COLRNG)Collection range (COLRNG)

Indique si les données de trace d'E/S collectées doivent être limitées aux opérations d'E/S dont les valeurs de temps se situent dans une plage donnée. Specifies whether the I/O trace data collected should be limited to I/O operations which are within a range of time values.

Remarque : Vous pouvez indiquer soit une valeur limite unique pour le paramètre Condition de collecte (COLCOND), soit une plage pour ce paramètre. Vous ne pouvez pas indiquer de valeurs pour les deux paramètres. Remarque :Either a single limiting value may be specified for the Collection condition (COLCOND) parameter or a range may be specified for this parameter. You cannot specify values for both parameters.

Valeurs uniques

*NONE: Aucune plage limitative n'est indiquée. No limiting range is specified.

Élément 1: Type de données

*RESPTIME: La collecte conditionnelle des données de trace est fondée sur le temps de réponse total de l'opération d'E/S. The conditional trace data collection will be based on the total response time of the I/O operation.
*QTIME: La collecte conditionnelle des données de trace est fondée sur le temps de file d'attente (attente) de l'opération d'E/S. The conditional trace data collection will be based on the queue (wait) time of the I/O operation.
*SERVTIME: La collecte conditionnelle des données de trace est fondée sur le temps de service de l'opération d'E/S. The conditional trace data collection will be based on the service time of the I/O operation.

Élément 2: Valeur inférieure

entier: Indiquez la limite inférieure d'une plage servant à déterminer les opérations d'E/S incluses dans la collecte de trace. Specify the lower limit of a range to determine which I/O operations will be included in the trace collection.

Élément 3: Valeur supérieure

entier: Indiquez la limite supérieure d'une plage servant à déterminer les opérations d'E/S incluses dans la collecte de trace. Specify the upper limit of a range to determine which I/O operations will be included in the trace collection.

Forcer écriture enregistrement (FRCRCD)

Indique quand les enregistrements de données d'E/S disque sont écrits dans les fichiers de base de données Disk Watcher. Specifies when disk I/O data records will be written to the Disk Watcher database files.

*ITVEND: Les données collectées sont écrites dans les fichiers de base de données à la fin de chaque intervalle. Collected data will be written to the database files at the end of each interval.
*CALC: Les données collectées sont écrites dans les fichiers à un moment déterminé par le système. Les données sont toujours disponibles dans les fichiers une fois la collecte des données d'E/S disque terminée. Collected data will be written to the files at a time determined by the system. Data will always be available in the files after disk I/O data collection is ended.

Seuil d'ASP du fichier (TOASPTHLD)To file ASP threshold (TOASPTHLD)

Indique le pourcentage du pool de mémoire secondaire (ASP) contenant les fichiers de base de données Disk Watcher qui peut être utilisé avant que la fin de la collecte soit forcée. Le volume de données collectées pouvant être très important, ce paramètre permet de limiter la part de l'ASP consommée. Si les fichiers de base de données se trouvent dans l'ASP système et que des valeurs sont indiquées à la fois pour ce paramètre et pour Seuil d'ASP système (SYSASPTHLD), le paramètre SYSASPTHLD prévaut sur la valeur indiquée ici. Specifies the percentage of the auxiliary storage pool (ASP) that contains the Disk Watcher database files which can be used before the collection is forced to end. Because the amount of data collected can be very large, this parameter allows you to limit how much of the ASP is consumed. If the database files exist in the system ASP and values are specified in both this parameter and the System ASP threshold (SYSASPTHLD), the SYSASPTHLD parameter will override the value specified here.

*SYSTEM: Le seuil configuré sur le système pour cet ASP. Cette valeur est un pourcentage configuré à l'aide de la fonction Modifier le seuil de stockage de la commande Démarrer les outils de maintenance système (STRSST). La collecte des données est forcée de se terminer lorsque ce pourcentage du stockage de l'ASP est consommé. The threshold which is configured on the system for this ASP. This value is a percentage which is configured using the Change Storage Threshold function of the Start System Service Tools (STRSST) command. Data collection will be forced to end if this percentage of the ASP storage is consumed.
1-99: Indiquez le pourcentage de l'ASP des fichiers de base de données pouvant être utilisé avant que la fin de la collecte des données d'E/S disque soit forcée. Par exemple, si vous indiquez 80, la collecte des données est forcée de se terminer si plus de 80 % du stockage de l'ASP est consommé. Une valeur indiquée pour ce paramètre prévaut sur le seuil configuré sur le système. Specify the percentage of the database files' ASP which may be used before disk I/O data collection will be forced to end. For example, if you specify 80, data collection will be forced to end if more than 80% of the ASP storage is consumed. A value specified on this parameter will override the threshold which is configured on the system.

Seuil d'ASP système (SYSASPTHLD)System ASP threshold (SYSASPTHLD)

Indique le pourcentage du pool de mémoire secondaire (ASP) système qui peut être utilisé avant que la fin de la collecte soit forcée. Disk Watcher allouant du stockage temporaire et le volume de données collectées pouvant être très important, ce paramètre permet de limiter la part de l'ASP système consommée. Si les fichiers de base de données se trouvent dans l'ASP système et que des valeurs sont indiquées à la fois pour ce paramètre et pour le paramètre Seuil d'ASP du fichier (TOASPTHLD), la valeur indiquée ici prévaut. Specifies the percentage of the system auxiliary storage pool (ASP) which can be used before the collection is forced to end. Because Disk Watcher allocates temporary storage and the amount of data collected can be very large, this parameter allows you to limit how much of the system ASP is consumed. If the database files exist in the system ASP and values are specified in both this parameter and the To file ASP threshold (TOASPTHLD) parameter, the value specified here will take precedence.

*SYSTEM: Le seuil configuré sur le système pour l'ASP système. Cette valeur est un pourcentage configuré à l'aide de la fonction Modifier le seuil de stockage de la commande Démarrer les outils de maintenance système (STRSST). La collecte des données est forcée de se terminer lorsque ce pourcentage du stockage de l'ASP système est consommé. The threshold which is configured on the system for the system ASP. This value is a percentage which is configured using the Change Storage Threshold function of the Start System Service Tools (STRSST) command. Data collection will be forced to end if this percentage of the system ASP storage is consumed.
1-99: Indiquez le pourcentage de l'ASP système pouvant être utilisé avant que la fin de la collecte des données d'E/S disque soit forcée. Par exemple, si vous indiquez 80, la collecte des données est forcée de se terminer si plus de 80 % du stockage de l'ASP système est consommé. Une valeur indiquée pour ce paramètre prévaut sur le seuil configuré sur le système. Specify the percentage of the system ASP which may be used before disk I/O data collection will be forced to end. For example, if you specify 80, data collection will be forced to end if more than 80% of the system ASP storage is consumed. A value specified on this parameter will override the threshold which is configured on the system.

Exemples

Exemple 1 : Ajout d'une définition Disk Watcher qui collecte des données pour des ASP spécifiques Example 1: Add a Disk Watcher Definition Which Collects Data for Specific ASPs

ADDDWDFN   DFN(ASPNBR)  ASP(2 16)  TYPE(*STATS)  COLITV(5)

Cette commande crée une définition Disk Watcher nommée ASPNBR. Cette définition collecte des statistiques récapitulatives pour le pool de mémoire secondaire (ASP) 2 et l'ASP 16. Les données sont collectées à un intervalle de 5 secondes et incluent toutes les opérations d'E/S qui se produisent dans les ASP indiqués. Pour collecter des données Disk Watcher à l'aide de cette définition, utilisez la commande Démarrer Disk Watcher (STRDW) en indiquant ASPNBR pour le paramètre Définition (DFN). This command will create a Disk Watcher definition called ASPNBR. This definition will collect summarized statistics data for auxiliary storage pool (ASP) 2 and ASP 16. Data will be collected at an interval of 5 seconds and will include all I/O operations which occur in the specified ASPs. To collect Disk Watcher data using this definition use the Start Disk Watcher (STRDW) command with ASPNBR specified for the Définition (DFN) parameter.

Exemple 2 : Ajout d'une définition Disk Watcher qui collecte des données pour une unité de disque spécifique Example 2: Add a Disk Watcher Definition Which Collects Data for a Specific Disk Unit

ADDDWDFN   DFN(DSKNBR)  ASP(*SYS)  DSKUNIT(12)  TYPE(*ALL)

Cette commande crée une définition Disk Watcher nommée DSKNBR. Cette définition collecte des données pour l'unité de disque 12 du pool de mémoire secondaire (ASP) système. Les données de trace détaillées et les statistiques récapitulatives sont collectées. Pour collecter des données Disk Watcher à l'aide de cette définition, utilisez la commande Démarrer Disk Watcher (STRDW) en indiquant DSKNBR pour le paramètre Définition (DFN). This command will create a Disk Watcher definition called DSKNBR. This definition will collect data for disk unit 12 in the system auxiliary storage pool (ASP). Both detailed trace data and summarized statistics data will be collected. To collect Disk Watcher data using this definition use the Start Disk Watcher (STRDW) command with DSKNBR specified for the Définition (DFN) parameter.

Exemple 3 : Ajout d'une définition Disk Watcher qui trace uniquement les opérations d'E/S répondant à une condition de collecte Example 3: Add a Disk Watcher Definition Which Traces Only I/O Operations Which Meet a Collection Condition

ADDDWDFN   DFN(RESPTIME)  COLTYPE(*TRACE)
           COLCOND(*RESPTIME *GT 100)

Dans cet exemple, une définition Disk Watcher nommée RESPTIME est créée. Cette définition collecte des données pour tous les ASP du système, et seules les données de trace sont collectées. Les données d'opérations d'E/S collectées pour la trace incluent uniquement les opérations de disque dont le temps de réponse total a été supérieur à 100 microsecondes. Pour collecter des données Disk Watcher à l'aide de cette définition, utilisez la commande Démarrer Disk Watcher (STRDW) en indiquant RESPTIME pour le paramètre Définition (DFN). In this example, a Disk Watcher definition called RESPTIME will be created. This definition will collect data for all ASPs on the system and only trace data will be collected. The I/O operation data collected for the trace will include only those disk operations whose total response time was greater than 100 microseconds. To collect Disk Watcher data using this definition use the Start Disk Watcher (STRDW) command with RESPTIME specified for the Définition (DFN) parameter.

Exemple 4 : Ajout d'une définition Disk Watcher qui trace uniquement les opérations d'écriture d'E/S Example 4: Add a Disk Watcher Definition Which Traces Only I/O Write Operations

ADDDWDFN   DFN(WRITEOPS)  TYPE(*TRACE)  IOTYPE(*WRITE)

Dans cet exemple, une définition Disk Watcher nommée WRITEOPS est créée. Cette définition collecte des données pour tous les ASP du système. Seules les données de trace des opérations d'E/S qui écrivent des données de disque sur le stockage sont collectées. Pour collecter des données Disk Watcher à l'aide de cette définition, utilisez la commande Démarrer Disk Watcher (STRDW) en indiquant WRITEOPS pour le paramètre Définition (DFN). In this example, a Disk Watcher definition called WRITEOPS will be created. This definition will collect data for all ASPs on the system. Only trace data for I/O operations which write disk data to storage will be collected. To collect Disk Watcher data using this definition use the Start Disk Watcher (STRDW) command with WRITEOPS specified for the Définition (DFN) parameter.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF0001: Erreur trouvée dans la commande &1.
CPFAF10: La définition ou le filtre existe déjà. Definition or filter already exists.
CPFB513: L'utilisateur ne possède pas le droit requis. The user does not have the required authority.
CPFB51C: Erreur sur la commande Ajouter une définition Disk Watcher (ADDDWDFN). Error on Add Disk Watcher Definition (ADDDWDFN) command.