PM94654: BLANK LINES IN TEXT FILES ON Z/OS CONTAIN X'00' BYTES

APAR status

• Closed as program error.

Error description

• Text files shipped with WebSphere Message Broker on z/OS contain
  the null (x'00') character where a blank line should exist.
  
  This is particularly problematic for the plugin header files
  which when used to compile a C plugin node fail to compile which
  errors similar to:
  
  ERROR CCN3766 /usr/lpp/mqsi/V8R0M0/include/plugin/BipCni.h:6
  The universal character name "" is not in the allowable range
  for an identifier.
  
  The list of affected files includes:
  include/BipRfc.h
  include/BipSMF.h
  include/cmqcmb.h
  include/plugin/BipCci.h
  include/plugin/BipCni.h
  include/plugin/BipCos.h
  include/plugin/BipCpi.h
  

Local fix

• Manually edit the affected files and remove the x'00' entries
  from lines which should be blank.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of WebSphere Message Broker V6.1, V7.0 & V8.0 and
  IBM Integration Bus V9.0 on z/OS who wish to build plugin
  nodes or parsers using the plugin header files.
  
  
  Platforms affected:
  z/OS
  
  ****************************************************************
  PROBLEM SUMMARY:
  Text files shipped with WebSphere Message Broker on z/OS contain
  the null (x'00') character where a blank line should exist.
  
  This is particularly problematic for the plugin header files
  which when used to compile a C plugin node fail to compile which
  errors similar to:
  
  ERROR CCN3766 /usr/lpp/mqsi/V8R0M0/include/plugin/BipCni.h:6
  The universal character name "" is not in the allowable range
  for an identifier.
  
  The list of affected files includes:
  include/BipRfc.h
  include/BipSMF.h
  include/cmqcmb.h
  include/plugin/BipCci.h
  include/plugin/BipCni.h
  include/plugin/BipCos.h
  include/plugin/BipCpi.h
  
  All of the scripts which wrapper the mqsi commands and some of
  the files for the samples and xmlt properties files are also
  affected but the null characters do not affect their operation.
  
  There are a number of resource name changes between WebSphere
  Message Broker and IBM Integration Bus Version 9.0. For
  details visit
  http://pic.dhe.ibm.com/infocenter/wmbhelp/v9r0m0/topic/com.ibm.e
  tools.mft.doc/bb23814_.htm
  

Problem conclusion

• The product has been changed to correctly package any text files
  which contain blank lines so that the blank lines are not
  replaced with null (x'00') characters.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v6.1       6.1.0.12
  v8.0       8.0.0.3
  v9.0       9.0.0.1
  v7.0       7.0.0.7
  
  The latest available maintenance can be obtained from:
  http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27009742
  
  If the maintenance level is not yet available, information on
  its planned availability can be found on:
  http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006308
  ---------------------------------------------------------------
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

  PM94438

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  WMB Z/OS V6

• Fixed component ID

  5655M7400

Applicable component levels

• R100 PSY

     UP