PK77943: REMOTE JAVA PROGRAM FAILS TO RETURN TO TOR

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• JAVA program runs successfully, remotely across an MRO link,
  however CICS fails to report program completion normally, due to
  RC=0C from an IRC SWITCH SUBSEQUENT request in the AOR.  Return
  code x'C' is IRC_RETC, reporting "Environment Incorrect".  This
  occurs because the IRC SWTICH SUBSEQUENT is submitted from the
  J9 TCB, instead of the QR TCB.
  Application is performing EXEC CICS INQUIRE TERMINAL on the QR,
  but on exit EIS_PROGRAM_MODE incorrectly indicates caller's TCB
  was 'J9'.
  Additional Symptom(s) Search Keyword(s):
  DFHSM0002 severe error 3021 occurred in module DFHSMSU.
  Abend AZTS occurred when trying to send data to the remote
  system over IRC.  Trace shows the following trace entry:
  ZIS2  EVENT IRC SWITCH SUBSEQUENT TO SYSTEM (CIUT01)
        RETURN CODE WAS 0000000C
  the RC 0000000C indicates:IRERRINE-Environment incorrect
  This is due to running on an L9 TCB.
  They were running with transaction isolation - traniso and
  the following exception occurred:
  L900E SM 3001 SMSU  ENTRY RELEASE_SUBSPACE  5AE3F4A4,5AE3D3A0
  L900E SM 3021 SMSU  *EXC* Under_a_TCB_other_than_QR
                            RELEASE_SUBSPACE,5AE3F4A4,5AE3D3A0
  
  
  KIXREVSXY
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: A JAVA program runs successfully in     *
  *                      an MRO connected AOR but the response   *
  *                      is never received in the TOR.           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A JAVA application runs on a J9 TCB and completes its job.
  However, when it tries to report back to the TOR via an IRC
  SWITCH SUBSEQUENT, this fails with return code 0000000C. The
  return code x'C' is IRC_RETC and relates to error IRERRINE,
  Environment Incorrect.
  This is due to trying to do the IRC SWITCH SUBSEQUENT from the
  J9 instead of the QR TCB.
  This is down to the fact that an EXEC CICS INQUIRE TERMINAL
  command is issued by a vendor product during task termination.
  This runs on QR but at the end switches back to the mode in
  EIS_PROGRAM_MODE which is J9. This then causes problems
  for the terminal control code that follows.
  The same problem can also occur when the initial program is
  defined as OPENAPI and THREADSAFE.
  

Problem conclusion

• DFHXMTA has been changed to set eis_program_mode to QR and
  switch off flags eis_abterm_allowed_switch, eis_recovery_switch
  and eis_reset_runaway_switch on return from DFHPGPG function
  INITIAL_LINK.
  

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:

  UK44954

Modules/Macros

•    DESXMAT  DFHXMTA
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK44954

     UP09/03/21 P F903

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.