PH64381: DFHRL2136 S WHEN USING MORE THEN ONE SET CICSPLEX COMMAND IN ONE DFHDPLOY STEP

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When using SET CICSPLEX command several times in one DFHDPLOY
  step, the SET PROG commands after the second SET CICSPLEX
  command does fail.
  
  The SET PROGRAM commands after the first SET CICSPLEX will be
  completed successfully. After switching the CICSplex by a second
  SET CICSPLEX command, the next SET PROGRAM command returns the
  following error message:
  
  DFHRL2136 S Internal API Error has occurred.
  

Local fix

• Use only one SET CICSPLEX in one DFHDPLOY step
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM users                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: In DFHDPLOY, when running multiple      *
  *                      "SET PROGRAM" commands to two different *
  *                      CICSPLEXes the "SET PROGRAM" commands   *
  *                      after the second "SET CICSPLEX" command *
  *                      fail with                               *
  *                      DFHRL2136S Internal API Error has       *
  *                      occurred. Please contact IBM Support.   *
  *                      DFHRL2055I Errors have occurred,        *
  *                      processing terminated.                  *
  ****************************************************************
  While running DFHDPLOY in batch to update multiple programs in
  multiple CICSPLEXes in a single step, all SET PROGRAMs after the
  second SET CICSPLEX fail.
  
  As part of the second SET CICSPLEX, the connection to the CMAS
  is disconnected and a new connection is made. As part of the
  disconnect process all existing resultsets are removed.
  
  Subsequent SET or DEPLOY cmds fail because they try to reuse a
  resultset that no longer exists.
  

Problem conclusion

• As part of the first SET PROGRAM, DFHDPLOY issues a GET
  OBJECT(SYSPARM)...RESULT(SYSPRTKN.1) CPSM API command. The
  result set identified by the token in SYSPRTKN.1 is reused on
  subsequent calls. However after the change of CICSPLEX causing
  a CPSM API DISCONNECT and CONNECT to the CMAS. the result
  set no longer exists and the GET OBJECT, for any SET or DEPLOY
  cmd, fails with,
  RETCODE=1028=INVALIDPARM REASONCODE=1283=RESULT.
  
  In DFHDPLOY routine Disconnect_Context, which disconnects from
  the CMAS and destroys existing resultsets we will DROP variable
  SYSPRTKN.1.  The next GET OBJECT(SYSPARM) will then reinitialise
  the variable and the resultset can be reused until the next
  disconnect.
  

Temporary fix

Comments

APAR Information

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

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

  UO02559 UO02560

Modules/Macros

• DFHDPLOY
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UO02560

     UP25/03/28 P F503

• R500 PSY UO02559

     UP25/03/27 P F503

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.