STRWCH

La commande Démarrer surveillance (STRWCH) démarre la fonction de surveillance d'événements, qui avertit l'utilisateur en appelant un programme qu'il a indiqué lorsque l'événement indiqué (un message, une entrée du journal LIC ou une entrée PAL) se produit. PAL signifie Product Activity Log (journal d'activité des produits) ; il présente les erreurs survenues (par exemple sur les unités de disque et de bande, les communications et les postes de travail). The Start Watch (STRWCH) command starts the watch for event function, which notifies the user by calling a user specified program when the specified event (a message, a LIC log entry or PAL entry) occurs. PAL stands for Product Activity Log which shows errors that have occurred (such as in disk and tape units, communications, and work stations).

Jusqu'à 10000 sessions de surveillance peuvent être actives simultanément, mais les identificateurs de sessions de surveillance actives doivent être uniques dans tout le système. Up to 10000 watch sessions can be active at a time but active watch session identifiers must be unique across the system.

La session de surveillance se poursuit jusqu'à ce qu'elle soit arrêtée par la commande Terminer surveillance (ENDWCH) ou par l'API Terminer surveillance (QSCEWCH). Une session de surveillance peut être arrêtée à partir du même travail ou d'un autre travail. The watch session continues until ended with the End Watch (ENDWCH) command or with the End Watch (QSCEWCH) API. A watch session can be ended from the same job or a different job.

Restrictions:

• Pour utiliser cette commande, vous devez posséder le droit spécial service (*SERVICE) ou être autorisé à la fonction de surveillance de service d'IBM i via la prise en charge de l'administration des applications de System i Navigator. La commande Modifier l'utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_SERVICE_WATCH, peut également être utilisée pour modifier la liste des utilisateurs autorisés à démarrer et à arrêter des opérations de surveillance. To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service watch function of IBM i through System i Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_WATCH, can also be used to change the list of users that are allowed to start and end watch operations.
• Lorsque le paramètre Travail surveillé (WCHJOB) est indiqué, l'émetteur de la commande doit s'exécuter sous un profil utilisateur identique à l'identité utilisateur du travail surveillé, ou sous un profil utilisateur possédant le droit spécial contrôle des travaux (*JOBCTL). Le droit spécial contrôle des travaux (*JOBCTL) est également requis si un nom d'utilisateur générique est indiqué pour le paramètre WCHJOB. When the Watched job (WCHJOB) parameter is specified, the issuer of the command must be running under a user profile which is the same as the job user identity of the job being watched, or the issuer of the command must be running under a user profile which has job control (*JOBCTL) special authority. Job control (*JOBCTL) special authority is also required if a generic user name is specified for the WCHJOB parameter.
• Si vous indiquez *ALL pour le nom de travail surveillé, ou un nom d'utilisateur générique, vous devez posséder le droit spécial sur tous les objets (*ALLOBJ) ou être autorisé à la fonction Surveiller n'importe quel travail d'IBM i via la prise en charge de l'administration des applications de System i Navigator. La commande Modifier utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_WATCH_ANY_JOB, peut également être utilisée pour modifier la liste des utilisateurs autorisés à démarrer et à arrêter des opérations de surveillance. If you specify *ALL for the watched job name, or a generic user name, you must have all object (*ALLOBJ) special authority, or be authorized to the Watch any job function of IBM i through System i Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_WATCH_ANY_JOB, can also be used to change the list of users that are allowed to start and end watch operations.
• Vous devez posséder les droits d'exploitation (*OBJOPR) et d'exécution (*EXECUTE) sur le programme de surveillance à appeler, ainsi que le droit d'exécution (*EXECUTE) sur la bibliothèque où se trouve le programme. You must have operational (*OBJOPR) and execute (*EXECUTE) authorities to the watch program to be called, and execute (*EXECUTE) authority to the library where the program is located.
• Vous devez posséder le droit d'utilisation (*USE) sur les files d'attente de messages indiquées dans le paramètre File d'attente de messages surveillée (WCHMSGQ), ainsi que le droit d'utilisation (*USE) sur la bibliothèque dans laquelle se trouve la file d'attente de messages. You must have use (*USE) authority to the message queues specified in Watched message queue (WCHMSGQ) parameter, and use (*USE) authority to the library where the message queue is located.

Paramètres

ID de session (SSNID)Session ID (SSNID)

Indique un identificateur de session pour cette surveillance. Cet identificateur doit être unique parmi toutes les surveillances actives du système. Specifies a session identifier for this watch. This identifier must be unique across all active watches on the system.

Ce paramètre est obligatoire. This is a required parameter.

*GEN

Le système génère un identificateur de session unique pour cette surveillance. The system will generate a unique session identifier for this watch.

nom

Indiquez l'identificateur de session de cette surveillance. Vous ne pouvez pas indiquer d'identificateur de session commençant par "QSC". Specify the session identifier for this watch. You cannot specify a session identifier that starts with "QSC".

Programme de surveillance (WCHPGM)Watch program (WCHPGM)

Indique le programme d'exit utilisateur à appeler pour signaler qu'un événement surveillé indiqué s'est produit. Le programme d'exit est appelé une fois pour chaque message, entrée du journal LIC et entrée PAL indiqués dans cette commande. Autrement dit, si un message est surveillé dans une file d'attente de messages et dans un historique de travail, et que le message est envoyé aux deux emplacements, le programme d'exit est appelé deux fois. Specifies the user exit program to be called to notify that a specified watch event occurred. The exit program will be called once for each message, LIC log entry and PAL entry specified on this command. That is, if a message is watched on a message queue and in a job log, and the message is sent to both locations, the exit program will be called twice.

Ce paramètre est obligatoire. This is a required parameter.

Le programme de surveillance est appelé : The watch program will be called:

• Après une correspondance avec un message, un type, une gravité et toute donnée de comparaison associée indiqués pour le paramètre WCHMSG, ou une correspondance avec une entrée du journal du code interne sous licence (LIC) et toute donnée de comparaison associée indiquée pour le paramètre WCHLICLOG, ou une correspondance avec une entrée du journal d'activité des produits (PAL) et toute donnée de comparaison associée indiquée pour le paramètre WCHPAL. After a match of a message, type, severity and any associated comparison data specified for the WCHMSG parameter, or a match of a Licensed Internal Code (LIC) log entry and any associated comparison data specified for the WCHLICLOG parameter, or a match of a Product Activity Log (PAL) entry and any associated comparison data specified for the WCHPAL parameter occurs.
• Chaque fois qu'il a été défini dans le paramètre Appel du programme de surveillance (CALLWCHPGM). Whenever it was defined in the Call watch program (CALLWCHPGM) parameter.

Le programme de surveillance possède trois paramètres d'entrée et un paramètre de sortie. Les quatre paramètres sont obligatoires : There are three input parameters and one output parameter associated with the watch program. The four parameters are required:

1   Watch option setting   Input    Char(10)
2   Session Id             Input    Char(10)
3   Error detected         Output   Char(10)
4   Event data             Input    Char(*)

Les valeurs autorisées pour le paramètre "Watch option setting" sont les suivantes : Allowed values for the "Watch option setting" parameter are:

*MSGID

Une correspondance s'est produite avec un ID de message ou un message immédiat/impromptu, un type de message, une gravité de message et toute donnée de comparaison associée indiqués dans le paramètre WCHMSG. A match on a message id or immediate/impromptu message, message type, message severity and any associated comparison data specified on WCHMSG parameter occurred.

*LICLOG

Une correspondance s'est produite avec une entrée du journal LIC et toute donnée de comparaison associée indiquée dans le paramètre WCHLICLOG. A match on a LIC log andany associated comparison data specified on the WCHLICLOG parameter occurred.

*PAL

Une correspondance s'est produite avec une entrée du journal d'activité des produits (PAL) et toute donnée de comparaison associée indiquée dans le paramètre WCHPAL. A match on a Product Activity Log (PAL) and any associated comparison data specified on the WCHPAL parameter occurred.

*STRWCH

Le programme de surveillance est appelé avant le début de la surveillance de tout événement. The watch program will be called before starting watching for any event.

*ENDWCH

The watch program will be called when the watch session is ending. Possible reasons might be:

• La commande Terminer surveillance (ENDWCH) ou l'API Terminer surveillance (QSCEWCH) a été émise. End Watch (ENDWCH) command or End Watch (QSCEWCH) API was issued.
• Un ou plusieurs des travaux de surveillance d'événements se sont terminés anormalement ou ont été arrêtés par une action de l'utilisateur. One or more of the watch for event jobs ended abnormally or ended by user action.

Remarque : Une session de surveillance peut se terminer parce qu'une erreur a été détectée dans le programme d'exit de surveillance. Dans ce cas, le programme de surveillance n'est pas appelé au moment de *ENDWCH. Note: A watch session might end because an error was detected on the watch exit program. In this case, the watch program will not be called at *ENDWCH time.

Le paramètre "Session ID" contient le nom de la session de surveillance qui appelle le programme d'exit utilisateur. The "Session ID" parameter contains the name of the watch session that is calling the user exit program.

Les valeurs autorisées pour le paramètre « Error detected » sont : Allowed values for the "Error detected" parameter are:

*ERROR

Erreur détectée par le programme d'exit de surveillance. La session de surveillance transmise dans le paramètre Session ID est arrêtée. Si la session de surveillance à arrêter avait initialement indiqué plusieurs messages, entrées du journal LIC ou entrées PAL, aucun d'entre eux n'est plus surveillé. Le message CPI3999 est envoyé à l'historique du travail et à l'historique système pour indiquer qu'une erreur du programme d'exit a provoqué l'arrêt de la session de surveillance. Error detected by watch exit program. The watch session that was passed in Session ID parameter will be ended. If the watch session to be ended originally specified multiple messages or LIC log entries or PAL entries, all of them will no longer be watched. CPI3999 message will be sent to the job log and the history log to indicate an error in the exit program caused the watch session to be ended.

<blanks>

Aucune erreur détectée par le programme d'exit de surveillance. No error detected by watch exit program.

Remarques : Notes:

• Toute valeur autre que "*ERROR" ou <blancs> est considérée comme une erreur, et la session de surveillance transmise dans le paramètre Session ID est arrêtée. Si la session de surveillance à arrêter avait initialement indiqué plusieurs messages, entrées du journal LIC ou entrées PAL, aucun d'entre eux n'est plus surveillé. Le message CPI3999 est envoyé à l'historique du travail et à l'historique système pour indiquer qu'une erreur du programme d'exit a provoqué l'arrêt de la session de surveillance. Any value other than "*ERROR" or <blanks> will be considered an error and the watch session that was passed in Session ID parameter will be ended. If the watch session to be ended originally specified multiple messages or LIC log entries or PAL entries, all of them will no longer be watched. CPI3999 message will be sent to the job log and the history log to indicate an error in the exit program caused the watch session to be ended.

Les valeurs autorisées pour le paramètre "Event data" lorsque *MSGID est indiqué pour le paramètre "Watch option setting" ont la structure suivante : Allowed values for the "Event data" parameter when *MSGID is specified for the "Watch option setting" parameter will be the following structure:

OFFSET     TYPE         FIELD
Dec  Hex
  0    0   BINARY(4)    Length of watch information
  4    4   CHAR(7)      Message watched
 11    B   CHAR(1)      Reserved
 12    C   CHAR(10)     Message queue name
 22   16   CHAR(10)     Message queue library
 32   20   CHAR(10)     Job name
 42   2A   CHAR(10)     User name
 52   34   CHAR(6)      Job number
 58   3A   BINARY(4)    Original replacement data length
 62   3E   CHAR(256)    Sending program name
318  13E   CHAR(10)     Sending module name
328  148   BINARY(4)    Offset to sending procedure name
332  14C   BINARY(4)    Length of sending procedure name
336  150   CHAR(10)     Receiving program name
346  15A   CHAR(10)     Receiving module name
356  164   BINARY(4)    Offset to receiving procedure name
360  168   BINARY(4)    Length of receiving procedure name
364  16C   BINARY(4)    Message severity
368  170   CHAR(10)     Message type
378  17A   CHAR(8)      Message timestamp
386  182   CHAR(4)      Message key
390  186   CHAR(10)     Message file name
400  190   CHAR(10)     Message file library
410  19A   CHAR(2)      Reserved
412  19C   BINARY(4)    Offset to comparison data
416  1A0   BINARY(4)    Length of comparison data
420  1A4   CHAR(10)     Compare against
430  1AE   CHAR(2)      Reserved
432  1B0   BINARY(4)    Comparison data CCSID
436  1B4   BINARY(4)    Offset where comparison data was found
440  1B8   BINARY(4)    Offset to replacement data
444  1BC   BINARY(4)    Length of replacement data
448  1C0   BINARY(4)    Replacement data CCSID
452  1C4   CHAR(10)     Sending user profile
462  1CE   CHAR(10)     Target job name
472  1D8   CHAR(10)     Target job user name
482  1E2   CHAR(6)      Target job number
 *   *     CHAR(*)      Sending procedure name
 *   *     CHAR(*)      Receiving procedure name
 *   *     CHAR(*)      Message comparison data
 *   *     CHAR(*)      Message replacement data

Les valeurs autorisées pour le paramètre "Event data" lorsque *LICLOG est indiqué pour le paramètre "Watch option setting" ont la structure suivante : Allowed values for the "Event data" parameter when *LICLOG is specified for the "Watch option setting" parameter will be the following structure:

OFFSET     TYPE         FIELD
Dec  Hex
  0    0   BINARY(4)    Length of watch information
  4    4   CHAR(4)      LIC Log major code
  8    8   CHAR(4)      LIC Log minor code
 12    C   CHAR(8)      LIC Log id (keyword DMPID on PRTINTDTA)
 20   14   CHAR(8)      LIC Log timestamp
 28   1C   CHAR(8)      TDE number
 36   24   CHAR(16)     Task name
 52   34   CHAR(30)     Server type
 82   52   CHAR(2)      Exception ID
 84   54   CHAR(10)     LIC job name
 94   5E   CHAR(10)     LIC user name
104   68   CHAR(6)      LIC job number
110   6E   CHAR(4)      Reserved
114   72   CHAR(8)      Thread ID
122   7A   CHAR(8)      LIC module compile timestamp
130   82   CHAR(8)      LIC module offset
138   8A   CHAR(8)      LIC module RU name
146   92   CHAR(48)     LIC module name
194   DA   CHAR(128)    LIC module entry point name
322  142   CHAR(1)      LIC log compare against specified
323  143   CHAR(1)      Reserved
324  144   BINARY(4)    Offset to comparison data
328  148   BINARY(4)    Length of comparison data
332  14C   CHAR(10)     LIC log compare against
 *    *    CHAR(*)      LIC log comparison data

Les valeurs autorisées pour le paramètre "Event data" lorsque *PAL est indiqué pour le paramètre "Watch option setting" ont la structure suivante : Allowed values for the "Event data" parameter when *PAL is specified for the "Watch option setting" parameter will be the following structure:

OFFSET     TYPE         FIELD
Dec  Hex
  0    0   BINARY(4)    Length of watch information
  4    4   CHAR(8)      System reference code
 12    C   CHAR(10)     Device name
 22   16   CHAR(4)      Device type
 26   1A   CHAR(4)      Model
 30   1E   CHAR(15)     Serial number
 45   2D   CHAR(10)     Resource name
 55   37   CHAR(8)      Error Log id (keyword ERRLOGID on PRTERRLOG)
 63   3F   CHAR(8)      PAL timestamp
 71   47   CHAR(4)      Reference code
 75   4B   CHAR(8)      Secondary code
 83   53   CHAR(8)      Table identifier
 91   5B   CHAR(1)      Reserved
 92   5C   BINARY(4)    Sequence
 96   60   BINARY(4)    Offset to comparison data
 100  64   BINARY(4)    Length of comparison data
 104  68   CHAR(10)     PAL compare against
 *   *     CHAR(*)      PAL comparison data

Les valeurs autorisées pour le paramètre "Event data" lorsque *STRWCH ou *ENDWCH est indiqué pour le paramètre "Watch option setting" ont la structure suivante : Allowed values for the "Event data" parameter when *STRWCH or *ENDWCH is specified for the "Watch option setting" parameter will be the following structure:

OFFSET     TYPE         FIELD
Dec  Hex
  0    0   BINARY(4)    Length of watch information
(always 4 at this time)

For more information on the watch exit program interface, refer to the Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/)

