Providing WLM definitions via Data Virtualization Manager

Edit online

Data Virtualization Manager provides information about WLM definitions. These definitions describe the separation and affinity requirements for a set of dynamic transactions.

Before you begin

Before you start this procedure, it is important to understand the following requirements:

Data Virtualization Manager must have proper access to the MVSADMIN.WLM.POLICY resource.

Your user ID must have UPDATE access or the following error occurs:

*SDx0038S INSTALL OF WLM SERVICE DEFINITION FAILED, RC=X'0000000C',
REASON=X'xVy0039s', DETECTED AT OPINWM+X'FFC3BF06'

Your user ID for starting the server must have READ access or the following error occurs:

SDx3269I WLM administration userid xxxxxxxx logged on to system

xVy0037E WLM EXTRACT SERVICE DEFINITION FAILED, RC=X'00000004', DETECTED AT
OPINWM+X'00000B02'

Procedure

Add the following statements to your AVZSIN00 configuration member:

If DoThis then 
  do
    “MODIFY PARM NAME(WLMFORCEPOLICY) VALUE(YES)”
    “MODIFY PARM NAME(WLMTRANNAME) VALUE(APPLNAME)”
    “MODIFY PARM NAME(WLMUSERID) VALUE(AVZS)”
End

The following table lists the parameters for WLM definitions:


Parameter	Description	Valid values
WLMFORCEPOLICY	Controls whether the Data Virtualization Manager server enforces service policy requirements.	YES The server initialization examines the active policy for required elements and terminates if the elements do not exist and the server is not allowed to add them. The server also examines the policy anytime it is refreshed, and shuts down the server if the new policy is not in compliance with server requirements. NO (default) The Data Virtualization Manager server checks the policy for required definitions, and issues an error message if the subsystem type (default AVZ, set by WLMSUBSYSTEM) is not defined in the policy. The server is allowed to initialize, and is not shut down for any policy changes.
WLMTRANNAME (optional)	Specifies which value is used as the transaction name when classifying the Data Virtualization Manager server transactions.	APPLNAME (default) The application name set in the client ODBC data source is used as the transaction name. MODNAME The name of the application that uses the client ODBC driver is used as the transaction name. INTNAME The client application executable internal name is used as the transaction name.
WLMUSERID (optional)	Specifies a highly privileged user ID under which WLM administration functions are performed. This user ID must be authorized to update the MVSADMIN.WLM.POLICY resource. If WLMUSERID is not specified, the server subsystem ID is used for WLM policy administration.	AVZS (default subsystem ID)

Enter WLM from the ISPF/PDF option 6 panel to log on to the IBM TSO/ISPF WLM administration tool.
Extract and save a copy of the current service definition. This is for backup purposes only.
Optional: Update the AVZSIN00 configuration member with a valid WLMUSERID.

Start Data Virtualization Manager server.

Upon startup, Data Virtualization Manager:

Examines the current WLM service policy for the required elements. If the active policy contains the required elements, initialization continues. If the required elements are not found, Data Virtualization Manager messages xDy0706I, and xDy0707I are issued for each missing element.

xDy0706I DATA VIRTUALIZATION SERVER AVZS requires the following elements
 missing from WLM Service Policy active_policy_name

xVy0707I Type: WORKLOAD, Data Virtualization Parameter: WLMWORKLOAD, 
Value: AVZ_WKLD

xVy0707I Type: SUBSYSTEM, Data Virtualization Parameter: WLMSUBSYSTEM, 
Value: AVZ

xVy0707I Type: SERVICE CLASS, Data Virtualization Parameter: 
WLMSERVICECLASS, Value: AVZ_SCNM

xVy0707I Type: SERVICE CLASS, Data Virtualization Parameter: 
WLMHISERVICECLASS, Value: AVZ_SCHI

xVy0707I Type: SERVICE CLASS, Data Virtualization Parameter: 
WLMTXSERVICECLASS, Value: AVZ_SCTX 
xVy0707I Type: REPORT CLASS, Data Virtualization Parameter: 
 WLMP1REPORTCLASS, Value: AVZ_RCP1

xVy0707I Type: REPORT CLASS, Data Virtualization Parameter: 
WLMP2REPORTCLASS Value: AVZ_RCP2

xVy0707I Type: REPORT CLASS, Data Virtualization Parameter: 
WLMP3REPORTCLASS, Value: AVZ_RCP3

xVy0707I Type: CLASSIFICATION RULE, Data Virtualization Parameter: 
WLMTRANSACTION, Value: AVZ_TNNM

