settings.json properties

You can control the characteristics of your environment by setting the following preferences in settings.json by using the JSON editor. For more information, see Accessing settings for IBM Z Open Editor.

List of settings.json properties

[cobol]

Use "[cobol]": {"editor.rulers": [array]} to set rulers for COBOL in the editor. array is an array of numbers representing the column numbers at which you want a ruler to appear. For more information, see Setting language specific tab stops and rulers.

[hlasm]

Use "[hlasm]": {"editor.rulers": [array]} to set rulers for HLASM in the editor. array is an array of numbers representing the column numbers at which you want a ruler to appear. For more information, see Setting language specific tab stops and rulers.

[jcl]

Use "[jcl]": {"editor.rulers": [array]} to set rulers for JCL in the editor. array is an array of numbers representing the column numbers at which you want a ruler to appear. For more information, see Setting language specific tab stops and rulers.

[pl1]

Use "[pl1]": {"editor.rulers": [array]} to set rulers for PL/I in the editor. array is an array of numbers representing the column numbers at which you want a ruler to appear. For more information, see Setting language specific tab stops and rulers.

[rexx]

Use "[rexx]": {"editor.rulers": [array]} to set rulers for REXX in the editor. array is an array of numbers representing the column numbers at which you want a ruler to appear. For more information, see Setting language specific tab stops and rulers.

files.associations

Specifies file names, including data set and member names, that contain certain strings as the appropriate type of file. For detailed usage, see Setting file associations.

zopeneditor.cobol.enableUnreachableCodeWarnings

Enables unreachable code warnings in the COBOL programs. For more information, see Enabling and disabling unreachable COBOL code warnings.

zopeneditor.cobol.includeFileExtensions

Specifies a list of file name extensions for COBOL include files. For more information, see Defining Include file associations.

zopeneditor.cobol.maximumLineLength

Provides a maximum line length for the COBOL editor. This setting will allow the editor to truncate all text after the provided column number while saving a document. To disable truncation of characters, set maximum line length to -1. For more information, see Setting language-specific maximum line length.

zopeneditor.cobol.tabstops

Adds custom COBOL tab stops in the editor. For more information, see Setting language specific tab stops and rulers.

zopeneditor.datasets

Specifies data set names that should contain COBOL or PL/I programs, copybooks, include files, and JCL. For detailed usage, see Setting file associations.

zopeneditor.enforceCaseSensitiveIncludeFileNames

Enforce case-sensitive matching of local copybooks and include file names in property groups. Default is false to match files with all cases in the path. Set it to true to avoid ambiguous matching on case-insensitive file systems.

zopeneditor.hlasm.enableResolvingMacros

Enables the automatic resolution of SYS1.MACLIBmacro files from MVS using your Zowe Exlorer profiles. See the Remote Macros section for more details. The default value is false. To use this feature, you need to enable it.

zopeneditor.hlasm.includeFileExtensions

Specifies a list of file name extensions for HLASM include files. For more information, see Defining Include file associations.

zopeneditor.hlasm.instructionsFilePath

Allows you to specify a custom HLASM instructions file. Contact IBM Support for questions about the format of such a file or updates to our out of the box file, for example, for a new hardware versions.

zopeneditor.hlasm.macrosFilePath

Allows you to specify a custom macro definitions file. This option is currently used internally only, but the schema for this format will be provided in a future release so that users can provide their own custom macro references.

zopeneditor.hlasm.maximumLineLength

Provides a maximum line length for the HLASM editor. This setting will allow the editor to truncate all text after the provided column number while saving a document. To disable truncation of characters, set maximum line length to -1. For more information, see Setting language-specific maximum line length.

zopeneditor.hlasm.tabstops

Defines custom HLASM tab stops in the editor. For more information, see Setting language specific tab stops and rulers.

zopeneditor.hlasm.zosMacrosVersion

Defines the version of z/OS to use for macro definitions. This allows for more accurate results for the hover and code completion features in HLASM. For more information, see Remote Macros.

zopeneditor.JAVA_HOME

Specifies a different Java for IBM Z Open Editor other than the default of your computer. For more information, see section Selecting the Java installation to use in Getting started.

zopeneditor.jcl.maximumLineLength

Provides a maximum line length for the JCL editor. This setting will allow the editor to truncate all text after the provided column number while saving a document. To disable truncation of characters, set maximum line length to -1. For more information, see Setting language-specific maximum line length.

zopeneditor.logger

Enables a logging output. See Troubleshooting using log files for details.

zopeneditor.pl1.includeFileExtensions

Specifies a list of file name extensions for PL/I include files. For more information, see Defining Include file associations.

zopeneditor.pl1.maximumLineLength

Provides a maximum line length for the PL/I editor. This setting will allow the editor to truncate all text after the provided column number while saving a document. To disable truncation of characters, set maximum line length to -1. For more information, see Setting language-specific maximum line length.

zopeneditor.propertygroups

Defines how the COBOL, PL/I, and HLASM editors look for component files such as copybooks and include files when you edit a program. For detailed usage, see Setting property groups.

zopeneditor.rexx.maximumLineLength

Provides a maximum line length for the REXX editor. This setting will allow the editor to truncate all text after the provided column number while saving a document. To disable truncation of characters, set maximum line length to -1. For more information, see Setting language-specific maximum line length.

zopeneditor.server.memoryAllocation

Specifies the maximum value of the memory that language servers are allowed to allocate. For more information, see section Configuring the Java memory allocation in Getting started.

zopeneditor.zowe

The zopeneditor.zowe setting can be used at a user or workspace level. Typically every user specifies these in their user settings using their personal profile names. If defined in workspace settings then it is assumed that all users of this workspace have defined the same standardized profile names on their systems. If set at both levels, the user and workspace level, the workspace level will override the user level.

Use "zopeneditor.zowe": {"defaultCliProfile": "profile"} to specify the profile you want to use for IBM Z Open Editor operations. If this is not defined, IBM Z Open Editor follows the precedence rules described in Setting up and using RSE profiles in IBM Z Open Editor to identify which CLI profile to use.

Use "zopeneditor.zowe": {"defaultRseConversionMappingsFile": "<absolute pathname>"} to specify the path to a valid RSE API mappings file or ZAPP file that contains RSE API mappings. These mappings will be used for Zowe Explorer MVS file content read/write operations for RSE API profiles. Note, that property groups for remote include file resolution and user build will not use this setting, but look for a workspace-local ZAPP file or if not found, a mappings file in the user's .zowe/profiles/rse directory.

zowe.files.temporaryDownloadsFolder.cleanup

The zowe.files.temporaryDownloadsFolder.cleanup setting is adopted from Zowe Explorer settings to support the use of multiple VS Code windows showing the same files opened via Zowe Explorer so you can see different parts of the same program on two different screens. Note that disabling the cleanup will result in files downloaded from z/OS not being removed when the editor is closed or restarted, so when you open a file via Zowe Explorer you may be viewing an outdated local version. Use the right-click "Pull from Mainframe" command to ensure you are working with the latest files.

Last Updated:
Contributors: Shi Kun Li, Peter Haumer, Lauren Li, Bradley Knaysi, Lauren Li, kmaselli, Min Huang, Saile, Billie Jean Simmons