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
signaturekeyringattribute 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
signaturekeyringattribute 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:
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 directoryTo download and consume IBM’s GIMZIP packages you must now add the
signaturekeyringattribute to your SMP/E RECEIVE ORDER, RECEIVE FROMNETWORK, RECEIVE FROMNTS, and GIMGTPKG jobs.To learn how to specify the
signaturekeyringattribute 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-packagesIf 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
hashattribute in the<SERVER>XML, even if you are verifying digital signatures. If thehashattribute 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.
Was this topic helpful?
Document Information
Modified date:
27 October 2026
UID
ibm17287262