Turn Off Tabs
Serena ChangeMan ZMF Connector 6.1.2 Readme
This readme file contains information about this release. Last updated on 2017-07-12.

Contents

About this Release

Welcome to ChangeMan ZMF Connector 6.1.2.

ChangeMan ZMF Connector is a flexible set of services and programs that can be used from Windows or UNIX/Linux platforms to deploy to z/OS through ChangeMan ZMF.

  • ChangeMan ZMF integration with Release Control 6.0.1 and above is implemented through the Release Control ChangeMan ZMF plugin and ZMF Connector.
Note: There are additional ways to integrate Serena products with ChangeMan ZMF using ZMF Connector. For help with custom integrations, contact Serena Services.

Documentation References

  • Refer to the ChangeMan ZMF Connector Configuration Guide for configuration details.
  • Refer to Documentation Center for the most current documentation.
  • Refer to the What's New tab for a complete list of new features in this release.

Supported Configurations

The following tables give the supported configurations for versions of ZMF Connector from 6.0 to current.

Supported ChangeMan ZMF Versions

ChangeMan ZMF Version Support Level Plugin Versions ZMF Connector Version
ChangeMan ZMF 8.1.2 Certified Release Control ZMF Plugin 2.2 ZMF Connector 6.1.2
ChangeMan ZMF 8.1.1.01 Certified

Release Control ZMF Plugin 2.2

Release Control ZMF Plugin 2.1

Release Control ZMF Plugin 2.0

ZMF Connector 6.1.2

ZMF Connector 6.1.1

ZMF Connector 6.1

ChangeMan ZMF 8.1.0 Certified

Release Control ZMF Plugin 2.2

Release Control ZMF Plugin 2.1

Release Control ZMF Plugin 2.0

Release Control ZMF Plugin 1.0

ZMF Connector 6.1.2

ZMF Connector 6.1.1

ZMF Connector 6.1

ZMF Connector 6.0

ChangeMan ZMF 7.1.3 Certified

Release Control ZMF Plugin 2.2

Release Control ZMF Plugin 2.1

Release Control ZMF Plugin 2.0

Release Control ZMF Plugin 1.0

ZMF Connector 6.1.2

ZMF Connector 6.1.1

ZMF Connector 6.1

ZMF Connector 6.0

ChangeMan ZMF 6.1.x Unsupported N/A N/A

Supported Serena Common Tomcat Versions

ChangeMan ZMF Version Support Level
Serena Common Tomcat 8.0 64-bit Certified

Supported Release Control Versions

Release Control Version Support Level ZMF Connector Version
Release Control 6.1.0.1 (Patch) Certified ZMF Connector 6.1.2
Release Control 6.1.0.1 (Patch) Certified ZMF Connector 6.1.1
Release Control 6.1 Certified ZMF Connector 6.1
Release Control 6.1 Certified ZMF Connector 6.0
Release Control 6.0.1.1 (Patch) Certified ZMF Connector 6.1.2
Release Control 6.0.1.1 (Patch) Certified ZMF Connector 6.1.1
Release Control 6.0.1 Certified * ZMF Connector 6.1
Release Control 6.0.1 Certified ZMF Connector 6.0
Release Control 6.0 Supported ZMF Connector 6.1
Release Control 6.0 Supported ZMF Connector 6.0

* If you want to use Release Control 6.0.1 with ZMF Connector 6.1, which is necessary only if you have ChangeMan ZMF 8.1.1.x, please refer to Serena Support Knowledgebase item S141772 to get the plugin files that are certified to work with Release Control 6.0.1. All other versions of the plugin are available from the Release Control plugins download page on http://www.serena.com/support.

Supported Release Control Plugin Archive Versions

ZMF Connector Version Support Level Release Control Plugin Archive Version
ZMF Connector 6.1.2 Certified RLC_ChangeManZMF_2.2
ZMF Connector 6.1.2 Unsupported RLC_ChangeManZMF_2.1
ZMF Connector 6.1.2 Unsupported RLC_ChangeManZMF_6.1.0.0_2.0
ZMF Connector 6.1.2 Unsupported RLC_ChangeManZMF_6.1.0.0_1.0
ZMF Connector 6.1.2 Unsupported RLC_ChangeManZMF_6.0.1_1.0
ZMF Connector 6.1.2 Unsupported RLC_ChangeManZMF_6.0.0_1.0
ZMF Connector 6.1.1 Unsupported RLC_ChangeManZMF_2.2
ZMF Connector 6.1.1 Certified RLC_ChangeManZMF_2.1
ZMF Connector 6.1.1 Unsupported RLC_ChangeManZMF_6.1.0.0_2.0
ZMF Connector 6.1.1 Unsupported RLC_ChangeManZMF_6.1.0.0_1.0
ZMF Connector 6.1.1 Unsupported RLC_ChangeManZMF_6.0.1_1.0
ZMF Connector 6.1.1 Unsupported RLC_ChangeManZMF_6.0.0_1.0
ZMF Connector 6.1 Unsupported RLC_ChangeManZMF_2.2
ZMF Connector 6.1 Unsupported RLC_ChangeManZMF_2.1
ZMF Connector 6.1 Certified * RLC_ChangeManZMF_6.1.0.0_2.0
ZMF Connector 6.1 Unsupported RLC_ChangeManZMF_6.1.0.0_1.0
ZMF Connector 6.1 Unsupported RLC_ChangeManZMF_6.0.1_1.0
ZMF Connector 6.1 Unsupported RLC_ChangeManZMF_6.0.0_1.0
ZMF Connector 6.1 Unsupported RLC_ChangeManZMF_2.2
ZMF Connector 6.0 Unsupported RLC_ChangeManZMF_2.1
ZMF Connector 6.0 Unsupported RLC_ChangeManZMF_6.1.0.0_2.0
ZMF Connector 6.0 Certified RLC_ChangeManZMF_6.1.0.0_1.0
ZMF Connector 6.0 Certified RLC_ChangeManZMF_6.0.1_1.0
ZMF Connector 6.0 Certified RLC_ChangeManZMF_6.0.0_1.0