Qualificatif 1 : Programme de surveillance Qualificatif 1: Watch program

nom

Indiquez le nom du programme d'exit de surveillance. Specify the name of the watch exit program.

Qualificatif 2: Biblio

*LIBL

Toutes les bibliothèques de la liste de bibliothèques du travail sont parcourues jusqu'à la première correspondance. All libraries in the job's library list are searched until the first match is found.

*CURLIB

La bibliothèque en cours du travail est utilisée pour localiser le programme. Si aucune bibliothèque en cours n'est définie pour le travail, la bibliothèque QGPL est utilisée. The current library for the job is used to locate the program. If no library is specified as the current library for the job, the QGPL library is used.

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.

Appel du programme de surveillance (CALLWCHPGM)Call watch program (CALLWCHPGM)

Indique les moments où le programme indiqué dans le paramètre Programme de surveillance (WCHPGM) est appelé. Le programme est toujours appelé lorsque l'événement surveillé se produit. Vous pouvez indiquer des moments supplémentaires où le programme doit être appelé. Specifies the times at which the program specified for the Watch program (WCHPGM) parameter will be called. The program will always be called when the watched for event occurs. You can specify additional times for the program to be called.

Valeurs uniques

*WCHEVT

Le programme de surveillance est appelé lorsque l'événement surveillé se produit. The watch program will be called when the watched for event occurs.

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