xVy0707I Type: CLASSIFICATION RULE, Data Virtualization Parameter: 
WLMHITRANSACTION, Value: AVZ_TNHI

xVy0707I Type: CLASSIFICATION RULE, Data Virtualization Parameter: 
WLMTXTRANSACTION, Value: AVZ_TNTX

Data Virtualization Manager then examines the WLM service definition for the required elements. If WLMFORCEPOLICY is set to NO, the following actions are skipped. If WLMFORCEPOLICY is set to YES, the following actions are enforced. The default is NO.
Action 1: If the required elements are found in the service definition, a WTOR is issued, requesting permission to activate the current service policy. If the current policy is no longer in the service definition, the user is asked to select one of the policies in the service definition for activation.
```
*nn xVy0719R Reply 'GO' to activate Policy
service_policy_name, or 'CANCEL' to terminate
Server initialization
```
If you reply with CANCEL, the Data Virtualization Manager server shuts down.
If you reply with GO, the Data Virtualization Manager server automatically activates your WLM Policy service_policy_name, and you should see the following message in the system log:
```
IWM001I WORKLOAD MANAGEMENT POLICY service_policy_name NOW IN EFFECT
```

Action 2: If the required elements are not found in the service definition, the Server issues message xDy0706I, and then message xDy0707I for each missing element.

xDy0706I DATA VIRTUALIZATION SERVER AVZS requires the following elements 
missing from WLM Service Definition service_definition_name.

xVy0707I Type: WORKLOAD, Data Virtualization Parameter: WLMWORKLOAD, 
Value: AVZ_WKLD

xVy0707I Type: SUBSYSTEM, Data Virtualization Parameter: WLMSUBSYSTEM, 
Value: AVZ

xVy0707I Type: SERVICE CLASS, Data Virtualization Parameter: 
WLMSERVICECLASS, Value: AVZ_SCNM

xVy0707I Type: SERVICE CLASS, Data Virtualization Parameter: 
WLMHISERVICECLASS, Value: AVZ_SCHI

xVy0707I Type: SERVICE CLASS, Data Virtualization Parameter: 
WLMTXSERVICECLASS, Value: AVZ_SCTX

xVy0707I Type: REPORT CLASS, Data Virtualization Parameter: 
WLMP1REPORTCLASS, Value: AVZ_RCP1

xVy0707I Type: REPORT CLASS, Data Virtualization Parameter: 
WLMP2REPORTCLASS, Value: AVZ_RCP2

xVy0707I Type: REPORT CLASS, Data Virtualization Parameter: 
WLMP3REPORTCLASS, Value: AVZ_RCP3

xVy0707I Type: CLASSIFICATION RULE, Data Virtualization Parameter: 
WLMTRANSACTION, Value: AVZ_TNNM

xVy0707I Type: CLASSIFICATION RULE, Data Virtualization Parameter: 
WLMHITRANSACTION, Value: AVZ_TNHI

xVy0707I Type: CLASSIFICATION RULE, Data Virtualization Parameter: 
WLMTXTRANSACTION, Value: AVZ_TNTX

The preceding messages are followed by a WTOR requesting permission to update the service definition.

*nn xVy0708R Reply 'GO' to update the WLM Service Definition, or
'CANCEL' to terminate server initialization

If you reply with CANCEL, Data Virtualization Manager server shuts down.

If you reply with GO, the Data Virtualization Manager server automatically makes the proper WLM updates to your WLM policy definition. At the conclusion of the update process, you receive the following message.

xDy0709I WLM Service Definition service_definition_name has been updated
with required elements

Action 3: A separate WTOR message is presented to activate the policy.

*nn xVy0719R Reply 'GO' to activate Policy service_policy_name, or
'CANCEL' to terminate server initialization

If you reply with CANCEL, Data Virtualization Manager server shuts down. The user can use the TSO/ISPF WLM administration dialog to extract the service definition and review the additions that are made by the Data Virtualization Manager server.

If you reply with GO, the Data Virtualization Manager server automatically activates your WLM policy service_policy_name, and you see the following message:

IWM001I WORKLOAD MANAGEMENT POLICY service_policy_name NOW IN EFFECT

Note: After the WLM service policy is activated, if you change any IBM Data Virtualization Manager for z/OS required WLM element in the service definition to an invalid value and activate a service policy, all servers requiring the now invalid definition shut down.

Note: You should have a backup of your existing WLM service policy definitions.