Displaying workload manager information

Use the DISPLAY WLM command to display the following information:

The name of the active service policy for the sysplex, if there is one. If there is no active service policy, the response indicates that the system is running with the DEFAULT service policy.
The date and time the service policy was activated.
The date and time the service definition was installed.
The status information for a specific application environment or for all application environments.
The status information for a specific scheduling environment on a specific system or on all systems.
The status information for a resource on a specific system or on all systems.
The status of the Application Response Measurement (ARM) services as well as the guest platform management provider (GPMP).

D WLM[,SYSTEM=sysname|,SYSTEMS]
     [,APPLENV=applenvname|*]
     [,DYNAPPL=applenvname|*[,SNODE=nodename]
                                        [,SNAME=subsystemname]
                                        [,STYPE=subsystemtype]]  
     [,SCHENV=schenvname[,SYSTEM=sysname|,SYSTEMS]]
     [,RESOURCE=resourcename[,SYSTEM=sysname|,SYSTEMS]]
     [,AM[,ALL]]
     [,SYSTEMS[,GPMP]]
     [,L={a|name|name-a}]

WLM

If no other parameters are specified, displays the name of the active service policy in effect on all systems in the sysplex, as well as the time and date that the service policy was activated. Also, for systems in the sysplex that are in an exception state, it shows summary information. If coupling facility structures are defined for either multisystem enclaves or for LPAR clustering, the status of those is shown.

SYSTEM=sysname

When used with D WLM, displays the name of the active service policy in effect on the sysname system only, including the time and date that the service policy was activated, when the service definition was installed, and the workload management version level. If coupling facility structures are defined for either multisystem enclaves or for LPAR clustering, the status of those is shown. It also displays the status of the named system in the sysplex (active or otherwise), including the service policy in effect on the named system.

SYSTEMS

When used with D WLM, displays the name of the active service policy in effect on all systems in the sysplex, the time and date that the service policy was activated, when the service definition was installed, the workload management version level, functionality level, and couple data set format level. If coupling facility structures are defined for either multisystem enclaves or for LPAR clustering, the status of those is shown. Finally, it displays the status of each system in the sysplex (active or otherwise), including the service policy in effect.

If you see a system listed that is not running with the active service policy, either the system does not have connectivity to the WLM couple data set or an attempt to activate the policy on that system failed. If connectivity to the WLM couple data set has been lost (or does not exist), establish the connection. You can use the DISPLAY XCF,COUPLE,TYPE=WLM command to query the status of the WLM couple data set. If connectivity to the WLM couple data set is established and the system is still not running with the active service policy, contact the IBM® support center.

When you partition a system out of a sysplex, the system may nevertheless remain listed for a period of time, even though it is no longer part of the sysplex. The reason is that workload management retains knowledge of the system for a certain amount of time in case your installation decides to reactivate the system. If the system is not activated within several days, the system is automatically removed from the list of systems.

APPLENV=applenvname or *

Displays status information for the specified application environment (applenvname). Specifying APPLENV=* | DYNAPPL=*, the command displays status information for all application environments. The following keywords are valid:

SNODE=nodename: When SNODE=nodename is used, DISPLAY WLM,DYNAPPL displays only information for dynamic application environments with the specified nodename.
SNAME=subsystemname: When SNAME=subsystemname is used, DISPLAY WLM,DYNAPPL displays only information for dynamic application environments with the specified subsystemname.
STYPE=subsystemtype: When STYPE=subsystemtype is used, DISPLAY WLM,DYNAPPL displays only information for dynamic application environments with the specified subsystemtype.

Note: The DISPLAY WLM,APPLENV command is processed on the coordinator system, which is determined dynamically and may not be the local system where the command was issued. The command output is routed to the console from which the command has been issued, but the command hardcopy is logged on the system on which the command has been processed. Therefore, the message may not appear in the SYSLOG on the system where the command was entered.

SCHENV=schenvname

Displays status information for the specified scheduling environment (schenvname). You can display multiple scheduling environments by using wildcard characters. The multiple-character symbol (*) and the single-character symbol (?) can be used in any position.

