A fix is available
APAR status
Closed as program error.
Error description
This problem only happens on requests coming into CICS that are using a Channel and over 60000 bytes long. When this happens, the last-in-chain block will only be received by the mirror task when TRANSFORMER-2 processing (ISXF UNFLATTEN _REQUEST) has completed. All the data may have been received off the socket before this point but it isn't until this point that the mirror task 'accepts' this data and the state of the session switches from SEND to RECEIVE. If an error is raised before we reach TRANSFORMER-2 for a multi-chain request then we attempt to send an IS7 to the mirror. This produces a DFHIS1027 from DFHISIS_SEND_ERROR. This routine has code to send an IS7 back to the client but this gets bypassed because issb_state = IS_RECEIVE. This needs to be IS_SEND to allow a SEND to proceed. So the client ends up hanging waiting for a response from CICS. If the entire request fits in a single chain then the ISSB_STATE will be ISSB_SEND at this point in error processing and the IS7 gets sent. Additional Symptom(s) Search Keyword(s): KIXREVDAM
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All * **************************************************************** * PROBLEM DESCRIPTION: A CTG client hangs after sending a * * large request over an IPIC connection * * which contains an incorrect password. * **************************************************************** * RECOMMENDATION: * **************************************************************** A CTG client sends an ECI request over an IPIC connection which contains a large channel which exceeds 60K in length. The request is directed to a CICS IPCONN defined with Userauth : Verify and includes an incorrect password. A mirror task is attached to process the request. The mirror receives the first-in-chain block. The IPIC block size is 60K. This means that there is a further block to be received so the state of the IPIC session used by the mirror task remains IS_RECEIVE. The mirror task performs a security check which fails because of the incorrect password. Consequently the mirror task is scheduled to abend on completion of task initialization. This means that the mirror program never runs and the logic to import the channel is bypassed. This would be the point at which the session state would change to IS_SEND. During abend processing, DFHACP invokes DFHISIS SEND_ERROR. This sends a message to the CICS log. It also contains logic to send an IS7 error back to the CTG client. However, this logic is skipped because the ISSB_STATE is still IS_RECEIVE. The individual CTG client is left hanging.
Problem conclusion
DFHISIS has been changed to consume the remainder of a request from CTG in the event that a security error is raised for an IPCONN defined with Userauth : Verify.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM14524
Reported component name
CICS TS Z/OS V4
Reported component ID
5655S9700
Reported release
600
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2010-05-14
Closed date
2010-05-27
Last modified date
2010-07-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK57331
Modules/Macros
DESISIS DFHISIS
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
R600 PSY UK57331
UP10/06/04 P F006
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":"4.1","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":"4.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 July 2010