A fix is available
APAR status
Closed as program error.
Error description
User performed an adhoc BAS install from a RESGROUP for a very large set of PROGDEF resources into a SCOPE which spanned multiple CMASes. A MAL needs to be sent to a CMAS with a namelist of resources. In this instance the cache storage to hold the list is larger than x'7FFFFF'. In this specific case, the BAGI (BAS Adhoc RESGROUP Install) MAL is received by a CMAS and method CTRP (Transport Services Source Recomposition) process the BAGI MAL fields and for the NAMELIST goes to label CTRP_NLSD to obtain the cache storage for the namelist. If, as in this instance the namelist storage is greater then x'7FFFFF' the XCBA (Cache Block Acquire) method call will return with XCBA_RESPONSE of XCBA_INVALID and XCBA_REASON XCBA_INVALID_SIZE. This will generate an exception trace with debug text INVSIZE and PointId 24 . Method XCBA needs to be invoked using the FSIZE parameter which supports fullword size versus the SIZE parameter which only support a 3 BYTE length. . Additional Symptom(s) Search Keyword(s): 8M EYU0XCBA EYU0CTRP CNST_INVL_SIZETEXT DCEQ_INVL_SIZETPID INVALID_SIZE BAS EUI user timeout waiting for BAS install to complete.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: Performing adhoc BAS installs from a * * RESGROUP or RESDESC for a very large * * set of xxxxDEF resources completes * * successfully but may not be installed * * in MASes connected to remote CMASes. * * Symptoms can be an exception trace * * entry with a debug text of INVSIZE and * * a PointId of 24, a local CMAS may hang * * until it times out, or just some of the * * resources being installed successfully. * * A resource set containing more than * * 83,000 resources may cause the failure. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes and MASes must be * * restarted. Note that the restarts do not * * need to occur at the same time. * **************************************************************** An adhoc BAS install from a RESGROUP or RESDESC containing a very large set of resources (for example, PROGDEFs) into a SCOPE which spans multiple CMASes appears to complete successfully but generates an exception trace entry. To satisfy this request a MAL (Method Argument List) is built containing a NAMELIST of resources and sent to a CMAS. Cache storage is acquired to hold the NAMELIST. When the NAMELIST storage is greater than x'7FFFFF' the XCBA (Cache Block Acquire) method call will return with a RESPONSE of INVALID and a REASON of INVALID SIZE.
Problem conclusion
Updated EYUQXCBA (XCBA - Acquire Cache Block) and EYUQXCBR (XCBR - Release Cache Block) to use the FSIZE parameter which supports a 4 BYTE length versus the SIZE parameter which only supports a 3 BYTE length.
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK21028
Reported component name
CPSM CICS 3.1
Reported component ID
5655M1501
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt
Submitted date
2006-03-07
Closed date
2006-04-24
Last modified date
2006-05-01
APAR is sysrouted FROM one or more of the following:
PK21079
APAR is sysrouted TO one or more of the following:
UK13763
Modules/Macros
EYU0CTRC EYU0CTRP
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK13763
UP06/04/26 P F604
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.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
22 February 2023