Skip to main content
Version: v1.28.x LTS

IBM® IMS™ Plug-in for Zowe CLI

IBM® IMS™ Plug-in for Zowe CLI

The IBM IMS Plug-in for Zowe CLI lets you extend Zowe CLI such that it can interact with IMS resources (regions, programs and transactions). You can use the plug-in to start, stop, and query regions and start, stop, query, and update programs and transactions.

Note: For more information about IMS, see IBM Information Management System (IMS) on the IBM Knowledge Center.


Use cases

As an application developer or DevOps administrator, you can use IBM IMS Plug-in for Zowe CLI to perform the following tasks:

  • Refresh IMS transactions, programs, and dependent IMS regions.
  • Deploy application code into IMS production or test systems.
  • Write scripts to automate IMS actions that you traditionally perform using ISPF editors, TSO, and SPOC.


For detailed documentation on commands, actions, and options available in this plug-in, see our Web Help. It is available for download in three formats: a PDF document, an interactive online version, and a ZIP file containing the HTML for the online version.

Software requirements

Before you install the plug-in, meet the software requirements in Software requirements for Zowe CLI plug-ins.


Use one of the following methods to install or update the plug-in:

Creating user profiles

You can set up an ims profile to retain your credentials, host, and port name. You can create multiple profiles and switch between them as needed. Issue the following command to create an ims profile:

zowe profiles create ims-profile <profileName> --host <hostname> --port <portnumber> --ims-connect-host <ims-hostname> --ims-connect-port <ims-portnumber> --user <username> --password <password>

Example: Setting up an IMS profile

The following example creates an ims profile named 'ims123' to connect to IMS APIs at host zos123 and port 1490. The name of the IMS plex in this example is 'PLEX1' and the IMS region we want to communicate with has a host of zos124 and a port of 1491:

zowe profiles create ims-profile ims123 --host zos123 --port 1490 --user ibmuser --password myp4ss --plex PLEX1 --ich zos124 --icp 1491

Note: For more information, issue the command zowe profiles create ims-profile --help.