PH07331: CONSOLE COMMAND TO INITIATE A TRANSACTION TREATED AS INVALID DATA WHEN CICS HAS BEEN SHORT ON STORAGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Two separate Modify commands send input into CICS from the same
  console.   Those commands are:
  .
  F cicsjob1,CKQC STOPCKTI
  .
  followed a few seconds later by
  .
  F cicsjob1,CEMT P SHUT
  .
  CICS is going in and out of SOS.
  .
  The CKQC transaction uses EXEC CICS RETURN TRANSID('CKSQ')
  IMMEDIATE INPUTMSG() to initiate transaction CKSQ to perform
  the STOPCKTI.
  .
  At the moment when CICS tries to attach the CKSQ transaction,
  CICS is SOS.  When SOS ends, CICS still does not attach CKSQ.
  .
  Nothing happens until the next input, CEMT P SHUT in this case,
  comes in.  At that time, CKSQ begins and when it does EXEC CICS
  RECEIVE, it receives 'CEMT P SHUT' rather than what was passed
  by CKQC via the INPUTMSG parameter on the RETURN TRANSID
  IMMEDIATE.  This causes the CKSQ program to issue this message:
  .
  DFHMQ0389 Invalid input. Start/Stop CKTI rejected.
  .
  Also, no CEMT transaction begins to do the Perform Shut.
  .
  A similar problem to this can happen to any transaction that is
  initiated by input from a console, and that uses EXEC CICS
  RETURN TRANSID IMMEDIATE.
  .
  Additional Symptom(s) Search Keyword(s): KIXREVDWZ
  

Local fix

• Prevent CICS from going SOS if possible
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: A MODIFY command to initiate a CICS     *
  *                      transaction is misinterpreted as an     *
  *                      input message if a previous transaction *
  *                      initiated from the console issued       *
  *                      EXEC CICS RETURN TRANSID IMMEDIATE      *
  *                      INPUTMESSAGE while CICS was short on    *
  *                      storage.                                *
  ****************************************************************
  An MVS modify command 'F CICSJOB,CKQC STOPCKTI' was issued from
  a console to stop the MQ trigger monitor transaction CKTI.
  CKQC issued EXEC CICS RETURN TRANSID IMMEDIATE INPUTMESSAGE for
  transaction CKSQ which caused TCTTETC (next pseudoconversational
  transaction ID) to be is set to 'CKSQ' and the INPUTMESSAGE was
  saved into a TIOA.
  The attach for CKSQ then failed because CICS was temporarily
  short on storage. Subsequently, a modify command 'F CICSJOB,CEMT
  P SHUT' was entered at the console. As 'CKSQ' was still in
  TCTTETC the 'CEMT P SHUT' was put into the TIOA overwriting the
  INPUTMESSAGE.
  CICS was no longer short on storage so transaction CKSQ was
  attached successfully and program DFHMQSSQ was invoked.
  DFHMQSSQ issued message DFHMQ0389 because it received unexpected
  input of 'CEMT P SHUT' and CKSQ terminated without stopping the
  MQ trigger monitor transaction.
  CICS did not shut down because the 'CEMT P SHUT' was consumed by
  the CKSQ task.
  
  The loss of console input could happen following
  any transaction, that was initiated from a console, invoking
  EXEC CICS RETURN TRANSID IMMEDIATE while CICS is short on
  storage.
  
  Additional keywords: MSGDFHMQ0389 MQ0389 SOS
  

Problem conclusion

• CICS has been changed to retry an attach that has failed because
  CICS was short of storage if the next pseudoconversational
  transaction ID was set by a transaction with a console as its
  primary facility.
  

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:

  UI62058 UI62059 UI62060

Modules/Macros

• DFHZCNA
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI62058

     UP19/03/23 P F903

• R100 PSY UI62059

     UP19/03/23 P F903

• R200 PSY UI62060

     UP19/03/23 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.