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.disableProblems
Disables code problems in the Problems view and editor. It will keep other language features such as Outline view available if possible. It will also disable unreachable code warnings. The default value is false. For more information, see Enabling and disabling problems in IBM Z Open Editor.
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.sequenceNumbers
Choose which columns will have sequence numbers inserted and removed from a file by using the Renumber and Unnumber functions in the COBOL editor. The following values are allowed:
zopeneditor.cobol.sequenceNumbers.column1
: Numbering starts at column 1zopeneditor.cobol.sequenceNumbers.column73
: Numbering starts at column 73zopeneditor.cobol.sequenceNumbers.column1and73
: Numbering starts at column 1 and 73
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.MACLIB
macro 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.disableProblems
Disables code problems in the Problems view and editor. It will keep other language features such as Outline view available if possible. The default value is false. For more information, see Enabling and disabling problems in IBM Z Open Editor.
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.disableProblems
Disables code problems in the Problems view and editor. It will keep other language features such as Outline view available if possible. The default value is false. For more information, see Enabling and disabling problems in IBM Z Open Editor.
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.rexx.disableProblems
Disables code problems in the Problems view and editor. It will keep other language features such as Outline view available if possible. The default value is false. For more information, see Enabling and disabling problems in IBM Z Open Editor.
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.server.startupOptions
Configure additional startup parameters for Java virtual machines started for running language servers. These might have been provided by tech support for troubleshooting. Leave blank by default.
zopeneditor.userbuild.enabled
Enable User Build capabilities that utilize IBM Dependency Based Build. When enabled, you can run a user build to compile and link programs during coding and unit testing simply by right-clicking inside a COBOL, PL/I, or HLASM file.
zopeneditor.userbuild.userSettings
Settings for IBM User Build. See the IBM Documentation for details.
zopeneditor.welcomePage.show
Show the welcome page on VS Code startup.
zopeneditor.zapp.useDefaultOnlineZappSchema
Z Open Editor comes with the built-in ZAPP JSON schema. It can be used for YAML files using Red Hat's YAML VS Code extension, and for JSON files with the built-in editor. If you encounter issues locating this built-in schema on deployments like Eclipse Che, such as being unable to see syntax errors with the Red Hat YAML extension, enable this option to load the schema from the internet.
zopeneditor.zapp.customZappSchemaLocation
When you work offline but have to provide a path to the ZAPP schema yourself, such as in a custom Che deployment, specify a valid HTTP or file URL to the location of the ZAPP JSON schema. If specified, the Use Default Online Zapp Schema option will be ignored.
zopeneditor.zcodeformat.useDefaultOnlineZCodeFormatSchema
Z Open Editor comes with the built-in zCodeFormat JSON schema. It can be used for YAML files using Red Hat's YAML VS Code extension, and for JSON files with the built-in editor. If you encounter issues locating this built-in schema on deployments like Eclipse Che, such as being unable to see syntax errors with the Red Hat YAML extension, enable this option to load the schema from the internet.
zopeneditor.zcodeformat.customZCodeFormatSchemaLocation
When you work offline but have to provide a path to the zCodeFormat schema yourself, such as in a custom Che deployment, specify a valid HTTP or file URL to the location of the zCodeFormat JSON schema. If specified, the Use Default Online zCodeFormat Schema option will be ignored.
zopeneditor.zapp.variables
Use to specify variable names with values that will be substituted in your ZAPP files. To reference a variable defined here in a ZAPP file, write ${variable-name}
. For example, define a variable here called HLQ
with a value that represents your personal high-level qualifier on z/OS MVS. In your ZAPP file, reference the variable in a property group's location entry like this: ${HLQ}.COBOL.COPYBOOKs
. Do not use single or double-quote characters for variable names and values. Note that all users need to define all the variables in their user settings that are used by the ZAPP file to avoid errors. You can place these properties in VS Code user and workspace settings.
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_name>"}
to specify the name of 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": {"defaultSshCliProfile": "<profile_name>"}
to specify the name of the Zowe CLI SSH profile used for remote execution of commands on UNIX System Services of your z/OS system. If no valid profile name is provided, the default SSH profile will be used.
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.
Use the boolean setting "zopeneditor.zowe": {"listBeforeDownload": "<true-or-false>"}
to modify Z Open Editor's behavior when requesting a file from MVS: - When the setting is set to true
, the editor will first try to confirm that whether the requested file actually exists by performing a list operation for that file. If the requested file exists, the editor will send another request to download it. If the requested file does not exist, the editor will move on to test the next location listed in the property group. - When the setting is set to false
, the editor will directly try to download the file from MVS without checking whether it actually exists. If the response from z/OS is a Not Found error, the editor will move on to the next location listed in the property group. In some cases when using z/OSMF as the protocol, this Not Found error will cause entries in z/OS log files, which you can avoid by specifying the value of the setting to true
. However, this extra round-trip to the server to check the existence will have performance impact. Because the logging is not an issue when using the RSE API protocol and because of the performance advantage, the default value for this setting is false
.
Use the integer setting "zopeneditor.zowe": {"maximumParallelFileDownloads": "<1-to-10>"}
to specify how many parallel downloads Z Open Editor should perform when requesting include files from MVS. Downloading several files in parallel can significantly improve performance, especially when you edit programs with many include files. The downside is that some protocols such as z/OSMF will allocate more address spaces for the parallel requests, which causes more resources being used and more logging on the z/OS side. The RSE API protocol does not have that problem because it achieves scalability in other ways that are documented in the RSE documentation. The default value for this setting is 5, and the maximum value is 10. Set it to 1 to disable parallel downloads requesting one include file at the time.
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.