A fix is available
APAR status
Closed as program error.
Error description
You are running with CICS TS 5.1 on z/OS 2.1 and receiving the following message, DFHSM0002 A severe error (code X'0C15') has occurred in module DFHSMMG. . The trace shows the following exception trace entry - SM 0C15 SMMG *EXC* - Invalid_length_on_getmain_for_SHARED_CICS31_storage - FUNCTION(GETMAIN) REMARK(MISCDATA) GET_LENGTH(FFFFECA5) SUSPEND(YES) STORAGE_CLASS(SHARED_CICS) . The GETMAIN length FFFFECA5 is invalid. This GETMAIN was issued by DFHWBPW UI30325 at offset 3F4. DECODE_USER_DATA_LENGTH is defined FL2 or half word only. However, the original request is 1ECA5 bytes in length. The old commarea mechanism for processing the HTTP request requests up to 32k which is why decode_user_data_length is a halfword. DFHWBPW can be modified to use the WEB API to get hold of the user data. This would avoid the problem with the invalid getmain length value. . Additional Symptoms Search Keywords: KIXREVEPH
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users. * **************************************************************** * PROBLEM DESCRIPTION: Abend AEXZ in program DFHWBPW due to * * DFHSM0002 (code X'0C15') in DFHSMMG. * **************************************************************** * RECOMMENDATION: * **************************************************************** CICS receives an HTTP POST request with over x'7FFF' bytes of data. The TCPIPSERVICE has been configured to use basic authentication and the user's password has expired. CICS drives DFHWBPW to allow the user to change their password. DFHWBPW issues a LH instruction to get the length of the data to be stored whilst the user changes their password. However, this instruction is operating on only a halfword value, so the length may have been truncated, and if the top bit of the halfword length is on, this is extended such that the most significant half of the fullword is populated with 'F's. A GETMAIN request is issued for this length with comment MISCDATA. The GETMAIN fails with a DFHSM0002 message due to the invalid length, DFHWBPW abends AEXZ and a system dump is taken. Additional keywords: msgDFHSM0002 SM0002 abendAEXZ
Problem conclusion
DFHWBPW has been modified to use a WEB RECEIVE command to retrieve the HTTP POST request's data and length.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PI59018
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
800
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2016-03-11
Closed date
2016-05-19
Last modified date
2016-06-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PI61956 UI38035 UI38036
Modules/Macros
DFHWBPW
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
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":"5.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":"5.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 June 2016