STRDW

La commande Démarrer Disk Watcher (STRDW) démarre la collecte des données de performances des disques. Elle permet à l'utilisateur d'obtenir des données, notamment les nombres et les durées des opérations d'entrée-sortie (E/S) sur les unités de disque. Elle fournit en outre des données d'exécution utiles sur les objets lus ou écrits sur disque, et sur les travaux, unités d'exécution ou tâches LIC qui provoquent ces opérations. Les données collectées sont écrites dans un ensemble de fichiers de base de données. Les noms de ces fichiers commencent tous par les lettres 'QAPYDW'. The Start Disk Watcher (STRDW) command starts the collection of disk performance data. It allows the user to obtain data including counts and durations of input/output (I/O) operations to disk units. In addition, it provides useful run-time data regarding which objects are being read from disk or written to disk, and which jobs, threads, or LIC tasks are causing the operations. The collected data is written to a set of database files. The file names all begin with the letters 'QAPYDW'.

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.
• Vous devez posséder le droit d'exécution (*EXECUTE) sur la bibliothèque indiquée dans le paramètre Biblio (LIB). You must have execute (*EXECUTE) authority to the library specified in the Biblio (LIB) parameter.

Paramètres

Définition (DFN)

Indique la définition Disk Watcher à utiliser lors du démarrage d'une nouvelle collecte Disk Watcher. La définition identifie les données d'E/S disque à collecter. Une nouvelle définition Disk Watcher peut être créée à l'aide de la commande Ajouter une définition Disk Watcher (ADDDWDFN). Specifies the Disk Watcher definition to use when starting a new Disk Watcher collection. The definition identifies the disk I/O data to be collected. A new Disk Watcher definition can be created using the Add Disk Watcher Definition (ADDDWDFN) command.

*SELECT

L'utilisateur sera invité à faire une sélection dans une liste des définitions Disk Watcher existantes. The user will be prompted to select from a list of existing Disk Watcher definitions.

nom

Indiquez le nom de la définition Disk Watcher à utiliser pour cette collecte. Specify the name of the Disk Watcher definition to use for this collection.

Collecte (COL)Collection (COL)

Indique le nom de la collecte. Le nom de la collecte est le nom du membre de fichier de base de données dans lequel les données de sortie doivent être écrites. Si aucun membre de ce nom n'existe dans chaque fichier de base de données Disk Watcher, un membre portant le nom indiqué est créé. Si un membre de ce nom existe déjà, vous devez indiquer *YES dans le paramètre Remplacer les données (RPLDTA) afin d'écraser les données du membre existant. Specifies the name of the collection. The name of the collection is the name of the database file member to which the output data is to be written. If a member by this name does not exist in each Disk Watcher database file, one will be created with the specified name. If a member by this name already exists, you must specify *YES on the Replace data (RPLDTA) parameter in order to write over the data in the existing member.

*GEN

Le nom de la collecte sera généré d'après le moment où la commande STRDW a été exécutée. Le format du nom de la collecte sera Qdddhhmmss, où ddd est le jour julien (001-366) et hhmmss l'heure (01-24), la minute (00-59) et la seconde (00-59) auxquelles la collecte des données d'E/S disque a démarré. The collection name will be generated based on when the STRDW command was run. The format of the collection name will be Qdddhhmmss where ddd is the Julian day (001-366) and hhmmss is the hour (01-24), minute (00-59) and second (00-59) the disk I/O data collection was started.

nom

Indiquez le nom de la collecte. Specify the name of the collection.

Biblio (LIB)

Indique la bibliothèque dans laquelle les fichiers de base de données des données Disk Watcher doivent exister. Chaque fichier introuvable dans la bibliothèque indiquée est automatiquement créé dans cette bibliothèque. Specifies the library where the database files for the Disk Watcher data are to exist. Each file that is not found in the specified library is automatically created in that library.

QPFRDATA

Les fichiers de base de données seront situés dans la bibliothèque QPFRDATA. The database files will be located in library QPFRDATA.

nom

Indiquez le nom de la bibliothèque dans laquelle les fichiers de base de données seront situés. Specify the name of the library where the database files will be located.

Texte 'descriptif' (TEXT)

Indique le texte à utiliser pour chaque membre de l'ensemble des fichiers de base de données Disk Watcher associés à la collecte. Specifies the text to be used for each member across the set of Disk Watcher database files associated with the collection.

*DFN