*STRWCH

Le programme de surveillance est appelé lorsque l'événement surveillé se produit, ainsi qu'avant le début de la surveillance de tout événement. The watch program will be called when the watched for event occurs and also be called before starting watching for any event.

*ENDWCH

The watch program will be called when the watched for event occurs and also be called when the watch session is ending. Possible reasons might be:

• La commande Terminer surveillance (ENDWCH) ou l'API Terminer surveillance (QSCEWCH) a été émise. End Watch (ENDWCH) command or End Watch (QSCEWCH) API was issued.
• Un ou plusieurs des travaux de surveillance d'événements se sont terminés anormalement ou ont été arrêtés par une action de l'utilisateur. One or more of the watch for event jobs ended abnormally or ended by user action.

Remarque : Une session de surveillance peut se terminer parce qu'une erreur a été détectée dans le programme d'exit de surveillance. Dans ce cas, le programme de surveillance n'est pas appelé au moment de *ENDWCH. Note: A watch session might end because an error was detected on the watch exit program. In this case, the watch program will not be called at *ENDWCH time.

Surveiller un message (WCHMSG)Watch for message (WCHMSG)

Indique jusqu'à cinq messages à surveiller. Si une valeur autre que *NONE est indiquée, vous devez indiquer où surveiller le message dans le paramètre File d'attente de messages surveillée (WCHMSGQ). Lorsque le message surveillé est ajouté à la file d'attente de messages ou à l'historique indiqué, le programme d'exit de surveillance est appelé. Specifies up to five messages which are to be watched. If a value other than *NONE is specified, you must specify where to watch for the message on the Watched message queue (WCHMSGQ) parameter. When the watched for message is added to the specified message queue or log, the watch exit program is called.

Remarque : Les messages déplacés et renvoyés ne seront pas surveillés. Seule l'occurrence d'origine du message peut être surveillée. Note: Moved and resent messages will not be watched. Only the original instance of the message can be watched.

Remarque : La surveillance des ID de message CPF1124 ou CPF1164 sera ignorée dans le travail QSCWCHPS (qui gère le traitement de la surveillance). Un programme d'exit utilisateur ne sera pas déclenché lorsque CPF1124 ou CPF1164 est émis dans le travail QSCWCHPS. Note: Watching for message id CPF1124 or CPF1164 will be ignored in job QSCWCHPS (which handles watch processing). A user exit program will not be triggered when CPF1124 or CPF1164 is issued in job QSCWCHPS.

