STRJW

La commande Démarrer Job Watcher (STRJW) démarre la collecte de données détaillées sur les performances des travaux. Elle permet à l'utilisateur d'obtenir des données détaillées relatives à un ensemble sélectionné de travaux ou de tâches du système. Job Watcher collecte les données par échantillonnage et les écrit dans un ensemble de fichiers de base de données dont les noms commencent tous par les lettres 'QAPYJW'. Outre les informations de base sur les travaux, l'utilisateur peut demander, en option, des données SQL, de groupe d'activation, de sockets et TCP, ainsi que de pile d'appels. The Start Job Watcher (STRJW) command starts the collection of detailed job performance data. It allows the user to obtain detailed data related to a selected set of jobs or tasks on the system. Job Watcher collects data on a sampling basis and writes the collected data to a set of database files. The file names all begin with the letters 'QAPYJW'. In addition to basic job information the user may optionally request SQL, activation group, sockets and TCP, and call stack data.

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.
• 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 Job Watcher à utiliser au démarrage d'une nouvelle collecte Job Watcher. La définition identifie les paramètres à utiliser au démarrage d'une collecte Job Watcher. Une nouvelle définition Job Watcher peut être créée à l'aide de la commande Ajouter définition Job Watcher (ADDJWDFN). Specifies the Job Watcher definition to use when starting a new Job Watcher collection. The definition identifies the parameters to use when starting a Job Watcher collection. A new Job Watcher definition can be created using the Add Job Watcher Definition (ADDJWDFN) command.

*SELECT

L'utilisateur est invité à effectuer une sélection dans une liste des définitions Job Watcher existantes. Cette valeur n'est pas valide lorsque la commande STRJW est soumise en traitement par lots et provoque une erreur. The user will be prompted to select from a list of existing Job Watcher definitions. This value is not valid when the STRJW command is submitted to batch and will result in an error.

nom

Indiquez le nom de la définition Job Watcher à utiliser pour cette collecte. Specify the name of the Job 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 sont écrites. Si aucun membre de ce nom n'existe dans chaque fichier de base de données Job Watcher, il est créé avec le nom indiqué. Si un membre de ce nom existe déjà, vous devez indiquer *YES pour 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 will be written. If a member by this name does not exist in each Job 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 est généré d'après le moment où la commande STRJW a été appelée. Le format du nom de la collecte est Qdddhhmmss, où ddd est le jour julien (001-366) et hhmmss correspond à l'heure (01-24), aux minutes (00-59) et aux secondes (00-59) du démarrage de la collecte. The collection name will be generated based on when the STRJW command was called. 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 collection was started.

nom

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

Biblio (LIB)

Indique la bibliothèque dans laquelle se trouvent les fichiers de base de données des données Job Watcher. 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 Job Watcher data will 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 Job Watcher associés à la collecte. Specifies the text to be used for each member across the set of Job Watcher database files associated with the collection.

*DFN

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

*BLANK

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

valeur-caractère

Indiquez une description textuelle pour cet ensemble de membres de fichiers de base de données Job Watcher. La description ne doit pas dépasser 50 caractères et doit être placée entre apostrophes. Specify a text description for this set of Job 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 Job Watcher doit être remplacé par un nouvel ensemble de membres portant le même nom. Specifies whether an existing set of Job Watcher database file members should be replaced with a new set of members with the same name.

*NO

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

*YES

Les membres existants des fichiers de base de données Job Watcher sont remplacés par les données de la nouvelle collecte. The existing Job 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 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.

*DFN

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

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

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

Indique les critères qui mettent fin à la collecte. Ce paramètre permet d'indiquer plusieurs conditions de fin de collecte des données. Si plusieurs options de fin sont indiquées, la collecte Job Watcher prend fin dès que l'un des critères indiqués est satisfait. 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 end option is specified, the Job Watcher collection will end the first time any one of the 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

Valeurs uniques

*NOITVDTA

Termine la collecte après le premier intervalle au cours duquel aucun enregistrement n'a été collecté. End the collection after the first interval in which no records were collected.

Autres valeurs

*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 Job 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 has been written to the Job 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 has 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. If the default of *NBRSEC is used for element 1 of this parameter, the collection will end after sixty seconds of 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. 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 the collection.

Travail (JOB)

Indique les travaux inclus dans la collecte Job Watcher. Si une valeur est indiquée pour ce paramètre, elle remplace la valeur de la définition Job Watcher. Specifies the jobs that will be included in the Job Watcher collection. If a value is specified on this parameter it will override the value in the Job Watcher definition.

Valeurs uniques

*DFN

Les travaux indiqués dans la définition Job Watcher sont utilisés pour cette collecte. The jobs specified in the Job Watcher definition will be used for this collection.

*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 de la ou des tâches incluses dans la collecte Job Watcher. Si une valeur est indiquée pour ce paramètre, elle remplace la valeur de la définition Job Watcher. Specifies the name of the task(s) which will be included in the Job Watcher collection. If a value is specified on this parameter it will override the value in the Job Watcher definition.

Valeurs uniques

*DFN

Les tâches indiquées dans la définition Job Watcher sont utilisées pour cette collecte. The tasks specified in the Job Watcher definition will be used for this collection.

*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 which will be included in the collection.

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

Indique le numéro d'élément de distribution de tâches (TDE) du ou des TDE inclus dans la collecte Job Watcher. Le numéro de 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 de 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 outils de service système (STRSST). Si une valeur est indiquée pour ce paramètre, elle remplace la valeur de la définition Job Watcher. 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). If a value is specified on this parameter it will override the value in the Job Watcher definition.

Valeurs uniques

*DFN

Les numéros de TDE indiqués dans la définition Job Watcher sont utilisés pour cette collecte. The TDE numbers specified in the Job Watcher definition will be used for this collection.

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

number

Numéro de TDE des TDE qui seront inclus dans la collecte. The TDE number of the TDEs which will be included in the collection.

Exemples

Exemple 1 : Démarrer Job Watcher avec une définition Example 1: Start Job Watcher Using a Definition

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

Cette commande démarre une collecte Job 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 Job Watcher de la bibliothèque MYLIB, dans le membre TEST. Les noms des fichiers de la base de données Job Watcher commencent tous par 'QAPYJW'. This command will start a Job Watcher collection using the definition called MYDFN to determine which data will 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 Job Watcher database files in library MYLIB in member TEST. The Job Watcher database file names all begin with 'QAPYJW'.

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

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

Cette commande démarre Job 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 Job Watcher de la bibliothèque QPFRDATA, dans un nom de membre généré par Job Watcher d'après la date et l'heure de début de la collecte. This command will start Job 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 Job Watcher database files in library QPFRDATA in a member name which will be generated by Job Watcher based on the date and time the collection started.

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

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

Cette commande ouvre un panneau d'invite qui répertorie toutes les définitions Job 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 Job Watcher de la bibliothèque MYLIB, dans le membre TEST. This command will open a prompt panel listing all Job 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 Job 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.

CPFB514

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

CPFB517

Erreur inattendue dans Job Watcher. Unexpected error in Job Watcher.

CPFB518

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

CPFB519

Erreur détectée dans le fichier de contrôle des conditions de Job Watcher. Error detected in Job Watcher condition control file.

CPFB51A

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

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.