A fix is available
APAR status
Closed as program error.
Error description
CICSPlex SM compatibility
Local fix
None. Additional Keywords: kixdcfcic670
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V3R2M0 Users * **************************************************************** * PROBLEM DESCRIPTION: When a CICSPlex SM V4R2M0 CMAS is * * part of a network which includes CMASes * * running prior releases of CPSM, callers * * that request the CICSPlex SM V4R2M0 * * COMSET, COMSETE, or WLMAROUT objects * * will receive an API response and reason * * of: * * ENVIRONERROR (1030) REQTIMEOUT (1342). * * ----------------------------------- * * When a CICSPlex SM V4R2M0 CMAS is * * part of a network which includes CMASes * * running prior releases of CPSM, callers * * that request the RELEASE action for * * PROGRAM objects in MASes connecting to * * a CMAS running a prior release of CPSM * * will receive an API response and reason * * of: * * ENVIRONERROR (1030) REQTIMEOUT (1342). * * ----------------------------------- * * If a PROGDEF created or updated in a * * CICSPlex SM V4R2M0 CMAS with attribute * * CONCURRENCY=REQUIRED is installed in a * * MAS executing a lower release of CPSM, * * the install will fail. If the install * * was requested by an API program or WUI * * user, an API response and reason of: * * TABLEERROR (1038) DATAERROR (1361) * * will be returned to the requester. * * ----------------------------------- * * If a FILEDEF or LSRDEF created or * * updated in a CICSPlex SM V4R2M0 CMAS * * with attribute LSRPOOLID containing a * * value greater than 8 is installed in a * * MAS executing a lower release of CPSM, * * the install will fail. If the install * * was requested by an API program or WUI * * user, an API response and reason of: * * TABLEERROR (1038) DATAERROR (1361) * * will be returned to the requester. * * ----------------------------------- * * Requests for monitor resources which * * originate in a CICSPlex SM V4R2M0 CMAS * * may return incomplete or empty result * * sets from CMASes executing lower relea- * * ses of CICSPlex SM. * * ----------------------------------- * * Actions executed on behalf of CPSM * * API programs including a WUI (Web User * * Interface) server may receive an API * * response and reason of: * * FAILED (1029) EXCEPTION(1359) * * if the action definition was last up- * * dated for a version lower than the * * current table version. * * ----------------------------------- * * If a WLMSPEC created or updated in * * a CICSPlex SM V4R2M0 CMAS with the * * routing algorithm (ALGTYPE) set to * * LNGOAL is installed in or imported * * into a CMAS executing a lower release * * of CPSM, the routing algorithm in ef- * * fect in routing regions connected to * * the lower level CMAS will be QUEUE. * * ----------------------------------- * * If a CMAS executing a lower release * * of CPSM is started on an LPAR where a * * CMAS is already executing CICSPlex SM * * V4R2M0, the version of CPSM's subsystem * * exit router EYU9XEER which was loaded * * into common storage during startup for * * the V4R2M0 CMAS, will be replaced by * * the lower version of EYU9XEER. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes and MASes must be recycled * * to pick up the new code. Note that regions * * do not have to be shut down and restarted at * * the same time. * * * * If a CMAS executing from a library to * * which the PTF resolving this APAR is applied * * connects, directly or indirectly, to a CMAS * * executing CICSPlex SM for CICS Transaction * * Server V3.1 or CICSPlex SM for CICS Trans- * * action Server V4.1, the PTFs which resolve * * the following APARs must be applied to the * * appropriate target libraries. * * * * - CTS 3.1 - CICSPlex SM 3.1.0 - APAR PM30696 * * - CTS 4.1 - CICSPlex SM 4.1.0 - APAR PM30655 * **************************************************************** Requests for the CICSPlex SM V4.2 COMSET, COMSETE, or WLMAROUT resource might cause the V4.2 CMAS to send a Method Argument List (MAL) for module EYU0CSBR (CSBR - Browse COMM Set Directories), EYU0CSBC (CSBC - Browse Comm Set Directory entries), or EYU0WABU (WABU - Browse Active TORs in Workload) to one or more CMASes running a release of CPSM lower than V4.2. Because pre-V4.2 CMASes do not have support for these methods, the MAL cannot be processed in pre-V4.2 CMASes, nor can it be returned to the V4.2 CMAS to resolve the request. As a result the originating request will wait until the com- munication times out. Requests for the RELEASE actions for PROGRAM objects might cause the V4.2 CMAS to send a Method Argument List (MAL) for module EYU0NRGR (NRGR - MAS Generic Release Processor) to one or more MASes running a release of CPSM lower than V4.2. Because pre-V4.2 MASes do not have support for this method, the MAL cannot be processed in pre-V4.2 MASes, nor can it be returned to the V4.2 CMAS to resolve the request. As a result the originating request will wait until the communication times out. In CICSPlex SM V4.2, the PROGDEF resource table was updated to allow CONCURRENCY=REQUIRED. If a PROGDEF resource defined in a CPSM V4.2 CMAS with CONCURRENCY=REQUIRED is installed in a a MAS executing an earlier release of CICS Transaction Server, the install will fail because the value REQUIRED is not valid for the CONCURRENCY attribute in the earlier release of CICS. CICS Transaction Server V4.2 supports up to 255 Local Shared Resource (LSR) pools. An attempt to install a FILEDEF or an LSRDEF specifying an LSRPOOLID greater than 8 will fail in a MAS executing a lower release of CICSPlex SM. In CICSPlex SM V4.2, the length of the resource name field, RESNAME, in the Method Argument List (MAL) for module EYU0MSIN (MSIN - Monitor Data Selector) was increased to 9 bytes as part of the changes to support 255 LSR pools. Earlier releases of CICSPlex SM support an 8 byte RESNAME and may return no data or incorrect data if the RESNAME field is truncated. When an API command is submitted against a resource table or a result set containing one or more resource tables, the Managed Object Services (MOS) dictionary is searched to find the method which supports the requested action. The search logic assumes that the resource table data and action version and subversion indices are synchronized. In fact actions are rarely subver- sioned, so if an action was last updated at a version lower than the version of the CMAS to which it connects, using the data subversion number to index the action table may result in errors including, but not limited to, the wrong method being identified for the action, or MOS being unable to identify the action to be performed. When a workload using the new LNGOAL or LNQUEUE routing al- gorithms is installed in or imported into a CMAS executing a prior release of CPSM, the routing algorithm should revert to the GOAL or QUEUE algorithm, respectively. When CMASes executing different releases of CICSPlex SM are started on the same LPAR, the active version of CPSM's subsys- tem exit router, EYU9XEER, should correspond to the highest version of CPSM executing on the LPAR. A change to the format of the CPSM service module header causes the CMAS initialization program EYU9XECS to extract the version of the active router program from an incorrect location, resulting in the copy of the router program installed when the V4R2M0 CMAS started being replaced by the version installed by the earlier CMAS.
Problem conclusion
Toleration support has been added for EYU0CSBC, EYU0CSBR, and EYU0WABU. Note that these methods can never return any resource objects from a pre-V4R2M0 CMAS because the resources are not known at prior releases. Module EYU0NRGR has been ported to V3R2M0 of CPSM. A CPSM user will be able to issue the RELEASE action for PROGRAM re- sources in MASes connected to CMASes executing CPSM V3R2M0, from a V4R2M0 API program or WUI or CMCI client. Module EYU0BNC2 (BNC2 - Install PROGDEF and TYPTMDEF) was updated to replace the CONCURRENCY attribute value REQUIRED with THREADSAFE. Modules EYU0BNC1 (BNC1 - Install LSRDEF, JRNMDEF, PROFDEF, and TRNCLDEF) and EYU0BNC3 (BNC3 - Install FILEDEF and TRANDEF) were modified to set the LSRPOOLID to the CICS default (1) if a value greater than 8 is encountered. The length of the RESNAME field in the MAL for EYU0MSIN was increased to 9 bytes, to accomodate requests originating in a CICSPlex SM V4R2M0 CMAS. Module EYU0MOCM (MOCM - MOS Common Service Functions) was updated to select the proper subversion number for an action which was last updated in a prior release of CPSM. Programs EYU0MOAC (MOAC - MOS Inquire Action), EYU0MOMB (MOMB - MOS Build MAL), EYU0MOPA (MOPA - MOS Inquire Parameter value Assertions), EYU0MOPM (MOPM - MOS Inquire Action Parameters), and EYU0MOSS (MOSS - MOS String Services) were recompiled to incorporate the changes to MOCM. Modules EYU0WMWC (WMWC - Workload Create) and EYU0WMQB (WMQB - Build Imported Workload) have been modified to convert the LNGOAL and LNQUEUE algorithm types to the appropriate supported algorithms. Module EYU9XECS was modified to recognise the changed header format and to avoid replacing a higher version of EYU9XEER in common storage. The ESSS Information Display utility program EYU9XENF was also modified to display "Unknown Version" if it encounters an active router program whose module header cannot be mapped.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
None. **** PE11/12/06 FIX IN ERROR. SEE APAR PM53321 FOR DESCRIPTION **** PE12/12/19 PTF IN ERROR. SEE APAR PM79539 FOR DESCRIPTION
APAR Information
APAR number
PM30686
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
50M
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2011-01-18
Closed date
2011-05-24
Last modified date
2013-01-08
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK68036
Modules/Macros
DYU0MOAC DYU0MOCM DYU0MOMB DYU0MOPA DYU0MOPM DYU0MOSS EYUCMSIN EYUCXXRS EYUQCSBC EYUQCSBR EYUQMSIN EYUQNAGR EYUQNRGR EYUQWABU EYUQXXRC EYURCSBC EYURCSBR EYURMSIN EYURNRGR EYURWABU EYUTMOMI EYUTMOSD EYUTNAGA EYUTNAGB EYUTNAG9 EYUTRCOM EYUTRDIR EYUTRMAS EYUTRMON EYUTRWLM EYUTVOSX EYUUXXFI EYUUXXRS EYUUXXTC EYUYCSBC EYUYCSBR EYUYMSIN EYUYNRGR EYUYWABU EYUZCSBC EYUZCSBR EYUZMSIN EYUZNRGR EYUZWABU EYU0BNC1 EYU0BNC2 EYU0BNC3 EYU0CSBC EYU0CSBR EYU0MOAC EYU0MOMB EYU0MOPA EYU0MOPM EYU0MOSS EYU0MSIN EYU0NHCT EYU0NLRT EYU0NPGR EYU0NQGF EYU0NQGR EYU0NQGT EYU0NQHT EYU0NQRA EYU0NQRB EYU0NQRC EYU0NQRD EYU0NQRE EYU0NRGR EYU0NSDC EYU0NSFL EYU0NSGR EYU0TAAC EYU0WABU EYU0WMQB EYU0WMWC EYU9CMPU EYU9CMP3 EYU9CMP4 EYU9MNPU EYU9MNP3 EYU9MNP4 EYU9NAPU EYU9NAP3 EYU9NAP4 EYU9NAP5 EYU9WMPU EYU9WMP3 EYU9WMP4 EYU9XECS EYU9XENF JCI650MJ
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R50M PSY UK68036
UP11/05/26 P F105
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.2","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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
08 January 2013