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
at the specified levels
in addition to the IBM
z/OS 3.1 base product.
You 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.
- 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.
If 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.
- Machine Learning for IBM
z/OS Core Edition
3.1
or
3.2
- 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.
(Machine Learning for IBM
z/OS (MLz) was formerly known as Watson Machine
Learning for IBM z/OS (WMLz).)
The MLz Core FMID (HAQN310 for MLz Core 3.1
or HAQN320 for
MLz Core
3.2
) 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.
If 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.
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).

- 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.
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.

| 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 |
– | |
Option 2 (preferred):AI System Services for IBM z/OS 1.2 PID 5655-164 ($0) ![]() |
ZCDP 5.1
FMID HHBO510 ![]() |
–![]() |
MLz Core 3.2
FMID HAQN320 ![]() |
–![]() |
|
|
IBM z/OS 3.1
PID 5655-ZOS |
BCP
FMID HBB77E0 |
|
|
z/OSMF
FMID HSMA310 |
|
|
|
DFSMS
FMID HDZ3310 |
|

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.
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
3.1 or 3.2
(which includes the MLz Core FMID (HAQN310
or HAQN320
)),
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 (HAQN310
or HAQN320
),
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 (HAQN310
or HAQN320
)),
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.