We have uncovered (with the assistance of one of our customers) a potential issue when running HostBridge for zIIP (HBz) version 6.62.

In the HBz infrastructure shipped with v6.62, it is possible under high load situations for module HBZIQPRC to issue a message indicating that the call to IWM4EDEL has completed with a return code of 4 and a reason code of x'xxxx0411'. This means: "INPUT ENCLAVE HAD 1 OR MORE SRBS SCHEDULED OR RUNNING, OR 1 OR MORE TCBS JOINED TO THE ENCLAVE." This is only an information condition. Thus, producing a message is unwarranted and may cause the CICS system log to be unnecssarily voluminous.

This issue is resolved by application of a patch to HostBridge load module HBZIQPRC.  It will eliminate the messages by raising the standard for messages to be displayed following a call to IWM4EDEL (which deletes an enclave).  Messages will only be displayed if the return code is > 4.

This patch is only applicable to HostBridge version 6.62.  The changes made by the patch will be incorporated into the standard HostBridge code base in the next version of the product.

Sample JCL to install the patch may be found here: HostBridge_Patch_20140105.txt

//JOBCARD  JOB
//*
//*  Apply patch to HostBridge Module HBZIQPRC
//*  It is recommended to save your current version of 
//*  HBZIQPRC to a separate library before applying the zap
//*
//SPZAP    EXEC PGM=AMASPZAP                            
//SYSPRINT DD SYSOUT=*                                  
//SYSLIB   DD DSN=YOUR.HOST.BRIDGE.V662TEST.LIBRARY,DISP=SHR       
//*                                                     
//SYSIN    DD *                                         
*                                                                  
* IN PROC WLM_ENCLAVE_DELETE_NATIVE...                            
* WITH THE FOLLOWING ZAP, A MESSAGE REGARDING IWM4EDEL WILL        
* ONLY BE GENERATED IF RETCODE > 4 (INSTEAD OF > 0):                                    
  NAME  HBZIQPRC HBZIQPRC                               
  VER 00007B7E 5900C0FA            C     R0,250(,R12)   
  VER 00007BB8 C9E6D4F4C5C4C5D3    DC    CL8'IWM4EDEL'  
  VER 00007BC0 00000000            DC    F'0'           
  REP 00007BC0 00000004            DC    F'4'           
*                                                                  
* IN PROC WLM_ENCLAVE_DELETE_CICS...                              
* WITH THE FOLLOWING ZAP, A MESSAGE REGARDING IWM4EDEL WILL        
* ONLY BE GENERATED IF TRACE IS NOT LOWER THAN 2:                  
* (CHANGING THE BRANCH BASED ON RETCODE TO BE A NOOP)              
  NAME  HBZIQPRC HBZIQPRC                                          
  VER  00007DC8 E30081500012            LT    R0,336(,R8)        
  VER  00007DCE A7240006                BRC  2,*+12            
  REP  00007DCE A7040006                BRC  0,*+12            
*                                                                  
* MODIFY THE COMPILED INFO TO INDICATE WE MADE THIS CHANGE:        
  NAME  HBZIQPRC HBZIQPRC                                          
  VER  00002908 C3D6D4D7C9D3C5C440            DC    C'COMPILED '  
  REP  00002908 C3D6D4D7C9D3C5C44E            DC    C'COMPILED+'  
  DUMPT HBZIQPRC HBZIQPRC
/*                                          
//

Please contact HostBridge Support if you have any questions about this fix.

© 2022 HostBridge Technology, LLC
Unless otherwise noted, all rights reserved.