Valeurs uniques

*NONE

Aucun message ne sera surveillé. No messages will be watched.

Élément 1: Message to watch

*ALL

Tous les messages doivent être surveillés. Cela comprend les messages stockés et les messages immédiats. Sachez que la surveillance de tous les messages peut dégrader les performances de votre système. Utilisez-la avec précaution. All messages are to be watched. This includes stored messages and immediate messages. Be aware that watching for all messages might cause performance degradation on your system. Use it cautiously.

*IMMED

Tous les messages immédiats ou impromptus sont surveillés. Aucun message stocké dans un fichier de messages n'est surveillé. All immediate or impromptu messages will be watched. No messages stored in a message file are watched.

nom-générique

Indiquez l'identificateur de message générique à surveiller. 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 (*) ; par exemple, ABC*. L'astérisque remplace tout caractère valide. Un nom de message générique désigne tous les messages dont l'identificateur commence par le préfixe générique. Specify the generic message identifier to be watched. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic message name specifies all messages with message identifiers that begin with the generic prefix.

nom

Indiquez l'identificateur de message de 7 caractères à surveiller. Specify the 7-character message identifier to be watched.

Élément 2: Donnée de comparaison

Indiquez les données de comparaison à utiliser si un message correspondant au message indiqué est ajouté à la file d'attente de messages ou à l'historique indiqué. Si les données du message, le "programme émetteur" (From program) ou le "programme destinataire" (To program) comprennent le texte indiqué, la condition surveillée est vraie. Si les données du message, le "programme émetteur" ou le "programme destinataire" ne contiennent pas le texte indiqué, la fonction de surveillance se poursuit simplement. Specify comparison data to be used if a message matching the specified message is added to the specified message queue or log. If the message data, the "From program" or the "To program" includes the specified text, the watched for condition is true. If the message data, the "From program" or the "To program" does not contain the specified text, the watch function just continues.

*NONE

Aucune donnée de comparaison n'est indiquée. Si un message correspondant au message indiqué est ajouté à la file d'attente de messages ou au journal indiqué, la condition surveillée est vraie. No comparison data is specified. If a message matching the specified message is added to the specified message queue or log, the watched for condition is true.

valeur-caractère

Indiquez la chaîne de texte utilisée pour la comparaison avec les données du message, le « programme émetteur » ou le « programme destinataire » du message surveillé. Ce texte est sensible à la casse et peut être placé entre guillemets pour indiquer des blancs intégrés ou de fin. Specify the text string used to compare against the message data, the "From program" or the "To program" of the watched for message. This text is case sensitive and can be quoted in order to specify imbedded or trailing blanks.

Élément 3: Compare against

Indiquez la partie du message avec laquelle les données de comparaison indiquées pour l'élément 2 doivent être comparées. Specify which part of the message the comparison data specified for element 2 is to be compared against.

*MSGDATA

Les données de comparaison seront comparées aux données de remplacement du message. The comparison data will be compared against the message replacement data.

*FROMPGM

Les données de comparaison seront comparées au nom du programme qui envoie le message, ou au nom du programme ILE qui contient la procédure qui envoie le message. The comparison data will be compared against the name of the program sending the message, or the name of the ILE program that contains the procedure sending the message.

*TOPGM

Les données de comparaison seront comparées au nom du programme auquel le message a été envoyé, ou au nom du programme ILE qui contient la procédure à laquelle le message a été envoyé. The comparison data will be compared against the name of the program the message was sent to, or the name of the ILE program that contains the procedure the message was sent to.

Élément 4: Type de message

Indiquez le type de message attribué au message à surveiller. Specify the message type assigned to the message to be watched.

*ALL

Tous les types de message doivent être surveillés. Cela comprend les types de message fin, commande, diagnostic, *ESCAPE, information, demande d'information, notification, réponse, demande, copie de l'expéditeur, portée et état. All the message types are to be watched. This includes completion, command, diagnostic, escape, informational, inquiry, notify, reply, request, sender's copy, scope and status message types.

*COMP

Un message de fin doit être surveillé. A completion message is to be watched.

*DIAG

Un message de diagnostic doit être surveillé. A diagnostic message is to be watched.

*ESCAPE

Un message *ESCAPE doit être surveillé. An escape message is to be watched.

*INFO

Un message d'information doit être surveillé. An informational message is to be watched.

*INQ

Un message de demande d'information doit être surveillé. An inquiry message is to be watched.

*NOTIFY

Un message de notification doit être surveillé. A notify message is to be watched.

*SCOPE

Un message de portée doit être surveillé. A scope message is to be watched.

*STATUS

Un message d'état doit être surveillé. A status message is to be watched.

Élément 5: Opérateur relationnel

Indiquez un opérateur relationnel avec lequel le code de gravité du message est comparé. Specify one relational operator against which the message severity code is compared.

*GE

Supérieur ou égal. Greater than or equal.

*EQ

Égal. Equal.

*GT

Supérieur. Greater than.

*LT

Inférieur. Less than.

*LE

Inférieur ou égal. Less than or equal.

Élément 6: Code gravité

Indique le code de gravité du message à surveiller. Specifies the severity code of the message to be watched.

00

Le code de gravité attribué au message surveillé est 00. The severity code assigned to the message to be watched for is 00.

Severity-code

Indiquez une valeur, comprise entre 00 et 99, comme niveau de gravité associé au message à surveiller. Specify a value, ranging from 00 through 99, as the severity level associated with the message to be watched.

File d'attente de messages surveillée (WCHMSGQ)Watched message queue (WCHMSGQ)

Indique où surveiller les messages indiqués dans le paramètre WCHMSG. Vous pouvez demander la surveillance de l'ajout du message dans la file d'attente de messages de l'opérateur système, dans l'historique, dans d'autres files d'attente de messages et dans des historiques de travail. Jusqu'à trois files d'attente de messages ou valeurs spéciales peuvent être indiquées. Specifies where to watch for the messages specified on the WCHMSG parameter. You can specify to watch the message being added to the system operator message queue, the history log, other message queues, and job logs. Up to three message queues or special values can be specified.

Élément 1: File attente messages

Valeurs uniques

*SYSOPR

Surveiller les messages ajoutés à la file d'attente de messages de l'opérateur système (file d'attente de messages QSYSOPR de la bibliothèque QSYS). Watch messages added to the system operator message queue (QSYSOPR message queue in library QSYS).

*JOBLOG

Surveiller les messages ajoutés aux historiques des travaux indiqués dans le paramètre Travail surveillé (WCHJOB). Watch messages added to the job logs of the jobs specified for the Watched job (WCHJOB) parameter.

*HSTLOG

Surveiller les messages ajoutés à l'historique (file d'attente de messages QHST de la bibliothèque QSYS). Watch messages added to the history log (QHST message queue in library QSYS).

