IBM Z® Open Editor
Docs
News and Blogs
IBM Downloads
VS Code Marketplace
GitHub
Docs
News and Blogs
IBM Downloads
VS Code Marketplace
GitHub
  • Overview

    • Introduction
    • Updates and user feedback
  • Getting Started

    • Getting started with IBM Z Open Editor
    • Setting up integrations to interact with z/OS
    • Getting started with Zowe 3.0
  • Configuration

    • Setting preferences
    • Configuring your applications with ZAPP files
    • Setting property groups
    • Setting compiler options
    • Setting file associations
    • Setting language-specific tab stops and rulers
    • Enabling and disabling problems in IBM Z Open Editor
    • Enabling and disabling unreachable COBOL code warnings
    • Customizing the Outline view
    • Setting language-specific maximum line length
    • EBCDIC code pages and mappings files
    • Experimental: Formatting COBOL source code
  • Tutorials

    • Tutorial overview
    • Exploring the user interface
    • Exploring the sample files
    • COBOL editing tutorial
    • COBOL, PL/I Preprocessor tutorial
    • HLASM editing tutorial
    • REXX editing tutorial
    • Managing z/OS resources with IBM RSE API Plug-in for Zowe CLI tutorial
    • Submitting JCL to compile, link, and run jobs tutorial
  • Editing program files

    • Language References
    • Making COBOL and PL/I code changes
    • Making High Level Assembler code changes
    • Making REXX code changes
    • Making JCL code changes
    • Using and managing code snippets
    • Using the integrated Git
    • Searching for COBOL, PL/I, HLASM, and REXX components
  • Interacting with z/OS using Zowe

    • Interacting with z/OS
    • Creating a configuration profile in Zowe Explorer v3.0.0
    • Migrating your old Zowe yaml profiles for Zowe v3.0
    • Supported methods of authentication for z/OS using Zowe
    • Sharing team configuration files
    • Connecting to z/OS with Zowe Explorer walk through
    • Using the Zowe Explorer views
    • Using Zowe profiles in Z Open Editor
    • Connecting to z/OS using Zowe CLI walk through
    • Using command line to interact with z/OS
    • Interact with RSE Common Properties
  • Advanced Capabilities

    • Overview
    • Activating advanced capabilities
    • Launching a 3270 emulator from Zowe Explorer
    • z/OS Resources Table
    • Data Elements View
    • Program Control Flow Browser
    • Data Flow Browser
    • Preprocessor support
    • Custom Macros for HLASM
    • Language Detection
    • Linting with IBM ZCodeScan
    • User build with IBM Dependency Based Build (DBB)
    • Agent Mode
    • Line Hex Editor
  • Cloud-based Editing

    • Overview to using Cloud and Browser-based platforms
    • Try Z Open Editor in the Red Hat Developer Sandbox
    • Configuring Red Hat OpenShift Dev Spaces
    • Managing Developer Workspaces
    • Managing secrets
    • Create and use custom images
    • Migrating from IBM Wazi for Dev Spaces
    • Using Z Open Editor on GitHub Codespaces
    • Using Z® Open Editor with Dev Containers
  • Troubleshooting

    • Known issues and limitations
    • Troubleshooting using log files
    • Troubleshooting for User Build
    • Uninstalling CLI plugins and VS Code extensions
  • Reference

    • IBM RSE API Plug-in for Zowe CLI commands
    • IBM RSE API Plug-in for Zowe CLI as nodejs SDK package
    • IBM RSE API Plug-in for Zowe CLI as nodejs SDK reference
    • Example Zowe configuation setups
    • IBM Z Open Editor MCP Tools
    • Accessibility and Keyboard Shortcuts
    • settings.json properties
    • Message ID Reference
    • Other Visual Studio Code extensions
  • Legal information

    • Notices
    • Trademarks
    • Privacy policy considerations

Creating a configuration profile in Zowe Explorer v3.0.0

Initializing the configuration file

A team configuration profile can be created using Zowe Explorer VS Code Extension or Zowe CLI in the following ways:

Zowe Explorer VS Code Extension

  1. Click the Zowe icon on the left side bar of your VS Code window.

  2. Click the + symbol in tree view of Zowe Explorer.

  3. Select Create a New Team Configuration File when prompted in the input box shown.

  4. If no workspace is opened a global configuration will be created in your ~/.zowe directory and opened in the VS Code text editor. If a workspace is opened a following prompt will be presented for the user to select global or project level config, a project level config will be created in the top level of the workspace. After selecting the appropriate file, the file will be opened in the text editor.

  5. Add host and port properties to the loaded file after creating the configuration file.

Zowe CLI

Run zowe config init --global-config which will prompt for a username and password once the command is issued.

For more information on Zowe team configuration setups, view Example Zowe configurations or Zowe CLI's documentation on Using team profiles.

Validating RSE API version

IBM Z Open Editor

IBM Z Open Editor's Welcome page now includes RSE API version checking. This check runs when an RSE profile is set as the Zowe profile. If the zopeneditor.advancedCapabilities.enableRseApiActivationCheck setting is enabled, the connection check occurs after activation. If the setting is disabled (default), the version check runs when the RSE profile connects to z/OS.

After the version check is initiated, the RSE API version information is displayed on the Open Editor's Welcome page under the Zowe Profile checks section. The check indicates whether the RSE API version is unsupported, supported but missing capabilities, or up to date with the latest capabilities. This information also highlights any missing capabilities, if present.

RSE API Plugin for Zowe CLI

Run zowe rse check version which will check the RSE API version and get upgrade recommendations. The --show-capabilities flag displays a detailed list of capabilities available in the current and recommended versions.

Last Updated: 6/17/26, 3:34 PM
Contributors: Rudy Leonel Pichola Flores, kmaselli, Billie Simmons, phaumer, Esther M
Prev
Interacting with z/OS
Next
Migrating your old Zowe yaml profiles for Zowe v3.0