ADDJWDFN

La commande Ajouter une définition Job Watcher (ADDJWDFN) ajoute une nouvelle définition Job Watcher au système. Une définition Job Watcher identifie les données de performance à collecter lors d'une collecte Job Watcher. Une session peut être démarrée à l'aide de la commande Démarrer Job Watcher (STRJW). Une définition est requise pour démarrer une nouvelle collecte Job Watcher. The Add Job Watcher Definition (ADDJWDFN) command adds a new Job Watcher definition to the system. A Job Watcher definition identifies the performance data that is to be collected during a Job Watcher collection. A session can be started using the Start Job Watcher (STRJW) command. A definition is required when starting a new Job Watcher collection.

Restrictions:

• Pour utiliser cette commande, vous devez posséder le droit spécial de service (*SERVICE) ou être autorisé à la fonction Job Watcher du système d'exploitation. La commande Modifier l'utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_SERVICE_JOB_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 Job Watcher function of the operating system. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_JOB_WATCHER, can be used to change the list of users that are allowed to use this command.

Paramètres

Définition (DFN)

Indique le nom de la définition Job 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 Job 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 Job Watcher. Specify the name of the new Job Watcher definition.

Texte 'descriptif' (TEXT)

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

*BLANK

La définition Job Watcher n'aura pas de description textuelle. The Job Watcher definition will have no text description.

valeur-caractère

Indiquez une description textuelle de la définition Job Watcher. La description ne doit pas dépasser 50 caractères, placés entre apostrophes. Specify a text description for the Job 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 de travail/tâche. Les données de travail/tâche sont collectées à partir du système par échantillonnage. Cette valeur indique le temps qui s'écoule entre la collecte de chaque échantillon. Specifies the interval between retrieval of job/task data. Job/task data is collected from the system on a sampling basis. This value specifies the amount of time that will elapse between the collection of each sample.

10

Le délai entre deux collectes de données d'intervalle est de 10 secondes. The delay between the collection of interval data will be 10 seconds.

*NODELAY

Les données sont collectées le plus rapidement possible, sans délai entre deux collectes de données d'intervalle. Data will be collected as fast as possible, with no delay between the collection of interval data.

0.1-3600.0

Indiquez le nombre de secondes de délai entre deux collectes de données d'intervalle. Si une valeur est indiquée pour ce paramètre, elle prévaut sur la valeur de la définition Job Watcher. Specify the number of seconds to delay between the collection of interval data. If a value is specified on this parameter it will override the value in the Job Watcher definition.

Catégories de données supplémentaires (ADDDTACGY)Additional data categories (ADDDTACGY)

Indique les types de données supplémentaires à inclure dans la collecte. Les types de données sélectionnés pour ce paramètre sont collectés en plus des données standard collectées par la fonction Job Watcher. Specifies additional types of data to include in the collection. Data types selected on this parameter will be collected in addition to the standard data collected by the Job Watcher function.

Valeurs uniques

*NONE

Seules les données standard sont incluses dans cette collecte. Les données standard collectées comprennent : les informations d'exécution (QAPYJWRUNI), les informations d'intervalle (QAPYJWINTI), les données TDE et de processus (QAPYJWSTS, QAPYJWTDE et QAPYJWPRC), le mappage des compartiments d'attente (QAPYJWBKT), les données de la machine virtuelle Java classique (QAPYJWJVM) et les données des unités d'exécution Java classiques (QAPYJWJVTH). Only standard data will be included in this collection. Standard data collected includes: run information (QAPYJWRUNI), interval information (QAPYJWINTI), TDE and process data (QAPYJWSTS, QAPYJWTDE, and QAPYJWPRC), wait bucket mapping (QAPYJWBKT), Classic Java virtual machine data (QAPYJWJVM), and Classic Java thread data (QAPYJWJVTH).

*ALL

Cette collecte inclut les données standard et toutes les catégories de données facultatives. This collection will include standard data and all optional data categories.

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

Élément 1: Catégorie

Indique les types de données supplémentaires à collecter. Specifies the additional types of data to collect.

*ACTGRPDTL

Ce type de données collecte des données détaillées sur les groupes d'activation. Il écrit ces données dans les fichiers de base de données QAPYJWAIGP, QAPYJWAIHP et QAPYJWAIPA. This data type will collect detailed activation group data. This data type will write activation group data to the database files QAPYJWAIGP, QAPYJWAIHP, and QAPYJWAIPA.

*ACTGRPSUM

