KFJ_SYSNAME

Edit online

This parameter defines the system name (SYSNAME), LPAR name, or SYSSMFID to use in runtime environment configuration members.

Note: KFJ_SYSNAME is an internal parameter that automatically assigns the value of SYSNAME, but it is possible to specify a different value for KFJ_SYSNAME in the KCIVARS DD as well.
Description

This parameter is specified in the KCIVARS DD statement of the JCL that runs the Configuration Manager jobs (for example, the KFJJMCM sample job in TKANSAM).

This parameter is used for the following purposes:
  • Used with OPTION MULTIPLE to create (or migrate) multiple runtime environments in a single RTEDEF library. The KFJ_SYSNAME parameter value replaces lpar in member name Kpp$lpar for the generated members. For more information, see CREATE and MIGRATE.
  • Used for remote deployment to generate runtime environments on a single local system that can then be deployed to remote target systems. For more information, see Deploying remote runtime environments.
  • Used to assign the system name if you use a SYSNAME that is larger than 4 characters (5 - 8 characters) and the SYSSMFID is not assigned or the default SYSSMFID setting is not acceptable.

    Normally, a SYSNAME is 1 - 4 characters in length; however, if a system has a longer SYSNAME, you can use the KFJ_SYSNAME parameter to override it. The KFJ_SYSNAME parameter value replaces the value assigned to the &SYSNAME parameter when generating member names for the DISCOVER, GENERATE, and MIGRATE actions. The following rules apply:

    • If the value for &SYSNAME is 4 characters or less, the value for KFJ_SYSNAME equals the &SYSNAME.
    • If the value for &SYSNAME is 5 - 8 characters in length, the value for KFJ_SYSNAME equals the &SYSSMFID parameter, which is the SMF ID.
    • If the value for &SYSSMFID is not set explicitly, the system defaults to the CPU model number.

    If the KFJ_SYSNAME value has been set for &SYSSMFID, warning message KFJ00205W is issued in the KCIPRINT member. This message states that you can provide (override) a custom KFJ_SYSNAME value (in KCIVARS DD) when running the Configuration Manager job. This action allows you to avoid duplicate member names in the RTEDEF data set, in case the &SYSSMFID is set to default to the CPU model number.