Connecting to z/OS using Zowe CLI walk through

Creating a Zowe team configuration file

  1. Issue the zowe config init command and you will be prompted for profile information. After responding to the prompts, the zowe.config.json file will be added to your ~/.zowe directory.

    • Run zowe config init --global-config to create a global profile.
    • Run zowe config init --help to learn all options for editing profiles by using a command line.

    Note: This tutorial walks through creating a global profile. User scoped configuration is very similar except that the file is created in your project's folder and is named zowe.user.json. Run zowe config init --user-config to create a profile scoped to your project folder.

  2. If you responded to the prompts to enter a username and password for a mainframe service, your credentials are stored securely on your computer by default.

  3. Open the zowe.config.json file in any text editor that supports JSON files, and then update the host and port values and other information needed in the profiles that are listed in the configuration file.

  4. Fill out the rse or zosmf profile template inside zowe.config.json depending on which type of profile you are creating.

  5. You can also use the command line to set team configuration properties. For example, run zowe config set "" "value" --global-configzowe config set --secure ... to set a secure property.

  6. If username and password were entered in step 1, you can use your profiles to access data sets, z/OS UNIX System Services files and directories, and jobs. If not entered, you will be prompted the first time you run a CLI command. If ‘autoStore:true’ is set in the configuration file, the credentials will be stored securely on your computer.

For more information about team configuration profiles in Zowe, see Zowe CLI documentationopen in new window.

For a Zowe team configuration file example, see here.

Supported authentication methods

Zowe supports many authentication mechanisms and you are not limited to username and password only. For more information, see Supported methods of authentication for z/OS using Zowe.

Last Updated:
Contributors: KRISTINA MAYO, Chun Hong Zheng