Ce type de données collecte des données récapitulatives sur les groupes d'activation. Ces données récapitulatives sont écrites dans le fichier QAPYJWPRC, dans les zones CURNUMACTG et CURNUMACT. This data type will collect summary data for activation groups. This summary data will be written to the file QAPYJWPRC in the fields CURNUMACTG and CURNUMACT.

*SQLCURSTMT

Ce type de données collecte les données d'instruction SQL "en cours" et de variables hôte. Les données de l'instruction SQL en cours sont écrites dans les fichiers QAPYJWSQL et QAPYJWSQLH. This data type will collect "in progress" SQL statement and host variable data. SQL current statement data will be written to the files QAPYJWSQL and QAPYJWSQLH.

*SQLSTMT

Ce type de données collecte les données d'instruction SQL "en cours" ou "dernière terminée" et de variables hôte. Les données d'instruction SQL sont écrites dans les fichiers QAPYJWSQL et QAPYJWSQLH. This data type will collect "in progress" or "last completed" SQL statement and host variable data. SQL statement data will be written to the files QAPYJWSQL and QAPYJWSQLH.

*SQLDTL

Ce type de données collecte des données SQL détaillées, qui comprennent l'instruction SQL "en cours" ou "dernière terminée", les variables hôte, la liste des curseurs ouverts et les données de la zone d'instructions préparées. Les données SQL détaillées sont écrites dans les fichiers QAPYJWSQL, QAPYJWSQLH, QAPYJWSQLO et QAPYJWSQLP. This data type will collect detailed SQL data which includes "in progress" or "last completed" SQL statement, host variable, open cursor list, and prepared statement area data. Detailed SQL data will be written to the files QAPYJWSQL, QAPYJWSQLH, QAPYJWSQLO, and QAPYJWSQLP.

*CALLSTK

Ce type de données collecte les piles d'appels de chaque TDE inclus dans la collecte. Les données de pile d'appels sont écrites dans les fichiers QAPYJWSTK et QAPYJWPROC. This data type will collect call stacks for each TDE included in the collection. Call stack data will be written to the files QAPYJWSTK and QAPYJWPROC.

*SCKTCP

Ce type de données collecte les données de socket et de TCP. Ces données sont écrites dans le fichier QAPYJWSKTC. This data type will collect socket and TCP data. Socket and TCP data will be written to the file QAPYJWSKTC.

*SCKJOB

Ce type de données collecte les mêmes données que le type de données *SCKTCP et collecte en outre des informations sur les travaux qui utilisent chaque socket. Les données collectées pour ce type de données sont écrites dans les fichiers QAPYJWSKTC et QAPYJWSKJB. This data type will collect the same data collected by the *SCKTCP data type and will additionally collect information regarding the jobs using each socket. Data collected for this data type will be written to the files QAPYJWSKTC and QAPYJWSKJB.

*JAVA

Ce type de données collecte les données de la machine virtuelle et des unités d'exécution IBM Technology for Java. Les données collectées pour ce type de données sont écrites dans les fichiers QAPYJWIJVM et QAPYJWIJVT. This data type will collect IBM Technology for Java VM and thread data. Data collected for this data type will be written to the files QAPYJWIJVM and QAPYJWIJVT.

*JAVASTACK

Ce type de données collecte les piles d'appels des unités d'exécution IBM Technology for Java incluses dans la collecte. Les données collectées pour ce type de données sont écrites dans le fichier QAPYJWIJVS. This data type will collect call stacks for IBM Technology for Java threads included in the collection. Data collected for this data type will be written to the file QAPYJWIJVS.

Élément 2: Interval frequency

Indique la fréquence (en intervalles) de collecte de chaque type de données. Specifies how frequently (in intervals) each type of data should be collected.

*ALWAYS

Les données de la catégorie correspondante sont collectées à chaque intervalle. Data for the corresponding category will be collected in every interval.

entier

Indiquez la fréquence en nombre d'intervalles. Par exemple, si 5 est indiqué pour ce paramètre, les données de la catégorie correspondante sont collectées aux intervalles 5, 10, 15, 20, etc. Specify the interval frequency in intervals. For example, if 5 is entered in this parameter, data for the corresponding category will be collected in intervals 5, 10, 15, 20, etc.

Données de pile d'appels fondées sur les attentes (WAITSTK)Wait-based call stack data (WAITSTK)

Indique un cas particulier dans lequel les piles d'appels peuvent être collectées pour certains travaux et/ou tâches qui se trouvent dans un type d'attente anormal sur le système. Specifies a special case where call stacks can be collected for certain jobs and/or tasks which have been in an abnormal type of wait state on the system.

Valeurs uniques

*NONE

Aucune pile d'appels fondée sur les attentes n'est incluse dans la collecte. No wait-based call stacks will be included in the collection.

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

