Product enablement in IFAPRDxx

IBM Dependency Based Build (DBB) is available as a stand-alone product or as part of different products as shown below. All of the functionality of IBM Dependency Based Build are provided no matter how it is purchased; however, you need to register DBB according to the product purchased. To learn which product was purchased, contact the person responsible for the purchase of DBB or your local IBM representative.

IBM Application Delivery Foundation for z/OS (program number 5655-AC6)

IBM Developer for z/OS Enterprise Edition (program number 5655-AC5)

IBM Wazi for Red Hat CodeReady Workspaces (program number 5900-A8N)

IBM Z Open Unit Test (program number 5737-J31)

IBM Z Open Development (program number 5737-I22)

IBM Dependency Based Build (program number 5737-K80)

Note: Starting from V14.2, IBM Developer for z Systems Enterprise Edition is renamed to IBM Developer for z/OS Enterprise Edition.

Products to be enabled on z/OS® are defined in SYS1.PARMLIB(IFAPRDxx). Define PROD=xx in the IEASYSxx parmlib member to specify which IFAPRDxx parmlib member should be used during IPL.

Specify the following product definition in IFAPRDxx to define IBM Application Delivery Foundation for z/OS (product code 5655-AC6):

PRODUCT OWNER('IBM CORP')
        NAME('IBM APP DLIV FND')
        ID(5655-AC6)
        VERSION(*) RELEASE(*) MOD(*)
        FEATURENAME(*)
        STATE(ENABLED)

Specify the following product definition in IFAPRDxx to define IBM Developer for z/OS Enterprise Edition (product code 5655-AC5):

PRODUCT OWNER('IBM CORP')               
        NAME('IBM IDz EE')              
        ID(5655-AC5)                    
        VERSION(*) RELEASE(*) MOD(*)    
        FEATURENAME(*)
        STATE(ENABLED)

Specify the following product definition in IFAPRDxx to define IBM Wazi for Red Hat CodeReady Workspaces (product code 5900-A8N):

PRODUCT OWNER('IBM CORP')               
        NAME('IBM WAZI CODE')              
        ID(5900-A8N)                    
        VERSION(*) RELEASE(*) MOD(*)    
        FEATURENAME(*)
        STATE(ENABLED)

Specify the following product definition in IFAPRDxx to define IBM Z Open Unit Test (product code 5737-J31):

PRODUCT OWNER('IBM CORP')               
        NAME('Z Open Unit Test')              
        ID(5737-J31)                    
        VERSION(*) RELEASE(*) MOD(*)    
        FEATURENAME(*)
        STATE(ENABLED)

Specify the following product definition in IFAPRDxx to define IBM Z Open Development (product code 5737-I22):

PRODUCT OWNER('IBM CORP')               
        NAME('IBM Z OPEN DEV')              
        ID(5737-I22)                    
        VERSION(*) RELEASE(*) MOD(*)    
        FEATURENAME(*)
        STATE(ENABLED)

Specify the following product definition in IFAPRDxx to define IBM Dependency Based Build (product code 5737-K80):

PRODUCT OWNER('IBM CORP')
        NAME('IBM DBB')
        ID(5737-K80)
        VERSION(*) RELEASE(*) MOD(*)
        FEATURENAME(*)
        STATE(ENABLED)

After the IFAPRDxx parmlib member is updated, it can be activated dynamically (until the next IPL) with the following console command:

SET PROD=xx

A product that is not defined in IFAPRDxx, or defined with STATE(DISABLED) or STATE(NOTDEFINED) will not be selected for registration. If none of the documented products is defined in IFAPRDxx, DBB enters trial mode. In trial mode, all APIs work as normal for 90 days. After 90 days, these DBB APIs will fail to register and the build process will terminate. To use trial mode, the directory pointed to by the DBB_CONF environment variable must be readable and writable.

If you change how a product is purchased, for example, you upgrade from using a stand-alone version to the IBM Application Delivery Foundation for z/OS product bundle, you must explicitly remove the existing product definition from the in-storage tables kept by z/OS when activating the new definition. Follow this scenario to do this dynamically (without IPL):

1. In IFAPRDxx, define the new product as described before, and update the old product with STATE(DISABLED).
2. Activate the update with operator command SET PROD=xx.
3. You can now safely remove the old product definition from IFAPRDxx.

You should not use IFAPRDxx entries that have NAME(*) or ID(*) fields because this will result in all z/OS applications that utilize product registration to find a match on the first test, and adhere to the related STATE() definition. For Dependency Based Build with STATE(ENABLED), this means that the application registers as IBM Application Delivery Foundation for z/OS (product code 5655-AC6).