Qualificatif 1: File attente messages

nom

Indiquez le nom de la file d'attente de messages à surveiller. Specify the name of the message queue to watch.

Qualificatif 2: Biblio

*LIBL

Toutes les bibliothèques de la liste de bibliothèques de l'unité d'exécution en cours sont recherchées jusqu'à ce que la première occurrence soit trouvée. All libraries in the library list for the current thread are searched until the first match is found.

nom

Indiquez le nom de la bibliothèque dans laquelle se trouve la file d'attente de messages. Specify the name of the library where the message queue is located.

Travail surveillé (WCHJOB)Watched job (WCHJOB)

Indique le travail dont l'historique est surveillé pour les messages indiqués dans le paramètre Surveiller le message (WCHMSG). Le travail indiqué n'est surveillé que si *JOBLOG est indiqué dans le paramètre File d'attente de messages surveillée (WCHMSGQ). Jusqu'à cinq noms de travaux peuvent être indiqués. Specifies the job whose job log is watched for the messages specified on the Watch for message (WCHMSG) parameter. The specified job will only be watched if *JOBLOG is specified on the Watched message queue (WCHMSGQ) parameter. Up to five job names may be specified.

Valeurs uniques

*

Seul l'historique du travail qui a émis cette commande de surveillance est surveillé. Only the job log of the job that issued this watch command is watched.

Élément 1: Travail

Qualificatif 1: Travail

nom-générique

Indiquez le nom générique du travail à surveiller. 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 (*) ; par exemple, ABC*. L'astérisque remplace tout caractère valide. Un nom de travail générique désigne tous les travaux dont le nom commence par le préfixe générique. Specify the generic name of the job to be watched. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic job name specifies all jobs with job names that begin with the generic prefix.

*ALL

Tous les travaux portant le nom d'utilisateur de travail indiqué sont surveillés. *ALL pour le nom de travail est considéré comme une spécification de travail générique car il surveille tous les travaux qui répondent au qualificatif de nom d'utilisateur de travail que vous avez indiqué. All jobs with the specified job user name are watched. *ALL for the job name is considered to be a generic job specification because it will watch all jobs that meet the job user name qualifier that you specified.

nom

Indiquez le nom du travail à surveiller. Specify the name of the job to be watched.

Qualificatif 2: Utilisat

nom-générique

Indiquez le nom générique du nom d'utilisateur du travail à surveiller. 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 (*) ; par exemple, ABC*. L'astérisque remplace tout caractère valide. Un nom d'utilisateur générique désigne tous les travaux portant le nom de travail indiqué et dont le nom d'utilisateur commence par le préfixe générique. Specify the generic name of the user name of the job to be watched. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic user name specifies all jobs with the specified job name and with user names that begin with the generic prefix.

*ALL

Tous les travaux portant le nom de travail indiqué sont surveillés. *ALL pour le nom d'utilisateur de travail est considéré comme une spécification de travail générique car il surveille tous les travaux qui répondent au qualificatif de nom de travail que vous avez indiqué. All jobs with the specified job name are watched. *ALL for the job user name is considered to be a generic job specification because it will watch all jobs that meet the job name qualifier that you specified.

nom

Indiquez le nom d'utilisateur du travail à surveiller. Specify the user name of the job to be watched.

Qualificatif 3: Numéro

*ALL

Tous les travaux portant le nom de travail et le nom d'utilisateur indiqués sont surveillés. *ALL pour le numéro de travail est considéré comme une spécification de travail générique car il surveille tous les travaux qui répondent aux qualificatifs de nom de travail et de nom d'utilisateur de travail que vous avez indiqués. All jobs with the specified job name and user name are watched. *ALL for the job number is considered to be a generic job specification because it will watch all jobs that meet the job name and job user name qualifiers that you specified.

000000-999999

Indiquez le numéro de travail pour qualifier plus précisément le nom de travail et le nom d'utilisateur. Vous ne pouvez pas indiquer de numéro de travail si un qualificatif de nom de travail générique ou de nom d'utilisateur générique est indiqué. Specify the job number to further qualify the job name and user name. You cannot specify a job number if a generic job name or a generic user name qualifier is specified.

Surveiller une entrée du journal LIC (WCHLICLOG)Watch for LIC log entry (WCHLICLOG)

Indique jusqu'à cinq identificateurs d'entrées du journal du code interne sous licence (LIC) à surveiller. Chaque entrée du journal LIC contient un code majeur et un code mineur. La condition surveillée est remplie si une entrée du journal LIC correspondant aux codes majeur et mineur indiqués et à toute donnée de comparaison indiquée est ajoutée. Specifies up to five licensed internal code (LIC) log entry identifiers which are to be watched for. Each LIC log entry contains a major and a minor code. The watched for condition will be met if a LIC log entry is added that matches the specified major and minor codes and any comparison data specified.

Valeurs uniques

*NONE

Aucune entrée du journal LIC ne sera surveillée. No LIC log entries will be watched for.

Élément 1: Major code

*ALL

Tout code majeur d'entrée du journal LIC sera considéré comme une correspondance. Si *ALL est indiqué pour le code majeur, vous ne pouvez pas indiquer *ALL pour le code mineur de l'entrée du journal LIC. Any LIC log entry major code will be considered to be a match. If *ALL is specified for the major code, you cannot specify *ALL for the LIC log entry minor code.

valeur-caractère

Indiquez le code majeur du journal LIC à surveiller. Vous pouvez indiquer soit un chiffre hexadécimal, soit un point d'interrogation pour chaque caractère du code à quatre chiffres. Un point d'interrogation est un caractère générique qui correspond à n'importe quel chiffre à cette position. Jusqu'à trois caractères génériques peuvent être indiqués. Specify the LIC log major code to be watched for. You can specify either a hexadecimal digit or a question mark for each character in the four-digit code. A question mark is a wildcard character that will match any digit in that position. Up to three wildcard characters can be specified.

Élément 2: Minor code

*ALL

Tout code mineur d'entrée du journal LIC sera considéré comme une correspondance. Si *ALL est indiqué pour le code mineur, vous ne pouvez pas indiquer *ALL pour le code majeur de l'entrée du journal LIC. Any LIC log entry minor code will be considered to be a match. If *ALL is specified for the minor code, you cannot specify *ALL for the LIC log entry major code.

valeur-caractère

Indiquez le code mineur du journal LIC à surveiller. Vous pouvez indiquer soit un chiffre hexadécimal, soit un point d'interrogation pour chaque caractère du code à quatre chiffres. Un point d'interrogation est un caractère générique qui correspond à n'importe quel chiffre à cette position. Jusqu'à trois caractères génériques peuvent être indiqués. Specify the LIC log minor code to be watched for. You can specify either a hexadecimal digit or a question mark for each character in the four-digit code. A question mark is a wildcard character that will match any digit in that position. Up to three wildcard characters can be specified.