Élément 1: Catégorie

Indique le type d'attente pour lequel les piles d'appels sont collectées. Specifies the type of wait for which call stacks will be collected.

*ABNWAIT

Cette catégorie collecte les piles d'appels qui se trouvent dans une attente anormale. Les attentes anormales sont celles qui ne se produisent que dans des situations problématiques : soit des attentes rares, soit des attentes qui prennent plus de temps que la normale. This category will collect call stacks which are in an abnormal wait. Abnormal waits are those that only occur in problem situations. These are either waits that rarely occur or waits that are taking a longer amount of time than normal to complete.

*CONFLICT

Cette catégorie collecte les piles d'appels qui se trouvent dans une attente de conflit. Les attentes de conflit se produisent lorsqu'un travail ou une tâche est dans une condition de saisie (seize) ou attend un verrouillage, un mutex ou une porte détenu par un autre travail ou une autre tâche. This category will collect call stacks which are in a conflict wait. Conflict waits occur when a job or task is either in a seize condition or is waiting for a lock, mutex, or gate that is being held by another job or task.

Élément 2: Minimum duration (microsecs)

Indique la durée minimale pendant laquelle le travail ou la tâche doit rester dans l'état d'attente anormale ou de conflit avant que les piles d'appels soient collectées. Specifies the minimum duration which the job or task must be in the abnormal or conflict wait state before call stacks will be collected.

10000

Une durée minimale de 10 000 microsecondes est utilisée. A minimum duration value of 10,000 microseconds is used.

entier

Indiquez le nombre de microsecondes pendant lesquelles le travail ou la tâche doit rester dans l'état d'attente. Specify the number of microseconds that the job or task must be in the wait state.

Travail (JOB)

Indique les travaux qui sont inclus dans la collecte Job Watcher. Les travaux sélectionnés pour ce paramètre sont collectés en plus des travaux ou tâches indiqués dans les paramètres Nom de tâche (TASKNAME), Numéro TDE (TDENBR), Profil utilisateur en cours (CURUSRPRF), Sous-système (SBS) ou Pool de mémoire en cours (CURPOOL). Specifies the jobs that will be included in the Job Watcher collection. Job(s) selected on this parameter will be collected in addition to any jobs or tasks specified on the Task name (TASKNAME), TDE number (TDENBR), Current user profile (CURUSRPRF), Sous-système (SBS), or Current storage pool (CURPOOL) parameters.

Valeurs uniques

*ALL

Tous les travaux du système sont inclus. All jobs on the system are included.

*NONE

Aucun des travaux du système n'est inclus. None of the jobs on the system are included.

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

Qualificatif 1: Travail

nom

Indiquez le nom du travail à inclure dans la collecte Job Watcher. Specify the name of the job to include in the Job Watcher collection.

nom-générique

Indiquez le nom générique du travail à inclure. Un nom générique est une chaîne de caractères composée d'un ou plusieurs caractères suivis d'un astérisque (*). Un nom générique désigne tous les éléments dont le nom commence par le même préfixe que le nom générique. Specify the generic name of the job to be included. A generic name is a character string of one or more characters followed by an asterisk (*). A generic name specifies all items that have names with the same prefix as the generic name.

Qualificatif 2: Utilisat

*ALL

Tous les travaux correspondant au nom de travail indiqué sont inclus. All jobs that match the specified job name are included.

nom

Indiquez le nom de l'utilisateur du travail à inclure. Specify the name of the user of the job to be included.

nom-générique

Indiquez le nom d'utilisateur générique des travaux à inclure. Specify the generic user name of the jobs to be included.

Qualificatif 3: Numéro

*ALL

Tous les travaux correspondant au nom de travail et au nom d'utilisateur indiqués sont inclus. All jobs that match the specified job name and user name are included.

number

Indiquez le numéro de travail pour qualifier plus précisément le nom de travail et le nom d'utilisateur. Specify the job number to further qualify the job name and user name.

Nom de tâche (TASKNAME)Task name (TASKNAME)

Indique le nom des tâches qui sont incluses dans la collecte Job Watcher. Les tâches sélectionnées pour ce paramètre sont collectées en plus des travaux ou tâches indiqués dans les paramètres Travail (JOB), Numéro TDE (TDENBR), Profil utilisateur en cours (CURUSRPRF), Sous-système (SBS) ou Pool de mémoire en cours (CURPOOL). Specifies the name of the task(s) which will be included in the Job Watcher collection. Task(s) selected on this parameter will be collected in addition to any jobs or tasks specified on the Travail (JOB), TDE number (TDENBR), Current user profile (CURUSRPRF), Sous-système (SBS), or Current storage pool (CURPOOL) parameters.

