z/OS AI Framework software and product packaging

AI Framework for IBM® z/OS® (z/OS AI Framework) requires the following software products to provide certain framework functionality. You must order and install these products Start of changeat the specified levelsEnd of change in addition to the IBM z/OS 3.1 base product.

Important: Start of changeYou must use the specified FMIDs of the following products. If you have earlier or later levels of these products installed on your system, you cannot use them with the z/OS AI Framework.End of change
IBM Z® Common Data Provider 5.1
The data collection function of the z/OS AI Framework uses IBM Z Common Data Provider (ZCDP) as the data collection engine. ZCDP provides the infrastructure for accessing IT operational data (such as SMF records) from z/OS systems and streaming it to the analytics platform in a consumable format.

The ZCDP 5.1 FMID (HHBO510) is typically packaged and installed as part of other IBM Z priced products; however, these other products are not required for you to use the z/OS AI Framework. Start of changeIf you do not already use any other such products that include the level of ZCDP that the z/OS AI Framework requires, you can obtain and install the correct level of ZCDP as part of AI System Services for IBM z/OS, as described in Preferred ordering and packaging scenario.End of change

Machine Learning for IBM z/OS Core Edition 3.1 Start of changeor 3.2End of change
The AI model server function of the z/OS AI Framework uses Machine Learning for IBM z/OS Core Edition (MLz Core), which is a machine learning solution that runs on the IBM Z platform. Start of change(Machine Learning for IBM z/OS (MLz) was formerly known as Watson Machine Learning for IBM z/OS (WMLz).)End of change

The MLz Core FMID (HAQN310 for MLz Core 3.1Start of change or HAQN320 for MLz Core 3.2End of change) is included with the priced product, Machine Learning for IBM z/OS Enterprise Edition (MLz Enterprise); however, MLz Enterprise is not required for you to use the z/OS AI Framework. Start of changeIf you do not already use a level of MLz Enterprise that includes the level of MLz Core that the z/OS AI Framework requires, you can obtain the correct level of MLz Core as part of AI System Services for IBM z/OS, as described in Preferred ordering and packaging scenario.End of change

All other functional components of the z/OS AI Framework (as shown in Figure 1) are delivered as part of the z/OS 3.1 base product.

Preferred ordering and packaging scenario

To simplify ordering and installation, IBM offers AI System Services for IBM z/OS (5655-164), which packages the ZCDP and MLz Core FMIDs together under a single, zero-charge product ID (PID).

Start of change
  • AI System Services for IBM z/OS 1.1 (AISS 1.1) contains the ZCDP 5.1 and MLz Core 3.1 FMIDs, and requires Java 11, as described in Software requirements.
  • AI System Services for IBM z/OS 1.2 (AISS 1.2) contains the ZCDP 5.1 and MLz Core 3.2 FMIDs, and requires Java 17, as described in Software requirements. This is the preferred option, as MLz Core 3.2 offers additional functionality and security. AISS 1.2 requires APAR OA67865 on z/OS 3.1.
End of change

If you are migrating from z/OS 2.4 or 2.5 to z/OS 3.1 and you do not already have any other products that include the ZCDP and MLz Core FMIDs, you can order the AI System Services for IBM z/OS PID along with the z/OS 3.1 PID (5655-ZOS) and receive both products in one portable software instance zone.

Tip: Installing both z/OS and AISS in the same zone makes applying future software maintenance easier than if the products are in different zones.
Table 1 shows the PIDs and the FMIDs and components from each product that the z/OS AI Framework requires.
Start of change
Table 1. z/OS AI Framework: Required products, FMIDs, and components
This product… Contains these FMIDs… Which include these components…
Option 1:
AI System Services for IBM z/OS 1.1
PID 5655-164 ($0)
ZCDP 5.1
FMID HHBO510
MLz Core 3.1
FMID HAQN310
Start of changeOption 2 (preferred):
AI System Services for IBM z/OS 1.2
PID 5655-164 ($0)End of change
Start of change
ZCDP 5.1
FMID HHBO510
End of change
Start of changeEnd of change
Start of change
MLz Core 3.2
FMID HAQN320
End of change
Start of changeEnd of change
IBM z/OS 3.1
PID 5655-ZOS
BCP
FMID HBB77E0
  • AI Base Component for z/OS
  • WLM (AI use case provider)
z/OSMF
FMID HSMA310
  • AI Control Interface for z/OS
