Tuesday, June 2, 2026

Db2 for zOS 101 Db2 and WLM

Terminology

Service definition

Consists of one or more service policies

Service policy

Contains several workloads
One service policy is active at a time in an LPAR or Parallel Sysplex

Workload
Arbitrary collection Consists of one or more service classes

Service class

Each service class has at least one period
- Each period has one goal
- If > 1 period, all but last have a duration

Goal (5 types)
System
Average response time
% response time
Execution velocity
Discretionary

Classification rules

WLM assigns address spaces and transactions to service classes by classification rules 

 Concepts: service class and classification


Classification

  • Assignment of incoming work to a service class, and optional report class
  • Based on a wide variety of filters, or qualifiers

 

Service class

Set or group of related work

  • Production CICS, IMS, and Db2 address spaced might be in the same service class: STCHI or PRODHI
  • Separate report classes can report on CICS, IMS, Db2 separately

Service class can combine goals of different types in multiple periods

  • Period is a combination of importance (IMP), goal, and duration
  • A service class period is the target of WLM measurement and management actions

Subsystem types and classification

 

Transaction Type

Allowable Goal Types

Allowable # of Periods

Address space oriented

Response Time

Execution Velocity
Discretionary

Multiple

Enclave

Response Time

Execution Velocity
Discretionary

Multiple

CICS/IMS

Response Time

One

Goal Types

System goals
SYSTEM, SYSSTC
- These have fixed dispatch priorities above IMP 1

Response time goals
Average response time
- Includes queue time and execution time
- Better for homogeneous type transactions

Percentile response time
- Reduce effect of outliers 

- Better for heterogeneous type transactions

 

Execution velocity goals (velocity goals)
Intended for work where response time goals are not appropriate
- Address spaces, long running jobs

Discretionary

For low priority, long-running work
- Probably not appropriate for Db2 work

 

Goal types: more detail


Execution velocity goals (velocity goals)

  • How fast work should run relative to other work requests when ready, without being delayed for CPU, storage or I/O
  • Expressed as a number, e.g. 60 or 40
    Value of 60 means 'ready' work runs 60% of the time
  • Differentiate velocity goals within an importance level by 10
  • Appropriate velocity goals depend on the number of engines (CPs)

 Response time goals

  • Average response time goal of 1 second - if one in 10 transactions takes 10 seconds, you will miss this goal
  • Percentile response time goal of 90% complete in 1 second, one transaction in 10 taking 10 seconds will not miss this goal

Importance

For most work, importance 1 (IMP 1) is highest and importance 5 (IMP 5) is lowest

WLM applies resources to IMP 1 first

If IMP 1 work meets its goals, WLM will apply resources to IMP 2, then IMP 3, then IMP 4, etc.

Some service trickles down to DISCRETIONARY

SYSTEM and SYSSTC are internal service classes for system tasks and have the highest dispatching priorities

SYSOTHER is the default service class for unclassified work and runs at a DISCRETIONARY goal

Note: not all work is "most important"

Importance levels and Db2, example

SYSTEM

z/OS

SYSSTC

IRLMs

IMP 1

Highest

DB2PMSTR, DB2PDBM1, DB2PDIST, DB2PWLMx

IMP 2

High

Production DDF txns

IMP 3

Medium

 

IMP 4

Low

Low priority work

IMP 5

Lowest

Lowest priority work

DISCRETIONARY

 

SYSOTHER

Default service class

Importance 1 is highest priority after SYSSTC

Db2 address spaces should have velocity goals and a single period defined

Non-production Db2s could be IMP 2 or IMP 3 or IMP 4 if in same LPAR (or Parallel Sysplex) with production Db2

Discretionary work gets service after all other importance levels

  • Not appropriate for Db2 address spaces
  • Not recommended for Db2 work
  • Very little service if CPU 100% busy

 WLM concepts and Db2 (notes)


Importance

  • Production Db2 address spaces (MSTR, DBM1, DIST, WLM) should be defined with Importance 1 (IMP 1)
  • Non-production Db2 address spaces in a production LPAR should be defined with lower importance: IMP > 1
    • Consider relative to other production work
  • Production DDF transactions should generally be defined with IMP below that of production Db2 address spaces
  • IRLMs should be defined in SYSSTC

 

Goals for Db2 work

  • System - IRLM in SYSSTC
  • Velocity goals are appropriate for started tasks or long-running work
    • Db2 address spaces should have velocity goals and only a single period in the service class (MSTR, DBM1, DIST, WLMx)
  • Response time goals are appropriate for transactions, including most DDF work
    • Percentile response time-e.g. 90% complete in 0.5 seconds
    • Average response time - e.g. average response time is 0.5 seconds
  • Discretionary: below IMP 5. Not appropriate for Db2 work, in general

 

