Team configuration for application developers
Team configuration for application developers
As an application developer or Zowe CLI user, you want to manage your connection details efficiently and in one location.
That could mean relying on a team configuration file, or creating your own user configuration file.
To create your own user configuration, start with a global team configuration file that you have created or was provided to you. In this way, a single global configuration can become the basis for multiple user-specific configurations that are created with modifications tailored to particular requirements.
Initializing user configuration
As an application developer, you can optionally generate a user configuration file that overrides the values defined in the global zowe.config.json
file. (See How Zowe CLI uses configurations for more information.)
Follow these steps:
-
To generate a team configuration file (
zowe.config.json
) that you can use globally, issue the following command:zowe config init --global-config
-
To generate the global user profile configuration file
zowe.config.user.json
, issue the following command:zowe config init --global-config --user-config
In your user file (
zowe.config.user.json
), observe that the profiles do not have properties and the "defaults" object is empty, as illustrated in the following example. Use a text editor or IDE (such as Visual Studio Code) to add your connection details as properties here to override properties inzowe.config.json
, or to add new connections."$schema": "./zowe.schema.json",
"profiles": {
"zosmf": {
"type": "zosmf",
"properties": {},
"secure": []
},
"tso": {
"type": "tso",
"properties": {},
"secure": []
},
"ssh": {
"type": "ssh",
"properties": {},
"secure": []
},
"base": {
"type": "base",
"properties": {},
"secure": []
}
},
"defaults": {},
"autoStore": true
}
Editing team configurations
After creating a team configuration file, you can define additional mainframe services, and other profiles, to the configuration.
Follow these steps:
-
Open the
~/.zowe/zowe.config.json
file in a text editor or an IDE (such as Visual Studio Code) on your computer. -
Edit the file by adding or modifying the profiles stored there.
The profiles object contains connection and other frequently needed information for accessing various services, as in the following example:
{
"$schema": "./zowe.schema.json",
"profiles": {
"zosmf": {
"type": "zosmf",
"properties": {
"port": 443
}
},
"base": {
"type": "base",
"properties": {
"host": "example1.com"
},
"secure": [
"user",
"password"
]
}
},
"defaults": {
"zosmf": "zosmf",
"base": "base"
},
}