CDC Guide for z/OS

10.4.0 HotFix 1
- 10.5.8
- 10.5.6
- 10.5.5
- 10.5.4
- 10.5.3
- 10.5.2
- 10.5.1
- 10.5
- 10.4.1
- 10.4.0

Back Next

Configuring PowerExchange to Offload Work to a zIIP

Before you configure PowerExchange to offload work to a zIIP, verify that the following prerequisites are satisfied:

The system callable services library SYS1.CSSLIB is available through the LNKLST contatenation or the LPALIB data set.

The projected usage function (PROJECTCPU) in the IEAOPTxx member in the system PARMLIB is enabled. If you enable zIIP usage on a system without a zIIP, and PROJECTCPU is set to FALSE, the system does not project CPU usage as if a zIIP were present, and PowerExchange reports RC = 4 from IWM4EOCT. PowerExchange continues to run zIIP-enabled functions in SRB mode.

All the libraries in the PowerExchange Listener STEPLIB concatenation are APF-authorised.

The DBMOVER configuration member does not include any TRACE statements.

Include the USESUP=Y statement in the DBMOVER configuration file on z/OS, and optionally include the following statements:

SUP_SSNAME

SUP_SSTYPE

WORKCLASS

Add PWX to the IBM Workload Manager for z/OS (WLM):

From the main menu of the WLM ISPF application, add PWX
as a subsystem type, or specify whatever value you specified for the SUB_SSTYPE statement in the DBMOVER configuration member.

For each PowerExchange Listener, add a work qualfier with a type of SI (system instance) to the list. The name must match the value in the DBMOVER SUP_SSNAME statement (default PWXLSTNR).

Optionally, change the default transaction name by using the TN qualifier type. This value must match the value in the DBMOVER WORKCLASS statement (default PWXWORK).

Check the job log to verify that zIIP enablement is successful.

If zIIP enablement is successful, the z/OS system log includes informational messages such as the following ones:

PWXDSP3400I Checking processors...                                                          
PWXDSP3401I Cpu 00 Serial FF04EEC52098 Type CP   Rel. Speed 1                               
PWXDSP3401I Cpu 01 Serial FF04EEC52098 Type CP   Rel. Speed 1                               
PWXDSP3401I Cpu 06 Serial FF04EEC52098 Type zIIP Rel. Speed 1                               
PWXDSP3403I 1 Processor available for zIIP offload                                          
PWXWCO3405I Connect to WLM Sub = PWX  Subn = GRAPWX   token = 140C2118                      
PWXWCF3409I Classify work to WLM Service class = 00238000                                   
PWXWCE3411I WLM Create Enclave function = PWXFUNC  enclave token = 0000003C00000033         
PWXWSE3415I WLM Set Rules tok = PWXR id = IWMOCT   ver = 00 cnt = 01 Dur = 1000000 Pct = 100
DTL-00607 Listener NODE1 VRM 9.5.0 Build DEV_BUILD started.

If the job log does not include messages that indicate that zIIP was successfully enabled, verify that the prerequisites for zIIP enablement are satisfied. If not all libraries in the PowerExchange Listener STEPLIB concatenation are APF-authorized, or if the DBMOVER configuration member includes a TRACE statement, zIIP exploitation is disabled.

Rename Saved Search

Table of Contents

CDC Guide for z/OS

CDC Guide for z/OS

Configuring PowerExchange to Offload Work to a zIIP

Configuring PowerExchange to Offload Work to a zIIP