PTF UJ93804 for APAR OA65222 (3Q23)

PTF UJ93804 for APAR OA65222 (3Q23) provides Configuration Manager enhancements, including new GENERATE action options RELINK and QUICKCONFIG, improvements in job output reporting, support for symbolics in parameter RTE_X_OVERRIDE_EMBEDS_LIB, and support for discovering subsystem aliases. Additional enhancements have also been made for configuring the OMEGAMON enhanced 3270 user interface.

Configuration Manager-only updates

The following changes have been made:
  • The GENERATE action has been updated to introduce the following OPTION keywords:
    RELINK
    This option allows you to rerun only the assembly and link-edit steps for modules shipped by products OMEGAMON for Networks (KN3) and OMEGAMON enhanced 3270 user interface (KOB).
    QUICKCONFIG
    This option skips the reloading of SMP/E modules into the runtime environment and provides significant reduction in resources used by the GENERATE action. The runtime environments that will benefit the most from this option are full runtime environments (RTE_TYPE parameter is set to FULL).

  • Configuration Manager jobs will now print fewer lines of output than previously, resulting in significantly reduced spool usage.

    Configuration Manager jobs now delete most of the substep DD outputs from the JES spool. There are some exceptions, such as KCIPRINT, KCITRACE, KCIVARSO, and other similar, important DD outputs. Automatically deleting this output significantly reduces spool usage and should help to successfully run the GENERATE action on systems where output line limitations exist. Since the number of output lines still varies, you should check the impact on your individual runtime environment setups and adjust the limits accordingly.

    If a Configuration Manager job fails, the DD statement that contains the error message is printed in addition to the regular DD statements. OPTION DEBUG has been added to re-enable the printing of the entire output; this option is only needed for troubleshooting.
    Note: Deletion of DD outputs is not supported in JES3. The debugging option can still be used if required, but its function is limited to printing additional debugging messages.
  • In the GENERATE and MIGRATE actions, you can now see stage completion messages issued to KCIPRINT. These messages give you a better understanding of how far the job has progressed.
  • Support for symbolics has been added to the Configuration Manager-only parameter RTE_X_OVERRIDE_EMBEDS_LIB. You can now use system variables, like in the respective security exits parameter (RTE_X_SECURITY_EXIT_LIB).
  • The DISCOVER action now honors subsystem aliases during discovery, which impacts the following parameters for Db2, IMS, and TCP/IP, respectively: KD2_DBnn_DB2_LOADLIB, KI2_I1nn_CLASSIC_IMS_RESLIB, KN3_TCPXnn_TCPIP_PROFILES_DSN

Product-specific updates

OMEGAMON enhanced 3270 user interface
The following changes have been made:

  • The default OMEGAMON enhanced 3270 user interface (KOB) UKOBDATF data set allocation size has been increased to 100 directory blocks, and the space allocation has been increased to CYL(1,5). This update impacts both Configuration Manager and PARMGEN.

    The UKOBDATF data set is not reallocated automatically by the configuration software. The new allocation size applies only to new runtime environments. If you want to change an existing UKOBDATF data set to use the new recommended size, you must manually reallocate it.

  • Parameter KOB_TIMEOUT was added to OMEGAMON enhanced 3270 user interface (KOB) configuration. This parameter can be used to control the TIMEOUT parameter in the IBM OMEGAMON enhanced 3270 user interface started task JCL, in the PARM=() section. This update impacts both Configuration Manager and PARMGEN.