Service class: assigning goal types (example only)


CICS, IMS or TSO transactions
E.g. average response time goal Transactions complete <0.7 seconds

Db2 Address Spaces
Velocity goal; IMP 1
Exec Vel = 70 , Single period

Production DDF Transactions
Percentile response time goal, single period
IMP 2; 90% complete < 0.5 seconds

Non-production DDF: response time goals in first period, response time or velocity in second period

Period 1: IMP 3, 90% complete <0.5 seconds
Period 2: IMP 4, 90% complete < 4 seconds
Period 3: MP 5, Vel = 40


Service class: period switch - example


PERIOD 1
DUR = 300
IMP = 3
R/T = 90% in 0.5 sec

PERIOD 2
DUR = 600
IMP = 4
R/T = 90% in 4 sec

PERIOD 3
IMP = 5
VEL = 40

All transactions assigned to this service class start in Period 1

  • WLM manages the transactions in period 1 to the percentile response time goal of 90% completing in half a second, with importance of 3

 Transactions that accumulate 300 service units (DUR = 300) before completing migrate to Period 2

  • New service class period; WLM manages the transactions in period 2 to the goal of 90% completing in 4 seconds, with importance of 4
  • This means, 90% of those that did not complete in period 1

Transactions that accumulate 900 service units (DUR 300 + DUR 600) before completing migrate to Period 3

  • A new service class period; WLM manages the transactions in period 3 to a velocity goal of 40, with importance of 5

"Service units" is a hardware independent measure of CPU consumption. If your transaction consumes 1000 service units on a z13, it should consume 1000 service units on a z14, z15 or z16 (and so on)

WLM managed delays

Processor
Dispatching priority

Non-paging DASD I/O
IOSQ, subchannel pending, control unit queue

Storage
Paging, swapping

Tasks
Multi-programming level, server address space creation
- e.g. WLM address spaces for external stored procedures

WLM cannot manage
-User delay
-Network delay
Any resources or delays not listed at right are shown as UNK (unknown)

Service class periods


WLM heuristic behavior is applied to service class periods

WLM can effectively manage 25-30 active service class periods

  • If you have more than 30 active service class periods, WLM may not be able to adjust resources for all of them when the system is busy
  • It is precisely when the system is busy that you want WLM to adjust resources to meet your business goals

"Loose" goals are performance goals that are too easily achieved

  • Service class periods with loose goals are likely to have a PI < 1, so WLM will always perceive they are meeting their goals.
  • Service class periods with loose goals may have a PI < 0.7, in which case they may become a donor
    • WLM may reduce resources for donor service class to apply to recipient service class (one with PI > 1)

 Defining Db2 address spaces to WLM


Db2 address spaces are started tasks

  • To WLM, the Db2 address spaces have a subsystem type of "STC"

 IRLMs should be defined in service class SYSSTC

Remaining Db2 address spaces should be assigned to a service class with a single period, a velocity goal and appropriate importance. For example,

  • Production: IMP 1
  • QA, Development and/or Test in same LPAR/Sysplex:
    • IMP > 1 (i.e. lower importance)
    • Adjust based on other production work, such as production batch
  • Db2 address spaces include ssnmMSTR, ssnmDBM1, ssnmDIST and ssnmWLMx for stored procedures

Three types of Db2 work

Local subsystem

Allied threads
-CICS
-IMS
-TSO
-WebSphere on zSystems
-MQ on zSystems

DDF threads

DDF requests use enclave SRBS
- zIIP-eligible 

Stored procedures

External stored procedures run in WLM application environments
Native SQL procedures run in DBM1 address space

First type: local attach

Db2 SQL activity runs under dispatchable unit of invoker

  • IMS, CICS, TSO, Batch, etc.
  • Inherited classification class of invoker
  • Priority and management of home unit
  • Service attributed back to invoker

 Second type: DDF and enclave SRBs

Why do we need enclaves?

-Manage DDF work separately from ssnmDIST

-Differentiate between high priority and low priority DDF work

Classifying DDF work


Define service classes and appropriate goals for DDF work

DDF Classification Defaults

  • Defaults apply if you do not provide any classification rules for DDF work
  • Enclaves default to the SYSOTHER service class (i.e. discretionary goal) unless they can be assigned to a service class

Managing DDF Work (Enclaves)

  • All goal types are permitted
  • Transactions may be subject to period switch
  • WLM manages an enclave with its own dispatching priority, etc.

High performance DBAT DDF transactions, we must use velocity goal