A fix is available
APAR status
Closed as program error.
Error description
A CICS CPSM API program may issue code similar to the following: . EXEC CPSM CONNECT EXEC CPSM LISTEN EXEC CPSM ADDRESS (to get the ECB to wait on below) EXEC CICS WAIT EXTERNAL ECBLIST . If the CMAS it connected to is cycled normally or abnormally (abends), the API program may never get posted out of its wait, even when the CMAS is restarted again. . Additional Symptom(s) Search Keyword(s): KIXREVRJL
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V3R2M0 Users * **************************************************************** * PROBLEM DESCRIPTION: A task executing a CPSM MAS API program * * will hang if it is waiting on a * * asynchronous processing ECB returned * * from an EXEC CPSM ADDRESS command when * * the CPSM agent terminates within the * * MAS. * * * * The MAS agent termination can be the * * result of the MAS STOP action, the COSH * * transaction, termination of the MAS, or * * termination of the CMAS to which the * * MAS is connected. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all MASes must be restarted. Note * * that the restarts do not need to occur at * * the same time. * **************************************************************** When a MAS goes through CPSM agent termination, method EYU0XLTP (XLTP) is called by method EYU0XDTM (XDTM) to terminate all tasks executing CPSM API programs within the MAS. Currently, XLTP only terminates those tasks that are suspended while in CPSM code. No attempt is made to terminate CPSM API programs that are suspended in application code while waiting on ECBs returned from the EXEC CPSM ADDRESS command. As a result, these tasks will hang until purged.
Problem conclusion
XLTP has been updated so that when it is called by XDTM, it will ensure that the asynchronous ECBs associated with each active CPSM API thread are POSTed, and that the sentinel associated with each ECB is set to zero (0) prior to the ECB being POSTed. Any subsequent EXEC CPSM commands issued by the POSTed programs will receive a Response of NOTAVAILABLE and a Reason of CPSMAPI.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK76645
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
50M
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2008-12-01
Closed date
2008-12-22
Last modified date
2009-01-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK77078 PK77079 UK42710
Modules/Macros
EYU0XDER EYU0XDY6 EYU0XLTP
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R50M PSY UK42710
UP08/12/24 P F812
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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 January 2009