A fix is available
APAR status
Closed as program error.
Error description
Your application issues the following CICS commands : EXEC CICS SET TCPIP CLOSED. EXEC CICS SET TCPIP OPENED. EXEC CICS INQUIRE TCPIPSERVICE(tcpipservice). This results in error message DFHSO0001 ISDCICS An abend (code 0C2/AKEA) has occurred at offset X'FFFF' in module DFHSOIS . . Your TCPIPSERVICE is defined with STATUS(OPEN). After the application issued EXEC CICS SET TCPIP OPEN, it caused the 'now closed' TCPIPSERVICE to get re-opened. An LTE block is getmained for the TCPIPSERVICE and a new CSOL listener task is attached to complete the re-opening of TCPIPSERVICE. Before CSOL get can going, the application issues EXEC CICS INQUIRE TCPIPSERVICE(tcpipservice). DFHSOIS is called to obtain the SERVER_IP_ADDRESS. This is held in lte_inet_addr in the LTE for TCPIPSERVICE. However, as CSOL has not got going yet,the lte_inet_addr remains unitialized. DFHSOIS detects this and issues a BPX1HST call from get_server_bin_ip_address. All BPX calls are supposed to be issued while running on the SO TCB. The problem is that DFHSOIS has failed to switch to SO so the BPX call is issued on the QR TCB. This is doomed to failure and eventually there is a branch to low core leading to the ABEND0C2. Additional Symptom(s) and Keyword(s): 0C2 ABENDS0C2 KIXREVSWM
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users. * **************************************************************** * PROBLEM DESCRIPTION: DFHSO0001 AN ABEND (CODE 0C2/AKEA) HAS * * OCCURRED AT OFFSET X'FFFF' IN MODULE * * DFHSOIS. * **************************************************************** * RECOMMENDATION: * **************************************************************** A program issues an EXEC CICS INQUIRE TCPIPSERVICE command just after TCPIP has been re-opened. This command fails with an ABENDS0C2 while processing a DFHSOIS INQUIRE call. The TCPIPSERVICE is in the process of being re-opened but the sockets listener task - CSOL has not reached the point of opening the listener and priming LTE_INET_ADDR.SOCK_SIN_ADDR. As LTE_INET_ADDR.SOCK_SIN_ADDR is zero, DFHSOIS issues a BPX1HST command to obtain the IP address of the host. All BPX calls should be issued while running on the sockets ( SO ) TCB but DFHSOIS is still running on the QR TCB when this call is made. ADDITIONAL KEYWORDS :- 0C2 S0C2 MSGDFHSO0001 SO0001
Problem conclusion
DFHSOIS has been altered so that should LTE_INET_ADDR.SOCK_SIN_ADDR be zero when an INQUIRE TCPIPSERVICE call is made with the parameter SERVER_IP_ADDRESS, then the task will be switched to the SO TCB.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK81926
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
2009-03-05
Closed date
2009-04-01
Last modified date
2009-05-14
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK45407
Modules/Macros
DESSOIS DFHSOIS
Fix information
Fixed component name
CICSTS FOR VSE
Fixed component ID
564805400
Applicable component levels
RB0P PSY UK45407
UP09/04/02 P E421
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":"1.1.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
14 May 2009