Enable/Register File Manager

Product enablement in IFAPRDxx

If you purchased File Manager as part of product code 5655-AC6 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(5655-AC6)
VERSION(*) RELEASE(*) MOD(*)
FEATURENAME('FILE-MANAGER')
STATE(ENABLED)

Sample registration parmlib entry FMNWIFAG, which contains the above statements, is provided in your hlq.SFMNSAM1 data set.

Alternatively and optionally, if you purchased File Manager separately (NOT as part of a bundle), you can include an entry for File Manager in the IFAPRDxx parmlib member as follows:

PRODUCT OWNER(’IBM CORP’)
NAME(’IBM FILE MANAGER’)
ID(5655-Q42)
VERSION(*) RELEASE(*) MOD(*)
FEATURENAME(’IBM-FM’)
STATE(ENABLED)

Sample registration parmlib entry FMNWIFA, which contains the above statements, is provided in your hlq.SFMNSAM1 data set.

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

SET PROD=xx 

Additional File Manager IFAPRDxx processing

If a product above is not defined in IFAPRDxx, when File Manager is first invoked it will register during initialization as IBM File Manager for z/OS, product code 5655-Q42.

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

To prevent File Manager from running, use the following IFAPRDxx entry:

PRODUCT OWNER(’IBM CORP’)
NAME(’IBM FILE MANAGER’)
ID(5655-Q42)
VERSION(*) RELEASE(*) MOD(*)
FEATURENAME(’IBM-FM’)
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):

  1. In IFAPRDxx, define the new product as described above, and update the old product with STATE(DISABLED).
  2. Activate the update using the following operator command:
    SET PROD=xx 
  3. 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), IBM File Manager for z/OS will register as IBM Application Delivery Foundation for z/OS® (product code 5655-AC6).