PM14576: PLTPI EXEC CICS START COLM TRANSIDERR INITIALIZATION

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The customer needs to delay a CICS MAS
  from joining a workload
  until after all initialization is complete.
  To do this, he
  - defines CPSMCONN=NO
  - does not use EYU9NXSM in the PLTPI
  so that the the MAS client does not start immediately.
  .
    He still wants the MAS client to start automatically
  once initialization is complete. To do this,
  his own PLTPI program issues an
  EXEC CICS START for the COLM transaction with a delay time.
  .
    This process worked until this release of CICS.
  In the current release, the CPSM transaction definitions
  are created automatically.  But, the COLM transaction defintion
  is not added until the very end of the PLTPI process.
  So, the EXEC CICS START command fails with:
  <><><><><><><><><><><><><><><><><><-><><><><><><><><><><><><>
  EIP   ENTRY START
  XMLD  ENTRY LOCATE_AND_LOCK_TRANDEF COLM
  DDLO  ENTRY LOCATE             2FA00060,35E69C5C,TXD,COLM
  DDLO  EXIT  LOCATE/EXCEPTION   NOT_FOUND,00000000 , 00000000
  XMLD  EXIT  LOCATE_AND_LOCK_TRANDEF/EXCEPTION NOT_FOUND,
  PGHM  ENTRY INQ_CONDITION         1C
  PGHM  EXIT  INQ_CONDITION/OK  AEX1,B1801C82,0005BA48,
  EIP   EXIT  START                 TRANSIDERR
  <><><><><><><><><><><><><><><><><><-><><><><><><><><><><><><>
  The stops the MAS agent from starting automatically.
    If the automatic definition of the COLM transaction
  could be moved forward in the process,
  so that it is available early enough for the START command,
  it would allow the customer to continue with his configuration.
  

Local fix

• Add the EYU$MDEF group from the SEYUSAMP library
  to the CSD of the affected CICS region.
  Add that group to the List for that region.
  This will create the defintions for PLTPI time.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: A PLTPI program gets a TRANSIDERR       *
  *                      response from an EXEC CICS START(COLM)  *
  *                      request.                                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A PLTPI program issues EXEC CICS START(COLM) to start a
  CICSPlex SM MAS and receives a TRANSIDERR response.
  
  For CICS TS 3.2 and subsequent releases, COLM is installed
  after the PLT programs have executed. In earlier releases
  it was installed before linking to the PLT programs.
  
  Note:
  The transaction definition installed by DFHSIPLT for COLM
  has CMDSEC(NO) and RESSEC(NO). However the customer
  specifies the SIT parameter CMDSEC(ALWAYS). COLM includes
  issuing EXEC CICS CREATE requests for PROGRAMs, TRANSACTIONs,
  a TDQUEUE and a PROFILE. If CMDSEC is active then ALTER access
  is required for the userid that runs COLM.
  As the customer's rules would not permit ALTER access being
  given for TDQUEUEs and PROFILEs, this security matter was
  resolved by installing the resources from a CSD group
  using definitions copied from the EYU½MDEF sample in SEYUSAMP.
  
  EYU½MDEF is provided for those customers who need to modify
  the MAS resource definitions to suit their environment but,
  in this case, the attributes are unchanged and it is just being
  used to resolve the security problem.
  
  Additional keywords: TRANSIDERR DFHSI1580D msgDFHSI1580D AEI1
                       PLT
  

Problem conclusion

• DFHSIPLT is changed to install the CICSPlex SM initial
  transactions and programs before linking to the PLT
  programs.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK59125

Modules/Macros

•    DFHSIPLT
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK59125

     UP10/07/29 P F007

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.