SYSTEM=sysname: Displays the state of the scheduling environment and the availability of each resource referenced by the scheduling environment on the designated system.
SYSTEMS: Displays the state of the scheduling environment on all active systems in the sysplex.

If neither SYSTEM=sysname or SYSTEMS is specified, SYSTEMS is the default.

RESOURCE=resourcename

Displays status information for the specified resource ( resourcename). You can display multiple resources by using wildcard characters. The multiple-character symbol (*) and the single-character symbol (?) can be used in any position.

SYSTEM=sysname: Displays the resource status information on the sysname system only.
SYSTEMS: Displays the resource status information on all active systems in the sysplex.

If neither SYSTEM=sysname or SYSTEMS is specified, the default is the system on which the command is entered.

AM

Displays the current state of the Application Response Measurement (ARM) services together with the number of active processes (address spaces) using ARM services.

ALL: Displays a list of address spaces that are registered with ARM, together with the registered applications and the started application instances.

GPMP

Displays the status information associated with the guest platform management provider (GPMP).

L=a, name, or name-a

Specifies the display area (a), console name (name), or both (name-a) where the display is to appear.

If you omit this operand, the display is presented in the first available display area or the message area of the console through which you enter the command.

Example 1:

To display the name of the active service policy, enter:

D WLM

The system responds with:

IWM025I  17.40.54  WLM DISPLAY 913                                    
  ACTIVE WORKLOAD MANAGEMENT SERVICE POLICY NAME: WEEKDAY             
  ACTIVATED: 2009/08/12  AT: 12:55:57  BY: USER01    FROM: SYS2  
  DESCRIPTION: Weekday policy with ResGrp     
  RELATED SERVICE DEFINITION NAME: COEFFS
  INSTALLED: 2009/08/12  AT: 12:55:51  BY: IBMUSER   FROM: SYS2       
  WLM VERSION LEVEL:       LEVEL025                                   
  WLM FUNCTIONALITY LEVEL: LEVEL025                                   
  WLM CDS FORMAT LEVEL:    FORMAT 3                                   
  STRUCTURE SYSZWLM_WORKUNIT STATUS: CONNECTED                        
  STRUCTURE SYSZWLM_EBAE2097 STATUS: CONNECTED
  STATE OF GUEST PLATFORM MANAGEMENT PROVIDER (GPMP): CONNECTED

Example 2:

To display status information associated with system WLTEAM9, enter:

D WLM,SYSTEM=wlteam9

The system responds with:

IWM025I  17.40.16  WLM DISPLAY 810                                 
  ACTIVE WORKLOAD MANAGEMENT SERVICE POLICY NAME: WEEKDAY          
  ACTIVATED: 2009/08/12  AT: 12:55:57  BY: USER01    FROM: SYS2    
  DESCRIPTION: Weekday policy with ResGrp     
  RELATED SERVICE DEFINITION NAME: COEFFS                          
  INSTALLED: 2009/08/12  AT: 12:55:51  BY: IBMUSER   FROM: SYS2    
  WLM VERSION LEVEL:       LEVEL025                                
  WLM FUNCTIONALITY LEVEL: LEVEL025                                
  WLM CDS FORMAT LEVEL:    FORMAT 3                                
  STRUCTURE SYSZWLM_WORKUNIT STATUS: CONNECTED                     
  STRUCTURE SYSZWLM_EBAE2097 STATUS: CONNECTED                     
  STATE OF GUEST PLATFORM MANAGEMENT PROVIDER (GPMP): CONNECTED
  *SYSNAME*  *MODE*  *POLICY*  *WORKLOAD MANAGEMENT STATUS*        
  WLTEAM9    GOAL    BASEPOL   ACTIVE

Example 3:

To display status information associated with all systems in the sysplex, enter:

D WLM,SYSTEMS

The system responds with:

