PM15214: CICS DEVELOPMENT ENHANCEMENT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: Provide the ability to access the CICS  *
  *                      Transaction Server Startup              *
  *                      Initialization Table parameters (SIT)   *
  *                      and any overrides supplied at run-time. *
  *                      Access to this information is via the   *
  *                      CICSPlex SM API and is available from   *
  *                      CICS 660 regions.                       *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and MASes must be           *
  *                 restarted.  Note that the restarts do not    *
  *                 need to occur at the same time.              *
  ****************************************************************
  Solution is provided at the CICS and CPSM levels:
  
  CICS changes (provided by the PTF that resolves APAR PM15583):
  
  A new Parameter Domain (PA) gate was introduced to allow queries
  of System Initialization parameters from either the assembled
  SIT, or from the SYSIN, JCL EXEC parm or Console streams.
  Changes were applied to DFHPAA, DFHPAGR, DFHPADM, DFHPAGP,
  DFHPATRI and DFHTT660. New module DFHPAIN was added to service
  the new INQUIRE_PARM gate.
  
  No new messages are introduced, but three new Parameter Domain
  CICS trace entries are added:
  
  PA0501 DFHPAIN PA 1  Entry  PAIN parameter list
  PA0502 DFHPAIN PA 1  Exit  PAIN parameter list
  PA0503 DFHPAIN Exc   Unknown SIT parameter
  
  CPSM changes (provided by the PTF that resolves APAR PM15214):
  
  A new SYSPARM Operations Base Table is introduced to allow the
  query of System Parameters.
  
  The new SYSPARM object requires two manadatory parameters to
  issue a query:
  
  - PARMTYPE ... must be set to SIT
  - PARMSRCE ... must be set to one of the following:
                 TABLE
                 CONSOLE
                 SYSIN
                 JCL
                 COMBINED
  
  The keyword attributes for the new SYSPARM table are:
  
  - KEYWORD ... the parameter keyword to be retrieved
  - SEGNUM  ... the keyword value segment number to be retrieved
  
  Typically, one SYSPARM record will be returned for each
  keyword/value pair designated by the PARMTYPE/PARMSRCE
  combination. In cases where the returned keyword value is longer
  than 255 bytes, then the value is segmented on 255 byte
  boundaries, with the SEGNUM and SEGLEN attributes describing
  where the current VALUE data occurs in the overall physical
  record.
  
  No Web User interface views are shipped with this APAR, but
  users may construct their own SYSPARM views using the WUI view
  editor.
  

Problem conclusion

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• After applying the PTF that resolves this APAR, all CMASes and
  MASes must be restarted.  Note that the restarts do not need to
  occur at the same time.
  ž**** PE10/11/11 PTF IN ERROR. SEE APAR PM26580  FOR DESCRIPTION
  

APAR Information

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

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

Modules/Macros

•    EYU#NQGR EYUA0197 EYUBCRTB EYUCCRSQ EYUCNQGR
  EYUCXXRS EYUC0197 EYUE0197 EYUK0197 EYUL0197 EYUNNQGR EYUP0197
  EYUQNAGR EYUQNEP1 EYUQNQGR EYUQNQRA EYUQNQRB EYUQNQRC EYUQNQRD
  EYUQNQRE EYUQNQRG EYUQXXRC EYUQ0197 EYURNEP1 EYURNQGR EYURNQGW
  EYURNQRA EYURNQRB EYURNQRC EYURNQRD EYURNQRE EYURNQRG EYUR0197
  EYUS0197 EYUTCRTB EYUTMOMI EYUTMOSD EYUTNAGA EYUTNAGB EYUTNAGC
  EYUTRDIR EYUTRMAS EYUTVOSX EYUTVTGE EYUTVTGK EYUTVTGS EYUT0197
  EYUUCRSQ EYUUNAEQ EYUUXXFI EYUUXXRS EYUUXXTC EYUYNEP1 EYUYNQGR
  EYUYNQRA EYUYNQRB EYUYNQRC EYUYNQRD EYUYNQRE EYUYNQRG EYUY0197
  EYUZNEP1 EYUZNQGR EYUZNQRA EYUZNQRB EYUZNQRC EYUZNQRD EYUZNQRE
  EYUZNQRG EYU0CRCK EYU0DXRC EYU0NEP1 EYU0NHCT EYU0NPGR EYU0NQGF
  EYU0NQGR EYU0NQGT EYU0NQHT EYU0NQK1 EYU0NQK3 EYU0NQK6 EYU0NQK7
  EYU0NQK8 EYU0NQK9 EYU0NQPG EYU0NQRA EYU0NQRB EYU0NQRC EYU0NQRD
  EYU0NQRE EYU0NQRG EYU0NQSN EYU0NQTK EYU0NSDC EYU0NSGR EYU9NAPU
  EYU9NAP3 EYU9NAP4 EYU9NAP6 EYU9NARU EYU9NAR3 EYU9NAR4 EYU9NAR6
  EYU9XMAL JCI660MJ R66KERN  SYSPARM
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UK60399

     UP10/09/18 P F009

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.