IBM Support

IBM z/OS Software Download Package Verification Change

Newsletters


Abstract

As of 10 September 2026 all GIMZIP packages for downloading IBM z/OS software product and service orders must use digital signature verification. Use of SHA-1 hash to verify the package content is no longer an option.

Content

The GIMZIP packages produced and downloaded for 

  • z/OS service orders submitted from SMP/E RECEIVE ORDER, 
  • z/OS product and service orders submitted from Shopz, and 
  • z/OS service orders submitted from ServiceLink, 

no longer contain SHA-1 hashes to verify the package content.  Instead, the packages are constructed using the GIMZIP securitylevel=3 option which produces SHA-256 hashes and digitally signs the packages but does not also produce SHA-1 hashes.  Therefore, when downloading and consuming IBM GIMZIP packages you must verify the digital signature.

  • If the signaturekeyring attribute is already specified in your SMP/E RECEIVE ORDER, RECEIVE FROMNETWORK, RECEIVE FROMNTS, and GIMGTPKG jobs, then you are already verifying the digital signature and should not be impacted by this update.
  • If the signaturekeyring attribute is NOT yet specified in your SMP/E RECEIVE ORDER, RECEIVE FROMNETWORK, RECEIVE FROMNTS, and GIMGTPKG jobs, then you must add this attribute to continue to download and consume IBM GIMZIP packages.

This update helps improve compliance of the security controls used in IBM’s z/OS software distribution process and eliminates legacy validation mechanisms.

Actions

The followings actions may be necessary:

  1. If you do not currently verify the digital signatures of IBM’s GIMZIP packages in your SMP/E RECEIVE ORDER, RECEIVE FROMNETWORK, RECEIVE FROMNTS, and GIMGTPKG jobs, you will be impacted.  You can expect SMP/E download operations to receive errors which indicate the GIMPAF.XML file was not found, like this if you download using the HTTPS method:

    GIM69195S ** RECEIVE PROCESSING HAS FAILED. THE SERVER AT https://deliverycb-bld.dhe.ibm.com/2026091068008/PROD/GIMPAF.XML DETECTED AN ERROR: 404 - Not Found.

    Or like this if you download using FTP:

    GIM45201S ** 550 /2026091068008/PROD/GIMPAF.XML: No such file or directory

    To download and consume IBM’s GIMZIP packages you must now add the signaturekeyring attribute to your SMP/E RECEIVE ORDER, RECEIVE FROMNETWORK, RECEIVE FROMNTS, and GIMGTPKG jobs.

    To learn how to specify the signaturekeyring attribute and verify the digital signatures, see the SMP/E User's Guide here:
    https://www.ibm.com/docs/en/zos/3.2.0?topic=guide-preparing-verify-signatures-gimzip-packages

  2. If SMP/E APAR IO29448 (PTF UO05209 from October 2025, SMP/E level 37.35) is not yet installed, then the RECEIVE FROMNETWORK command and the GIMGTPKG program require the hash attribute in the <SERVER> XML, even if you are verifying digital signatures.  If the hash attribute is not specified you can expect to receive this error:

    GIM37150S ** THE hash KEYWORD IS MISSING OR INVALID.

    To avoid this you can add a zero hash value to the <SERVER> XML, like this:

    
    <SERVER
      host="deliverycb-bld.dhe.ibm.com"
      user="A123456z"
      pw="abcdefg12345678"
      >
      <PACKAGE
        file="2026091234567/PROD/GIMPAF2.XML"
        id="U01234567"
        hash="0000000000000000000000000000000000000000"
        >
      </PACKAGE>
     </SERVER>

    The zero hash value satisfies the syntax requirements to avoid the GIM37150S error, but the value will be ignored because the digital signature will be validated.

    In addition, the RECEIVE FROMNTS command prior to APAR IO29448 does not properly support verifying the digital signature of GIMZIP packages. Therefore, if you cannot use RECEIVE FROMNETWORK or RECEIVE ORDER to obtain PTFs from IBM, and must use RECEIVE FROMNTS, as a substitute for RECEIVE FROMNTS until you install the PTF for APAR IO29448, you can use the GIMUNZIP service routine to unzip the SMPPTFIN archive file from a GIMZIP package to a data set, and then use the RECEIVE command pointing the SMPPTFIN DD statement to that data set.

[{"Type":"MASTER","Line of Business":{"code":"LOB56","label":"Z HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG90","label":"z\/OS"},"ARM Category":[{"code":"a8m0z00000009xwAAA","label":"z\/OS"}],"Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"1.10.0;1.11.0;1.12.0;1.9.0;2.1.0;2.2.0;2.3.0;2.4.0;2.5.0;3.1.0;3.2.0"}]

Document Information

Modified date:
27 October 2026

UID

ibm17287262