ChangeMan ZMF Plugin Configuration Details

The default ChangeMan ZMF plugin provides functionality for ChangeMan ZMF deployment units and executions, where deployment units are change packages.

The ZMF Deployment Unit provider is used when adding deployment units and it allows you to link ChangeMan ZMF change packages to your Release Control release package.
The ChangeMan ZMF Execution provider is used when creating deployment tasks or task templates. You can choose to perform a number of ChangeMan ZMF actions, such as auditing, promoting, and approving change packages.

Before you can use the ChangeMan ZMF plugin, an administrator must do the following:

Install and add the plugin. See Preparing the Plugins.
Add one or more configurations of the plugin. See Adding or Updating Configurations and the example ChangeMan ZMF plugin configuration described in the following table.
Configure custom column fields to display appropriate data for ChangeMan ZMF deployment units. See Fields for ChangeMan ZMF.

Limitations

You can associate only one change package to each deployment task.
You can associate a change package with a deployment task only after you have added the task.
You can promote only full change packages; you cannot promote individual components.

Example ChangeMan ZMF Plugin Configuration

The fields for an example ChangeMan ZMF plugin configuration are described in the following table.

Field	Description	Example / Default Values
Name	A unique name for the plugin configuration	ZMF 8.1
Description	A description of the plugin configuration that distinguishes it from other configurations in the list	Sample ZMF 8.1
Mainframe Connector Url	The location of the Apache Tomcat server instance where the ChangeMan ZMF Connector war files (`almsernet`, `almzmf`, `almzmfws`, and `almzmfalf`) are installed. The default Tomcat port is 8080.	http://<servername>:8080
ZMF Server	The z/OS Mainframe host name where the ChangeMan ZMF started task is installed	<LPARName>
ZMF Server Port Id	The port ID used by the ChangeMan ZMF started task. Note: This is the `CMN` port number.	<portNum>
Use Single Sign-On (SSO)	If this is set to true, the ChangeMan ZMF provider will use the user name and password specified in the ZMF Connector `almsernet` service resource properties as a proxy user. The proxy user logs in on behalf of the SBM user name specified in the SSO token. To access ChangeMan ZMF, the SBM user name with which you log into Release Control must have a matching TSO login ID that exists on the mainframe.	true
User Name	If single sign-on is not enabled for this server, use this user name to log in to this system.
Password	If single sign-on is not enabled for this server, use this password to log in to this system.
Server Time Zone Name	This field is used to set the time zone used in the display of date/time fields in Release Control. If the time zone of the Release Control server is different than that of the ChangeMan ZMF host, enter the time zone of the ChangeMan ZMF host in this field. See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones or similar sites for information on Java time zone entries. If this field is blank, the time zone of the Release Control server is used to calculate the time.
Execution Properties	Used when adding deployment tasks or task templates
Execution - Provider Name	A descriptive name of the execution provider	ZMF 8.1 Execution
Execution - Provider Description	Description of the provider, which appears as a tooltip in Edit Deployment Tasks when users are adding a deployment task	Execution provider for ZMF 8.1
Deployment Unit Properties	Used when adding deployment units
Deploy Unit - Provider Name	A descriptive name of the deployment unit provider	ZMF 8.1 Deploy Unit
Deploy Unit - Provider Description	Description of the provider, which appears as a tooltip in Edit Deployment Units when users are adding a deployment unit	Deploy Unit provider for ZMF 8.1
Status Filters	A comma-separated list of package statuses to filter the list of change packages from which to select	DEV,FRZ,REJ
Type Filters	A comma-separated list of package types to filter the list of change packages from which to select	PLANNED-PERMANENT,PLANNED-TEMPORARY,UNPLANNED-PERMANENT,UNPLANNED-TEMPORARY
Level Filters	A comma-separated list of package levels to filter the list of change packages from which to select	SIMPLE,PARTICIPATING
Empty Work Request No	Search for packages with blank or null work request number	false
Promotion Minimum Level	Search for packages with this minimum promotion level and above	00
Audit Maximum Return Code	Search for packages with this audit return code or less	04
Deploy Unit - Result Limit	Result limit for find deploy unit service	300
Provider Types
Execution	Provides functionality for executing deployment tasks	Enabled
Deployment Unit	Provides functionality for linking deployment units	Enabled
Request	Provides functionality for associating requests	Not Supported
Configuration Information
Configuration ID	Unique identifier of this configuration within the database instance. Read only.
Configuration UUID	Unique global identifier of this configuration. Read only.