ChangeMan ZMF Plug-in for ZOWE CLI lets you interact with ChangeMan ZMF systems on the mainframe in a familiar zowe command line format. If you are already familiar with the Zowe CLI, you will find the ZMF Plugin-in very familiar to work with.

ZMF CLI commands can be entered and executed in a script written in Python (for example) to perform a variety of downstream business functions.

Minimum Requirements


Before installing the ChangeMan ZMF Plug-in for Zowe CLI, the following pre-requisites are necessary to be installed. 

  1. zowe cli version 6.31 or later. If you do not yet have zowe cli installed, follow the instructions found on the zowe website - Installing Zowe CLI | Zowe Docs
  2. Version 8.2 Patch 5 (with the following hotfixes) or a higher release.
    1. ZMF 
    2. ZMF 
    3. ZMF 
    4. Sernet 
    5. ChangeMan ZMF REST Services version 8.2 Patch 5 build number 114 or higher.  


Download the ChangeMan ZMF Plug-in for Zowe CLI and save the .tgz file to a local directory of your choice. From that local directory, install the plugin using the zowe plugins l command. where n.n.n is the version of the .tgz file downloaded.

zowe plugins install microfocus-zmf-cli-plugin-n.n.n.tgz

The plugin will be installed. All ZMF Plugin commands use changeman-zmf as the top level group name - or the abbreviation of zmf and can be tested by issuing the following command to display ZMF CLI help

zowe zmf -h

This command will then display the next level of available ZMF command. this level always presents a verb - get, checkin, checkout etc. As with Zowe CLI, each level of subcommand has the available help option by appending the parameter. Example: zowe zmf get -h

As there are a number of ZMF cli commands available, To help in identifying the required parameters for each command,, you can generate web help by issuing the command:

zowe --hw This will generate all the help files and display in a browser. The location of the web help will depend on your platform. As new versions of the ChangeMan ZMF Plug-in CLI are released, you should regenerate the web help to pick up new documented features. See screenshot for sample web help.


Please refer to the REST Services Getting Started Guide and the browser based REST prototyping tool for details on the REST services. as the ZMF CLI uses the exact parameter format as defined in that Guide. Also refer to the ZMF XML Services Guide for more information on individual parameters.

Before attempting to use the ChangeMan ZMF plug-in for Zowe CLI, it is necessary to create a profile for each ZMF subsystem that you wish to execute ZMV CLI commands against.

Profile creation is a standard zowe cli function and details can be found here: Using Zowe CLI | Zowe Docs.

For example to create a profile with the name U830ALL using the host zos123 with secure SSL port 1234 and a basepath URI of /zmfrest, userid of ibmuser and password myp4ss and setting rejectunauthorised to false
zowe profiles create zmf-profile U830ALL -H zos123 -P 1234 --pr https --bp /zmfrest -u ibmuser --pass myp4ss --ru false

You may specify a protocol of either http or https but ensure that the port number that you specified is correct for that protocol. Note that using an HTTPS port will require require that you have AT-TLS set up and configured on your mainframe host. Refer to the IBM AT-TLS documentation on configuring AT-TLS for your specific environment. In particular ensure the ciphers are defined correctly.

Also zowe provides a very good write up on how to configure AT-TLS for an SSL environment. Configuring Zowe Application Framework | Zowe Docs

An example ZMF CLI command :

zowe zmf browse pcomp -c CBLDB201 -t SRC -p STEV001571


pcomp = Browse Package Component - the related REST service using the prototyping tool is /component/browsepackage
-c = Component
-t = Component Type
-p = Package

Alternatively, you my use the long form of the command:

zowe changemanzmf browse packagecomponent --component CBLDB201 --componenttype SRC --package STEV001571

Note that the fields are case sensitive.

The ZMF cli plug-in returns output to the screen. This will either be a string -.e..g. a source component, or a JSON object. Typically, using a script, the output would be piped to a local file and post processed.

A simple example python script screen shot can be seen above, which demonstrates retrieving a component and its associated copybooks and saves them to a local directory. Post processing of those files can then take place outside of ZMF.


In preparation for the release of zowe V2, a number of changes have been made to the ZMF cli plugin.
- This version has now isolated text so that in the future the ZMF cli plugin can be internationalized when zowe provides this functionality.
- Some of thje ZMF commands have been simplified. This has been done to provide for future expansion and additional new commands. If ytou use any of these commands, , please modify your scripts to use the new command format. None of the command parameters have changed.

Existing command | abbrev New command | abbrev
package-audit | pa package | pkg
component-build | cbld component | comp
component-checkin | cci component | comp
component-checkout | cco component | comp
package-demote | pd package | pkg
package-freeze | pf package | pkg
component-lock | cl component | comp
package-promote | pp package | pkg
component-recompile | cr component | comp
package-refreezenonsource | prfns nonsource | ns
package-refreezeparameters | prfp parameters | parm
package-refreezesite | prfs site | s
package-refreezesource | prfsrc source | src
package-refreezeutility | prfu utility | util
package-revert | pr package | pkg
package-unfreezenonsource | pufns nonsource | ns
package-unfreezeparameters | pufp parameters | parm
package-unefreezesite | pufs site | s
package-unfreezesource | pufsrc source | src
package-unfreezeutility | pufu utility | util
component-unlock | cu component | comp

