OA47937: CI310 PARMGEN 3Q15 ENHANCEMENTS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• A. 3Q15 Enhancements:
  " RFE: Provide PARMGEN Workflow UI improvements for:
  A. PARMGEN Configuration Framework Enhancements/Updates:
  1. Enhanced product globals end-to-end management (verifying
  globals on-line, viewing global parameter help on-line, creating
  globals, converting globals, copying globals) by supporting a
  new, user-customizable common globals source library
  ("GBL_DSN_GLOBAL_SOURCE_LIB" ) for products that provide KppGLB*
  global data members (OMEGAMON XE for CICS, OMEGAMON XE for IMS
  V5.3.0 and higher versions).  For brand new RTEs created
  starting at PARMGEN 2Q15 IF, this new dataset is automatically
  created, loaded and concatenated by PARMGEN in the
  product-specific started task's globals DDNAME (RKppGLBL DD).
  
  2. Enhanced the PARMGEN system and user variables handling by:
  o providing tailored IBM default variables profile
  (%GBL_USER_JCL%(KCI$RTEV)) based on customer's existing LPAR RTE
  profile customization values. ?Benefit:  For existing RTE
  deployments not yet enabled for variables or not using the best
  practice user symbols, having a tailored KCI$RTEV IBM variables
  profile that a customer can reference, to decide which
  resolution values to use for the best practice symbols (IBM
  default resolution values -or- resolution values extracted out
  of this user LPAR RTE profile) makes it easier and faster to
  convert to using variables in the RTE.  Having variables enabled
  in the product runtime members make it easier to deploy changes
  at product startup without having to reconfigure the runtime
  members.
  o enhancing %GBL_USER_JCL%(%RTE_NAME%) LPAR RTE variables user
  profile to provide handy placeholder examples of typical types
  of system variables used during PARMGEN System Variables RTE
  configuration such as Type 1: Static system symbols, - Type 2:
  PARMGEN KCIPARSE-extracted symbols and Type 3: User-defined
  symbols.  Additional user defined symbols are highlighted in the
  sample System Variables LPAR resolution member such as new
  &KOB_SITST_* OMEGAMON enhanced 3270 user interface Situation
  Status Tree related user symbols to make it easier to override
  the new OMEGAMON Enhanced 3270UI situation data collection
  parameters, etc. ?Benefit:  With these symbols already defined
  and set-up with the typical resolution values, customers can
  quickly uncomment out the symbolics that apply to them and thus
  save time from having to define.
  o enhancing the %GBL_USER_JCL%(KCI$RTEV) IBM default variables
  profile to provide additional handy system and user-defined
  symbols; pre-defined TKANSAM($MDLVARS) model introduced in 3Q14B
  PARMGEN IF is available for merging via KCIJPMCF merge profile
  job.    In 3Q15, the following best-practice user symbols are
  also added (&KOB_SITST_SAMPLE_MINUTES.,
  &KOB_SITST_RECENT_SLOTS., &KOB_SITST_HISTORY_SLOTs.,
  &KOB_SITST_HISTORY_RANGE., &KOB_SITST_INCLUDE_HUBS., and
  &KOB_SITST_EXCLUDE_HUBS., &KD5_CTIRA_SUBSYSTEM_ID., etc.)
  ?Benefit:  Provide tailored/predefined model user symbols for
  quicker deployment of operational changes (obviate the need to
  reconfigure the RTEs).  In PARMGEN 3Q14B IF (UA73689), we
  provided a tailored IBM-default variables profile in the PARMGEN
  global JCL library OOTBox for reference (in addition to the
  current WCONFIG and IKANSAMU copy under the IBM name of
  KCI$RTEV).  In PARMGEN 3Q15 IF (UA77851), we are also enabling
  the new user symbols above, as well as in the
  WCONFIG/IKANPARU(KOB$PENV) TOM KOBENV imbed (for placeholder
  KOB_SITST_* parms.) and in the WCONFIG(KD5$PENV) OMEGAMON XE for
  DB2 Agent's KD5ENV imbed (for placeholder
  *CTIRA_SUBSYSTEM_ID=&KD5_CTIRA_SUBSYSTEM_ID.).
  
  3. Provide additional PARMGEN Quick Configuration mode
  optimization and integration enhancements covering new and
  updated WCONFIG override imbeds such as WCONFIG(KCI$SSET) SET
  &vars. common imbed to INCLUDE MEMBER
  %RTE_X_STC_INAPF_MEMBER_NAME% new deployment parameters,
  additional best-practice user variables, additional IVP advanced
  validation checks to detect potential errors before production
  deployment, new and updated on-line POSTCFG important README
  steps that save deployment/reconfiguration time (now printable
  starting in 1Q15 IF), and other time-to-value deployment
  enhancements.
  
  4. Enhanced post-configuration on-line, printable README steps
  to aid in deployment:
  o Added POSTCFG KCI entry's new Step 12 - (Optional) If you plan
  to exploit the integration of IBM Operations Analytics for z
  Systems with the z/OS OMEGAMON products through the Tivoli
  Enterprise Portal (TEP) or through the Service Management Unite
  user interface, then complete enablement of the required
  components. "
  o Added POSTCFG KCI entry's new Step 13 - "(Optional) If you
  plan to exploit the OMEGAMON Serviceability Log Analysis,
  complete installation and configuration of the z/OS Log
  Forwarder component."
  o Updated POSTCFG KCI entry's Step 2 - "Copy procedures to
  %GBL_DSN_SYS1_PROCLIB%" to add a new Section 2F "Product started
  tasks and associated PROCSTEP:" table.
  o Added POSTCFG KCI entry's new Step 11 "(Optional) Start/stop
  available features dynamically" for various products to
  highlight the importance of dynamic commands that can obviate
  the need to have to reconfigure the products' runtime members
  when a certain function needs to be enabled or disabled.
  
  5. Provided the flexibility to override the JCL REGION value in
  additionall PARMGEN jobs, including the KCIJPCFG, KCIJPPRF,
  KCIJPUP1, $PARSE*-related "Set-up PARMGEN work environment"-type
  of jobs.  KCIP@PG2 panel externalizes the new GBL_REGION field
  for customer overrides.  ?Benefit:  Flexibility in accommodating
  site-specific exits that limit any REGION=0M specifications in
  batch jobs.
  
  
  ===END "Sub-section: A. 3Q15 RFEs>>A. Configuration Framework
  Enhancements/Updates:"
  
   B. PARMGEN-supported Application Configuration
  Enhancements/Updates:
  1. Tivoli Management Services:Engine infrastructure common to
  TEMS and Agents:
  o Provided placeholder parameter support for KDE_LOOPBACK_POOL.
  The KDE_TRANSPORT POOL: keyword does not permit configuration of
  socket port pools on the LOOPBACK device.  To accommodate this,
  the KDE_LOOPBACK_POOL parameter can be used to configure a pool
  of available ports associated with the loopback device from
  which all Tivoli Monitoring socket requests are satisfied.
  
  2. OMEGAMON Enhanced 3270 User Interface V7.3.0:
  o Provided support for KOB_SITST_* Situation Status Tree
  situation data collection placeholder parameters in
  WCONFIG(KOB$PENV) imbed to the RTE's RKANPARU(KOBENV)
  environmental runtime member.
  o Added FB-to-VB conversion support for the new
  xKANSAMU(KOBXKNCP) tailored copy job introduced in PARMGEN 2Q15
  IF, to copy OMEGAMON Enhanced 3270 User Interface support
  elements into the alternate
  %RTE_XKAN_HILEV%.XKANWENU/XKANHENU/XKANEXEC Tivoli OMEGAMON
  (TOM) datasets for other integration products that deliver
  workspaces and other OMEGAMON enhanced 3270UI support elements.
  The job comments were also updated with the DCB of the output
  OMEGAMON datasets.  An example of a product that provides this
  integration support is IBM DB2 Query Monitor for z/OS (KQQ)
  V3.2.  KOBXKNCP copy job is updated to add FB-to-VB conversion
  support if the product's input EXEC dataset is FB.
  o Modified existing post-configuration on-line, printable README
  steps to aid in deployment:
  " Updated POSTCFG KOB entry's Step 13 "(Optional) Complete
  enablement of alternate XKAN* Tivoli OMEGAMON (TOM) datasets for
  other integration products that deliver workspaces and other
  OMEGAMON enhanced 3270UI support elements." to highlight product
  integration with OMEGAMON enhanced 3270 user interface (enhanced
  3270UI) and to highlight the usage of a enhanced
  WKANSAMU(KOBXKNCP) sample copy job to make it easier to
  accommodate integrating enhanced 3270UI integration files coming
  from another CSI, into our TOM RTE XKAN* datasets, as well as
  the requirements when to use this job:
  " RTE where the OMEGAMON enhanced 3270UI is configured in
  " if the OMEGAMON enhanced 3270UI reports to a z/OS-based Hub
  TEMS, submit this job in the RTE where the z/OS Hub TEMS is
  configured (if other than the same local LPAR RTE where the
  OMEGAMON enhanced 3270UI is configured in) .
  
  3. OMEGAMON XE for IMS V5.3.0:
  o This is JOBGEN SMP/E installation and PARMGEN application
  configuration support for the new version of OMEGAMON XE for IMS
  product (HKI5530 FMID).  The following configuration
  enhancements are provided in support of new features delivered
  in this new version.  For more information, please refer to the
  product's IBM Knowledge Center publication
  (https://www.ibm.com/support/knowledgecenter/SSXS8U/com.ibm.omeg
  amon_ims.doc_5.3.0/welcome.htm?lang=en)
  o Added JOBGEN TKCIINST(KCIDJG00) new version SMP/E installation
  support for new HKI5530 FMID.
  o Added IMS V14.1 KOICTOQ module support in the COPYKOIM step
  and in the SP51410 step of the composite KCIJPSEC "Run product
  security steps" job, and in the standalone OMXE IMS-specific
  equivalent job (KOISUPD).  These jobs are tailored by PARMGEN's
  $PARSE* "Create this RTE's runtime members and jobs." In the
  RTE's xKANSAMU dataset.
  o Added IMS V14.1 KI2BMPO0 module support in the LKEDKI2 step of
  the composite KCIJPLNK "Run post-SMP/E RKANMODU ASM/LINK steps"
  job, and in the OMXE IMS-specific equivalent job (KI2BLDLI).
  These jobs are tailored by PARMGEN's $PARSE* "Create this RTE's
  runtime members and jobs." In the RTE's xKANSAMU dataset.
  o Added OMEGAMON XE for IMS Near-term history support in the
  OMEGAMON enhanced 3270 user interface.
  o Added support for KIPGLBgb Global data (text format).  You no
  longer specify global definitions for Response Time Analysis
  groups and Bottleneck Analysis in a KOIGBL* load module that you
  compile for each IMS subsystem monitored in the LPAR. You now
  specify the definitions in a source member, KIPGLBgb that is
  dynamically loaded from the RKIPGLBL DD data set when the
  OMEGAMON for IMS Classic address space starts.  In addition, the
  GLOBAL parameter of the START command is deprecated. Instead,
  you specify GLOBAL=xx in the PARM setting of the OMEGAMON for
  IMS Classic address space startup procedure, where xx is the
  suffix of the KIPGLB member in the RKIPGLBL DD data set that
  contains the globals for the Classic address space to use.  The
  GBL_DSN_GLOBAL_SOURCE_LIB parameter in PARMGEN identifies the
  data set that contains the global definition members. This data
  set and the global definition members in it can be shared across
  multiple runtime environments. The KI2_I1nn_CLASSIC_GLOBAL
  parameter in PARMGEN identifies the suffix of the KIPGLB globals
  member for the OMEGAMON for IMS Classic address space to use.
  PARMGEN KCIJPLOD job automatically creates the default KIPGLB99
  global definitions member for a new RTE. However, you can also
  use the KIPGLBCR sample that is provided in RKANSAMU to create
  members.   If you are upgrading to V5.3, PARMGEN KCIJPLOD job
  automatically converts your old KOIGBL* global modules to the
  KIPGLB* global text format.  You have the option to use the
  standalone KIPGLBCV sample in RKANSAMU to convert your KOIGBLxx
  load modules to KIPGLBgb source members.  KCIJPLOD job performs
  these functions to populate the GBL_DSN_GLOBAL_SOURCE_LIB
  without replace, to preserve any existing globals.  PARMGEN
  provides the following tailored standalone jobs in xKANSAMU:
  " KIPGLJOB KIPGLB* composite create globals job with replace
  (creates globals directly in GBL_DSN_GLOBAL_SOURCE_LIB)
  " KIPGLBCR KIPGLB* create global job (model)
  " KIPGLCgb KIPGLB* create global job (per KI2_I1nn_* IMS row)
  " KIPGLBVR KIPGLB* verify global job (model)
  " KIPGLVgb KIPGLB* verify global job (per KI2_I1nn_* IMS row)
  " KIPGLBCV KOIGBL*-KIPGLB* convert globals job
  (where gb = GLOBAL suffix)
  o Added z/OS System Logger support for the Application Trace
  Facility (ATF) function.  OMEGAMON XE for IMS ATF function now
  uses the z/OS System Logger to store application trace data in
  log streams. You provide the log stream information when you run
  PARMGEN to configure the OMEGAMON XE for IMS on z/OS product.
  You must then run post-configuration jobs to create the log
  streams and define them to the z/OS System Logger. You can use
  Coupling Facility (CF) list structure-based log streams or
  DASD-only log streams.  Changes are:
  " New DETLLOGR, SUMMLOGR, DETXLOGR and SUMXLOGR parameters in
  the RKANPARU(KI2ATF%KI2_I1nn_CLASSIC_MPREFIX%) ATF startup
  member.
  " New RKANPARU(KOICFG%KI2_I1nn_CLASSIC_MPREFIX%) ATF startup
  member.
  " New RKANSAMU jobs:
  " KI2ATL%KI2_I1nn_CLASSIC_MPREFIX% Sample job to define z/OS Log
  Streams for ATF per IMS subsystem configured in the RTE.
  " KI2ATLGR Composite sample job to define z/OS Log Streams for
  ATF for all IMS subsystem configured in the RTE.
  " KI2ATCFR   Sample job to define Coupling Facility Structures
  ATF Log Streams.
  o Added new post-configuration on-line, printable README steps
  to aid in deployment:
  " New POSTCFG KI5 entry's Step 8 "Implement the DFSPPUE0 IMS
  command (ICMD) user exit." and new Step 9 "Update IMS control
  region JCL." in support of  OMEGAMON XE for IMS on z/OS command
  support for IMS commands (type-1 and type-2) that can now be
  issued from the OMEGAMON enhanced 3270 user interface.
  " New POSTCFG KI5 Step 10 "Define z/OS System Logger Log Streams
  for Application Trace Facility (ATF)" to define z/OS System
  Logger Log Streams for Application Trace Facility (ATF).
  " New POSTCFG KI5 Step 11 "(Optional) Start/stop product
  functions dynamically." to highlight the importance of dynamic
  commands that can obviate the need to have to reconfigure the
  OMXE for IMS runtime members when a certain function needs to be
  enabled or disabled.
  
  4. OMEGAMON XE for Mainframe Networks V5.3.0:
  o This is JOBGEN SMP/E installation and PARMGEN application
  configuration support for the new version of OMEGAMON XE for
  Mainframe Networks product (HKN3530 FMID).  The following
  configuration enhancements are provided in support of new
  features delivered in this new version.  For more information,
  please refer to the product's IBM Knowledge Center publication
  (https://www.ibm.com/support/knowledgecenter/SS2JL7/com.ibm.omeg
  amon.mn.doc_5.3.0/welcome.htm?lang=enhttps://www.ibm.com/support
  /knowledgecenter/SSXS8U/com.ibm.omegamon_ims.doc_5.3.0/welcome.h
  tm?lang=en)
  o Added JOBGEN TKCIINST(KCIDJG00) new version SMP/E installation
  support for new HKN3530 FMID.
  o Added OMEGAMON XE for Mainframe Networks Near-term history
  support in the OMEGAMON enhanced 3270 user interface. In support
  of enhanced 3270UI NTH support for this product, its ITM
  persistent datastore sequential files' allocated PDS cylinder
  size (KN3_PD_CYL LPAR RTE profile parameter) has been increased
  to 420 cylinders by default.
  o Added new post-configuration on-line, printable README steps
  to aid in deployment:
  o New POSTCFG KN3 Step 11 "(Optional) Start/stop product
  functions dynamically." to highlight the importance of dynamic
  commands that can obviate the need to have to reconfigure the
  OMXE for Mainframe Networks runtime members when a certain
  function needs to be enabled or disabled.
  
  5. OMEGAMON XE for CICS on z/OS V5.1.0 and higher versions:
  o Provided support for exploiting a new
  "GBL_DSN_GLOBAL_SOURCE_LIB" common product globals source
  library allowing management of the KC2GLB* globals via PARMGEN
  on-line support (verify globals, on-line parameter help).
  ?Benefit:  Flexibility in accommodating a common dataset that
  PARMGEN allocates to house globals from products that support
  these global data members.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All PARMGEN configuration users.             *
  ****************************************************************
  * PROBLEM DESCRIPTION: RFE: Provide PARMGEN Workflow UI 3Q15   *
  *                      improvements for: A. PARMGEN            *
  *                      Configuration Framework                 *
  *                      Enhancements/Updates: B. PARMGEN        *
  *                      Application Configuration               *
  *                      Enhancements/Updates:                   *
  ****************************************************************
  * RECOMMENDATION: Apply the PTF.                               *
  RFE: Provide PARMGEN Workflow UI 3Q15 improvements for: A.
  PARMGEN Configuration Framework Enhancements/Updates: B. PARMGEN
  Application Configuration Enhancements/Updates:
  

Problem conclusion

Temporary fix

Comments

• This is PARMGEN 3Q15 Interim Feature update.
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UA77851

Modules/Macros

• KCIPRMLB KDSPRMLB KI5PRMLB
  

Fix information

• Fixed component name

  PARMGEN ICAT CO

• Fixed component ID

  5608A41CC

Applicable component levels

• R310 PSY UA77851

     UP15/08/11 P F508

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.