Valeurs uniques

*ALL

Toutes les tâches du système sont incluses dans la collecte. All tasks on the system will be included in the collection.

*NONE

Aucune des tâches du système n'est incluse dans la collecte. None of the tasks on the system will be included in the collection.

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

nom

Indiquez le nom des tâches à inclure dans la collecte. Specify the name of the tasks(s) which will be included in the collection.

Numéro TDE (TDENBR)TDE number (TDENBR)

Indique le numéro d'élément de répartition des tâches (TDE) des TDE inclus dans la collecte Job Watcher. Le numéro TDE est un identificateur unique attribué à chaque travail, unité d'exécution et tâche s'exécutant dans le système. Le numéro TDE peut être obtenu à l'aide de l'option Afficher la liste des tâches de la fonction Afficher/Modifier/Vider de la commande Démarrer les outils de maintenance système (STRSST). Les TDE sélectionnés pour ce paramètre sont collectés en plus des travaux ou tâches indiqués dans les paramètres Travail (JOB), Nom de tâche (TASKNAME), Profil utilisateur en cours (CURUSRPRF), Sous-système (SBS) ou Pool de mémoire en cours (CURPOOL). Specifies the Task Dispatching Element (TDE) number of the TDE(s) which will be included in the Job Watcher collection. The TDE number is a unique identifier assigned to each job, thread, and task running in the system. The TDE number may be found by using the Display list of tasks option in the Display/Alter/Dump function of Start System Service Tools (STRSST). TDE(s) selected on this parameter will be collected in addition to any jobs or tasks specified on the Travail (JOB), Task name (TASKNAME), Current user profile (CURUSRPRF), Sous-système (SBS), or Current storage pool (CURPOOL) parameters.

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

number

Le numéro TDE des TDE qui sont inclus dans la collecte. The TDE number of the TDE(s) which will be included in the collection.

Profil utilisateur en cours (CURUSRPRF)Current user profile (CURUSRPRF)

Indique le profil utilisateur en cours des travaux qui sont inclus dans la collecte. Les travaux sélectionnés pour ce paramètre sont collectés en plus des travaux ou tâches indiqués dans les paramètres Travail (JOB), Nom de tâche (TASKNAME), Numéro TDE (TDENBR), Sous-système (SBS) ou Pool de mémoire en cours (CURPOOL). Specifies the current user profile of the jobs which will be included in the collection. Jobs selected on this parameter will be collected in addition to any jobs or tasks specified on the Travail (JOB), Task name (TASKNAME), TDE number (TDENBR), Sous-système (SBS), or Current storage pool (CURPOOL) parameters.

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

nom

Nom du profil utilisateur en cours des travaux qui sont inclus dans la collecte. Seuls les travaux qui s'exécutent sous le profil utilisateur en cours indiqué pendant l'intervalle sont inclus dans la collecte. The current user profile name of the jobs which will be included in the collection. Only jobs which are running under the specified current user profile during the interval will be included in the collection.

Sous-système (SBS)

Indique le sous-système des travaux qui sont inclus dans la collecte Job Watcher. Les travaux sélectionnés pour ce paramètre sont collectés en plus des travaux ou tâches indiqués dans les paramètres Travail (JOB), Nom de tâche (TASKNAME), Numéro TDE (TDENBR), Profil utilisateur en cours (CURUSRPRF) ou Pool de mémoire en cours (CURPOOL). Specifies the subsystem of the jobs which will be included in the Job Watcher collection. Jobs selected on this parameter will be collected in addition to any jobs or tasks specified on the Travail (JOB), Task name (TASKNAME), TDE number (TDENBR), Current user profile (CURUSRPRF), or Current storage pool (CURPOOL) parameters.

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

nom

Le nom du sous-système des travaux qui sont inclus dans la collecte. Seuls les travaux qui s'exécutent dans le sous-système indiqué au moment de la collecte des données sont inclus dans la collecte. The name of the subsystem of the jobs which will be included in the collection. Only jobs which are running in the specified subsystem at the time data is gathered will be included in the collection.

Pool de mémoire en cours (CURPOOL)Current storage pool (CURPOOL)

