Skip to main content
Version: v1.5.x

Zowe CLI quick start

Get started with Zoweâ„¢ CLI quickly and easily.

Note: This section assumes some prerequisite knowledge of command-line tools and writing scripts. If you prefer more detailed instructions, see Installing Zowe CLI.

Installing#

Before you install Zowe CLI, download and install Node.js and npm.

Installing Zowe CLI core#

npm config set @brightside:registry https://api.bintray.com/npm/ca/brightside
npm install @brightside/core@lts-incremental -g

Installing CLI plug-ins#

zowe plugins install @brightside/cics@lts-incremental @brightside/db2@lts-incremental

The command installs the IBM CICS plug-in, but the IBM Db2 plug-in requires additional configuration to install.

For more information, see Installing plug-ins.

Issuing your first commands#

Issue zowe --help to display full command help. Append --help (alias -h) to any command to see available command actions and options.

To interact with the mainframe, type zowe followed by a command group, action, and object. Use options to specify your connection details such as password and system name.

Listing all data sets under a high-level qualifier (HLQ)#

zowe zos-files list data-set "MY.DATASET.*" --host my.company.com --port 123 --user myusername123 --pass mypassword123

Downloading a partitioned data-set (PDS) member to local file#

zowe zos-files download data-set "MY.DATA.SET(member)" -f "mylocalfile.txt" --host my.company.com --port 123 --user myusername123 --pass mypassword123

See Command Groups for a list of available functionality.

Using profiles#

Zowe profiles let you store configuration details such as username, password, host, and port for a mainframe system. Switch between profiles to quickly target different subsystems and avoid typing connection details on every command.

Profile types#

Most command groups require a zosmf-profile, but some plug-ins add their own profile types. For example, the CICS plug-in has a cics-profile. The profile type that a command requires is defined in the PROFILE OPTIONS section of the help response.

Tip: The first zosmf profile that you create becomes your default profile. If you don't specify any options on a command, the default profile is used. Issue zowe profiles -h to learn about listing profiles and setting defaults.

Creating a zosmf profile#

zowe profiles create zosmf-profile myprofile123 --host my.company.com --port 123 --user myusername123 --password mypassword123

Note: The port defaults to 443 if you omit the --port option. Specify a different port if your host system does not use port 443.

Using a zosmf profile#

zowe zos-files download data-set "MY.DATA.SET(member)" -f "mylocalfile.txt" --zosmf-profile myprofile123

For detailed information about issuing commands, using profiles, and storing variables as environment variables, see Defining Zowe CLI connection details.

Writing scripts#

You can write Zowe CLI scripts to streamline your daily development processes or conduct mainframe actions from an off-platform automation tool such as Jenkins or TravisCI.

Example:#

You want to delete a list of temporary datasets. Use Zowe CLI to download the list, loop through the list, and delete each data set using the zowe zos-files delete command.

#!/bin/bash
set -e
# Obtain the list of temporary project data sets
dslist=$(zowe zos-files list dataset "my.project.ds*")
# Delete each data set in the list
IFS=$'\n'
for ds in $dslist
do
echo "Deleting Temporary Project Dataset: $ds"
zowe files delete ds "$ds" -f
done

For more information, see Writing scripts to automate mainframe actions.

Next Steps#

You successfully installed Zowe CLI, issued your first commands, and wrote a simple script! Next, you might want to: