The workscope parameter

workscope=[ulq],name,type

Use this parameter to qualify a request for performance data in more detail with regard to address spaces and WLM entities. Workscopes can be applied to single valued metrics as well as to list valued metrics. For example,

for the metric performance index, the workscope parameter denotes the associated service class period
for the metric % workflow by job, you can use this parameter to focus on jobs that belong to a certain service class.

The workscope parameter consists of three parts:

an upper level qualifier which may be blank or which specifies the name of a WLM service class, if the workscope type is a WLM service class period
a workscope name (for example, job name or report class name) or a service class period
a workscope type
Available workscope types:

G

global (no workscope required)

W

WLM workload

S

WLM service class

P

WLM service class period

R

WLM report class

J

job

Examples:

Workscope term	result
&workscope=,BATCH,W	focus on workload BATCH
&workscope=HOTTSO,3,P	focus on period 3 of service class HOTTSO
&workscope=,CICSPRD,R	focus on report class CICSPRD
&workscope=,CATALOG,J	focus on job catalog

Example request strings with a workscope parameter:

Example 1 (single valued metric): Retrieve the performance index (ID = 8D1000) for the first period of service class BATCHMED:

http://ddshost:8803/gpm/perform.xml?resource=,MVSPLEX,SYSPLEX
                                            &id=8D1000&workscope=BATCHMED,1,P

Example 2 (list valued metric): Retrieve the workflow by job (ID = 8D0560) for all jobs running in service class HOTTSO:

http://ddshost:8803/gpm/perform.xml?resource=,SYSA,MVS_IMAGE
                                            &id=8D0560&workscope=,HOTTSO,S