DFSMS
FMID HDZ3310
  • VSAM RLS
  • EzNoSQL for z/OS
End of change

A benefit of this packaging scenario is that, in addition to receiving ZCDP and MLz Core at no charge, you are assured that ZCDP and MLz Core are at the proper levels that the z/OS AI Framework requires. If you are using a previous installation of ZCDP or MLz Core or both, be sure they are at the correct levels.

Note: You can use this same packaging strategy if you already have z/OS 3.1 and you later want to add AI System Services for z/OS so that you can use the z/OS AI Framework, and you do not already have any other products that include ZCDP and MLz Core. You can order AI System Services for z/OS and receive ZCDP and MLz Core in one portable software instance zone.

Other ordering and packaging scenarios

The following scenarios describe various combinations of ordering and packaging for z/OS, AI System Services for z/OS, MLz Enterprise, and ZCDP.

  • You already have z/OS 3.1 and MLz Enterprise, but no ZCDP.
    If you already have z/OS 3.1, and you already have MLz Enterprise Start of change3.1 or 3.2End of change (which includes the MLz Core FMID (HAQN310Start of change or HAQN320End of change)), but you need the ZCDP FMID (HHBO510), you have 2 options:
    • You can order and install another IBM product that includes the ZCDP FMID, if you already intend to use that product.
    • You can order and install the zero-charge AI System Services for z/OS, but this will cause duplication of the MLz Core FMID, which you already have as part of MLz Enterprise. You have 3 options to manually mitigate the duplication:
      • Carefully merge the two instances.
      • Carefully delete the MLz Core FMID from the portable software instance for your AISS order.
      • Do not use a z/OSMF portable software instance; instead, use CBPDO but do not install the MLz Core FMID that comes with AISS.
      Note: If you order AI System Services for z/OS at the same time as another product that also contains ZCDP, they will install into the same zone and share the FMID for ZCDP.
  • You already have z/OS 3.1 and ZCDP, but no MLz.
    If you already have z/OS 3.1, and you already have the ZCDP FMID (HHBO510) as part of another IBM product, but you need the MLz Core FMID (HAQN310Start of change or HAQN320End of change), you have 2 options:
    • You can order and install MLz Enterprise, which will also install the MLz Core FMID that you need for the z/OS AI Framework. This approach makes sense if you already intend to use MLz Enterprise for other purposes apart from the z/OS AI Framework.
    • You can order and install the zero-charge AI System Services for z/OS, but this will cause duplication of the ZCDP FMID, which you already have as part of another product. You have 3 options to manually mitigate the duplication:
      • Carefully merge the two instances.
      • Carefully delete the ZCDP FMID from the portable software instance for your AISS order.
      • Do not use a z/OSMF portable software instance; instead, use CBPDO but do not install the ZCDP FMID that comes with AISS.
      Note: If you order AI System Services for z/OS at the same time as MLz Enterprise, they will install into the same zone and share the FMID for MLz Core.
  • You already have z/OS 3.1 and ZCDP and MLz Enterprise.

    If you already have z/OS 3.1 and MLz Enterprise (which includes the MLz Core FMID (HAQN310Start of change or HAQN320End of change)), and you also already have the ZCDP FMID (HHBO510) as part of another IBM product, you do not need to order or install anything else; you already have all the necessary FMIDs on your system.

ZCDP and MLz Core instances are not shared

Regardless of the particular ordering, packaging, and installation process you use, the z/OS AI Framework configures its own running instances of ZCDP and MLz Core, including the Spark runtime environment that MLz Core uses. These separately configured instances are not shared with any other products, and any existing ZCDP and MLz Core configurations remain unaffected. This approach ensures that these separate instances are properly configured for use with the z/OS AI Framework (for instance, proper security setup).

Important: The AI Framework for IBM z/OS Configuration Workflow (described later) prompts you to specify the locations where the correct levels of ZCDP and MLz Core are installed on your system and configures new, separate instances of these products that are specifically for use with the z/OS AI Framework.

Start of changeYou must use the AI Framework Configuration Workflow to configure these new instances of ZCDP and MLz Core for use with the z/OS AI Framework. Do not attempt to use separate configuration mechanisms (such as other z/OSMF plug-ins or GUIs that are provided by those products) to configure new instances, nor share existing instances that are used with other products; otherwise, the z/OS AI Framework will not work correctly. Use the AI Framework Configuration Workflow instead, as described later in Configuring the z/OS AI Framework.End of change