IBM Support

PM70388: START COMMAND REQID TSQ IS NOT DELETED AT TASK DETACH TIME

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • If CICS creates a REQID TSQ for a START command and the
    started transaction does not issue a RETRIEVE, CICS will not
    automatically delete the REQID TSQ as part of task termination.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Temporary Storage Queue entries that    *
    *                      are associated with a START command     *
    *                      REQID may not be deleted.               *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    In the scenario for this APAR, a transaction started by a REQID
    used the same REQID to start the next instance of itself. The
    auxiliary Temporary Storage Queue (TSQ) with that REQID name
    continually grew in size and was not deleted.
    
    The code contained the following statements and options:
    
     EXEC CICS CANCEL REQID(name)
     EXEC CICS START TRANSID() REQID(name) QUEUE() INTERVAL()
    
    For CICS to work efficiently, the transaction that is started
    must include an EXEC CICS RETRIEVE before the START even if
    there is no data to retrieve. The RETRIEVE will delete the
    REQID TSQ entry created by the previous START command.
    
    A RETRIEVE should have been used instead of the EXEC CICS
    CANCEL command in the code shown above. EXEC CICS CANCEL with
    the REQID is a possible way to delete the REQID TSQ, but it
    will always return NOTFND in this case. This is because it is
    not possible to CANCEL the REQID once the transaction associated
    with it has been successfully started.
    
    However, CICS does not attempt to delete a REQID TSQ during the
    task termination process if the task has not issued a RETRIEVE.
    This APAR changes CICS to delete the REQID TSQ during task
    termination if it has not been deleted by the task itself.
    

Problem conclusion

  • DFHXMTA and DFHICXM have been changed to ensure that a request
    to delete the REQID TSQ is performed during task termination
    if it is needed.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

  • ž**** PE13/02/01 FIX IN ERROR. SEE APAR PM81883  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PM70388

  • Reported component name

    CICSTS FOR VSE

  • Reported component ID

    564805400

  • Reported release

    B0P

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-08-06

  • Closed date

    2012-10-19

  • Last modified date

    2013-05-01

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

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

    UK82814

Modules/Macros

  •    DFHICXM  DFHXMTA
    

Fix information

  • Fixed component name

    CICSTS FOR VSE

  • Fixed component ID

    564805400

Applicable component levels

  • RB0P PSY UK82814

       UP12/10/30 P E512

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.

[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.1","Edition":""}]

Document Information

Modified date:
01 May 2013