Defining the FMN1PARM member

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

Default parmlib member FMN1PARM is provided in the SFMNSAM1 library. Copy this member to the appropriate system parmlib library.

Note: The sample FMN1PARM member supplied in SFMNSAM1 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 FMN1PARM 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 FM/IMS users READ access to the data set SYS1.PARMLIB.

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

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

Method 1
Place the FMN1PARM 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 FM/IMS users do not have READ access to SYS1.PARMLIB. For example, when FM/IMS users have READ access to another library in the logical parmlib concatenation, and the FMN1PARM member is placed in the latter library. This will not work. The key issue is whether the FM/IMS user has READ access to SYS1.PARMLIB.
Method 2
This method must be used when FM/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 "FMNPARM" 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.FMNPARM
    • SYS8.FMNPARM.PARMLIB
    • FMNPARM.SYS8.PARMLIB
    • SYS2.FMNPARMS.LIB
    • SYS8.XFMNPARM.PARMLIB
  2. Add member FMN1PARM 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 FMN1PARM member must be located in the library created in step 1. If the FMN1PARM member specifies any include statements (see Facilities for customizing the FMN1PARM definitions), all of the included members must also reside in the same library.
You use the FMN1PARM member to define:
  • Whether FM/IMS uses SAF to control FM/IMS audit logging.
  • The SAF resource name prefix to be used by FM/IMS when determining access to various resources.
  • Whether FM/IMS loads the FMN1POPT module from a specific library.

For more information, see FM/IMS options specified in FMN1PARM.