IO21669: THE HASH VALUE APPEARING IN THE GIMPAF.XML FILE IS BINARY ZEROS WHEN ICSF IS NOT AVAILABLE DURING GIMZIP P 14/07/14 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• GIMZIP calls ICSF to generate a hash value for each archive file
  being placed in the package.  If ICSF is not available, SMP/E
  uses its own internal function to generate a hash value.  After
  APAR IO20858, the hash values appearing in the GIMPAF.XML file
  are binary zeros when the SMP/E internal function is used to
  generate the hash value.
  
  
  PE Information:
    Users Affected:
      Users of the SMP/E GIMZIP, GIMUNZIP and GIMGTPKG service
      routines, and the RECEIVE ORDER and RECEIVE FROMNETWORK
      commands who do not have ICSF active on their system.
  
    User Impact:
      UO01692 (HMP1H00) and UO01693 (HMP1J00) provide the ability
      to use HTTP/HTTPS to download software packages via the
      SMP/E RECEIVE ORDER or RECEIVE FROMNETWORK commands or the
      SMP/E GIMGTPKG service.  However, they introduced an error
      in the existing functions of the SMP/E GIMZIP, GIMUNZIP, and
      GIMGTPKG service routines, and the RECEIVE ORDER and
      RECEIVE FROMNETWORK commands.
  
  
      SMP/E uses ICSF to calculate SHA-1 hash values for each
      archive file of a software package.  If ICSF is not active
      on the system, SMP/E uses the Java MessageDigest class to
      calculate SHA-1 hash values.
  
      After UO01692 (or UO01693) is installed, when ICSF is not
      active, SMP/E's hash value calculation is incorrect.  For
      example, GIMZIP produces a value of binary zero in the
      GIMPAF.XML file when ICSF is not active.
  
  Local Fix:
      If ICSF is active on your system, or if you do not use the
      GIMZIP, GIMUNZIP, or GIMGTPKG service routines, or the
      RECEIVE ORDER or RECEIVE FROMNETWORK commands, this is not a
      concern for you.  You can install UO01692 or UO01693.
  
      However, if you use any of those services or commands and
      you do not have ICSF active on your system, you should not
      install UO01692 (or UO01693) until the fixing PTF for
      IO21669 is available.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users running SMP/E GIMZIP, GIMUNZIP,    *
  *                 GIMGTPKG, RECEIVE ORDER, or RECEIVE          *
  *                 FROMNETWORK when ICSF is not active.         *
  ****************************************************************
  * PROBLEM DESCRIPTION: When ICSF is not active, calculated     *
  *                      SHA-1 hash values are incorrect.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  SMP/E calls ICSF to calculate a SHA-1 hash value for each
  archive file being processed.  If ICSF is not active, SMP/E uses
  the Java MessageDigest class to calculate SHA-1 hash values.
  
  After APAR IO20858, when ICSF is not active, SMP/E's calculated
  SHA-1 hash values are incorrect.  For example, the hash values
  appearing in the GIMPAF.XML file produced by GIMZIP are binary
  zeros when ICSF is not active.
  
  This can cause GIM20314S (THERE IS A SYNTAX ERROR IN PACKAGE
  ATTRIBUTE FILE /u/dir/GIMPAF.XML) when GIMUNZIP, GIMGTPKG, or
  RECEIVE FROMNETWORK process a GIMZIP package containing an
  incorrect SHA-1 hash value.  Or GIM49100S or GIM45500S
  (VERIFICATION OF THE HASH VALUE FAILED) when GIMUNZIP, GIMGTPKG,
  RECEIVE ORDER or RECEIVE FROMNET calculate an incorrect hash
  value.
  MSGGIM45500S
  

Problem conclusion

• Modules GIMMPSHA, GIMRRDRV and GIMZPDRV are modified at the
  SMP/E 3.5 and SMP/E 3.6 levels to properly calculate SHA-1 hash
  values when ICSF is not active and the Java MessageDigest class
  is used instead.
  
  Module GIMMPRCX was modified at the SMP/E 3.5 and SMP/E 3.6
  levels for the RECEIVE ORDER command to echo the SERVER data
  'port=', 'user=' and 'pw=' tags to SYSPRINT only when a values
  for those tags are specified.
  H00Y
  J00Y
  GIMJVATH
  GIMJVCLT
  GIMJVCMD
  GIMJVCMF
  GIMJVCNI
  GIMJVGET
  GIMJVGIN
  GIMJVLVL
  GIMJVREQ
  GIMKXENU
  GIMLEVEL
  GIMMPRCO
  GIMMPRCX
  GIMMPSHA
  GIMMPXML
  GIMM5ENU
  GIMRRCMD
  GIMRRDRV
  GIMUTCMP
  GIMZPDRV
  HMP1H00J
  HMP1J00
  

Temporary fix

Comments

APAR Information

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

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

  UO01713 UO01714

Modules/Macros

• GIMJVATH GIMJVCLT GIMJVCMD GIMJVCMF GIMJVCNI
  GIMJVGET GIMJVGIN GIMJVLVL GIMJVREQ GIMKXENU GIMLEVEL GIMMPRCO
  GIMMPRCX GIMMPSHA GIMMPXML GIMM5ENU GIMRRCMD GIMRRDRV GIMUTCMP
  GIMZPDRV HMP1H00J HMP1J00
  

Fix information

• Fixed component name

  SMP/E

• Fixed component ID

  566894901

Applicable component levels

• RH00 PSY UO01713

     UP14/07/23 P F407 Ø

• RJ00 PSY UO01714

     UP14/07/23 P F407 Ø

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.