With the Display Watch panel, you can list
the details of the active watch sessions. The information displayed includes
the messages, the Licensed Internal Code log entries, and the Product Activity
Log (PAL) entries that are watched.
To view the details of the watch sessions, follow these steps:
- At the command line, type WRKWCH and press
F4 (Prompt). The Work with Watches display is shown.
- Type option 5 (Display) and press Enter. The details of the watch
sessions are displayed.
Note: By default, the first
display shows the message details information. If no messages are watched
for, then the first display shows the Licensed Internal Code log details.
If neither messages nor Licensed Internal Code logs are watched for, then
the first display shows the PAL details.
- Session ID: Shows the session identifier for
the watch. This identifier is unique across all active watches on the system.
- Started by: Shows the name, user name, and
the job number of the job that started the watch session.
- Watch program: Shows the exit
program that is called to notify you that a specified watch event occurred
and the name of the library where the exit program is located.
- Origin: Shows the name of the command or API
that started the watch.
- Run priority: Shows the priority for the job
where the watch session work is run.
- Started: Shows the date and time when the watch
session was started.
- Length of time to watch: Shows the time limit
(in minutes) for watching for a message, a Licensed Internal Code log entry,
or a PAL entry. This information is only available on watch sessions that
are started by trace commands. When the specified amount of time elapses,
the watch exit program is called (if one was specified on Watch Exit Program
parameter), the watch is ended, and message CPI3999 is sent to the history
log.
- Time interval: Shows the interval of time (in
seconds) of how often the trace exit program is called. This information is
only available on watch sessions that are started by trace commands.
- Call exit program: Shows the times at which
the watch program is called. This program is always called when the watched-for
event occurs. The watch program is also called when the watch session is ending.
Note: If
a watch session is started by the Start Watch (STRWCH) command or Start Watch
(QSCSWCH) API, the Length of time to watch and Time
interval parameters are not shown. Instead, the Call
exit program parameter is shown.
The following tables list some additional information that is displayed
during watch sessions:
Table 1. Other information when watching for messages
Parameters |
Description |
Message ID |
The message identifier to be watched for. |
Watched message queue |
Identifies where to watch for the message identifiers
specified on the Watch for message parameter. |
Library |
The name of the library where the message queue
is located. |
Job name |
The name of the job being watched. |
User |
The user name of the job being watched. |
Job number |
The job number to further qualify the job name
and user name. |
Compare against |
Specifies which part of the message that the
comparison data is to be compared against. |
Comparison data |
Specifies that comparison data that is used
if a message matching the specified message ID is added to the specified message
queue or log. |
Table 2. Other information when watching for Licensed Internal
Code log entries
Parameters |
Description |
Major code |
Licensed Internal Code log major code being
watched for. |
Minor code |
Licensed Internal Code log minor code being
watched for. |
Compare against |
The part of the Licensed Internal Code log
that the data specified in the Licensed Internal Code log comparison data
field is to be compared against. |
Comparison data |
Specifies the comparison data used if a log
entry matching the specified major and minor codes is added to the licensed
internal code log. If this text is found in the licensed internal code log
entry data field that is specified as compare against, the watched for condition
is true. This text is case sensitive. |
Table 3. Other information when watching for Product Activity
Log (PAL) entries
Parameters |
Description |
SRC (system reference code) |
The system reference code that identifies the
Product Activity Log (PAL) entry being watched for. |
Compare against |
The part of the PAL that the data specified
for comparison data is to be compared against. |
Comparison data
|
The comparison data to be used if a PAL entry
that matches the specified system reference code was added. |
Table 4. Function keys that can be used on the Display Watch
panel
Function keys |
Description |
F11 (Message queue and job)
|
Displays the message queue and job log information. |
F13 (Message details) |
Displays information about the messages being
watched for.
|
F14 (LIC log details) |
Displays information about the licensed internal
code logs being watched for. |
F15 (PAL details) |
Displays information about the PALs being watched
for. |
F22 (Display entire field ) |
Shows the full comparison data field. |