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 functionalities 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 5755-AB1)

IBM Developer for z/OS Enterprise Edition (program number 5755-AB5)

IBM Gitlab Ultimate for IBM z/OS (program number 5737-N86)

IBM Dependency Based Build (program number 5737-K80)

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 5755-AB1):

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

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

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

Specify the following product definition in IFAPRDxx to define GitLab Ultimate (product code 5737-N86):

PRODUCT OWNER('IBM CORP')               
        NAME('GitLab Ultimate')              
        ID(5737-N86)                    
        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 5755-A01).