Indique le pool système en cours des travaux et/ou tâches qui sont inclus dans la collecte Job Watcher. Les travaux et/ou tâches sélectionnés pour ce paramètre sont collectés en plus des travaux ou tâches indiqués dans les paramètres Travail (JOB), Nom de tâche (TASKNAME), Numéro TDE (TDENBR), Profil utilisateur en cours (CURUSRPRF) ou Sous-système (SBS). Specifies the current system pool of the jobs and/or tasks which will be included in the Job Watcher collection. Jobs and/or tasks selected on this parameter will be collected in addition to any jobs or tasks specified on the Travail (JOB), Task name (TASKNAME), TDE number (TDENBR), Current user profile (CURUSRPRF), or Sous-système (SBS) parameters.

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

1-64

Le numéro du pool en cours des travaux et/ou tâches qui sont inclus dans la collecte. Seuls les travaux et/ou tâches qui s'exécutent dans le pool indiqué au moment de la collecte des données sont inclus dans la collecte. The current pool number of the jobs and/or tasks which will be included in the collection. Only jobs and/or tasks which are running in the specified pool at the time data is gathered will be included in the collection.

Forcer écriture enregistrement (FRCRCD)

Indique quand les enregistrements de données sont écrits dans les fichiers de base de données Job Watcher. Specifies when data records will be written to the Job 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 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 data collection is ended.

Inclure les travaux/tâches inactifs (INCALLFST)Include inactive jobs/tasks (INCALLFST)

Indique si les données détaillées de tous les travaux et tâches, y compris les travaux et tâches inactifs, sont collectées pour le premier intervalle. Specifies whether detailed data for all jobs and tasks, including inactive jobs and tasks, will be collected for the first interval.

*NO

Les travaux et tâches inactifs ne sont pas collectés au premier intervalle. Inactive jobs and tasks will not be collected on the first interval.

*YES

Les travaux et tâches inactifs sont collectés au premier intervalle. Cette option fournit des informations détaillées sur les travaux et tâches en attente au moment du démarrage de la collecte. Ces informations ne seraient autrement disponibles qu'à un intervalle où le travail ou la tâche devient actif. La collecte de ces informations supplémentaires peut rendre la durée du premier intervalle nettement supérieure à celle du reste de la collecte. Inactive jobs and tasks will be collected on the first interval. This option will provide detailed information about the jobs and tasks that are waiting at the time the collection started. This information would otherwise not be available until an interval in which the job or task becomes active. Collecting this additional information may cause the duration of the first interval to be significantly larger than the rest of the collection.

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 Job 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 Job 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

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 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. The percentage of the database files' ASP which may be used before 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. Job 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 Job 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

Le pourcentage de l'ASP système pouvant être utilisé avant que la fin de la collecte des données 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. The percentage of the system ASP which may be used before 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.

Fichier de contrôle de condition (CONDCTLF)Condition control file (CONDCTLF)

Indique le nom du fichier de contrôle de condition. Ce fichier doit être un fichier physique source et peut servir à indiquer les conditions que Job Watcher utilise pour limiter la collecte de données. Si un fichier est indiqué pour ce paramètre, les données collectées sont comparées aux conditions définies dans le fichier. Specifies the name of the condition control file. This file must be a source physical file and may be used to specify conditions that Job Watcher will use to limit data collection. If a file is specified on this parameter, the data collected will be compared against the conditions defined in the file.

Les conditions doivent être indiquées dans un format précis. Les conditions et formats valides sont décrits ci-après : Conditions must be specified in a specific format. A description of valid conditions and formats follows:

Comparaison directe de zone Direct field comparison

Syntaxe : FIELDNAME.COMPARAND.VALUE Syntax: FIELDNAME.COMPARAND.VALUE

Exemple 1 : la condition est satisfaite lorsque plus de 75 écritures synchrones de base de données se produisent dans l'intervalle Example 1: The condition will be met when more than 75 synchronous database writes occur in the interval

SYNDBWRT.GT.75

Exemple 2 : la condition est satisfaite lorsque le temps d'attente du compartiment 6 est compris entre 30 et 80 microsecondes. Example 2: The condition will be met when the wait time in bucket 6 is between 30 and 80 microseconds.

QTIME06.GE.30.AND.QTIME06.LE.80

Condition de taux Rate condition

Syntaxe : RATE(FIELDNAME).COMPARAND.VALUE Syntax: RATE(FIELDNAME).COMPARAND.VALUE

Exemple : la condition est satisfaite lorsque le taux d'écritures synchrones de base de données est supérieur à 10 par seconde Example: The condition will be met when the rate of synchronous database writes is greater than 10 per second

RATE(SYNDBWRT).GT.10

Condition de pourcentage (s'applique au temps passé dans un compartiment d'attente particulier) Percent condition (applies to time spent in a particular wait bucket)

Syntaxe : PERCENT(FIELDNAME).COMPARAND.VALUE Syntax: PERCENT(FIELDNAME).COMPARAND.VALUE

