Zowe V3 LTS: Office Hours

Zowe™, the Zowe™ logo, and the Open Mainframe Project™ are trademarks of The Linux® Foundation

Zowe V3 Office Hours Series

Sept 6 - Oct 18, Join live or watch the replays

• Hosted EVERY Friday morning at 8:00 am ET
• AGENDA:
• Overview - what’s new in v3
• Installation & configuration changes
• Upgrade considerations
• Breaking changes & conformance considerations
• User experience impact
• New feature details
• Resources & SME contact information

​

• MEETING LINK: https://zoom-lfx.platform.linuxfoundation.org/meeting/92746535715?password=0d6d9c4d-acab-4979-9ac1-f0a99aaa75c2

​

• Note: You do not need to establish a Linux Foundation account, simply join the meeting as a GUEST

​

​

Want a reminder email? Join our mailing list here: https://lists.openmainframeproject.org/g/zowe-user

2

2

Support Timeline & Version Compatibility

Zowe Support Timeline

Active, Maintenance, and End of Support implications

Zowe v1 (Maintenance) EOS 1.28.8 9/30

Zowe v2 (Active) 2.18 8/30

UNDER DEVELOPMENT

Zowe v3 (maintenance)

2025

2026

2027

Zowe v2 (Maintenance) 2.18.x 3/31

Zowe v3 (Active)

Zowe v4 (Active)

4

4

Version Compatibility and Conformance

Zowe Extensions Compatibility Recommendations:

• Verify your Vendor extensions have earned Zowe v3 Conformance (conformance assures interoperability)
• Alternatively, (not recommended) verify interoperability with the Vendor

​

Vendor Support Offerings:

• All Zowe v2 Support Providers must re-apply to re-affirm their conformance for Zowe v3. Comprehensive Support Providers MUST support ALL new Zowe Core components introduced with v3 (Zowe Extensions are excluded).

​

5

Zowe Conformance Landscape: https://www.zowe.org/extend

Zowe Conformance Program: https://openmainframeproject.org/our-projects/zowe-conformance-program/

Zowe Support Provider Conformance Program: https://openmainframeproject.org/our-projects/zowe-conformant-support-provider-program/

Overview & Breaking Changes

Zowe V3 Overview

Breaking changes (for users):

• Removal of V1 profile support
• Removal of ‘bright’ command
• Improved error message format

​

Breaking changes (for extenders and Zowe Client Node.js SDK users):

• A comprehensive list of breaking changes is available here:
• https://ibm.box.com/s/vqu92d82b4wk0i6fupo8glbrxvufn4zw

​

Supported Node.js Versions:

• Node 16 is EOL and no longer supported
• Zowe CLI V3 will support Node 18, 20, and Node 22 when it enters active LTS status later this fall.

​

​

7

Installation & Configuration

Zowe V3 Installation & Configuration

How will users install the V3 release of Zowe CLI?

• Issue command: npm install -g @zowe/cli; or
• Download the V3 Zowe CLI offline installation package, unzip the .tgz file, and issue command: npm install -g zowe-cli.tgz

How will users configure the V3 release of Zowe CLI?

• V1 profiles are no longer supported.
• Users can:
• use the zowe config convert command to convert existing v1 profiles to a team config; or
• use the zowe config init command, then manually add connection information; or
• use the zowe config auto-init command (if your system has the Zowe API ML)

9

User Experience

Zowe V3 User Experience

There will be several changes to UX:

• Removal of V1 profile support
• The `zowe profiles` command group will be removed
• Users will still be able to run the `zowe config convert` command to convert V1 profiles to a V2 configuration file
• Removal of the `bright` command
• Automation that invokes Zowe CLI using the `bright` command will need to be modified to use the `zowe` command instead
• Revised error format
• If you use Zowe CLI in a pipeline and parse error output, you will likely have to update your pipelines in order to run Zowe CLI V3

11

New Feature Details

Zowe V3 Feature Details (Error Format)

Old error format:

​

​

​

​

New error format:

• Clearly differentiates error messages, REST service error codes, and diagnostic information

13

Zowe V3 Feature Details (Searching)

Users can search for a string in data sets and job spool using:

• zowe zos-files search ds …
• Performance can be tuned using the --max-concurrent-requests command-line option when searching through data sets
• zowe zos-jobs search jobs …

​

​

14

Notices

Additional Notices

• The IBM® IMS™ Plug-in for Zowe CLI project has been archived and will not receive future updates.
• New enhancements after the release of V3 will only be implemented in V3.
• V2 will continue to receive security patches and critical bugfixes.
• Scripts that do not specify hard-coded version numbers or version tags (and require compatibility with Zowe V2) will need to ensure that they are specifying a version of Zowe CLI that works with their configuration.

16

Resources & Contact

Zowe V3 Resources

• https://www.zowe.org/vnext

18

Zowe V3 Contacts

• OMP Slack channels #zowe-cli, or #zowe-help
• GitHub repository (https://github.com/zowe/zowe-cli)
• Adam Wolfe (adam.wolfe@broadcom.com)

19

Thank you!��Questions?