Élément 3: Donnée de comparaison

Indiquez les données de comparaison à utiliser si une entrée de journal correspondant aux codes majeur et mineur indiqués est ajoutée au journal du code interne sous licence (LIC). Si ce texte est trouvé dans les zones de données de l'entrée de journal surveillée, la condition surveillée est vraie. Specify comparison data to be used if a log entry matching the specified major and minor codes is added to the licensed internal code (LIC) log. If this text is found in the LIC log entry data fields of the watched for log entry, the watched for condition is true.

*NONE

Aucune donnée de comparaison n'est indiquée. Si une entrée du journal LIC correspondant aux codes majeur et mineur indiqués est ajoutée au journal LIC, la condition surveillée est vraie. No comparison data is specified. If a LIC log entry matching the specified major and minor codes is added to the LIC log, the watched for condition is true.

valeur-caractère

Specify the text string used to compare against the entry data of the watched for log entry. If this text is found in the LIC log entry data field specified for element 4, the watch condition is considered to be true. This text is case sensitive. If *ALL is specified in the LIC log compare against field, the LIC log fields which will be compared are TDE number, task name, server type, job name, user ID, job number, thread ID, exception ID, LIC module compile timestamp, LIC module offset, LIC module RU name, LIC module name, LIC module entry point name. The comparison data cannot be used to match across two fields, and can match an entire field or a substring of any field.

Lors de la surveillance d'un ID d'exception, les quatre chiffres hexadécimaux de l'ID d'exception doivent être indiqués. Le préfixe MCH peut également être indiqué si vous souhaitez comparer uniquement avec la zone d'ID d'exception et éviter d'éventuelles correspondances de sous-chaîne avec les autres zones. When watching for an exception ID, all four hexadecimal digits of the exception ID must be specified. Also, the prefix MCH may be specified if you want to compare only against the exception ID field and avoid possible substring matches with the other fields.

Élément 4: Compare against

Indiquez la partie du journal LIC avec laquelle les données de comparaison indiquées pour l'élément 3 doivent être comparées. Specify which part of the LIC log the comparison data specified for element 3 is to be compared against.

*ALL

Les données de comparaison du journal LIC seront comparées à toutes les zones décrites ci-dessous. The LIC log comparison data will be compared against all the fields described below.

*TDENBR

Les données de comparaison du journal LIC seront comparées au numéro de l'élément de répartition de tâche (TDE) qui a demandé l'entrée du journal LIC. The LIC log comparison data will be compared against the number of the task dispatching element (TDE) which requested the LIC log entry.

*TASKNAME

Les données de comparaison du journal LIC seront comparées au nom de la tâche qui a demandé l'entrée du journal LIC. Le nom de tâche est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par une tâche. The LIC log comparison data will be compared against the name of the task which requested the LIC log entry. Task name is blank (hex 40s) if the LIC log entry is not requested by a task.

*SVRTYPE

Les données de comparaison du journal LIC seront comparées au type de serveur qui a demandé l'entrée du journal LIC. Le type de serveur est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par un serveur. The LIC log comparison data will be compared against the type of server that requested the LIC log entry. Server type is blank (hex 40s) if the LIC log entry is not requested by a server.

*JOBNAME

Les données de comparaison du journal LIC seront comparées au nom du travail qui a demandé l'entrée du journal LIC. Le nom de travail LIC est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par un travail. The LIC log comparison data will be compared against the name of the job which requested the LIC log entry. LIC job name is blank (hex 40s) if the LIC log entry is not requested by a job.

*JOBUSR

Les données de comparaison du journal LIC seront comparées au nom d'utilisateur du travail qui a demandé l'entrée du journal LIC. Le nom d'utilisateur LIC est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par un travail. The LIC log comparison data will be compared against the user name of the job which requested the LIC log entry. LIC user name is blank (hex 40s) if the LIC log entry is not requested by a job.

*JOBNBR

Les données de comparaison du journal LIC seront comparées au numéro de travail (000000-999999) qui qualifie plus précisément le nom de travail et le nom d'utilisateur du travail qui a demandé l'entrée du journal LIC. Le numéro de travail LIC est à blanc (hex 40) si l'entrée du journal LIC n'est pas demandée par un travail. The LIC log comparison data will be compared against the job number (000000-999999) to further qualify the job name and user name of the job which requested the LIC log entry. LIC job number is blank (hex 40s) if the LIC log entry is not requested by a job.

*THDID

Les données de comparaison du journal LIC seront comparées à l'unité d'exécution qui a demandé l'entrée du journal LIC. L'identificateur d'unité d'exécution est à zéros binaires si l'entrée du journal LIC n'est pas demandée par une unité d'exécution. The LIC log comparison data will be compared against the thread which requested the LIC log entry. Thread identifier is binary zeros if the LIC log entry is not requested by a thread.

*EXCPID

Les données de comparaison du journal LIC seront comparées à l'exception qui a provoqué la demande de l'entrée du journal LIC. Il s'agit d'une zone hexadécimale de 2 octets formée en concaténant, au numéro de groupe d'exceptions de 1 octet de poids fort, un numéro de sous-type d'exception de 1 octet de poids faible. L'identificateur d'exception est à zéros binaires si l'entrée du journal LIC n'est pas demandée à la suite d'une exception. The LIC log comparison data will be compared against the exception that caused the LIC log entry to be requested. This is a 2-byte hexadecimal field formed by concatenating to the high-order 1-byte exception group number a low-order 1-byte exception subtype number. Exception identifier is binary zeros if the LIC log entry is not requested as a result of an exception.

*MODNAME

Les données de comparaison du journal LIC seront comparées au nom du module LIC qui a demandé l'entrée du journal LIC. Si le nom du module dépasse 64 caractères, le nom du module LIC est tronqué à 64 caractères. The LIC log comparison data will be compared against the LIC module name which requested the LIC log entry. If the module name is greater than 64 characters, the LIC module name is truncated to 64 characters.

*MODRUNAME

Les données de comparaison du journal LIC seront comparées au nom de l'unité de remplacement du module LIC. Le nom de l'unité de remplacement du module LIC est toujours en EBCDIC majuscules. The LIC log comparison data will be compared against the LIC module replacement unit name. LIC module RU name is always in upper case EBCDIC.

*MODEPNAME

Les données de comparaison du journal LIC seront comparées au nom du point d'entrée qui a demandé l'entrée du journal LIC. Si le nom du point d'entrée dépasse 128 caractères, le nom du point d'entrée du module LIC est tronqué à 128 caractères. The LIC log comparison data will be compared against the name of the entry point which requested the LIC log entry. If the entry point name is greater than 128 characters, the LIC module entry point name is truncated to 128 characters.

*MODOFFSET

