A fix is available
APAR status
Closed as program error.
Error description
You have VTAM=NO specified in the DFHSIT's in your CICS regions. You have CICSRGN monitoring active (MCICSRGN). When EYU0MCCD is called to process the data, a program check occurs in the CONV_DWORD_PACK routine on a CVB (convert to binary)instruction. Running a CICS region with VTAM=NO can also cause a large number of exception trace entries to be written to the CMAS AUXTRACE with Debug:BADIQVTM Point-Id:402. This trace is written every time that a heartbeat is generated in the LMAS.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: Various errors may occur when a CMAS or * * MAS has the VTAM=NO parameter specified * * in the CICS SIT. * * * * If VTAM=NO is specified for a CMAS: * * * * - The CMAS resource table will * * indicate N/A for the VTAMACB * * attribute. Additionally, every time * * the CMAS table is requested, an * * exception trace will be written by * * method EYU0XLAC (XLAC). The trace * * will have an exception point ID of 1 * * and a debug text of EYU0XTRP. * * * * If VTAM=NO is specified for a MAS: * * * * - If MCICS CPSM monitoring is active * * for the MAS, abend ASRA S0C7 will * * occur in method EYU0MCCD (MCCD) in * * the CMAS to which the MAS is * * connected every time the monitoring * * data is collected. Additionally, * * every time monitoring data is * * collected, two exception traces will * * be written by method EYU0NMCR * * (NMCR). The first trace will have * * an exception point ID of 402 and a * * debug text of BADIQVTM. The second * * trace will have an exception point * * ID of 407 and a debug text of * * BADCOLVT. * * * * - Every 15 seconds, method EYU0NLHD * * (NLHD) running in the MAS will issue * * an exception trace. The trace will * * have an exception point ID of 402 * * and a debug text of BADIQVTM. If * * auxtrace is active in the MAS, this * * can lead to the trace datasets * * filling with these trace entries. * * Also, since MAS traces are shipped * * to the CMAS to which it is * * connected, the CMAS's trace datasets * * can fill also. * * * * - The CICSRGN resource table will * * indicate N/A for the VTMSTATUS and * * GRSTATUS attributes. Additionally, * * every time the CICSRGN table is * * requested, two exception traces will * * be written by method EYU0NQCR * * (NQCR). The first trace will have * * an exception point ID of 402 and a * * debug text of BADIQVTM. The second * * trace will have an exception point * * ID of 407 and a debug text of * * BADCOLVT. * **************************************************************** * 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. * **************************************************************** When VTAM=NO is specified in the CICS SIT for a system, the EXEC CICS INQUIRE VTAM command will return a RESP of INVREQ, and the EXEC CICS COLLECT STATISTICS VTAM will return a RESP of NOTFND. The methods that issue these commands for CPSM do not recognize this as an indication that VTAM is not available, and instead issue exception trace entries and do not set appropriate default values for the data that was to be returned. This results in the errors documented above.
Problem conclusion
Methods XLAC, NMCR, NLHD, and NQCR have been updated to recognize if VTAM=NO has been specified in the CICS SIT, and if so, to set appropriate default values for the data that would be returned from the EXEC CICS commands, and to not issue exception traces.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
Various errors may occur when a CMAS or MAS has the VTAM=NO parameter specified in the CICS SIT. If VTAM=NO is specified for a CMAS: - The CMAS resource table will indicate N/A for the VTAMACB attribute. Additionally, every time the CMAS table is requested, an exception trace will be written by method EYU0XLAC (XLAC). The trace will have an exception point ID of 1 and a debug text of EYU0XTRP. If VTAM=NO is specified for a MAS: - If MCICS CPSM monitoring is active for the MAS, abend ASRA S0C7 will occur in method EYU0MCCD (MCCD) in the CMAS to which the MAS is connected every time the monitoring data is collected. Additionally, every time monitoring data is collected, two exception traces will be written by method EYU0NMCR (NMCR). The first trace will have an exception point ID of 402 and a debug text of BADIQVTM. The second trace will have an exception point ID of 407 and a debug text of BADCOLVT. - Every 15 seconds, method EYU0NLHD (NLHD) running in the MAS will issue an exception trace. The trace will have an exception point ID of 402 and a debug text of BADIQVTM. If auxtrace is active in the MAS, this can lead to the trace datasets filling with these trace entries. Also, since MAS traces are shipped to the CMAS to which it is connected, the CMAS's trace datasets can fill also. - The CICSRGN resource table will indicate N/A for the VTMSTATUS and GRSTATUS attributes. Additionally, every time the CICSRGN table is requested, two exception traces will be written by method EYU0NQCR (NQCR). The first trace will have an exception point ID of 402 and a debug text of BADIQVTM. The second trace will have an exception point ID of 407 and a debug text of BADCOLVT. When VTAM=NO is specified in the CICS SIT for a system, the EXEC CICS INQUIRE VTAM command will return a RESP of INVREQ, and the EXEC CICS COLLECT STATISTICS VTAM will return a RESP of NOTFND. The methods that issue these commands for CPSM do not recognize this as an indication that VTAM is not available, and instead issue exception trace entries and do not set appropriate default values for the data that was to be returned. This results in the errors documented above. Methods XLAC, NMCR, NLHD, and NQCR have been updated to recognize if VTAM=NO has been specified in the CICS SIT, and if so, to set appropriate default values for the data that would be returned from the EXEC CICS commands, and to not issue exception traces.
APAR Information
APAR number
PK51832
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
2007-08-28
Closed date
2007-09-27
Last modified date
2007-10-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK51826 UK29671
Modules/Macros
EYU0NLHD EYU0NMCR EYU0NQCR EYU0XLAC
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK29671
UP07/09/29 P F709
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"}},"488":{"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}
Document Information
Modified date:
22 February 2023