Exemple : la condition est satisfaite lorsque plus de 10 pour cent du temps d'attente a été comptabilisé dans le compartiment 9 Example: The condition will be met when more than 10 percent of time spent waiting was counted in bucket 9

PERCENT(QTIME09).GT.10

Condition de moyenne Average condition

Syntaxe : AVERAGE(FIELDNAME1,FIELDNAME2).COMPARAND.VALUE où FIELDNAME1 est un temps et FIELDNAME2 est un compteur correspondant Syntax: AVERAGE(FIELDNAME1,FIELDNAME2).COMPARAND.VALUE where FIELDNAME1 is a time and FIELDNAME2 is a corresponding count

Remarque : à l'heure actuelle, les seules combinaisons temps/compteur signalées dans Job Watcher sont les temps et compteurs des compartiments d'attente signalés dans le fichier QAPYJWTDE. Note: At this time the only time/count combinations reported in Job Watcher are the wait bucket times and counts reported in the QAPYJWTDE file.

Exemple : la condition est satisfaite lorsque le temps d'attente moyen d'une attente comptabilisée dans le compartiment 5 est supérieur à 50 microsecondes Example: The condition will be met when the average wait time for a wait counted in bucket 5 is greater than 50 microseconds

AVERAGE(QTIME05,QCOUNT05).GT.50

Valeurs uniques

*NONE

Aucune condition n'est indiquée pour la collecte Job Watcher. No condition will be specified for the Job Watcher collection.

Qualificatif 1: Fichier

nom

Indiquez le nom du fichier qui contient les informations de condition. Specify the name of the file which contains the condition information.

Qualificatif 2: Biblio

nom

Indiquez le nom de la bibliothèque qui contient le fichier de contrôle de condition. Specify the name of the library which contains the condition control file.

Membre de contrôle de condition (CONDCTLMBR)Condition control member (CONDCTLMBR)

Indique le membre de fichier qui contient les informations de condition. Specifies the file member which contains the condition information.

*FIRST

Le premier membre du fichier est utilisé. The first member in the file will be used.

nom

Indiquez le nom du membre qui contient les informations de condition. Specify the name of the member which contains the condition information.

Type de condition (CONDTYPE)Condition type (CONDTYPE)

Indique le type de collecte conditionnelle. Specifies the type of conditional collection.

*PERITV

La condition indiquée est vérifiée à chaque intervalle. Dans ce type de collecte, les données ne sont écrites dans les fichiers de base de données que pour les intervalles où la condition a été satisfaite. Si un programme d'exit est indiqué dans le paramètre Programme d'exit utilisateur (EXITPGM), il est appelé à chaque intervalle où la condition a été satisfaite. The specified condition will be checked in every interval. In this type of collection, data will only be written to the database files for intervals in which the condition was satisfied. If an exit program is specified on the on the Programme d'exit utilisateur (EXITPGM) parameter it will be called in each interval where the condition was satisfied.

*TRIGGER

La condition indiquée est vérifiée à chaque intervalle jusqu'à ce qu'elle soit satisfaite. Une fois la condition remplie, les données sont écrites sans condition dans les fichiers de base de données pour le reste de la collecte. Si un programme d'exit est indiqué dans le paramètre Programme d'exit utilisateur (EXITPGM), il est appelé une seule fois, à l'intervalle où la condition a été satisfaite. The specified condition will be checked in each interval until the condition is satisfied. Once the condition has been met, data will be unconditionally written to the database files for the remainder of the collection. If an exit program is specified on the on the Programme d'exit utilisateur (EXITPGM) parameter it will be called one time in the interval where the condition was satisfied.

*UNTILMET

Les données sont écrites sans condition dans les fichiers de base de données jusqu'à ce que la condition soit satisfaite. Une fois la condition remplie, la collecte se termine. Si un programme d'exit est indiqué dans le paramètre Programme d'exit utilisateur (EXITPGM), il est appelé une seule fois avant la fin de la collecte. Data will be unconditionally written to the database files until the condition is satisfied. Once the condition has been met, the collection will end. If an exit program is specified on the on the Programme d'exit utilisateur (EXITPGM) parameter it will be called one time before the collection ends.

Option de délai d'attente (TIMEOUT)

Indique la durée pendant laquelle la collecte peut s'exécuter sans écrire de données dans les fichiers de base de données. Specifies how long the collection should run without writing any data to the database files.

Valeurs uniques

*NONE

La collecte n'expire pas. The collection will not time out.

Élément 1: Option

*NBRSEC

