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
    • PL/I macro preprocessor
    • 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 Zowe profiles
    • 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)
    • User build with customizable tasks
    • 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

    • PL/I Compiler Options Support 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 configuration setups
    • IBM Z Open Editor MCP Tools
    • GRUB Scripts - Git remote user build
    • Accessibility and Keyboard Shortcuts
    • settings.json properties
    • Message ID Reference
    • Other Visual Studio Code extensions
  • Legal information

    • Notices
    • Trademarks
    • Privacy policy considerations

Overview

IBM Z® Open Editor v4 and later features enterprise-level advanced capabilities that support use cases that go beyond programming and basic access to z/OS resources. These capabilities are available through IBM commercial zDevOps solutions, such as IBM Developer for z/OS Enterprise Edition (IDzEE). While the core Z Open Editor experience continues to provide free full language support for COBOL, PL/I, REXX, HLASM, JCL, and integrations with Zowe™ Explorer, these advanced capabilities require the purchase of additional components and licenses to activate.

You can purchase the required licenses through IBM Developer for z/OS Enterprise Edition, IBM Developer for z/OS Select, or IBM Application Delivery Foundation for z/OS.

All new users of Z Open Editor receive a 90-day evaluation trial for all the advanced capabilities. After the trial period, these capabilities require activation through either an RSE API server connection or imported activation kits, as described in Activating advanced capabilities. Only the following capabilities documented in this section require such a license.

Capability categories

Advanced capabilities are categorized based on their setup requirements:

  • Client-only capabilities: Run entirely within the VS Code client, with no external dependencies.
  • Host component capabilities: Require a Zowe connection profile (z/OSMF or RSE API server) for full functionality.

Capabilities available with IBM® Developer for z/OS® Select

The following capabilities are available with IBM® Developer for z/OS® Select as well as IBM Developer for z/OS Enterprise Edition (IDzEE), IBM Application Delivery Foundation for z/OS (ADFz), and IBM Bob™ Premium Package for Z (PPZ).

  1. Remote Connection Emulator: Open a 3270 emulator hosted on the RSE API server by right-clicking a Zowe Explorer RSE API profile. The emulator opens either in a VS Code panel or an external browser, depending on your preference.
  2. z/OS Resources table: A feature-rich view that extends Zowe Explorer with a sortable table. Gain insights into your jobs, data sets, and UNIX files by listing, filtering, and sorting on many available properties.
  3. Data Elements view: Use this view to display information about the data elements in a COBOL or PL/I program, including those from copybooks and include files, in a table that can be sorted and filtered.
  4. Program Control Flow Browser: Use this view to display the control flow of a COBOL or PL/I program in an interactive graph.
  5. Data Flow Browser for COBOL: Display the data flow of a data element in a COBOL program using an interactive graph. You can use this feature to examine how a data element is populated, modified, or written elsewhere.
  6. Preprocessor support for COBOL and PL/I: Run a preprocessor either on a local workstation or remotely on z/OS, driven by a new ZAPP profile type. Continue to edit with full syntax checks except for the preprocessor statements, and automatically rerun the preprocessor each time you save. Compare the preprocessor-generated code with the original code side-by-side.
  7. HLASM macros support: Use custom macro resolution in HLASM programs with references to macros in local files and remote data sets. The HLASM editor provides hovers, document links, go to definition, and code completion for macros. This capability supports one or more macro declarations per include file by pre-scanning macro files, provided they are found in local ZAPP property groups. Remote macros can only be found when using an RSE API connection as your default Zowe Explorer profile.
  8. Language Detection for data set members: Use Zowe Explorer with RSE API profiles to detect the programming language of a data set member opened in the editor.
  9. Line Hex Editor: View and edit the raw hexadecimal representation of a sequential data set or PDS member. Use this capability to work with binary and EBCDIC-encoded content at the byte level without leaving VS Code.

Client-side and host-enabled capabilities

The following table shows the client-side and host-enabled capabilities available with these offerings.

CapabilityClient-sideZowe profile requirement
Remote Connection Emulator-RSE API only (not included in PPZ)
z/OS Resources table-RSE API or z/OSMF
Data Elements view✅-
Program Control Flow Browser✅-
Data Flow Browser for COBOL✅-
Preprocessor support for COBOL and PL/I✅RSE API or z/OSMF
HLASM macros support-RSE API and limited z/OSMF (no code completion for macros)
Language Detection for data set members-RSE API only (not included in PPZ)
Line Hex Editor-RSE API or z/OSMF

Note: Preprocessor support for COBOL and PL/I can run entirely in the VS Code client without a z/OS connection, or remotely on z/OS when a Zowe profile is available.

Additional capabilities available in other products

The following capabilities are available with with IBM Developer for z/OS Enterprise Edition (IDzEE), IBM Application Delivery Foundation for z/OS (ADFz), and IBM Bob Premium Package for Z (PPZ).

  1. Linting with IBM ZCodeScan: Helps developers scan COBOL and PL/I program files for best practice violations and security vulnerabilities, and it presents the results in a linter-like format.
  2. Dependency Based user build and advanced error reporting: Run a build of COBOL, PL/I, HLASM programs on a remote z/OS system through a right-click in Z Open Editor. Review informational, warning, or error messages issued by the compiler directly in the VS Code Problems view. Z Open Editor automatically downloads the build logs, parses them, and presents the messages in the Problems view with descriptions and error codes. Then navigate to warnings and errors in the code using a mouse, click in the Problems view to identify and resolve issues, and then rerun the build.
  3. User build with customizable tasks: Create a flexible build pipeline by using individually configurable tasks in a userbuild profile defined in the zapp.yaml file. Each task can perform built-in actions, run a local script, or invoke a remote command on z/OS. Use the included GRUB scripts to synchronize only changed files with z/OS through Git instead of uploading all dependencies during every build. This approach supports any programming language and enables post-build activities, such as deployment or testing, directly from VS Code.
  4. Agent Mode: Use Z Open Editor's MCP (Model Context Protocol) server within an Agent-based AI chat panel in VS Code. This setup provides the panel with context and data from your z/OS data sets, files, and jobs through Zowe APIs, along with Z Open Editor configuration files to assist in troubleshooting your environment.

Client-side and host-enabled capabilities

In addition to the previously listed capabilities, IBM Developer for z/OS Enterprise Edition, IBM Application Delivery Foundation for z/OS, and IBM Bob Premium Package for Z provide the following advanced capabilities.

The following capabilities require a Zowe connection profile and additional dependencies.

CapabilityZowe profile requirementAdditional dependencies
Linting with IBM ZCodeScanRSE API only
  • RSE API server must be registered as IDzEE or ADFz.
  • Requires PARMLIB(IFAPRDxx) enablement.
  • Requires SMF 122 record collection.
  • IDz host linked to RSE API through the RSEENV configuration file.
User build with IBM Dependency Based BuildRSE API or z/OSMF
  • Build requires zExplorerExtension for ELAXMGUX.
User build with customizable tasksRSE API or z/OSMFNone
Agent ModeRSE API or z/OSMF
  • Requirements vary depending on the MCP tools in use.
Last Updated: 9/10/26, 11:36 AM
Contributors: PETER HAUMER, phaumer, Hestia Zhang, Benjamin Santos, Saile Daimwood, Ethan Mendel, Prasang Prajapati, Vinithanjali Selvaraj, Esther M, Peter Moogk, Jesse Burnett, Ankit Kumar, Pratima .
Next
Activating advanced capabilities