Included members

You can divide the FMN3PARM across multiple members using the include specification. The format for an included member is as follows:

  • The first character of the line must be a '%' character.
  • Specify the member name to be included after the % character.
  • Specify a single member name only after the % character.

Multiple levels of include nesting are supported, circular (recursive) definitions will result in an error and FM/CICS will not initialize.

Empty included members are ignored.

Example 1:

Suppose in a sysplex environment there are 4 z/OS® images, with system IDs SYS1, SYS2, SYS3, and SYS4. File Manager is available on all images, with different auditing requirements on each image.

Include members can be used to code this as follows:

Member FMN3PARM

<Z SYS1>
%FMNPSYS1
</Z>
<Z SYS2>
%FMNPSYS2
</Z>
<Z SYS3>
%FMNPSYS3
</Z>
<Z SYS4>
%FMNPSYS4
</Z>

Member FMNPSYS1

FMAUDIT SAF_CTRL=YES

Member FMNPSYS2

FMAUDIT SAF_CTRL=NO

Member FMNPSYS3

FMAUDIT SAF_CTRL=NO

Member FMNPSYS4

FMAUDIT SAF_CTRL=YES

This has the advantage of consolidating all the options for each z/OS® image in a specific member.

If you used Method 1 to add member FMN3PARM to the logical parmlib concatenation (see Defining the FMN3PARM member for more information), be careful to avoid any conflicts between included member names and existing member names in the logical parmlib concatenation.