La collecte expire une fois écoulé le nombre de secondes indiqué dans l'élément 2 de ce paramètre sans que la condition ait été satisfaite. The collection will time out after the number of seconds specified in element 2 of this parameter has elapsed without the condition being met.

*NBRITV

La collecte expire une fois collecté le nombre d'intervalles indiqué dans l'élément 2 de ce paramètre sans que la condition ait été satisfaite. The collection will time out after the number of intervals specified in element 2 of this parameter have been collected without the condition being met.

Élément 2: Valeur

entier

Indiquez le nombre de secondes (pour *NBRSEC) ou le nombre d'intervalles (pour *NBRITV) à utiliser comme critère d'expiration de la collecte conditionnelle. Specify the number of seconds (for *NBRSEC) or the number of intervals (for *NBRITV) to use as the timeout criteria for the conditional collection.

Nombre d'occurrences consécutives (OCCURS)Consecutive occurrence count (OCCURS)

Indique le nombre d'intervalles consécutifs dans lesquels la condition indiquée doit se produire avant d'être considérée comme satisfaite. Specifies number of consecutive intervals in which the specified condition must occur before it is considered satisfied.

1

La condition doit se produire dans un intervalle pour être considérée comme satisfaite. The condition must occur in one interval to be considered satisfied.

entier

Indiquez le nombre d'intervalles consécutifs dans lesquels la condition doit se produire. Specify the number of consecutive intervals in which the condition must occur.

Taille de l'historique (HSTSIZE)History size (HSTSIZE)

Indique la quantité de données (en intervalles) à mettre en mémoire tampon comme historique pendant la collecte conditionnelle. La quantité de données indiquée est conservée jusqu'à ce que la condition soit satisfaite ; toutes les données en mémoire tampon sont alors écrites dans les fichiers de base de données, avec les données de l'intervalle en cours. Specifies the amount of data (in intervals) that should be buffered as history during the conditional collection. The specified amount of data will be maintained until the condition has been satisfied, at which time all buffered data will be written to the database files along with the data from the current interval.

0

Aucune donnée d'historique n'est mise en mémoire tampon. No history data will be buffered.

entier

Indiquez le nombre d'intervalles à mettre en mémoire tampon comme historique. Specify the number of intervals which should be buffered as history.

Programme d'exit utilisateur (EXITPGM)

Indique le programme d'exit utilisateur qui est appelé lorsque la condition est satisfaite. Specifies the user exit program which will be called at the time the condition is satisfied.

Valeurs uniques.

*NONE

Aucun programme d'exit n'est appelé. No exit program will be called.

Qualificatif 1: Programme d'exit utilisateur

nom

Indiquez le nom du programme d'exit utilisateur. Specify the name of the user exit program.

Qualificatif 2: Biblio

nom

Indiquez le nom de la bibliothèque dans laquelle se trouve le programme d'exit utilisateur. Specify the name of the library where the user exit program is located.

Données du programme d'exit (EXITPGMDTA)Exit program data (EXITPGMDTA)

Indique les données à transmettre au programme d'exit utilisateur indiqué dans le paramètre Programme d'exit utilisateur (EXITPGM). Specifies any data which should be passed to the user exit program specified on the Programme d'exit utilisateur (EXITPGM) parameter.

*NONE

Aucune donnée n'est transmise au programme d'exit utilisateur. No data will be passed to the user exit program.

valeur-caractère

Indiquez les données à transmettre au programme d'exit utilisateur. Specify any data which should be passed to the user exit program.

Exemples

Exemple 1 : Ajout d'une définition Job Watcher qui collecte des données pour un travail spécifique sans délai entre les échantillons Example 1: Add a Job Watcher Definition which will Collect Data for a Specific Job with No Delay Between Samples

ADDJWDFN   DFN(MYJOB) COLITV(*NODELAY)
           JOB(123456/MYUSER/MYJOB)  TASKNAME(*NONE)

Cette commande ajoute une définition Job Watcher qui collecte des données pour le travail 123456/MYUSER/MYJOB. Les données sont collectées le plus rapidement possible, sans délai entre les intervalles. Pour collecter des données Job Watcher à l'aide de cette définition, utilisez la commande Démarrer Job Watcher (STRJW) en indiquant MYJOB pour le paramètre Définition (DFN). This command will add a Job Watcher definition which will collect data for job 123456/MYUSER/MYJOB. Data will be collected as fast as possible, with no delay between intervals. To collect Job Watcher data using this definition use the Start Job Watcher (STRJW) command with MYJOB specified for the Définition (DFN) parameter.

Exemple 2 : Ajout d'une définition Job Watcher qui collecte des données pour un travail générique, avec collecte de données SQL Example 2: Add a Job Watcher Definition which will Collect Data for a Generic Job, Collecting SQL Data