Les membres des fichiers de base de données Disk Watcher auront la même description textuelle que la définition Disk Watcher sélectionnée dans le paramètre Définition (DFN). Disk Watcher database file members will have the same text description as the Disk Watcher definition that was selected on the Définition (DFN) parameter.

*BLANK

Les membres des fichiers de base de données Disk Watcher n'auront aucune description textuelle. Disk Watcher database file members will have no text description.

valeur-caractère

Indiquez la description textuelle de cet ensemble de membres de fichiers de base de données Disk Watcher. La description ne doit pas dépasser 50 caractères de texte, entre apostrophes. Specify the text description for this set of Disk Watcher database file members. The description should be no more that 50 characters of text, enclosed in apostrophes.

Remplacer les données (RPLDTA)Replace data (RPLDTA)

Indique si un ensemble existant de membres de fichiers de base de données Disk Watcher doit être remplacé par un nouvel ensemble de membres de même nom. Specifies whether an existing set of Disk Watcher database file members should be replaced with a new set of members with the same name.

*NO

Les membres de fichiers de base de données Disk Watcher existants ne seront pas remplacés. Une nouvelle collecte Disk Watcher ne démarrera pas si le membre indiqué existe déjà. The existing Disk Watcher database file members will not be replaced. A new Disk Watcher collection will not begin if the specified member already exists.

*YES

Les membres de fichiers de base de données Disk Watcher existants seront remplacés par les données de la nouvelle collecte. The existing Disk Watcher database file members will be replaced with data from the new collection.

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.

*DFN

L'intervalle de collecte indiqué dans la définition Disk Watcher sera utilisé pour cette collecte. The collection interval specified in the Disk Watcher definition will be used for this collection.

*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.

Fin de la collecte (ENDCOL)End collection (ENDCOL)

Indique les critères qui mettront fin à la collecte. Ce paramètre permet d'indiquer plusieurs conditions qui mettront fin à la collecte des données. Si plusieurs critères de fin sont indiqués, la collecte des données d'E/S disque prendra fin dès que l'un des critères indiqués sera rempli. Specifies the criteria which will end the collection. This parameter allows you to specify multiple conditions which will end the collection of data. If more than one ending criteria is specified, disk I/O data collection will end the first time any one of specified criteria has been met.

Vous pouvez indiquer 3 valeurs pour ce paramètre. You can specify 3 values for this parameter.

Élément 1: Option

*NBRSEC

Termine la collecte après écoulement d'un certain nombre de secondes. Indiquez la limite de temps dans l'élément 2 de ce paramètre. End the collection after a number of seconds has elapsed. Specify the time limit in element 2 of this parameter.

*DASDMB

Termine la collecte lorsqu'un certain nombre de mégaoctets de données ont été écrits dans les fichiers de la base de données Disk Watcher. Indiquez la limite en mégaoctets dans l'élément 2 de ce paramètre. End the collection when a number of megabytes of data have been written to the Disk Watcher database files. Specify the megabyte limit in element 2 of this parameter.

*NBRITV

Termine la collecte lorsqu'un certain nombre d'intervalles de collecte se sont écoulés. Indiquez le nombre d'intervalles dans l'élément 2 de ce paramètre. End the collection when a number of collection intervals have occurred. Specify the number of intervals in element 2 of this parameter.

Élément 2: Valeur

60

Si la valeur par défaut *NBRSEC est utilisée pour l'élément 1 de ce paramètre, la collecte prend fin après soixante secondes de collecte de données d'E/S disque. If the default of *NBRSEC is used for element 1 of this parameter, the collection will end after sixty seconds of disk I/O data is collected.

entier

Indiquez le nombre de secondes (pour *NBRSEC), le nombre de mégaoctets (pour *DASDMB) ou le nombre d'intervalles (pour *NBRITV) à utiliser comme critère de fin de la collecte des données d'E/S disque. Specify the number of seconds (for *NBRSEC) or the number of megabytes (for *DASDMB) or the number of intervals (for *NBRITV) to use as the ending criteria for disk I/O data collection.

Fichier matériel (HDWF)Hardware file (HDWF)

Indique si les données seront écrites dans le fichier QAPYDWHDWR pour cette collecte. Ce fichier contient les informations sur les ressources d'unités de stockage fournies par la commande Afficher ressources matériel (DSPHDWRSC). Specifies whether data will be written to the QAPYDWHDWR file for this collection. This file contains storage device resource information provided by the Afficher ressources matériel (DSPHDWRSC) command.