The following GET comands have been moved to BROWSE
component-browse | cb component | comp
component-browsebaseline | cbb baselinecomponent | bcomp
compoennt-browsepackage | cbp packagecomponent | pcomp

An example :
zowe zmf get cbp -p STEV001571 -c CBLDB201 -t SRC
now becomes:
zowe zmf browse pcomp -p STEV001571 -c CBLDB201 -t SRC

If you wish to review the upcoming changes in zowe V2 please refer to Zowe
A major change in zowe v2 relates to profiles which will involve some significant but beneficial changes to both profile management and security. Also included with zowe V2 are potential performance gains.

For a complete list of all the ZMF CLI plugin commands and their parameters, run the zowe --hw command to generate online web help.


Fixed an issue with the license file not being displayed correctly.
Implemented changes in readiness for supporting zowe V2.


This version adds further command line interface support for the following Package functions:

  • Audit
  • Freeze
  • Promote
  • Unfreeze
    - non source
    - parameters
    - sites
    - source
    - utility
  • Refreeze
    - non source
    - parameters
    - sites
    - source
    - utility

To regenerate online web help, issue the following: zowe --hw


- Added support for a single persistent session to be established. This is achieved by issuing:
- zowe zmf session zl command. This will return a 200 if successful and a token generated.
- followed by some number of intervening commands. Token usage is transparent.
- finally terminate the session with a zowe zmf session zf command.

However, it is possible for such a session to time out which would invalidate the token. in which case a subsequent command would return a 401 error and a message of 'No Credentials".
This would then require a new zowe zmf session zl command to be reissued to establish a new token.


Support for the ChangeMan ZMF Plug-in for Zowe CLI is available on the Micro Focus Community page for ChangeMan ZMF.

Please do not go through the normal Support channels for this component.

Suggested apps

Suggested for you are based on app category, product compatibility, popularity, rating and newness. Some apps may not show based on entitlements. Learn more about entitlements.


ChangeMan ZMF Plug-in for Zowe CLI 1.0.5
91.1 KB
Jan 11, 2022
More info Less info
Product compatibility
Version 8.2.5
Release notes

Internationalized text in advance of zowe support for Internationalizatrion.
Further structural changes in support of zowe V2.
Simplified some commands for ease of use. Refer to the changelog for details.

ChangeMan ZMF Plug-in for Zowe CLI 1.0.4
68.8 KB
Dec 16, 2021
More info Less info
Product compatibility
Version 8.2.5
Release notes

Resolved an issue with the license file not being displayed correctly.
Internal structure changes ahead of the upcoming release of zowe V2.

ChangeMan ZMF Plug-in for Zowe CLI 1.0.3
68.1 KB
Nov 24, 2021
More info Less info
Product compatibility
Version 8.2.5
Release notes

Added additional REST api calls related to Package functions.

ChangeMan ZMF Plug-in for Zowe CLI 1.0.2
56.5 KB
Jul 27, 2021
More info Less info
Product compatibility
Version 8.2.5
Release notes

ChangeMan ZMF Plug-in for Zowe CLI

Release 1.0.2

Added support for a single persistent session to be established. This is achieved by issuing:
zowe zmf session zl command. This will return a 200 if successful and a token generated.
- followed by some number of intervening commands. Token usage is transparent.
- finally terminate the session with a zowe zmf session zf command.

However, it is possible for such a session to time out which would invalidate the token. in which case a subequent command would return a 401 error and a message of 'No Credentials".

This would then require a new zowe zmf session zl command to be reissued to establish a new token.

ChangeMan ZMF Plug-in for Zowe CLI 1.0.1
50.8 KB
Jun 25, 2021
More info Less info
Product compatibility
Version 8.2.5
Release notes

ChangeMan ZMF Plug-in for Zowe CLI

Release 1.0.1

Fixed an issue specifically to running the ZMF Plug-in on a Linux system

ChangeMan ZMF Plug-in for Zowe CLI 1.0.0
50.8 KB
Jun 16, 2021
More info Less info
Product compatibility
Version 8.2.5
Release notes

ChangeMan ZMF Plug-in for Zowe CLI

Release 1.0.0

Initial release of the ChangeMan ZMF Plug-in for Zowe CLI


Unsubscribe from notifications

You are receiving release updates for this item because you have subscribed to the following products:
If you unsubscribe, you will no longer receive any notifications for these products.
Tip: to update your subscription preferences, go to Manage Subscriptions from your Dashboard, uncheck the products you no longer want to receive notifications for, and click 'Save'.

Marketplace Terms of Service

In order to continue, you must accept the updated Marketplace Terms of Service
Since you are downloading an app from the Micro Focus Marketplace, you need to accept the updated Marketplace Terms of Service before you can continue. Use the link to review the Marketplace Terms of Service. Once complete check the, "I accept the Marketplace Terms of Service" box below and click accept to continue your download.

Your download has begun...

Your download has begun

Related content and resources

Your browser is not supported!

Please upgrade to one of the following broswers: Internet Explorer 11 (or greater) or the latest version of Chrome or Firefox

release-rel-2022-1-1-4548 | Wed Jan 19 06:11:08 PST 2022