Skip to main content
Version: v3.1.x LTS

Version 3.1.0 (February 2025)

Version 3.1.0 (February 2025)

Welcome to the Zowe Version 3.1.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 v3.1.0 build: Want to try new features as soon as possible? You can download the v3.1.0 build from Zowe.org.

New features and enhancements

Zowe Version 3.1.0 contains the enhancements that are described in the following topics.

find out more

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 API Mediation Layer

  • The external URL is now overridden for additional registration. (#3935)
  • OIDC token (Okta token) is now supported for authentication in API Catalog. (#3925)
  • Topology of API ML services on multiple sysplexes is now supported wherein certificates can be obtained from multiple sources. This feature allows communication to start on any sysplex and going through any sysplex to any other sysplex. #3914
  • Users can now set the number of concurrent requests to be routed at the same time to a specific service. The feature: "Limit API usage" is part of this solution. (#3903)
  • Limit API usage. A custom inmemory rate limiter has been added to limit usage of predefined services. (#3868)
  • A validate OIDC token call to ZAAS client has been added to validate OIDC via ZAAS client. (#3897)
  • A Java sample has been added to show how to build a Java application that uses a client certificate to authenticate against API ML. (#3862)
  • A client AT-TLS setting is now supported. (#3828)

Zowe CLI

Zowe CLI (Core)

  • The zowe zos-files copy data-set command now copies members from a source partitioned data set to an existing target partitioned data set. (#2386)
  • Download members matching a specified pattern with the new command zowe zos-files download all-members-matching (zowe files dl amm). (#2359)
  • Pass a .zosattributes file path for the download encoding format by adding the new --attributes flag to the zowe zos-files upload command. (#2322)
  • Add the new --ignore-not-found flag to avoid file-not-found error messages when deleting files so scripts are not interrupted during automated batch processing. The flag bypasses warning prompts to confirm delete actions. (#2254)
  • Added --wait-for-active and --wait-for-output options to the zowe zos-jobs download output command. (#2328)
  • Added support for running applications on TSO/E address spaces. Start applications and receive/transmit messages using the new tso start, tso receive, and tso send commands. (#2280)
  • Added optional --attributes flag to the zowe zos-files upload file-to-uss command to allow passing a .zosattributes file path for upload encoding format. (#2319)
  • Issue the zowe files search data-sets command with the new --encoding option to use a different code page when searching data set contents. (#2161)
  • Add the new --stateful flag to zos-tso issue cmd to allow declaring the statefulness of the address space being created. (#2240)
  • To minimize the amount of unnecessary text returned from TSO commands, the --suppress-startup-messages flag default value changed to true. (#2240)

Zowe CLI Imperative Framework

  • Added the DeferredPromise class to Imperative to provide utilities for data synchronization. (#2405)

DB2 Plug-in for Zowe CLI

  • Updated the ibm_db dependency to support Node.js 22 and native installation on M1 Macs. (#169)

Zowe Explorer

Zowe Explorer (Core)

  • See the Zowe Explorer changelog for updates included in this release.

Zowe Explorer API

Zowe Explorer FTP Extension

Zowe Explorer ESLint Plug-in

Bug fixes

Zowe Version 3.1.0 contains the bug fixes that are described in the following topics.

Zowe API Mediation Layer

  • Made "native" the default SAF authorization provider. (#3937)
  • Provided /zOSMF static definition conversion. (#3938)
  • Prevented leaking of 'exampleSetFlag' in api doc (v3.x.x). (#3933)
  • Improved error handling in case of failure when retrieving API doc. (#3932)
  • Remove dthe word 'central' from the log messages. (#3929)
  • Fixed services endpoint to show correct list of onboarded services. (#3919)
  • Provided for Auto conversion during z/OSMF static definition creation. (#3930)
  • Improved untrusted certificate message when certificate is not forwarded. (#3321)
  • Corrected apiBasePath & server URL for primary and additional Gateways. (#3922)
  • Enabled infinispan debug logs messages with caching service in debug mode. (#3905)
  • Specified content type when validating OIDC. (#3902)
  • Fixed handling unavailable services (#3879)
  • Semantic of onboarded Gateways in the multitenancy deployment. (#3884)
  • Upgraded spring boot with HTTP headers workaround (#3882)
  • Exceptions now handled that could arise in the passticket authentication schema. (#3871)
  • Default JDK DNS resolver now used. (#3877)
  • Now permitting trailing quotes in z/OSMF static definition not having matching initial ones. (#3875)
  • Restored handling mode of x-forwarded-prefix as it is used in v2. (#3874)
  • Preventing fail when headers cannot be modified. (#3845)
  • Fixed error message in case of TLS error. (#3864)
  • Updated Gateway schema with OIDC config parameters. (#3867)
  • SSL strictness in enabler now respected.(#3813)
  • SSL context now configured for webclient. (#3811)
  • Applied minor fixes in logs. (#3806)
  • Changed refill strategy to allow for API rate limiting. (#3949)
  • Fixed LogBack turbofilters configuration. (#3954)
  • Fixed LogBack configuration. (#3962)
  • Fixed the order of the Gateway filter to avoid random malfunction of routing. (#3966)

Zowe CLI

Zowe CLI (Core)

  • Fixed an issue where the zowe files upload dir-to-uss command was missing a progress bar to track progress of file uploads. (#2344)
  • The zowe files copy data-set command no longer copies all partitioned data set members if a member is specified. (#2402)
  • Added support for the --encoding flag to the zowe upload dir-to-uss to allow for encoding uploaded directories for command group consistency. (#2337)
  • Improved output formatting for the zowe zos-tso start app and zowe zos-tso send app commands by parsing and displaying relevant data rather than the entire JSON response. (#2347)
  • Resolved an issue where zowe zos-files upload file-to-uss was not properly handling command flags. (#2234)
  • Fixed an issue where the zowe zos-logs list logs command could fail or not return all logs if a start time was not supplied. (#2336)
  • Fixed issues flagged by Coverity. (#2291)

Zowe CLI Imperative Framework

  • Fixed a typo in the syntax validation code for positional arguments which caused validation to never fail. (#2375)
  • Resolved an issue where extraneous base profiles were created in project configurations when a nested profile property was updated. (#2400)
  • Resolved an issue where base profiles in a team configuration file were overwritten when a user configuration file did not include a base profile. (#2383)
  • Modified location of Proxy-Authorization header to be located in the agent instead of the request. (#2389)
  • Modified 8.8.2 bugfix to correct web help alias. (#2361)
  • Resolved issue where special characters could be corrupted when downloading a large file. (#2366)
  • Fixed an issue where the Imperative Event Emitter could skip triggering event callbacks. (#2360)
  • Updated --help-web commands to work even in the presence of a faulty configuration. (#2361)
  • Fixed an issue where the ProfileInfo.profileManagerWillLoad method failed if profiles were not yet read from disk. (#2284)
  • Fixed an issue where the ProfileInfo.onlyV1ProfilesExist method could wrongly return true when V2 profiles exist. (#2311)
    • Deprecated the static method ProfileInfo.onlyV1ProfilesExist and replaced it with an onlyV1ProfilesExist instance method on the ProfileInfo class. (#2313)
  • Fixed an issue where the ConvertV1Profiles.convert method may create team configuration files in the wrong directory if the environment variable ZOWE_CLI_HOME is set. (#2312)
  • Fixed an issue where the Imperative Event Emitter would fire event callbacks for the same app that triggered the event. (#2279)
  • Fixed an issue where the ProfileInfo.updateKnownProperty method could rewrite team config file to disk without any changes when storing secure value. (#2324)

CICS Plug-in for Zowe CLI

  • Removed bundled dependencies from the npm package. (#192)

  • Restored the npm-shrinkwrap file in the npm package. (#187)

Zowe Explorer

Zowe Explorer (Core)

  • See the Zowe Explorer changelog for updates included in this release.

Zowe Explorer API

Zowe Explorer FTP Extension

Zowe Explorer ESLint Plug-in

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 3.0.

  • BDSA-2023-3495
  • BDSA-2024-5686