ADDJWDFN   DFN(GENJOB)  COLITV(5)  ADDDTACGY((*SQLDETAIL))
           JOB(*ALL/*ALL/QPADEV*)  TASKNAME(*NONE)

Cette commande ajoute une définition Job Watcher qui collecte des données pour tous les travaux dont le nom commence par 'QPADEV'. Les données sont collectées avec un délai de 5 secondes entre les intervalles. Les données standard et les données SQL sont collectées. Pour collecter des données Job Watcher à l'aide de cette définition, utilisez la commande Démarrer Job Watcher (STRJW) en indiquant GENJOB pour le paramètre Définition (DFN). This command will add a Job Watcher definition which will collect data for all jobs with names which begin with 'QPADEV'. Data will be collected with a delay of 5 seconds between intervals. Standard data and SQL data will be collected. To collect Job Watcher data using this definition use the Start Job Watcher (STRJW) command with GENJOB specified for the Définition (DFN) parameter.

Exemple 3 : Ajout d'une définition Job Watcher qui collecte des données pour tous les travaux et toutes les tâches, avec collecte des piles d'appels de ceux qui sont en attente de conflit Example 3: Add a Job Watcher Definition which will Collect Data for All Jobs and Tasks, Collecting Call Stacks for those in Conflict Waits

ADDJWDFN   DFN(CONFLICT)  WAITSTK((*CONFLICT 100))

Cette commande ajoute une définition Job Watcher qui collecte des données pour tous les travaux et toutes les tâches du système. Les données sont collectées à l'intervalle par défaut de 10 secondes. Les données collectées avec cette définition comprennent les données standard, ainsi que les piles d'appels de tout travail ou toute tâche qui a été en attente de conflit pendant au moins 100 microsecondes. Pour collecter des données Job Watcher à l'aide de cette définition, utilisez la commande Démarrer Job Watcher (STRJW) en indiquant CONFLICT pour le paramètre Définition (DFN). This command will add a Job Watcher definition which will collect data for all jobs and tasks on the system. Data will be collected at the default interval of 10 seconds. Data collected with this definition will include standard data, as well as call stacks for any job or task which was in a conflict wait for 100 microseconds or longer. To collect Job Watcher data using this definition use the Start Job Watcher (STRJW) command with CONFLICT specified for the Définition (DFN) parameter.

Exemple 4 : ajout d'une définition Job Watcher qui collecte des données sous conditions pour un nom de travail générique Example 4: Add a Job Watcher Definition which will Conditionally Collect Data for a Generic Job Name

ADDJWDFN   DFN(COND)  JOB(*ALL/*ALL/QSQ*)
           TASKNAME(*NONE)  CONDCTLF(MYLIB/MYCTLFILE)
           CONDCTLMBR(MYCTLMBR)  CONDTYPE(*TRIGGER)
           TIMEOUT(1000/*NBRITV)  HSTSIZE(5)

Cette commande ajoute une définition Job Watcher qui collecte de façon conditionnelle des données pour tous les travaux dont le nom commence par 'QSQ'. Le fichier/membre qui indique la condition à évaluer est MYCTLFILE/MYCTLMBR et ce fichier se trouve dans la bibliothèque MYLIB. Aucune donnée n'est écrite dans les fichiers de base de données Job Watcher tant que la condition indiquée n'est pas satisfaite. Au moment où la condition est remplie, les 5 intervalles précédents de données d'historique sont écrits dans les fichiers de base de données. Si la collecte des données se poursuit pendant 1000 intervalles sans que la condition soit satisfaite dans aucun intervalle, la collecte se termine sans écrire aucune donnée dans les fichiers de base de données. Pour collecter des données Job Watcher à l'aide de cette définition, utilisez la commande Démarrer Job Watcher (STRJW) en indiquant COND pour le paramètre Définition (DFN). This command will add a Job Watcher definition which will conditionally collect data for all jobs with names which begin with 'QSQ'. The file/member which specifies the condition to evaluate is MYCTLFILE/MYCTLMBR and this file exists in library MYLIB. No data will be written to the Job Watcher database files until the specified condition has been satisfied. At the time the condition is met, the 5 previous intervals of history data will be written to the database files. If data collection continues for 1000 intervals and the condition is not satisfied in any interval, the collection will end without writing any data to the database files. To collect Job Watcher data using this definition use the Start Job Watcher (STRJW) command with COND specified for the Définition (DFN) parameter.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPFAF10

La définition ou le filtre existe déjà. Definition or filter already exists.

CPFB518

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