(Optional) Define SAF application ID

You can optionally specify a SAF application ID for use with the OMEGAMON enhanced 3270 user interface, overriding the default value.

Before you begin

The OMEGAMON enhanced 3270 user interface reads the PDS member rte_plib_hilev.rte_name.RKANPARU(KOBENV) to obtain the SAF security configuration values for authentication and authorization.

Parameter KOB_SAF_APPLID can be added to the file to specify the SAF application ID. If parameter KOB_SAF_APPLID is omitted from RKANPARU(KOBENV), the value CANDLE will be used.

About this task

The default value for the SAF application ID that is used for the enhanced 3270 user interface is CANDLE. You can change this value by adding the KOB_SAF_APPLID parameter to the RKANPARU(KOBENV) member of the runtime environment in which the enhanced 3270 user interface is configured. For example:

KOB_SAF_APPLID=safapplid
where safapplid is the name of the SAF application ID.

You can use the embed file KOB$PENV to add the statement to the RKANPARU(KOBENV) file, which prevents the parameter from being overwritten when updates or maintenance is applied.

Procedure

To define the SAF application ID for your OMEGAMON enhanced 3270 user interface, overriding the default value, perform the following steps using either of the following methods:
  • Using Configuration Manager:
    1. Add the following statement to the rte_plib_hilev.rte_name.EMBEDS(KOB$PENV) embed file:
      KOB_SAF_APPLID=safapplid
      where safapplid is the name of the SAF application ID.
    2. Run the GENERATE command.
      The contents of the KOB$PENV file are dynamically embedded in the KOBENV file.
    Recycle the OMEGAMON enhanced 3270 user interface started task for the configuration changes to take effect.
    Note: For more information about changing parameter values after you have completed configuration of the runtime environment using Configuration Manager, see Creating or updating a runtime environment.
  • Using PARMGEN,
    1. Add the following statement to the WCONFIG(KOB$PENV) embed file:
      KOB_SAF_APPLID=safapplid
      where safapplid is the name of the SAF application ID.
    2. Submit the $PARSE job to refresh the profile.
      The contents of the KOB$PENV file are dynamically embedded in the KOBENV file.
    Recycle the OMEGAMON enhanced 3270 user interface started task for the configuration changes to take effect.
    Note: For more information about changing parameter values after you have completed configuration of the runtime environment using PARMGEN, see Scenario RTE03: Changing parameters in an RTE.