Bulk Data Movement Guide

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 HotFix 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 PowerExchange (PWX) to the IBM Workload Manager for z/OS (WLM):

From the main menu of the WLM ISPF application, select Option 6,

Classification Rules

Add PWX
as a subsystem type, or specify the value you specified for the SUP_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, which has the default value of PWXLSTNR.

The following example shows the default subsystem instance PWXLSTNR:

   Subsystem-Type  Xref  Notes  Options  Help                                 
 --------------------------------------------------------------------------   
                 Create Rules for the Subsystem Type        Row 1 to 1 of 1   
 Command ===> ____________________________________________ SCROLL ===> PAGE   
                                                                              
 Subsystem Type PWX   (Required)    Fold qualifier names?   Y  (Y or N)       
 Description  . . . PowerExchange Listener                                    
                                                                              
 Action codes:   A=After     C=Copy        M=Move     I=Insert rule           
                 B=Before    D=Delete row  R=Repeat   IS=Insert Sub-rule      
                                                              More ===>       
           --------Qualifier--------               -------Class--------       
 Action    Type       Name     Start                Service     Report        
                                          DEFAULTS: STCHIM      ________      
  ____  1  SI         PWXLSTNR ___                  ________    ________

If you want to change the default transaction name of PWXWORK to another name, use the TN workload qualifier. Then, make sure the TN value matches the value in the WORKCLASS statement in the DBMOVER member.

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 number_of_entries entries in PCCA vector table...
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.

Assign PowerExchange Listeners to WLM service classes, as needed. To configure the subsystem instance for each Listener, specify the SUP_SSNAME statement in the DBMOVER configuration member.

PowerExchange zIIP Exploitation

Download Guide

Watch

Comments

Communities

Knowledge Base

Success Portal