Monitoring Measurement Requests


To monitor the status of your Strobe measurement requests:

  1. Select Option 3 (STATUS) from the Strobe  Options menu.
  2. Press Enter to display the Strobe - Status panel.
  3. 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)

Important

The figures in this section show an example of an AutoStrobe status panel. Sections of the panel that apply only to AutoStrobe are noted in the descriptions of the panel fields.

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.

  • If you have suspended the measurement session, the sample data set is open.
  • If you have ended the measurement session, the sample data set is closed.

Queued

The target program has not yet begun executing.

Completed

The request has been terminated and all sample data sets have been closed.

Important

For AutoStrobe measurements of multiple steps,  creates one measurement session to act as a template request for each job step you specified. As each job step becomes active,  copies the template request and adds an active request for the specified job step. This 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.

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

image2021-2-15_19-52-52.png

 Strobe - Status Panel (Scrolled Right Once)

image2021-2-15_19-53-24.png

 Strobe - Status Panel (Scrolled Right Twice)

image2021-2-15_19-53-59.png

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/
STEPNUM

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:

  • AUTO-T: output will be in text format
  • AUTO-I: output will be formatted for use by iStrobe

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:

  1. Clear the SYSTEM field.
  2. 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

image2021-9-9_19-50-17.png

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:

  1. Select Option 3 (STATUS) from the Strobe Options menu.
  2. Press Enter to display the Strobe - Status panel.
  3. Type Y in the CHANGE THRESHOLDS field.
  4. Press Enter to display the Strobe - Threshold Definitions panel.
  5. 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.
  6. 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.
  7. Type the names of jobs that you do not want the threshold to apply to in the JOBNAME field.
  8. Press Enter to return to the Strobe - Status panel.

image2021-9-9_19-55-7.png

Viewing the Parameters of a Measurement Request

To view the measurement parameters that have been supplied for a request:

  1. Type V to the left of the request.
  2. Press Enter to display a view panel.
  3. 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

image2021-9-9_20-4-51.png

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:
P: = Plans
A: = AuthIDs
C: = CorrIDs
L: = Locations
U: = Enduser IDs
T: = Enduser Transactions
W: = Enduser Workstations
*: = Freeform text string

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:

  • Requester location
  • Correlation ID
  • Authorization ID
  • End user’s user ID
  • End user’s workstation
  • End user’s transaction

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. 

Important

AutoStrobe only - For AutoStrobe deferred requests, the request retention period does not begin until the request moves from the deferred to the queued category.

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.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*