Installation Prerequisites

Your environment must be set up to satisfy the requirements listed below before you install the ChangeMan ZMF Web Services plug-in on the Web Services application server. It is not within the scope of this document to describe how to install or configure the software listed in this section.

Web Application Server Environment

The Web Services application server can run on any desired operating system platform, including z/OS, but most commonly runs on Windows, Linux, or Solaris. On this platform, the ChangeMan ZMF Web Services API requires:

• Oracle® Corporation’s J2SE™ Development Kit (JDK) version 1.5 or higher, which you can download free of charge from http://www.oracle.com/technetwork/java/index.html
• The ZMF Web Services API has been tested with Apache Tomcat. You can download the latest GA version free of charge from http://tomcat.apache.org/

Important

The Web Services application server must support Apache Axis version 1.3. Axis version 1.3 should not be confused with Axis 2 version 1.3. The ChangeMan ZMF Web Services API does not support Axis 2.

The Axis 1.3 library is supplied in the zmfws.war file. It does not conflict with other versions of Axis installed on the server.

Web Services Development Environment

A Web Services client development tool that supports the WSDL 1.1 standard is desirable. For Java development, Eclipse is recommended.

ZMF for Eclipse Compatibility

ZMF for Eclipse (formerly WD4ZMF), a Serena plug-in that integrates the open-source Eclipse IDE with ChangeMan ZMF, uses the ChangeMan ZMF Web Services API.

If you plan to install the ChangeMan ZMF Web Services API on the same platform where the ZMF for Eclipse or an earlier ZMF Eclipse integration already resides, be sure that both ZMF for Eclipse and the Web Services API you plan to install are at the same maintenance level before you proceed.

Caution

If a previously installed Eclipse plug-in for ZMF uses an older version of the Web Services API than the one you are about to install, proceeding with the installation might cause ZMF for Eclipse or WD4ZMF to fail.

z/OS Server Environment

On the z/OS host, the ChangeMan ZMF 8.1 Web Services API requires the following:

• ChangeMan ZMF version 6.1.0 (or above) on every z/OS LPAR you wish to access with ZMF Web Services. (HFS and Java functionality require ZMF 7.1.0 or higher.)

• TCP/IP connectivity between the Web Services application server and the ChangeMan ZMF server(s).

In addition, Serena recommends that you install the XMLSERV prototyping tool on your ChangeMan ZMF system to assist with debugging Web Services calls to the ZMF XML Services. (See the ChangeMan ZMF Installation Guide for setup instructions.)

Security Considerations

Host Security

The ChangeMan ZMF Web Services API is compatible with RACF®, CA-ACF2®,and CA-Top Secret® on the mainframe. In addition, all messages between ChangeMan ZMF on the host and the ZMF Connector plug-in on the Web Services application server are compressed.