IWM025I  17.41.57  WLM DISPLAY 960                                
  ACTIVE WORKLOAD MANAGEMENT SERVICE POLICY NAME: WEEKDAY         
  ACTIVATED: 2009/08/12  AT: 12:55:57  BY: USER01    FROM: SYS2   
  DESCRIPTION: Weekday policy with ResGrp     
  RELATED SERVICE DEFINITION NAME: COEFFS                         
  INSTALLED: 2009/08/12  AT: 12:55:51  BY: IBMUSER   FROM: SYS2   
  WLM VERSION LEVEL:       LEVEL025                               
  WLM FUNCTIONALITY LEVEL: LEVEL025                               
  WLM CDS FORMAT LEVEL:    FORMAT 3                               
  STRUCTURE SYSZWLM_WORKUNIT STATUS: CONNECTED                    
  STRUCTURE SYSZWLM_EBAE2097 STATUS: CONNECTED                    
  STATE OF GUEST PLATFORM MANAGEMENT PROVIDER (GPMP): CONNECTED
  *SYSNAME*  *MODE*  *POLICY*  *WORKLOAD MANAGEMENT STATUS*       
  SYS2       GOAL    BASEPOL   ACTIVE                             
  WLTEAM9    GOAL    BASEPOL   ACTIVE

Example 4:

To display status information associated with the guest platform management provider, enter:

D WLM,SYSTEMS,GPMP

The system responds with:

IWM025I  17.42.24  WLM DISPLAY 977                              
  ACTIVE WORKLOAD MANAGEMENT SERVICE POLICY NAME: WEEKDAY       
  ACTIVATED: 2009/08/12  AT: 12:55:57  BY: USER01    FROM: SYS2 
  DESCRIPTION: Weekday policy with ResGrp     
  RELATED SERVICE DEFINITION NAME: COEFFS                       
  INSTALLED: 2009/08/12  AT: 12:55:51  BY: IBMUSER   FROM: SYS2 
  WLM VERSION LEVEL:       LEVEL025                             
  WLM FUNCTIONALITY LEVEL: LEVEL025                             
  WLM CDS FORMAT LEVEL:    FORMAT 3                             
  STRUCTURE SYSZWLM_WORKUNIT STATUS: CONNECTED                  
  STRUCTURE SYSZWLM_EBAE2097 STATUS: CONNECTED                  
  STATE OF GUEST PLATFORM MANAGEMENT PROVIDER (GPMP): CONNECTED
  *SYSNAME*  *MODE*  *POLICY*  *WORKLOAD MANAGEMENT STATUS*     
  SYS2       GOAL    BASEPOL   ACTIVE                           
  WLTEAM9    GOAL    BASEPOL   ACTIVE                           
  *SYSNAME* *GPMP STATUS* *GPMP TRACE LEVEL*
  SYS2      CONNECTED     LOW-MEMORY
  WLTEAM9   CONNECTED     MEDIUM-FILE

Example 5:

To display the status of the application environment named DB2PAY, enter:

D WLM,APPLENV=db2pay

The system responds with:

IWM029I  18.59.22  WLM DISPLAY 319
  APPLICATION ENVIRONMENT NAME     STATE     STATE DATA
  DB2PAY                           AVAILABLE
  ATTRIBUTES: PROC=BR14     SUBSYSTEM TYPE: DDF

Example 6:

To display status of all application environments, enter:

D WLM,APPLENV=*

The system responds with:

IWM029I  19.02.29  WLM DISPLAY 341
  APPLICATION ENVIRONMENT NAME     STATE     STATE DATA
  BR14                             AVAILABLE
  FRESCA                           AVAILABLE
  PAYAT2                           AVAILABLE
  PAYAT5                           AVAILABLE
  PAYROLL                          AVAILABLE
  PAYTEST                          AVAILABLE
  PAYTEST2                         AVAILABLE

Example 7:

To display status of the scheduling environment DB2LATE, enter:

D WLM,SCHENV=DB2LATE

The system responds with:

IWM036I  12.21.05  WLM DISPLAY 181
  SCHEDULING ENVIRONMENT: DB2LATE
  DESCRIPTION:            Offshift DB2 Processing
  AVAILABLE ON SYSTEMS:   SYS1  SYS3

