Configuring the ChangeMan ZMF Application

An application process is used to run the component processes you need. Most of the properties that are needed for the component processes should be set at the application level, because many properties are used by more than one component process.

When the application process is initiated through Release Manager deployment tasks, a small set of values are passed as part of the request. Any properties with no values passed will use the values set in the application. If no values are set, the default values will be used.

Tip: For the quickest implementation, import the sample environment and application and modify the properties to suit your needs.

To configure the application:

Create an application that will contain your properties and component processes or select an existing one. For example, ZMF Application.
If you imported the sample application, edit the application and change the application name and description to match your implementation's values.
Add properties to your application that are common to all component processes, or modify the existing imported values to match your system information. For example, the connection information property values are as follows:
ZMF_HOST_NAME, value <your host name>

ZMF_HOST_PORTID, value <your port #>

ZMF_HOST_PROXYID, value <your proxy ID>

ZMF_HOST_PROXY_PASSWORD, value <your proxy ID password>

ZMF_JOB_CARDS, value <your job card>

Note: Values must be entered in uppercase. If the proxy ID is not uppercase, the connection will fail.
Add the following processes to your application if they have not already been imported. The process names and descriptions for the application processes needed for the Release Manager integration are as follows.
- Approve Package - Initial approval of a package
- Approve Package for PROD - This is the last approval, which causes the package to go to APR status and initiates the installation process; this process waits for the event in ChangeMan ZMF that confirms that the package actually installed in production.
- Audit Package - Submit an audit package job
- Backout Package - Back out a package from production
- Deploy Package - Promote a package
- Freeze Package - Freeze a package
- Get Applications - Get applications
- Get Approvers - Get package approvers
- Get Installation Sites - Get package installation sites
- Get Packages - Get packages in DEV or FRZ status
- Get Packages1 - Get packages in DEV status
- Get Packages2 - Get packages in FRZ status
- Get Packages3 - Get packages in FRZ, BAK, or BAS status
- Get Packages4 - Get packages in INS, BAK, or BAS status
- Get Production Sites - Get production sites
- Get Promotion Areas - Get promotion areas
- Get Promotion Sites - Get promotion sites
- Get Sites - Get sites
- Reject Package - Reject a package
- Revert Package - Revert a package back to development
- Undeploy Package - Demote a package
Add the properties to the application processes that the component processes will inherit, or change them in the imported application. The properties for which values will be passed to and from Release Manager have an RM$ at the beginning of the value, as shown in the following properties for Approve Package.
- name ZMF_PACKAGE_NAME, label Package Name: value RM${applicationProcess:Get Packages2;properties:{[name:ZMF_PACKAGE_NAME_FILTER,value: ZMF_PACKAGE_NAME]};displaycols:package, packageStatusDesc, packageTitle}
- name ZMF_PACKAGE_APPROVER, label Package Approver: value RM${applicationProcess:Get Approvers;properties:{[name:ZMF_PACKAGE_NAME, value:ZMF_PACKAGE_NAME]};displaycols:approverEntity, approverDesc}

Configuring the ChangeMan ZMF Application

Related Topics