Defining the HFM1PARM member

If auditing is to be controlled from parmlib (user has read access to FILEM.PARMLIB.IMS, see SAF-controlled auditing for Z Data Tools IMS component), then member HFM1PARM must be defined in SYS1.PARMLIB (or any other library in the logical parmlib concatenation) as follows.

Default parmlib member HFM1PARM is provided in the SHFMSAM1 library. Copy this member to the appropriate system parmlib library.

Note: The sample HFM1PARM member supplied in SHFMSAM1 also includes a FMSECRTY statement. This option is not used at present, and can be either omitted, or commented out. It has no effect.

There are two methods that can be used to include the HFM1PARM member in a library in the logical parmlib concatenation. The choice of method depends on whether the installation's security software is configured to allow ZDT/IMS users READ access to the data set SYS1.PARMLIB.

Method 1 can only be used when ZDT/IMS users have read access to SYS1.PARMLIB.

Method 2 can be used regardless of whether ZDT/IMS users have READ access to SYS1.PARMLIB or not, and must be used when ZDT/IMS users do not have READ access to SYS1.PARMLIB.

Method 1
Place the HFM1PARM member in any library in the current logical parmlib concatenation. No IPL or other action is required to activate the new member (unless a new library was added to the logical parmlib concatenation).
Note:
  1. Method 1 cannot be used in any situation where ZDT/IMS users do not have READ access to SYS1.PARMLIB. For example, when ZDT/IMS users have READ access to another library in the logical parmlib concatenation, and the HFM1PARM member is placed in the latter library. This will not work. The key issue is whether the ZDT/IMS user has READ access to SYS1.PARMLIB.
Method 2
This method must be used when ZDT/IMS users do not have READ access to SYS1.PARMLIB.
  1. Create a new library with dataset attributes similar to SYS1.PARMLIB.
    The library name for this data set must include the string "HFMPARM" in one of the qualifiers. You can choose any data set name that meets this requirement. Examples of suitable data set names are:
    • SYS1.PARMLIB.HFMPARM
    • SYS8.HFMPARM.PARMLIB
    • HFMPARM.SYS8.PARMLIB
    • SYS2.HFMPARMS.LIB
    • SYS8.XHFMPARM.PARMLIB
  2. Add member HFM1PARM to the new library, specifying the appropriate FMAUDIT parameter.
  3. Add the new library to the logical parmlib concatenation. This can be done dynamically, or by means of a system IPL.
Note: When Method 2 is used, the HFM1PARM member must be located in the library created in step 1. If the HFM1PARM member specifies any include statements (see Facilities for customizing the HFM1PARM definitions), all of the included members must also reside in the same library.
You use the HFM1PARM member to define:
  • Whether ZDT/IMS uses SAF to control ZDT/IMS audit logging.
  • The SAF resource name prefix to be used by ZDT/IMS when determining access to various resources.
  • Whether ZDT/IMS loads the HFM1POPT module from a specific library.

For more information, see ZDT/IMS options specified in HFM1PARM.