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

Sharing team configuration files

Team configuration files can be shared with others using a git project. For faster setup, a team lead can include a team configuration file with connection details in the code repository without any secure values. Each developer would enter their own secure values once they start using profiles. A team configuration file needs to be at the top level of project so that it can be read correctly in VS Code. An important thing to note is in order for the configuration profile to work properly the zowe.schema.json file needs to be included in the same folder as the team configuration profile.

Take a look at the location where your team configuration file resides.

  • If you created a global zowe.config.json, it was placed in ~/.zowe folder.
  • If you created a user configuration file scoped to 1 repository zowe.config.user.json, it was placed inside that repository.

In both cases, a zowe.schema.json file should have been automatically created and placed in the same folder. If the schema file is missing, team configuration files will not work. The schema file has definitions of the supported profile attributes. If you add an extender, such as RSE CLI plug-in, the extender will update the schema file to support new profile types. Therefore, make sure to share both the team configuration file and the zowe.schema.json file.

For more information about methods for sharing team configuration files, see Zowe documentation.

Troubleshooting tips

You might encounter a situation where the zowe.schema.json file is not automatically updated by the extender, and extender profiles are not working. To verify, open the schema file and check for your extender definitions.

  • Use zowe config update-schemas to manually update the schema.
  • Use zowe config update-schemas --help for more options.

If your schema file is missing, the easiest solution is to re-create the team configuration file by using Zowe Explorer or Zowe CLI, and then the schema file will be automatically created in the same location.

Last Updated: 6/23/25, 10:10 AM
Contributors: KRISTINA MAYO, Chun Hong Zheng, PETER HAUMER, phaumer, Benjamin Santos, Esther M
Prev
Supported methods of authentication for z/OS using Zowe
Next
Connecting to z/OS with Zowe Explorer walk through