* This archive contains the plugin jar files that are certified to work with Release Control 6.1. If you want to use Release Control 6.0.1 with ZMF Connector 6.1, which is necessary only if you have ChangeMan ZMF 8.1.1.x, please refer to Serena Support Knowledgebase item S141772 to get the plugin files that are certified to work with Release Control 6.0.1.

Support Level Definitions

Support Level Definition
Certified R&D believes the platform should function normally and will fix defects against the platform. This is our primary test platform / platforms.
Supported R&D believes the platform should function normally and will fix defects against the platform.
Unsupported R&D believes the platform might not function normally and will NOT fix defects against the platform.

Related Product Supported Platforms

  • Detailed information about supported platforms and software configuration for Release Control is available in the Release Control Supported Platform Matrix. (In the row for this release, click the link in the Platform Matrix column.)
  • Detailed information about supported platforms and software configuration for Deployment Automation is available in the Deployment Automation Supported Platform Matrix. (In the row for this release, click the link in the Platform Matrix column.)

Third-party Tools

For more information regarding third-party software copyrights and license information, refer to the files under Downloads or News at http://www.serena.com/support.

What's New

Enhancements

Enhancements made to ZMF Connector 6.1.2 include the following:

  • Support for ChangeMan ZMF version 8.1.2

    Services have been updated to add support for ChangeMan ZMF version 8.1.2.

More Information

To learn more about ZMF Connector, visit these areas:

Upgrades

This section provides important information for upgrades to ZMF Connector version 6.1.2.

Before you upgrade, review the following sections, and then proceed with the upgrade.

For full documentation on installing the Release Control ZMF plugin client jar, refer to "Installing Plugins" in the Release Control ChangeMan ZMF Plugin Quick Reference on Documentation Center. This documentation also includes details on adding plugin configurations and using the plugin.

Downloading the ZMF Connector

To upgrade from ZMF Connector 6.0 or 6.1.1 to ZMF Connector 6.1.2, do the following:

  1. Download ZMF Connector 6.1.2 from the ALM Solutions Connector product download page on http://www.serena.com/support.
    Note: If you cannot find ZMF Connector on the download page, contact Support.

Installing the ZMF Connector

To upgrade from ZMF Connector 6.0 or 6.1.1 to ZMF Connector 6.1.2, do the following:

  1. Backup the earlier version. For example, copy the following directories to a backup location:

    C:\Program Files\Serena\common\tomcat\8.0\webapps\...

    almsernet

    almzmf

    almzmfalf

    almzmfws

  2. Install and configure the 6.1.2 services by following the instructions in ChangeMan ZMF Connector Configuration Guide, "Installing and Configuring the ZMF Connector Services".

    The mainframe portion of the configuration should stay the same as it was for your prior ZMF Connector if you were using ZMF Connector 6.0 or above.

  3. If needed, use the following procedure to upgrade your Release Control plugin to work with ZMF Connector 6.1.2. If you are using a version of the Release Control ZMF plugin that has been certified to work with ZMF Connector 6.1.2, you do not need to upgrade the plugin. See Supported Configurations.

Upgrading the Release Control ZMF Plugin

If you need to upgrade to a certified version of the plugin, do the following:

  1. In SBM Configurator, stop the SBM Tomcat service.
  2. Navigate to the ..\Serena\SBM\Common\Tomcat 7.0\server\default\webapps\rlc\web-inf\lib folder.
  3. Back up the rlc-client-zmf-xxxx.jar and rlc-provider-zmf-xxxx.jar files, where xxxx is specific to your existing version of the plugin.
  4. Remove the above jar files.
  5. Download the version of the plugin file you want to install from the Release Control download page on http://www.serena.com/support.
  6. Extract and copy the provider and client jar files to the following folder:

    ..\Serena\SBM\Common\Tomcat 7.0\server\default\webapps\rlc\web-inf\lib folder.

  7. In SBM Configurator, start the SBM Tomcat service.

Upgrading from Earlier Versions of ZMF Connector

For assistance with upgrading to ZMF Connector 6.1.2 from a version earlier than ZMF Connector 6.0, contact Serena Support.

Known Issues

Issues known to exist at the time of release are as follows:

  • Audit requests do not show as completed if the audit return code is 20. (DEF275298).

    If you execute a change package audit request, and the ChangeMan ZMF started task is somehow terminated during the execution, the audit return code returned to ZMF Connector is 20. In this situation, the audit task may not show as completed in the integrating product, even if it is ultimately completed successfully in ChangeMan ZMF.