Les données de comparaison du journal LIC seront comparées au déplacement en octets dans le texte du module LIC qui a demandé l'entrée du journal LIC. The LIC log comparison data will be compared against the byte offset into the LIC module text which requested the LIC log entry.

*MODTSP

Les données de comparaison du journal LIC seront comparées à l'horodatage de compilation du module LIC. Le format de cette zone est le format d'horodatage du système. The LIC log comparison data will be compared against the timestamp of when the LIC module was compiled. The format for this field is the system time-stamp format.

Surveiller une entrée PAL (WCHPAL)Watch for PAL entry (WCHPAL)

Indique jusqu'à cinq entrées du journal d'activité des produits (PAL) à surveiller. Lorsque l'entrée PAL surveillée se produit, le programme d'exit de surveillance est appelé. Specifies up to five Product Activity Log (PAL) entries which are to be watched for. When the watched for PAL occurs, the watch exit program is called.

Valeurs uniques

*NONE

Aucune entrée PAL ne sera surveillée. No PAL entries will be watched for.

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

Élément 1: Code SRC

*ALL

Tout code de référence système sera considéré comme une correspondance. Any system reference code will be considered to be a match.

valeur-caractère

Indiquez le code de référence système (SRC) à surveiller. Vous pouvez indiquer soit un chiffre hexadécimal, soit un point d'interrogation pour chaque caractère du code à huit chiffres. Un point d'interrogation est un caractère générique qui correspond à n'importe quel chiffre à cette position. Jusqu'à sept caractères génériques peuvent être indiqués. Vous pouvez également indiquer un SRC générique, c'est-à-dire une chaîne de caractères composée d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, ABC*. L'astérisque remplace tout caractère valide. Un SRC générique désigne toutes les entrées PAL dont le code de référence système commence par le préfixe générique. Specify the system reference code (SRC) to be watched for. You can specify either a hexadecimal digit or a question mark for each character in the eight-digit code. A question mark is a wildcard character that will match any digit in that position. Up to seven wildcard characters can be specified. You can also specify a generic SRC that is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic SRC specifies all PAL entries with system reference codes that begin with the generic prefix.

Élément 2: Donnée de comparaison

Indiquez les données de comparaison à utiliser si une entrée PAL correspondant au code de référence système indiqué se produit. Si la zone indiquée à l'élément 3 correspond au texte indiqué, la condition surveillée est vraie. Si la zone indiquée à l'élément 3 ne correspond pas au texte indiqué, la fonction de surveillance se poursuit simplement. Specify comparison data to be used if a PAL entry matching the specified system reference code occurs. If the field specified in element 3 matches the specified text, the watched for condition is true. If the field specified in element 3 does not match the specified text, the watch function just continues.

*NONE

Aucune donnée de comparaison n'est indiquée. Si une entrée PAL correspondant au code de référence système indiqué se produit, la condition surveillée est vraie. No comparison data is specified. If a PAL entry matching the specified system reference code occurs, the watched for condition is true.

valeur-caractère

Specify the text string used to compare against the field specified in element 3 of the watched for PAL entry. This text is case sensitive.

Vous pouvez indiquer les caractères génériques point d'interrogation (?) et astérisque (*) dans la chaîne de texte. Un point d'interrogation est un caractère générique d'un seul caractère et correspond à n'importe quel caractère à la même position. Par exemple, '??123' correspond à toute valeur de cinq caractères se terminant par '123'. Plusieurs caractères génériques point d'interrogation peuvent être indiqués pour la valeur des données de comparaison. You can specify question mark (?) and asterisk (*) wildcard characters in the text string. A question mark is a single-character wildcard and will match any character in the same position. For example, '??123' will match any value that is five characters long and ends with '123'. Multiple question mark wildcard characters can be specified for the comparison data value.

Un astérisque est un caractère générique de plusieurs caractères. Vous pouvez indiquer un seul caractère générique astérisque à la fin de la valeur des données de comparaison. Par exemple, 'ABC*' correspond à toute valeur commençant par les lettres 'ABC'. An asterisk is a multiple-character wildcard character. You can specify a single asterisk wildcard character at the end of the comparison data value. For example, 'ABC*' will match any value that begins with the letters 'ABC'.

Élément 3: Compare against

Indiquez la partie de l'entrée PAL avec laquelle les données de comparaison indiquées pour l'élément 2 doivent être comparées. Specify which part of the PAL entry the comparison data specified for element 2 is to be compared against.

*RSCNAME

Les données de comparaison seront comparées au nom de l'unité physique dont l'entrée figure dans le journal. Un nom de ressource est d'abord attribué par le système, mais il a pu être remplacé par une nouvelle valeur par un utilisateur. The comparison data will be compared against the name of the physical device that has the entry in the log. A resource name is assigned at first by the system, but may have been changed to a new value by a user.

*RSCTYPE

Les données de comparaison seront comparées au numéro ou au mot servant à identifier un produit. The comparison data will be compared against the number or word used to identify a product.

*RSCMODEL

Les données de comparaison seront comparées aux numéros ou aux lettres servant à identifier le niveau de fonction d'un produit d'un type donné. The comparison data will be compared against the numbers or letters used to identify the feature level of a product with a given type.

Priorité d'exécution (RUNPTY)

Indique la priorité du travail dans lequel le travail de la session de surveillance sera exécuté. Specifies the priority of the job where the watch session work will be run.

25

Une priorité de travail de 25 sera utilisée. A job priority of 25 will be used.

1-99

Indiquez la priorité d'exécution du travail. Pour plus d'informations sur la priorité d'exécution d'un travail, voir Ensemble de rubriques Gestion des travaux de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ Specify the run priority of the job. For more information on job run priority, refer to the Ensemble de rubriques Gestion des travaux de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/

Exemples

Exemple 1 : Démarrer la surveillance d'un identificateur de message générique dans votre travail en indiquant une gravité de message Example 1: Start a Watch for a Generic Message Identifier on Your Job and Specifying a Message Severity

STRWCH   SSNID(OWN_JOB) WCHPGM(MYLIB/MYPGM)
         WCHMSG((CPF00* *NONE *MSGDTA *ALL *GE 50)) WCHMSGQ((*JOBLOG))

Cette commande démarre la session de surveillance nommée "OWN_JOB" pour surveiller tout message commençant par CPF00 survenant dans le travail qui a appelé la commande STRWCH et dont le code de gravité est supérieur ou égal à 50. Lorsqu'un message CPF00* est envoyé à l'historique du travail en cours, le programme MYPGM de la bibliothèque MYLIB est appelé pour signaler l'événement. This command starts the watch session named "OWN_JOB" to start watching for any message starting with CPF00 to occur on the job that called the STRWCH command and whose severity code is greater than or equal to 50. When a CPF00* message is sent to the current job log, MYPGM program in MYLIB library will be called to be notified of the event.

