Registering Fault Analyzer in the IFAPRDxx parmlib member

If you purchased Fault Analyzer as part of product code 5755-A01 IBM Application Delivery Foundation for z/OS, include an entry in the IFAPRDxx parmlib member as follows:


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

If you purchased Fault Analyzer separately, an entry in IFAPRDxx parmlib is not required. However, if you would prefer to have an entry, the following can be added:


PRODUCT OWNER('IBM CORP')
        NAME('FAULT ANALYZER')
        ID(5755-A02)
        VERSION(*) RELEASE(*) MOD(*)
        FEATURENAME('FAULT ANALYZER')
        STATE(ENABLED)

All parameters except VERSION, RELEASE, and MOD must be specified exactly as shown. Any syntactically valid values can be specified for VERSION, RELEASE, and MOD.

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

SET PROD=xx

Refer to MVS™ Initialization and Tuning Reference for general information about the IFAPRDxx parmlib member.

Additional Fault Analyzer IFAPRDxx processing

If a product above is not defined in IFAPRDxx, when Fault Analyzer is first invoked it will register during initialization as product code 5755-A02.

If a product above is defined with STATE(DISABLED) or STATE(NOTDEFINED), the product will not be selected for registration.

To prevent Fault Analyzer from running, use the following IFAPRDxx entry:


PRODUCT OWNER(’IBM CORP’)
NAME('FAULT ANALYZER')
ID(5755-A02)
VERSION(*) RELEASE(*) MOD(*)
FEATURENAME('FAULT ANALYZER')
STATE(DISABLED)

If you change how a product is purchased, for example if 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):

In IFAPRDxx, define the new product as described above, and update the old product with STATE(DISABLED).
Activate the update using the following operator command:
```
SET PROD=xx 
```
You can now safely remove the old product definition from IFAPRDxx.

IBM® advises against defining IFAPRDxx entries that have NAME(*) or ID(*) fields, as this could result in unintended product registrations. If a match is found on an entry defined with NAME(*) and ID(*) with STATE(ENABLED), Fault Analyzer will register as product code 5755-A02.