Version 2.17.0 (July 2024)
Version 2.17.0 (July 2024)
Welcome to the Zowe Version 2.17.0 release!
See New features and enhancements for a full list of changes to the functionality. See Bug fixes for a list of issues addressed in this release.
Download v2.17.0 build: Want to try new features as soon as possible? You can download the v2.17.0 build from Zowe.org.
New features and enhancements
Zowe Version 2.17.0 contains the enhancements that are described in the following topics.
To watch a demo of new enhancements and updated features included in a Zowe minor release, look for the release demo recording in the Zowe V2 System Demo playlist on YouTube.
System demos are typically held the week after a minor release becomes available. Check the Open Mainframe Project Calendar for the latest schedule.
Zowe installation and packaging
- Added
JCLsample templates withinSZWESAMPdataset, also seen within“files/SZWESAMP”. Datasets beginning withZWEIare intended to be an alternative but not replacement ofzwe initoperations.ZWEIRAC,ZWEITSS, andZWEIACFare derived from and intended to replaceZWESECURin the future.ZWEIKR*are derived from and intended to replaceZWEKRINGin the future. (#3890) - Added a job,
ZWEGENERwithin theSZWESAMPdataset. When provided the location of Zowe’s runtime directory andYAMLfiles, this job will take theSZWESAMPsample JCL templates and resolve parameter values with those found in theYAMLconfiguration after validation, placing the results into theCUST.JCLLIBdataset. This can be used to simplify setup of jobs for Zowe installation. (#3890) - Startup performance has been improved by moving extension schema validation of application framework plugins from runtime to install time. This additionally helps identify schema errors at install time that would previously have been shown only at runtime. (#3866)
- Added
zowe.network.server.tls.attlsandzowe.network.client.tls.attlsas Booleans for controlling global or per-component way to tell Zowe servers that they should operate in a mode compatible with anAT-TLSsetup. (#3463) - Startup performance has been improved by reducing the quantity of processes involved during startup. (#115)
- Reduction in resource consumption. Each Zowe component uses one less shell process at runtime. (#115)
- Added a “files/defaults.yaml” file which contains default
YAMLproperties to reduce the chance of errors found during an upgrade of Zowe when re-using an olderYAMLconfiguration file. This file should not be edited but can be reviewed to learn default behaviors, and overridden within userYAMLfiles. (#3883)
Zowe Application Framework
Zlux App Server
- The
app-servercan now use Zowe's standardized and simplifiedAT-TLSconfiguration simply by togglingzowe.network.server.tls.attls: trueorcomponents.app-server.zowe.network.server.tls.attls: true. If you wish to control client tls separately from servertls, you can also usezowe.network.client.tls.attlsorcomponents.app-server.zowe.network.client.tls.attls. (#300) (#303) - Reduced startup time by removing a check for DNS behavior on node versions 14 and less. Node 14 has not been supported since September 2023. (#304)
- Reduced startup time by consolidating startup configuration script actions into one process. (#305)
Zlux Server Framework
- Added function
isClientAttls(zoweConfig)withinlibs/util.js.whenever a plugin makes a network request, it should always use this to determine, if a normallyHTTPSrequest should instead be made asHTTPdue toAT-TLShandling theTLSwhen enabled. (#544)
Zowe Common C
- Fixed
xplatform.loadFileUTF8when trying to opennonexistentfile. (#454) - Allocated
SLHforhttp serverwith configurable valuehttpRequestHeapMaxBlocksinYAML. (#447)
ZSS
- Added code to configure the
SLHblock size of thehttp serverthroughhttpRequestHeapMaxBlocksin the YAML. (#701)
Zowe API Mediation Layer
- Cloud gateway can now run with AT-TLS enabled in the environment. (#3564)
- The request buffer size for WebSocket connections is now customizable. (#3609)
Zowe CLI
Zowe CLI (Core)
- Added the ability to set JCL reader properties for
--jobRecordLength,--jobRecordFormat, and--jobEncodingon thezowe jobs submit local-fileandzowe jobs submit stdincommands. (#2139) - Added the ability to download job spool files using other codepages with
--encodingon thezowe jobs download output,zowe jobs view spool-file-by-id, andzowe jobs view all-spool-contentcommands. This allows users to download job spool files in other languages (i.e. IBM-1147 for French). (#1822)
Zowe CLI Imperative Framework
-
Added the
ProfileInfo.profileManagerWillLoadfunction to verify that the credential manager can load. (#2111) -
Added support for proxy servers using a proxy http agent. Supports the usage of the environment variables HTTP_PROXY and HTTPS_PROXY (not case sensitive).
- If any of these environment variables is set, and depending on how the Zowe session is configured for http or https, the REST client instantiates an appropriate http agent.
- If the z/OS system uses self-signed certificates then the proxy server must be configured to accept them.
- If the proxy server itself is configured with self-signed certificates then the user needs to either import these certificates on their workstation, use
rejectUnauthorizedin their Zowe profile, or use the (not recommended) nodejs variableNODE_TLS_REJECT_UNAUTHORIZED=0. - Zowe also looks for the environment variable
NO_PROXY. These work with a simple comma-separated list of hostnames that need to match with the hostname of the Zowe profile.
-
Added the
BufferBuilderutility class to provide a convenient way of downloading to a stream that can be read as a buffer. (#2167)
Zowe Explorer
Zowe Explorer (Core)
- See the Zowe Explorer changelog for updates included in this release.
Zowe Explorer API
- See the Zowe Explorer API changelog for updates included in this release.
Zowe Explorer FTP Extension
- See the Zowe Explorer FTP Extension changelog for updates included in this release.
Zowe Explorer ESLint Plug-in
- See the Zowe Explorer ESLint Plug-in changelog for updates included in this release.
Bug fixes
Zowe Version 2.17.0 contains the bug fixes that are described in the following topics.
Zowe installation and packaging
- Removed references to nonexistant STC
ZWESVSTCfromz/OSMFworkflows. This was replaced withZWESLSTCwithinZowe v2.xand already existed within the workflows. (#3881) - Updated messages
ZWEL0121EandZWEL0122Eto clarify how to resolve these errors if encountered. (#3884) - Fixed schema validation issue preventing startup when having null entries within the
zowe.certificatessection of theYAMLconfiguration. (#3905), (#3901)
Zowe Application Framework
Zlux Server Framework
- Fixed function
isServerAttls(zoweConfig)withinlibs/util.js, which was preventing usingAT-TLSwithapp-server. (#544)
Zowe Common C
- Fixed an incorrect check in the recovery router code, which might lead to the state
cell-poolbeing released prematurely. (#446)
Zowe API Mediation Layer
- Updated attls icsf condition. (#3635)
- Added missing PAT documetantion. (#3618)
- Added requestConnectionTimeout as a zowe.yaml property. (#3629)
- Disabled auto conversion for tagged files on z/OS. (#3619)
- The keystore is now not loaded when AT-TLS is set, thereby allowing ICSF keys. (#3612)
- Health endpoints can now be optionally protected. (#3625)
- The external URL in the ZUUL Gateway if AT-TLS is enabled has been corrected. (#3565)
- The protocol in the start.sh is now specified. (#3593)
- Fixed consistency between UI titles and messages. (#3502)
- WebSocket client default timeout is now customizable. (#3613)
Zowe CLI
Zowe CLI (Core)
- Updated
bracesdependency for technical currency. (#2157) - Fixed
zowe daemon enableinstalling an invalid daemon binary on macOS. (#2126)
Zowe CLI Imperative Framework
- Fixed error in REST client that when using stream could cause small data sets to download with incomplete contents. (#744)
- Updated
micromatchdependency for technical currency. (#2167) - Updated
bracesdependency for technical currency. (#2157) - Modified error text in
SyntaxValidator.invalidOptionError. (#2138) - Updated error text for invalid command options so that allowable values are displayed as strings instead of regular expressions when possible. (#1863)
- Fixed issue where the
ConfigSecure.securePropsForProfilefunction did not list secure properties outside the active config layer. (Zowe Explorer #2633)
Zowe Explorer
Zowe Explorer (Core)
- See the Zowe Explorer changelog for updates included in this release.
Zowe Explorer API
- See the Zowe Explorer API changelog for updates included in this release.
Zowe Explorer FTP Extension
- See the Zowe Explorer FTP Extension changelog for updates included in this release.
Zowe Explorer ESLint Plug-in
- See the Zowe Explorer ESLint Plug-in changelog for updates included in this release.
Vulnerabilities fixed
Zowe discloses fixed vulnerabilities in a timely manner giving you sufficient time to plan your upgrades. Zowe does not disclose the vulnerabilities fixed in the latest release as we respect the need for at least 45 days to decide when and how you upgrade Zowe. When a new release is published, Zowe publishes the vulnerabilities fixed in the previous release. For more information about the Zowe security policy, see the Security page on the Zowe website.
The following security issues were fixed by the Zowe security group in version 2.16.
- CVE-2024-24549 (BDSA-2024-0623)
- BDSA-2024-0622
- BDSA-2021-2621
- BDSA-2023-2855
- CVE-2023-26159 (BDSA-2023-3572)
- CVE-2024-28849 (BDSA-2024-0638)
- CVE-2022-25883 (BDSA-2023-2207)
- CVE-2024-22243 (BDSA-2024-0402)
- CVE-2024-22257 (BDSA-2024-0647)