Exemple 2 : Démarrer la surveillance d'un message en indiquant une priorité d'exécution Example 2: Start a Watch for a Message Specifying a Run Priority

STRWCH   SSNID(*GEN) WCHPGM(MYLIB/EXTPGM)
         WCHMSG((CPF1804))
         WCHMSGQ((*SYSOPR) (*JOBLOG))
         WCHJOB((*ALL/MYUSER/MYJOBNAME))
         RUNPTY(10)

Cette commande démarre une session de surveillance pour appeler le programme d'exit utilisateur MYLIB/EXTPGM lorsque le message CPF1804 est trouvé dans la file d'attente de messages de l'opérateur système ou dans l'historique du travail *ALL/MYUSER/MYJOBNAME. Un identificateur de session de surveillance unique est généré. L'identificateur de session est renvoyé dans les données du message de fin CPC3901 envoyé après le démarrage réussi de la session de surveillance. Le travail dans lequel le programme d'exit utilisateur est appelé s'exécute avec une priorité d'exécution de 10. This command starts a watch session to call MYLIB/EXTPGM user exit program when CPF1804 message is found on the System Operator message queue or within the *ALL/MYUSER/MYJOBNAME job log. A unique watch session identifier will be generated. The session identifier will be returned in the message data of CPC3901 completion message sent after the watch session starts successfully. The job where the user exit program will be called will run with a run priority of 10.

Exemple 3 : Démarrer la surveillance d'un message immédiat en indiquant des données de comparaison Example 3: Start a Watch for an Immediate Message Specifying Comparison Data

STRWCH   SSNID(FRMPGM) WCHPGM(MYLIB/EXTPGM)
         WCHMSG((*IMMED QSCSWCH *FROMPGM))
         WCHMSGQ((*HSTLOG))

Cette commande démarre une session de surveillance pour appeler le programme d'exit utilisateur MYLIB/EXTPGM lorsqu'un message immédiat (ou impromptu) est envoyé à la file d'attente de messages QHST de la bibliothèque QSYS par le programme QSCSWCH. This command starts a watch session to call MYLIB/EXTPGM user exit program when an immediate (or impromptu) message is sent to message queue QHST in library QSYS by QSCSWCH program.

Exemple 4 : Démarrer la surveillance de plusieurs types de messages dans mes historiques de travaux Example 4: Start a Watch for Several Messages Types in my Job Logs

STRWCH   SSNID(ERRMSG) WCHPGM(MYLIB/EXTPGM)
         WCHMSG((*ALL *NONE *MSGDTA *DIAG *GT 50)
                (*ALL *NONE *MSGDTA *STATUS *GT 50)
                (*ALL *NONE *MSGDTA *ESCAPE *GT 50))
         WCHMSGQ((*JOBLOG))
         WCHJOB((*ALL/MYUSER/*ALL))

Cette commande démarre une session de surveillance pour appeler le programme d'exit utilisateur MYLIB/EXTPGM lorsqu'un message de diagnostic, d'état ou *ESCAPE dont le code de gravité est supérieur à 50 est envoyé à l'historique d'un travail s'exécutant sous le profil utilisateur MYUSER. This command starts a watch session to call MYLIB/EXTPGM user exit program when any diagnostic, status or escape message with a severity code greater than 50 is sent to a job log running under MYUSER user profile.

Exemple 5 : Démarrer la surveillance d'une entrée du journal LIC Example 5: Start a Watch for a LIC Log Entry

STRWCH   SSNID(LICLOGSSN) WCHPGM(*LIBL/EXTPGM)
         WCHLICLOG(('99??' 9932 MYJOBNAME))

Cette commande démarre LICLOGSSN pour surveiller une entrée du journal du code interne sous licence (LIC) dont le code majeur commence par 99 et le code mineur est 9932, générée sur le système. De plus, les informations du journal LIC doivent contenir le texte "MYJOBNAME". La première correspondance du programme EXTPGM trouvée dans la liste de bibliothèques est appelée pour signaler que l'événement s'est produit. This command starts LICLOGSSN to watch for a Licensed Internal Code (LIC) log entry that has a major code starting with 99 and a minor code of 9932 generated on the system. Also, the LIC log information should contain the text "MYJOBNAME". The first match of EXTPGM program found in the library list will be called notifying that the event occurred.

Exemple 6 : Démarrer la surveillance d'une entrée PAL et appeler le programme d'exit au début et à la fin Example 6: Start a Watch for a PAL Entry and Call Exit Program at Start and End Times

STRWCH   SSNID(PALSSN)
         WCHPGM(USRLIB/USRPGM)
         CALLWCHPGM(*STRWCH *ENDWCH)
         WCHPAL((B600512? MYRSC *RSCNAME))

Cette commande démarre PALSSN pour surveiller une entrée du journal d'activité des produits (PAL) dont le code de référence système commence par B600512, générée sur le système. De plus, le nom de ressource PAL contient le texte "MYRSC". Le programme USRLIB/USRPGM est appelé pour signaler que l'événement s'est produit, mais il est également appelé avant le début de la surveillance de tout événement et à la fin de la session de surveillance. This command starts PALSSN to watch for a Product Activity Log (PAL) entry that has a system reference code starting with B600512 generated on the system. Also, the PAL resource name contains the text "MYRSC". The program USRLIB/USRPGM will be called notifying that the event occurred, but it will also be called before starting watching for any event and when the watch session is ending.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF0006

Erreurs trouvées dans la commande.

CPF2401

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

CPF2403

File d'attente de messages &1 non trouvée dans &2.

CPF2408

Non autorisé à la file d'attente de messages &1.

CPF39E3

L'ID de session &1 existe déjà. Session ID &1 already exists.

CPF39E4

Indiquez un message, une entrée du journal LIC ou une entrée PAL à surveiller. Specify Watch for message, LIC log entry or PAL entry.

CPF39E5

Aucun travail actif trouvé, la session de surveillance n'a pas été démarrée. No active jobs found, watch session not started.

CPF39E6

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

CPF39E7

Identificateur de session non valide. Invalid session identifier.

CPF39E8

Droits insuffisants pour surveiller les opérations. Not enough authority to watch operations.

CPF39E9

Le droit spécial *JOBCTL est obligatoire. *JOBCTL special authority required.

CPF3958

Vous n'avez pas le droit d'utiliser le programme &1 de la bibliothèque &2. Not authorized to use program &1 in library &2.

CPF39D0

La fonction de surveillance d'événements ne peut pas démarrer. Code motif &1. Watch for event function cannot start. Reason code &1.

CPF39D1

Limite dépassée pour les travaux de surveillance d'événements. Limit exceeded for jobs watching for events.

CPF3C20

Erreur détectée par le programme &1. Error found by program &1.

CPF9811

Programme &1 non trouvé dans la bibliothèque &2.