All previous versions of Zowe Explorer for Visual Studio Code™ can be downloaded from Zowe Explorer GitHub Releases.
Zowe Explorer for VS Code provides access to mainframe resources in Visual Studio Code. Zowe Explorer provides a modern, familiar, user-friendly interface that enables mainframe developers and system programmers to:
- Manage data sets and USS files on a z/OS mainframe with browse, create, modify, rename, copy, and upload functionality
- Submit JCL and view job output
- Issue TSO, UNIX, and MVS console commands from an integrated VS Code terminal
- Apply other VS Code extensions for things like syntax highlighting, debugging, and IntelliSense to improve the developer experience
Share an idea or open an issue in our Git repository to help improve Zowe Explorer or report an issue.
- Join the #zowe-explorer-vscode channel on Slack to stay in touch with the Zowe community.
- To translate Zowe Explorer into your language, join our POEditor project.
- For the complete Zowe Explorer documentation, see Zowe Docs.
Addressing system requirements
Before you use Zowe Explorer, ensure that you meet the following prerequisites:
-
macOS: Only Mac operating system versions supported by Apple
-
Unix-like:
-
Windows: Only Windows operating system versions supported by Microsoft
-
Note: Secure credentials are not supported in Red Hat CodeReady Workspaces as the keyring is not unlocked by default. However, you can use the Kubernetes Secrets plug-in for Zowe CLI or Zowe® Explorer for Kubernetes® Secrets as an alternative, or you can create your own Custom Credential Managers in Zowe Explorer and Zowe CLI.
-
VS Code 1.90.0+
Note: Only VS Code versions that bundle actively maintained versions of Node.js are supported.
-
IBM z/OSMF is configured and running.
- See z/OSMF REST services for Zowe clients for a list of services that need configuration.
-
If using IBM CICS or IBM z/OS FTP: Applicable plug-in services are configured and running on the mainframe.
- Plug-ins communicate with various mainframe services. The services must be configured and running on the mainframe before issuing plug-in commands. - See Zowe® Explorer for IBM® CICS® Transaction Server system requirements. - See Zowe® Explorer for IBM® z/OS® FTP system requirements.
Getting started
Use various services to communicate with system resources and extract system data on the mainframe:
-
z/OSMF
- See z/OSMF documentation for more information.
-
FTP
- This connection is available with the Zowe Explorer FTP Extension.
- See FTP documentation for more information.
-
There are multiple extensions that offer additional protocols and functionality. See the Explorer for Visual Studio Code Zowe V3 section in the Zowe V2 and V3 Conformant Landscape for a complete list of conformant extensions.
- Configure Zowe Explorer by changing the extension settings. For more information, see Configuring Zowe Explorer.
Team configuration stores connection information to access the mainframe. Check that you have your team configuration in place.
-
Your team configuration is in place when:
- Selecting the + icon in the headers of the DATA SETS, UNIX SYSTEM SERVICES, or JOBS tree views presents options in the Quick Pick to edit your configuration file or, if available, use an existing profile.
-
You do not have team configuration when:
- A pop-up message displays advising that client configurations were not found.
- A Search icon does not display in the headers of the DATA SETS, UNIX SYSTEM SERVICES, or JOBS tree views. Select the + icon to create team configuration.
If you are missing your team configuration files, zowe.config.json and zowe.schema.json, work with your administrator to confirm the connection information needed to finalize the configuration.
A team configuration file stores connection information to mainframe services in profiles, making team configuration easy to maintain and share with others in your organization.
Team configuration should be created by an administrator or team lead who understands what connection information is needed and can efficiently manage it. A user can also set up their team configuration when they understand their team's requirements for use and the options available to ensure these are met.
If you do not have a team configuration file, create a new one in Visual Studio Code:
- Open Zowe Explorer.
- In the pop-up message that prompts you to create a new configuration file, click Create New.
- In the Quick Pick, select the type of configuration file to create, a global or project file.
- In the Editor tab, fill in the required connection information.
Refer to Zowe Docs for documentation on understanding and implementing team configuration:
Note: Team configuration can apply across three core components of the Zowe project: Zowe Explorer for VS Code, Zowe Explorer for IntelliJ IDEA, and Zowe CLI.
The first time a team configuration profile is used, you are prompted for a user name and password for the profile's connection.
The term password is used loosely to represent all supported authentication secrets, such as passphrases, passtickets, Multifactor Authentication (MFA) tokens, etc.
Secure fields in the team configuration file are handled by the Zowe Imperative dependency.
To update securely stored user names and passwords in Zowe Explorer:
-
Right click the applicable profile and select Manage Profile.
-
Select Update Credentials from the Quick Pick.
You are prompted for the new credentials and these are saved to the secure credentials vault.
Zowe Explorer for VS Code supports multiple authentication methods including basic authentication, multi-factor authentication, tokens, and certificates. See Zowe Docs for more information about these other authentication methods.
Working with file trees
-
Expand a tree view in the Side Bar.
-
Click on the Search icon next to a profile to search for the resources that you want to view.
Search results display under the profile in the Side Bar.
-
Click on the resource to display it in an Editor.
-
If the file is able to be edited, edit the document in the Editor.
-
Press the
Ctrl+sorCommand+skeys to save the changes.The changes are saved and the edited resource is uploaded to the mainframe.
Downloading file content
-
Expand a tree view in the Side Bar.
-
Click on the Search icon next to a profile and enter search criteria.
Search results display under the profile in the Side Bar.
-
Right-click on the desired file and select a download option.
The selected files are saved.
Extending Zowe Explorer
You can add new functionalities to Zowe Explorer by creating your own extension. For more information, see Extensions for Zowe Explorer.
Tip: View an example of a Zowe Explorer extension in the Zowe Explorer FTP extension documentation.
Known issues
Files written in languages primarily read from right to left (Arabic, Hebrew, many Asian languages) can include portions of text that are written and read left to right, such as numbers.
These bidirectional (BiDi) languages are not currently supported in Visual Studio Code. (See Issue #86667 for more information.)
As a result, VS Code extensions like Zowe Explorer, Zowe Explorer CICS Extension, and Zowe Explorer FTP Extension are not able to support BiDi languages in files.