Monitoring Measurement Requests
To monitor the status of your Strobe measurement requests:
- Select Option 3 (STATUS) from the Strobe Options menu.
- Press Enter to display the Strobe - Status panel.
- Press Enter to refresh the list. Strobe updates all the information given for each request, allowing you to monitor the sample counts for your active requests and any change in the status of a request. Scrolling to the right provides you with additional information about the measurement request, as shown in Strobe - Status Panel (Scrolled Right Once).
The Strobe - Status panel shows the status of each measurement request as follows:
Status | Meaning |
---|---|
Active | Strobe is currently placing samples in the sample data set. |
Suspended | Strobe is not sampling.
|
Queued | The target program has not yet begun executing. |
Completed | The request has been terminated and all sample data sets have been closed. |
AutoStrobe only: | |
Completed exceeding thresholds | The AutoStrobe measurement request is completed and has exceeded one or more of the specified threshold criteria. |
Deferred | The AutoStrobe measurement request has been delayed for a later time, either because it is a scheduled request or a related request in a concurrent set that is waiting to be initiated by the trigger request. |
The displayed list is limited to the requests on a specific system that belong to the owner IDs specified in the OWNERID MASK field at the top of the panel. For more information, see Listing by Owner ID.
You can modify any measurement request that appears on the Strobe- Status panel and filter the requests by system or by owner ID. AutoStrobe users can also categorize completed requests that have exceeded one or more specific thresholds. The following table directs you to the sections that describe how to monitor and manage measurement requests.
To | See section |
---|---|
Find descriptions of the panel columns | |
Select a system | |
Set the owner ID mask | |
AutoStrobe only: | |
Set AutoStrobe thresholds | |
View requests | |
Change requests | |
Terminate requests | |
Delete requests | |
Produce Performance Profiles | |
Change automatic Performance Profile requests |
Strobe - Status Panel
Strobe - Status Panel (Scrolled Right Once)
Strobe - Status Panel (Scrolled Right Twice)
The Strobe- Status panel displays the following information for each measurement request.
All requests: | |
REQ | The request number. |
OWNERID | The user ID or job name that initiated the request. |
SYSTEM | The system on which the measurement session was initiated. This column is displayed only in a multisystem environment. |
JOBNAME | The job name of the target measurement. |
PROGRAM | The name of the target program. |
STEPNAME/ | The name or number of the target step (an asterisk (*) indicates the current step). |
TARGET | The target sample size. |
Active, suspended, and competed requests: | |
TOTAL | The total number of samples taken. |
EXEC | The number of times Strobe observed the task executing |
Queued requests: | |
DURATION | The estimated duration of the measurement session, in minutes, as specified in the SESSION DURATION field of the Strobe - Add Queued Request panel. |
RESP | The final session action to be taken when the target sample size is reached (STOP, QUIT, or CONT). |
AutoStrobe only: AutoStrobe group deferred requests: | |
DUR | The estimated duration of the measurement session, in minutes, as specified in the SESSION DURATION field of the Strobe - Add Queued Request or Strobe - Add Active Request panel. |
REASON | The type of deferred AutoStrobe measurement request. If the request is a scheduled request, then SCHEDULE appears in this field. In this case you will only see one deferred request, regardless of how many days or times the request is scheduled. Once a scheduled measurement session is initiated, the next scheduled measurement session for this request appears in the deferred category. If the request is a related request in a concurrent set, then the concurrent set name appears in this field. If the concurrent set is also scheduled, then SCHEDULE appears in this field. |
Scroll to the right once to view the following information:
PROFILE | If an automatic Profile request is associated with this measurement request, one of the following values appears:
Otherwise, the column is blank. |
AutoStrobe only: AUTO REAS | If the measurement request was generated through AutoStrobe candidate monitoring, this column shows what category of data caused the measurement to start. (I/O, TCB, or ELAPSED) |
AutoStrobe only: For all AutoStrobe group and trigger-related requests, scroll to the right twice to view the following information:
CONCURRENT | The concurrent set name, if any, for the AutoStrobe measurement request. If the request is the trigger request for the concurrent set, T appears to the right of the concurrent set name. Scroll to the right to view this column. |
GROUP N(AME) | This column, which indicates the group name if the AutoStrobe measurement request is part of a group, only shows partially after two right scrolls. To obtain the full group name, scroll once more to the right. |
Viewing Measurement Requests
You can view the parameters of a measurement request as well as listing them by system and owner ID.
Listing by System
To view the status of measurement requests on a particular system, type the system name in the SYSTEM field.
To view a list of all active systems in the sysplex:
- Clear the SYSTEM field.
- Press Enter to display the Strobe - System Selection List panel. On this panel, Strobe lists the active systems in the sysplex on the bottom half of the screen.
- To select one or more of these systems, type S to the left of the system name.
- To exclude one or more systems, type E to the left of the system name.
Strobe - System Selection List Panel
Listing by Owner ID
To control your view of requests on the Strobe - Status panel and the sample data sets that appear on the Strobe - Sample Data Set List panel, you can specify an owner identification in the OWNERID MASK field. You have the following options:
- To view requests for another TSO user, type the user ID or the job name of a batch job that submitted the measurement request. The default is your TSO user ID.
- To view requests submitted either by a group of TSO users whose user IDs begin with the same characters or through batch jobs whose job names begin with a common prefix, type those characters followed by the wildcard character ( *). If you type SA*, for example, Strobe displays all requests submitted by users whose TSO user IDs begin with SA and all requests submitted by batch jobs whose job names begin with SA.
To view all requests, type * (asterisk) in this field or clear the field. When you clear the field, Strobe resets it to your TSO user ID the next time you invoke Strobe.
Setting AutoStrobe Measurement Thresholds
If you have AutoStrobe installed at your site, you can categorize the measurement requests on the Strobe - Status panel by listing those requests that have exceeded specific measurement thresholds.
To set thresholds for measurement requests, complete the following steps:
- Select Option 3 (STATUS) from the Strobe Options menu.
- Press Enter to display the Strobe - Status panel.
- Type Y in the CHANGE THRESHOLDS field.
- Press Enter to display the Strobe - Threshold Definitions panel.
- Type the baseline value in any of the threshold fields in the top half of the panel. For example, if you specify two minutes and thirty seconds as a CPU Time threshold,, measurement requests with a CPU time greater than or equal to two minutes and 30 seconds will appear in the Completed Measurement Requests Exceeding Thresholds category on the Strobe - Status panel.
- Type the names of programs that you do not want the threshold to apply to in the PROGRAM field. Measurements of steps that execute this program will never be displayed in the Completed Measurement Requests Exceeding Thresholds category.
- Type the names of jobs that you do not want the threshold to apply to in the JOBNAME field.
- Press Enter to return to the Strobe - Status panel.
Viewing the Parameters of a Measurement Request
To view the measurement parameters that have been supplied for a request:
- Type V to the left of the request.
- Press Enter to display a view panel.
- Press the Up or Down function keys to view all the data. The panel displays the options selected for the request.
The first line of the view panel identifies the request number and the status of the request. The remainder of the view panel is divided into sections that display information about each type of measurement request field. The DATA COLLECTORS, MODULE MAPPING DATA, SESSION MANAGEMENT, and REQUEST RETENTION sections are described further in the section Additional Measurement Options.
HEADER INFORMATION Fields
JOBNAME | The name of the job. |
PROGRAM | The name of the measured program. |
STEP | The name of the step. |
SYSTEM | The MVS system name you identified as a target for the measurement request. If you entered a list of systems, or specified all systems as potential targets for the requests, the value *LIST or *ALL appears in this field. |
SESSION DURATION | Time in minutes of session duration. |
TARGET SAMPLE SIZE | The number of samples to collect. |
NOTIFY TSO USER ID | The specified user ID to which Strobe sends a notify message. |
CREATED | Time and date that the request was created; the formats depend on the date and time formats specified in the Strobe parameter data set. |
AutoStrobe only: The following fields apply only to AutoStrobe measurement requests and appear only if the request is an element in a request group.
CONCURRENT NAME | The name of the concurrent set with which this AutoStrobe request is associated. |
TRIGGER | Whether this AutoStrobe measurement request has been designated as the trigger for the concurrent set. |
GROUP | The name of the AutoStrobe measurement request group of which this request is a request group element. |
View Panel for Measurement Request
SYSTEMS REQUESTED Fields
These fields appear only if you are viewing measurement requests in a multisystem environment. The SYSTEMS REQUESTED field lists the systems you identified as potential targets for the measurement request. Systems that you excluded as potential targets for the measurement request appear next to the EXCLUDED field.
CONCURRENT REQUESTS IN CONCURRENT SET NAME Fields (AutoStrobe only)
These fields appear only if you have assigned an AutoStrobe request to be part of a concurrent set and designated it as the trigger request. The CONCURRENT REQUESTS IN CONCURRENT SET NAME fields list the name of the concurrent set to which the request belongs and the request numbers of the other related requests in the concurrent set.
MULTIPLE STEPNAMES Fields (AutoStrobe only)
This part of the view panel appears only if you are an AutoStrobe user and specified multiple steps of the job to be measured.
The MULTIPLE STEPNAMES field is a list of the step numbers, step names, or program names that will be measured as part of this request.
When you submit a single measurement request to measure multiple steps of a job, Strobe creates one measurement session to act as a template request for each job step you specified. As each job step becomes active, Strobe copies the template request and adds an active request (with the same options) for the specified job step.
The template request is never used for an actual measurement session. When all of the job steps have been measured, the template request is marked complete. This field also displays the number of the template request.
SAMPLE DSNAME Fields
This part of the view panel appears only if your system does not use System Managed Storage:
PREFIX | The high-level qualifiers for the sample data set name |
UNIT NAME | The specified unit on which the data set is or will be allocated |
VOLUME | The volume on which the data set is or will be allocated |
DISP | The specified data set disposition |
SAMPLE DATA SET SMS PARAMETERS Fields
This part of the view panel appears only if your system uses System Managed Storage:
MGMTCLAS | The Management Class of the data set |
DATACLAS | The Data Class of the data set |
STORCLAS | The Storage Class of the data set |
SAMPLE DATA SET NAME Fields
This section of the view panel appears only when you examine completed, active, or suspended requests:
NAME | The name of the data set |
UNIT NAME | The unit name of the allocated data set |
VOLUME | The volume on which the data set is allocated |
DISP | The data set disposition |
CPU TIME | The amount of time during the measurement session that one or more CPUs were executing tasks in the measured job step, exclusive of Strobe itself, expressed in minutes and seconds to the nearest hundredth |
WAIT TIME | The portion of run time during which no task within the measured address space was able to make use of the CPU time available to it |
SESSION TIME | The actual duration of the measurement session, expressed in minutes and seconds to the nearest hundredth |
STRETCH TIME | The estimated amount of time that the CPU was unavailable to process programs executing in the measured address space because of demands made by higher-priority address spaces and by service request block (SRB) processing time for all address spaces |
EXEC% | The percentage of time during which the central processing subsystem (comprising one or more CPUs) was in use by application tasks executing within the measured job step |
WAIT% | The percentage of time during which the central processing subsystem was available but was not in use by application tasks executing within the measured job step |
EXCPS | The number of EXCP requests (direct invocations of execute channel programs, representing I/O) issued from the measured address space during the measurement session |
SAMPLES | The total number of samples collected during the measurement session |
THRESHOLD Fields (AutoStrobe only)
These fields appear only if you have assigned one or more thresholds on the Strobe - Threshold Definition panel:
THRESHOLDS EXCEEDED | The thresholds that were exceeded for this measurement session |
THRESHOLDS | The threshold criteria specified on the Strobe - Threshold Definition panel |
DATA COLLECTORS Fields
DATA COLLECTORS | The data collectors supplied with Strobe that you specified |
QUEUED TRANSACTIONS | The queued transaction you specified |
CICS OPTIONS | The CICS options that you specified |
TERMINAL ID DATA | The CICS terminals for which you requested detailed performance information |
CAPTURE OPTIONS | The capture options that you specified |
DB2 FILTER DATA | The DB2 Trace Filter options that you specified, where: |
COLLECTDB2PREDDATA | The collection of DB2 dynamic SQL data you specified |
DDF OPTIONS | The DDF Requester, up to two of which are either Primary or Secondary:
|
MQ COMMON USER MODULE | The name of the common WebSphere MQ user module that you specified |
OTHER DATA COLLECTORS | Program names of data collectors that you specified in the OTHER DATA COLLECTORS field or specified with the Strobe Command Language |
MODULE MAPPING DATA Fields
LIBRARIES TO SEARCH | Specified search libraries |
DETAIL BASELINE | The specified minimum percentage of execution samples required |
BASELINE OVERRIDE | Named modules that are mapped regardless of the percentage of execution samples |
SVC NUMBERS | SVC modules that you specified for more detailed reporting |
SESSION MANAGEMENT Fields
NUMBER OF SESSIONS | Specified search libraries | |
FINAL SESSION ACTION | The specified action that Strobe will take after it reaches its target number of samples | |
Quit | Stop sampling and terminate the measurement request | |
Stop | Stop sampling, end the measurement session, and terminate the measurement request (default for an active request) | |
Continue | Take no action when the target sample size is reached (default for a queued request) |
REQUEST RETENTION Fields
The following fields appear only if you have specified a retention period for the measurement request. For information on specifying a request retention period, see Retaining Measurement Requests.
QUEUED REQUEST RETENTION | Appears for queued requests only; the date on which the system will remove the request. The date format depends on the date format specified in the Strobe parameter data set. |
COMPLETED REQUEST RETENTION | For completed requests, the number of days the system will retain the request after it completes |
REQUEST SCHEDULE Fields (AutoStrobe only)
The following columns appear only if you have submitted the AutoStrobe measurement request with a schedule, or if the AutoStrobe request is in a request group that was submitted with a schedule:
DAY | The day of the week that the measurement session is scheduled to be initiated. |
DATE | The month, day, and year that the measurement session is scheduled to be initiated. The date format depends on the date format specified in the Strobe parameter data set. |
TIMEn | The time of day that the measurement session is scheduled to be initiated. If you have specified more than one time on the Strobe - Request Scheduler panel, or have added or excluded specific times, you will see more than one TIME column. The format depends on the time format specified in the Strobe parameter data set. |
RETRY ATTEMPTS | The number of times Strobe will try to initiate a scheduled measurement. When Strobe reaches the number of retry attempts, it will not initiate the measurement, until the next time the measurement is scheduled to run. |
RETRY INTERVAL | The time in minutes between retry attempts. |
AUTO PROFILE JCL Field
This section appears only if you have submitted the measurement request with the automatic profile option and contains the JCL required to produce the Performance Profile.