Example 8:

To display status of all scheduling environments in a sysplex beginning with the string ‘DB2’, enter:

D WLM,SCHENV=DB2*

The system responds with:

IWM036I  12.21.05
WLM DISPLAY 181
  SCHEDULING ENVIRONMENT: DB2LATE
  DESCRIPTION:            Offshift DB2 Processing
  AVAILABLE ON SYSTEMS:   SYS1  SYS3

  SCHEDULING ENVIRONMENT: DB2PRIME
  DESCRIPTION:            Primetime DB2 Processing
  AVAILABLE ON SYSTEMS:   SYS2

Example 9:

To display system-level status information about the DB2LATE scheduling environment on system SYS1, enter:

D WLM,SCHENV=DB2LATE,SYSTEM=SYS1

The system responds with:

IWM037I  12.21.05  WLM DISPLAY 181
  SCHEDULING ENVIRONMENT: DB2LATE
  DESCRIPTION:            Offshift DB2 Processing
  SYSTEM:                 SYS1
  STATUS:                 AVAILABLE
                   REQUIRED    CURRENT
  RESOURCE NAME    STATE       STATE
  DB2A             ON          ON
  PRIMETIME        OFF         OFF

Example 10:

To display status of all resources on all systems in a sysplex, enter:

D WLM,RESOURCE=*,SYSTEMS

The system responds with:

IWM038I  12.21.05  WLM DISPLAY 181
  RESOURCE:     DB2A
  DESCRIPTION:  DB2 Subsystem
  SYSTEM  STATE    SYSTEM  STATE    SYSTEM  STATE
  SYS1    ON       SYS2    ON       SYS3    ON

  RESOURCE:     PRIMETIME
  DESCRIPTION:  Peak Business Hours
  SYSTEM  STATE    SYSTEM  STATE    SYSTEM  STATE
  SYS1    OFF      SYS2    ON       SYS3    OFF

Example 11:

To display whether the Application Response Measurement (ARM) services are enabled or disabled, enter:

D WLM,AM

The system responds with:

IWM075I 17.54.21 WLM DISPLAY 512
ARM SERVICES ARE ENABLED
GUEST PLATFORM MANAGEMENT PROVIDER JOBNAME=HVEMCA ASID=0032
GPMP POLICY IS ACTIVE
NUMBER OF REGISTERED PROCESSES=3, APPLICATIONS=1

To display the list of all ARM instrumented address spaces together with the registered applications and started application instances, enter:

D WLM,AM,ALL

The system responds with:

  IWM075I  16.32.14  WLM DISPLAY 068                       
  ARM SERVICES ARE ENABLED                                 
  GUEST PLATFORM MANAGEMENT PROVIDER JOBNAME=HVEMCA ASID=0032         
  GPMP POLICY IS ACTIVE                                    
  NUMBER OF REGISTERED PROCESSES=2, APPLICATIONS=2         
  ADDRESS SPACES CURRENTLY REGISTERED WITH ARM:            
    JOBNAME=CICSREG1 ASID=0027                             
      APPLICATION=CICS                                     
        IDENTITY PROPERTIES=0 CONTEXT NAMES=0              
        STARTED APPLICATION INSTANCES:                     
          EWLINST1                                         
            TRAN=0 GROUP=<name omitted>                    
        REGISTERED TRANSACTIONS:                           
          SYS_DefaultZWLMTransactionName                   
    JOBNAME=BGBOMYT1 ASID=0035                             
      APPLICATION=My ARM Application                       
        IDENTITY PROPERTIES=7 CONTEXT NAMES=1              
        STARTED APPLICATION INSTANCES:                     
          <name omitted>                                   
            TRAN=2 GROUP=My-Group                          
        REGISTERED TRANSACTIONS:                           
          My-HttpTransaction                               
  ADDRESS SPACES WITH DISABLED ARM REGISTRATION:           
    JOBNAME=BGBOMYT2 ASID=0034