Turn Off Tabs
Serena ChangeMan ZMF Connector 6.1 Readme
This readme file contains information about this release. Last updated on 2016-06-16.

Contents

About this Release

Welcome to Serena ChangeMan ZMF Connector 6.1.

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 Serena ChangeMan ZMF.

  • ChangeMan ZMF integration with Serena Release Control 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 Serena ChangeMan ZMF Connector Configuration Guide for configuration details.
  • Refer to Serena 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

Supported ChangeMan ZMF Versions

ChangeMan ZMF Version Support Level Plugin Versions ZMF Connector Version
ChangeMan ZMF 8.1.1, 8.1.1.01 Certified Release Control ZMF Plugin 2.0 ZMF Connector 6.1
ChangeMan ZMF 8.1.0 Certified Release Control ZMF Plugin 1.0

Release Control ZMF Plugin 2.0

ZMF Connector 6.0

ZMF Connector 6.1

ChangeMan ZMF 7.1.3 Certified Release Control ZMF Plugin 1.0

Release Control ZMF Plugin 2.0

ZMF Connector 6.0

ZMF Connector 6.1

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
Serena Common Tomcat 8.0 32-bit Supported

Supported Release Control Versions

Release Control Version Support Level ZMF Connector Version
Release Control 6.1 Certified ZMF Connector 6.1
Release Control 6.1 Certified ZMF Connector 6.0
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.

Supported Release Control Plugin Archive Versions

ZMF Connector Version Support Level Release Control Plugin Archive Version
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.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 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 include the following:

  • Support for ChangeMan ZMF 8.1.1.

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

More Information

To learn more about ZMF Connector, visit these areas:

Upgrades

Upgrading from ZMF Connector 6.0

To upgrade from ZMF Connector 6.0 to ZMF Connector 6.1, do the following:

  1. Download the ZMF Connector 6.1 bundle from the ChangeMan ZMF download page on http://www.serena.com/support.
  2. Install and configure the 6.1 services by following the instructions in Serena 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 ZMF Connector 6.0 installation.

  3. If you are using Release Control 6.0.1 with ZMF Connector 6.0 and want to upgrade to using ZMF Connector 6.1, you will need to replace the Release Control ZMF plugin jar files as follows:
    1. In SBM Configurator, stop the SBM JBoss service.
    2. Navigate to the ..\Serena\SBM\Common\jboss405\server\default\deploy\rlc.war\WEB-INF\lib folder.
    3. Back up rlc-client-zmf-6.0.1.0-snapshot.jar and rlc-provider-zmf-6.0.1.0-snapshot.jar.
    4. Remove rlc-client-zmf-6.0.1.0-snapshot.jar and rlc-provider-zmf-6.0.1.0-snapshot.jar.
    5. Download RLC_ChangeManZMF_6.1.0.0_2.0.zip from the Release Control plugins download page on http://www.serena.com/support.
    6. Extract and copy rlc-client-zmf-6.1.0.0-2.0.jar and rlc-provider-zmf-6.1.0.0-2.0.jar into the..\Serena\SBM\Common\jboss405\server\default\deploy\rlc.war\WEB-INF\lib folder.
    7. In SBM Configurator, start the SBM JBoss service.
  4. If you are using Release Control 6.1 with ZMF Connector 6.0 and want to upgrade to using ZMF Connector 6.1, you will need to replace the Release Control ZMF plugin client jar file as follows:
    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 rlc-client-zmf-6.1.0.0-1.0.jar and rlc-provider-zmf-6.1.0.0-1.0.jar.
    4. Remove rlc-client-zmf-6.1.0.0-1.0.jar and rlc-provider-zmf-6.1.0.0-1.0.jar.
    5. Download RLC_ChangeManZMF_6.1.0.0_2.0.zip from the Release Control plugins download page on http://www.serena.com/support.
    6. Extract and copy rlc-client-zmf-6.1.0.0-2.0.jar and rlc-provider-zmf-6.1.0.0-2.0.jar to the ..\Serena\SBM\Common\Tomcat 7.0\server\default\webapps\rlc\web-inf\lib folder.
    7. In SBM Configurator, start the SBM Tomcat service.
CAUTION:
After you replace the plugin client jar file, Release Control will not be able to communicate with ZMF Connector 6.0. If you want to return to using ZMF Connector 6.0, you must revert the Release Control plugin client jar file to the version included in your version of Release Control, which you backed up as part of the above procedure.

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

Upgrading from Earlier Versions

For assistance with upgrading to ZMF Connector 6.1 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.