Software requirements for UMS

Before you install and configure IBM® Unified Management Server for z/OS®, make sure that your environment meets the following minimum software requirements.

  • IBM z/OS 2.4 or later.
  • IBM z/OS Integrated Cryptographic Service Facility (ICSF) must be installed and configured with a token data set (TKDS) and the ICSF started task started, as described in the z/OS Cryptographic Services ICSF: System Programmer's Guide.
  • IBM z/OS Management Facility (z/OSMF) (version is same as z/OS version). For information, see the z/OSMF documentation.
  • IBM Resource Access Control Facility (RACF®) or another equivalent external security manager that supports z/OS system authorization facility (SAF) interface.
  • Refer to the following table for the supported Zowe version for each UMS release or PTF level.
    Table 1. Supported Zowe versions
    UMS version Zowe version
    UMS1.2.0.7 (UI96717) Zowe 2.3.0 and later
    Note: If you plan to use client authentication for an UMS DBA user by using a certificate that can be mapped to a DBA user ID, you should use the Zowe 2.12.0 version or later. For details on DBA user IDs, see Setting up DBA user for Unified Management Server.
    UMS1.2.0.6 (UI96248) Zowe 2.3.0 and later
    Note: If you plan to use client authentication for an UMS DBA user by using a certificate that can be mapped to a DBA user ID, you should use the Zowe 2.12.0 version or later. For details on DBA user IDs, see Setting up DBA user for Unified Management Server.
    UMS1.2.0.5 (UI94998) Zowe 2.3.0 and later
    UMS1.2.0.4 (UI93732) Zowe 2.3.0 and later
    UMS1.2.0.3 (UI93091) Zowe 2.3.0 and later
    UMS1.2.0.2 (UI92457) Zowe 2.3.0 and later
    UMS1.2.0.1 (UI91302) Zowe 2.3.0 and later
    UMS1.2.0.0
    • Zowe 2.3.0
    • Zowe 2.4.0
    • Zowe 2.5.0
    • Zowe 2.7.0 and later
    Note: Zowe 2.6.0 is not supported with UMS1.2.0.0.
    Restriction: If you are running Zowe 2.12.0, you must remove the zowe.sysMessages section from the zowe.yaml file.
    If you are using Zowe distributed by IBM Z Distribution for Zowe, see the Fix list for IBM Z Distribution for Zowe for the relationship between the Zowe releases, APARs, and PTFs for IBM Z Distribution for Zowe. For more information, see the IBM Zowe documentation.
    IBM Z® Distribution for Zowe is a no-charge offering with optional Subscription and Support (S&S).
    • Zowe support for components used by the listed offerings is included as part of the licensing of the below offerings when the corresponding product S&S entitlement is current. No separate Zowe S&S entitlement is required.
      • IBM Db2® DevOps Experience for z/OS & IBM Unified Management Server for z/OS
      • IBM Db2 Administration Foundation for z/OS & IBM Unified Management Server for z/OS
      • IBM IMS Administration Foundation for z/OS (a component of IBM IMS Tools Base for z/OS) & IBM Unified Management Server for z/OS
    • Zowe can be supported for a fee by IBM Software Support in the below use cases:
      • Zowe components not used by any of the offerings listed above.
      • Zowe issues unrelated to the offerings listed above.
    • The following Zowe components are mandatory:
      • Zowe Application Framework (ZLUX)
      • Zowe Cross-Memory (ZIS) Server
      • Zowe Cross-Memory Auxiliary Server
    • The following Zowe component is mandatory for multifactor authentication and high availability support:
      • Zowe API Mediation Layer
    • The Zowe CLI component is not supported.

    For more information on how Zowe configures, validates, and starts all of its components, see Zowe component lifecycle.

    Important: To bring Unified Management Server up and running, you must complete all the Zowe steps that are related to Zowe cross-memory server setup. This includes configuring the Zowe auxiliary address space. For details, see the following topics:
  • IBM 64-bit SDK for z/OS, Java™ Technology Edition 8. For information, see IBM Java SDK.
  • IBM SDK for Node.js - z/OS, Node.js v14.x (except v14.17.2), v16.x, or v18.2 (except v18.12.1). For more information, see Zowe documentation.
  • Any of the browsers supported by Zowe. For details, see the Zowe documentation.

Additional requirements for z/OS 3.1

If you are running UMS on z/OS 3.1, the following are required:
  • UMS 1.2 must be 1.2.0.4 (APAR PH56865, PTF UI93732) or later.
  • A Zowe release that supports z/OS 3.1 must be used:
    • If you are using Open Source Zowe, V2.11 or later is required.
    • If you are using IBM Z Distribution for Zowe V2, the following PTFs are required:
  • Fixpack 15 (PTF UI94465/ APAR PH58170/ PH58174) is required for IBM 64-bit SDK for z/OS, Java Technology Edition, version 8 SR8.
For details on Zowe releases, see Fix list for IBM Z Distribution for Zowe. For Java version, maintenance level, and fixpack download, see Java SDK Products on z/OS.