Registering z/OS Debugger

z/OS® Debugger is available as a component of multiple products. Different functions of z/OS Debugger are enabled according to the product you purchased.
  • IBM® Developer for z/OS Enterprise Edition 16.0, program number 5755-A05 (Shopz orderable)
    • IBM Developer for z/OS Enterprise Edition is one of the products included in IBM Application Delivery Foundation for z/OS 4.0, program number 5755-A01 (Shopz orderable).
  • IBM Debug for z/OS 16.0, program number 5755-A06 (Shopz orderable)
  • IBM Developer for z/OS 16.0, program number 5724-T07 (web download)
  • IBM Z and Cloud Modernization Stack 2023, program number 5900-A8N (web download)

You must set up z/OS product registration for z/OS Debugger to enable its functions. Products to be enabled on z/OS are defined in the IFAPRDxx parmlib member that is used for IPL.

If you already defined the product using FEATURENAME('*') for another component of the product, you do not need to repeat the definition. Otherwise, you must specify one of the following IFAPRDxx entries, depending on how you purchased z/OS Debugger:
  • If you acquired z/OS Debugger as a part of IBM Application Delivery Foundation for z/OS (product code 5755-A01), specify the following definition in IFAPRDxx. Sample member EQAWIFAA, which contains the next statements, is provided in the SEQASAMP sample library.
    PRODUCT OWNER('IBM CORP')
            NAME('IBM APP DLIV FND')
            ID(5755-A01)
            VERSION(*) RELEASE(*) MOD(*)
            FEATURENAME(*)
            STATE(ENABLED)
  • If you acquired z/OS Debugger as a part of IBM Developer for z/OS Enterprise Edition (product code 5755-A05), specify the following definition in IFAPRDxx. Sample member EQAWIFAE, which contains the next statements, is provided in the SEQASAMP sample library.
    PRODUCT OWNER('IBM CORP')
            NAME('IBM IDz EE')
            ID(5755-A05)
            VERSION(*) RELEASE(*) MOD(*)
            FEATURENAME(*)
            STATE(ENABLED)
  • If you acquired z/OS Debugger as a part of IBM Debug for z/OS (product code 5755-A06), specify the following definition in IFAPRDxx. Sample member EQAWIFAD, which contains the next statements, is provided in the SEQASAMP sample library.
    PRODUCT OWNER('IBM CORP')
            NAME('IBM Debug for z')
            ID(5755-A06)
            VERSION(*) RELEASE(*) MOD(*)
            FEATURENAME(*)
            STATE(ENABLED)
  • If you acquired z/OS Debugger as a part of IBM Developer for z/OS (product code 5724-T07), specify the following definition in IFAPRDxx. Sample member EQAWIFAZ, which contains the next statements, is provided in the SEQASAMP sample library.
    PRODUCT OWNER('IBM CORP')
            NAME('IBM IDz')
            ID(5724-T07)
            VERSION(*) RELEASE(*) MOD(*)
            FEATURENAME(*)
            STATE(ENABLED)
  • If you acquired z/OS Debugger as a part of Wazi Code delivered in IBM Z and Cloud Modernization Stack (product code 5900-A8N), specify the following definition in IFAPRDxx. Sample member EQAWIFAW, which contains the next statements, is provided in the SEQASAMP sample library.
    PRODUCT OWNER('IBM CORP')
            NAME('IBM Wazi Code')
            ID(5900-A8N)
            VERSION(*) RELEASE(*) MOD(*)
            FEATURENAME(*)
            STATE(ENABLED)
Notes:
  • These sample definitions enable all features of the selected product. To register each feature individually, create a PRODUCT block for each feature and specify FEATURENAME('IDz-DEBUGGER') to register the z/OS Debugger feature.
  • If you do not register any of the listed products in the IFAPRDxx parmlib member, z/OS Debugger will assume that you purchased IBM Developer for z/OS (product code 5724-T07) and enable only the related functions.
  • No matter which product you bought and registered, any Copyright statement at z/OS Debugger startup always shows 5724-T07 for the product ID. The same is true for "CALL %VER", as well as Copyright statements in samples, ISPF parts, program objects or load modules.

After you update IFAPRDxx, issue the SET PROD=xx operator command to dynamically activate the definitions. z/OS Debugger will then be enabled in your z/OS environment.

IBM advises against defining IFAPRDxx entries that have NAME(*) or ID(*) fields, as 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 z/OS Debugger with STATE(ENABLED), this means that the application will register as Application Delivery Foundation for z/OS (product code 5755-A01).

If your site has coded a generic entry in IFAPRDxx, complete the following steps:
  1. Code an entry for each item that you did not purchase STATE(NOTDEFINED).
  2. Code an entry for the item you did purchase as shown in the previous text.
  3. Issue a SET PROD=xx operator command.