A fix is available
APAR status
Closed as program error.
Error description
Your CMAS Aux trace has lots of trace entries like this: --------------------------------- METHOD:NQRA PRIOR:NQGR DEBUG:BAD RESP POINTID: 402 MAJOBJ:MAS ENVRN:LMAS TYPE:EXCEPTION TOD:18:21:30.59 UOW(CPSM): SYSTM:B090 NAME:CICSA CICS-TASK: 297 ... EibResp LEN:000004 0 - 00000010 ---------------------------------- This trace entry shows than an EXEC CICS INQUIRE TASK was done and got back an INVREQ condition with a RESP2 of 1 meaning SUSPENDVALUE is specified but significan characters were lost. . This is the same kind of thing that CPSM APAR PQ40559 was taken for. . Also, those same NQRA exception trace entries show up with an EibResp of 0000005B meaning TASKIDERR. That is a very normal condition and we probably should not be making an Exception trace entry for that.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V2R3M0 Users * **************************************************************** * PROBLEM DESCRIPTION: - CICS tasks that are suspended and * * have a suspend resource value that * * is greater than eight bytes in length * * will be missing from TASK EUI/API/WUI * * and RTA requests. * * * * Examination of the Aux trace data * * will show an exception trace from * * method NQRA with a DEBUG text of * * BAD RESP and a Point ID of 402. * * * * - When NQRA is called to obtain task * * related information for a specified * * task and that task has completed, * * NQRA will record an exception trace * * entry. * * * * - If method EYU0XDNR fails an API * * request with a FAILED/EXCEPTION * * response and reason, no exception * * trace is requested. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes and MASes must be recycled * * to pick up the new code. Note that the * * restarts do not need to be done at the same * * time. * **************************************************************** - Method EYU0NQRA (NQRA - Generic Receiver Inquire Specific) is called from the TASK key list processor to obtain the information required to build the TASK resource table. NQRA will issue an EXEC CICS INQUIRE TASK with the SUSPENDVALUE option. If the TASK being waited on has a suspend resource name that is longer than 8 bytes, NQRA will receive an INVREQ response with a RESP2 of 1. Because of the bad response NQRA will fail the request for the task instance and no information will be returned. - If NQRA is called to obtain TASK related information for a task that is no longer in the system, then an exception trace will be requested reporting a TASKIDERR response. - EYU0XDNR (XDNR - CMAS API request analysis) calls various API methods in order to process an EXEC CPSM API request. If one of these called methods fail, when the API response is O.K. XDNR will change the API response to FAILED with an API reason of exception. If this occurs, XDNR does not take an exception trace, which can make problem determination difficult.
Problem conclusion
- The Generic Receiver tables, used by NQRA, have been updated so that the EXEC CICS INQUIRE TASK uses the RESNAME keyword. This will allow a full 16 byte suspend resource name field to be stored in the TASK SUSPENDVALUE attribute. - NQRA has been updated so that if a TASKIDERR occurs, no exception trace is taken. Changes have also been made so that a TASKIDERR response can optionally be traced using Level 31 tracing. Additionally, the exception trace routine in NQRA has been changed to trace the full Generic Receiver work area instead of just the EIBRESP fields. This allows the EXEC CICS INQUIRE TASK parameter list to be traced. - XDNR has been changed so that an exception trace will be taken if it sets the API response and reason to FAILED EXCEPTION.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK59571
Reported component name
CPSM CICS 3.1
Reported component ID
5655M1501
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2008-01-18
Closed date
2008-06-04
Last modified date
2008-07-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK59617 UK37053
Modules/Macros
EYURNQGW EYUTNAGA EYUTNAG8 EYUTNAG9 EYU0NHCT EYU0NQRA EYU0XDNR
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK37053
UP08/06/05 P F806
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.
{"0":{"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"}},"512":{"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Line of Business":{"code":"LOB35","label":"Mainframe SW"}},"1":null,"2":null,"3":null,"4":null,"5":null,"6":null,"7":null,"8":null,"9":null,"10":null,"11":null,"12":null,"13":null,"14":null,"15":null,"16":null,"17":null,"18":null,"19":null,"20":null,"21":null,"22":null,"23":null,"24":null,"25":null,"26":null,"27":null,"28":null,"29":null,"30":null,"31":null,"32":null,"33":null,"34":null,"35":null,"36":null,"37":null,"38":null,"39":null,"40":null,"41":null,"42":null,"43":null,"44":null,"45":null,"46":null,"47":null,"48":null,"49":null,"50":null,"51":null,"52":null,"53":null,"54":null,"55":null,"56":null,"57":null,"58":null,"59":null,"60":null,"61":null,"62":null,"63":null,"64":null,"65":null,"66":null,"67":null,"68":null,"69":null,"70":null,"71":null,"72":null,"73":null,"74":null,"75":null,"76":null,"77":null,"78":null,"79":null,"80":null,"81":null,"82":null,"83":null,"84":null,"85":null,"86":null,"87":null,"88":null,"89":null,"90":null,"91":null,"92":null,"93":null,"94":null,"95":null,"96":null,"97":null,"98":null,"99":null,"100":null,"101":null,"102":null,"103":null,"104":null,"105":null,"106":null,"107":null,"108":null,"109":null,"110":null,"111":null,"112":null,"113":null,"114":null,"115":null,"116":null,"117":null,"118":null,"119":null,"120":null,"121":null,"122":null,"123":null,"124":null,"125":null,"126":null,"127":null,"128":null,"129":null,"130":null,"131":null,"132":null,"133":null,"134":null,"135":null,"136":null,"137":null,"138":null,"139":null,"140":null,"141":null,"142":null,"143":null,"144":null,"145":null,"146":null,"147":null,"148":null,"149":null,"150":null,"151":null,"152":null,"153":null,"154":null,"155":null,"156":null,"157":null,"158":null,"159":null,"160":null,"161":null,"162":null,"163":null,"164":null,"165":null,"166":null,"167":null,"168":null,"169":null,"170":null,"171":null,"172":null,"173":null,"174":null,"175":null,"176":null,"177":null,"178":null,"179":null,"180":null,"181":null,"182":null,"183":null,"184":null,"185":null,"186":null,"187":null,"188":null,"189":null,"190":null,"191":null,"192":null,"193":null,"194":null,"195":null,"196":null,"197":null,"198":null,"199":null,"200":null,"201":null,"202":null,"203":null,"204":null,"205":null,"206":null,"207":null,"208":null,"209":null,"210":null,"211":null,"212":null,"213":null,"214":null,"215":null,"216":null,"217":null,"218":null,"219":null,"220":null,"221":null,"222":null,"223":null,"224":null,"225":null,"226":null,"227":null,"228":null,"229":null,"230":null,"231":null,"232":null,"233":null,"234":null,"235":null,"236":null,"237":null,"238":null,"239":null,"240":null,"241":null,"242":null,"243":null,"244":null,"245":null,"246":null,"247":null,"248":null,"249":null,"250":null,"251":null,"252":null,"253":null,"254":null,"255":null,"256":null,"257":null,"258":null,"259":null,"260":null,"261":null,"262":null,"263":null,"264":null,"265":null,"266":null,"267":null,"268":null,"269":null,"270":null,"271":null,"272":null,"273":null,"274":null,"275":null,"276":null,"277":null,"278":null,"279":null,"280":null,"281":null,"282":null,"283":null,"284":null,"285":null,"286":null,"287":null,"288":null,"289":null,"290":null,"291":null,"292":null,"293":null,"294":null,"295":null,"296":null,"297":null,"298":null,"299":null,"300":null,"301":null,"302":null,"303":null,"304":null,"305":null,"306":null,"307":null,"308":null,"309":null,"310":null,"311":null,"312":null,"313":null,"314":null,"315":null,"316":null,"317":null,"318":null,"319":null,"320":null,"321":null,"322":null,"323":null,"324":null,"325":null,"326":null,"327":null,"328":null,"329":null,"330":null,"331":null,"332":null,"333":null,"334":null,"335":null,"336":null,"337":null,"338":null,"339":null,"340":null,"341":null,"342":null,"343":null,"344":null,"345":null,"346":null,"347":null,"348":null,"349":null,"350":null,"351":null,"352":null,"353":null,"354":null,"355":null,"356":null,"357":null,"358":null,"359":null,"360":null,"361":null,"362":null,"363":null,"364":null,"365":null,"366":null,"367":null,"368":null,"369":null,"370":null,"371":null,"372":null,"373":null,"374":null,"375":null,"376":null,"377":null,"378":null,"379":null,"380":null,"381":null,"382":null,"383":null,"384":null,"385":null,"386":null,"387":null,"388":null,"389":null,"390":null,"391":null,"392":null,"393":null,"394":null,"395":null,"396":null,"397":null,"398":null,"399":null,"400":null,"401":null,"402":null,"403":null,"404":null,"405":null,"406":null,"407":null,"408":null,"409":null,"410":null,"411":null,"412":null,"413":null,"414":null,"415":null,"416":null,"417":null,"418":null,"419":null,"420":null,"421":null,"422":null,"423":null,"424":null,"425":null,"426":null,"427":null,"428":null,"429":null,"430":null,"431":null,"432":null,"433":null,"434":null,"435":null,"436":null,"437":null,"438":null,"439":null,"440":null,"441":null,"442":null,"443":null,"444":null,"445":null,"446":null,"447":null,"448":null,"449":null,"450":null,"451":null,"452":null,"453":null,"454":null,"455":null,"456":null,"457":null,"458":null,"459":null,"460":null,"461":null,"462":null,"463":null,"464":null,"465":null,"466":null,"467":null,"468":null,"469":null,"470":null,"471":null,"472":null,"473":null,"474":null,"475":null,"476":null,"477":null,"478":null,"479":null,"480":null,"481":null,"482":null,"483":null,"484":null,"485":null,"486":null,"487":null,"488":null,"489":null,"490":null,"491":null,"492":null,"493":null,"494":null,"495":null,"496":null,"497":null,"498":null,"499":null,"500":null,"501":null,"502":null,"503":null,"504":null,"505":null,"506":null,"507":null,"508":null,"509":null,"510":null,"511":null}
Document Information
Modified date:
22 February 2023