*YES

Les informations sur les ressources d'unités de stockage seront écrites dans le fichier QAPYDWHDWR pour cette collecte. Le nom du membre du fichier QAPYDWHDWR sera le nom indiqué dans le paramètre Collection (COL). Storage device resource information will be written to the QAPYDWHDWR file for this collection. The name of the QAPYDWHDWR file member will be the name specified on the Collection (COL) parameter.

*NO

Les informations sur les ressources d'unités de stockage ne seront pas écrites dans le fichier QAPYDWHDWR pour cette collecte. Storage device resource information will not be written to the QAPYDWHDWR file for this collection.

Exemples

Exemple 1 : Démarrer une collecte Disk Watcher Example 1: Start a Disk Watcher Collection

STRDW   DFN(MYDFN)  COL(TEST)  LIB(MYLIB)

Cette commande démarre Disk Watcher en utilisant la définition MYDFN pour déterminer les données à collecter. En supposant que la valeur par défaut fournie ENDCOL(*NBRSEC 60) est utilisée, la collecte des données prend fin après 60 secondes. Les données collectées sont écrites dans les fichiers de la base de données Disk Watcher de la bibliothèque MYLIB, dans le membre TEST. Les noms des fichiers de la base de données Disk Watcher commencent tous par 'QAPYDW'. This command will start Disk Watcher using definition MYDFN to determine which data should be collected. Assuming the shipped default of ENDCOL(*NBRSEC 60) is used, data collection will end after 60 seconds. Collected data will be written to the Disk Watcher database files in library MYLIB in member TEST. The Disk Watcher database file names all begin with 'QAPYDW'.

Exemple 2 : Démarrer Disk Watcher avec un intervalle de collecte Example 2: Start Disk Watcher Using a Collection Interval

STRDW   DFN(MYDFN)  COLITV(5)  ENDCOL((*NBRITV 200))

Cette commande démarre Disk Watcher pour collecter des données en utilisant la définition MYDFN. Les données sont collectées à intervalles de 5 secondes, ce qui remplace l'intervalle indiqué dans la définition. La collecte prend fin après 200 intervalles. Les données sont écrites dans les fichiers de la base de données Disk Watcher de la bibliothèque QPFRDATA, dans un nom de membre généré par Disk Watcher d'après la date et l'heure de début de la collecte. This command will start Disk Watcher to collect data using the definition called MYDFN. Data will be collected at an interval of 5 seconds, overriding the interval specified in the definition. Data collection will end after 200 intervals have been collected. Data will be written to the Disk Watcher database files in library QPFRDATA in a member name which will be generated by Disk Watcher based on the date and time the collection started.

Exemple 3 : Démarrer Disk Watcher en sélectionnant une définition par invite Example 3: Start Disk Watcher, Prompting to Select a Definition

STRDW   DFN(*SELECT)  COL(TEST)  LIB(MYLIB)
        ENDCOL((*DASDMB 100))

Cette commande ouvre un panneau d'invite qui répertorie toutes les définitions Disk Watcher existant actuellement sur le système. La définition sélectionnée sur ce panneau sert à déterminer les données à collecter. La collecte prend fin après l'écriture de 100 mégaoctets de données dans les fichiers de la base de données Disk Watcher de la bibliothèque MYLIB, dans le membre TEST. This command will open a prompt panel listing all Disk Watcher definitions which currently exist on the system. The definition selected on this panel will be used to determine what data will be collected. Data collection will end after 100 megabytes of data have been written to the Disk Watcher database files in library MYLIB in member TEST.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF2401

Accès non autorisé à la bibliothèque &1.

CPF9810

Bibliothèque &1 non trouvée.

CPFB511

Disk Watcher n'a pas pu démarrer pour le motif de code &1. Disk Watcher could not start due to reason code &1.

CPFB512

Le démarrage de Disk Watcher ne s'est pas terminé correctement. Start Disk Watcher did not complete successfully.

CPFB513

L'utilisateur ne possède pas le droit requis. The user does not have the required authority.

CPFB514

Le membre existe déjà. Member already exists.

CPFB515

Mémoire insuffisante dans le pool machine. Not enough storage in machine pool.

CPFB51B

L'option *SELECT n'est valide que si la commande est exécutée de manière interactive. Option *SELECT is only valid if the command is being run interactively.