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 V4R1M0 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 CICSPlex SM V4R1M0, the * * install will fail. If the install was * * requested by an API program, WUI user, * * or CMCI request, 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 CICSPlex SM V4R1M0, the * * install will fail. If the install was * * requested by an API program, WUI user, * * or CMCI request, 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 * * might return empty or incomplete result * * sets from CMASes executing lower relea- * * ses of CICSPlex SM. * * ----------------------------------- * * API programs or customized WUI views * * which retrieve CSYSDEF resources with a * * filter including attributes CONTEXT or * * MPCMASID might receive empty or incom- * * plete result sets. * * ----------------------------------- * * If a MQCONDEF created or updated in * * a CICSPlex SM V4R2M0 CMAS with attri- * * bute RESYNCMEMBER=GROUPRESYNC is * * installed in a MAS executing CICSPlex * * SM V4R1M0, the install will fail. If * * the install was requested by an API * * program, WUI user, or CMCI request, an * * API response and reason of: * * TABLEERROR (1038) DATAERROR (1361) * * will be returned to the requester. * * ----------------------------------- * * 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 V3.2, 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 3.2 - CICSPlex SM 3.2.0 - APAR PM30686 * **************************************************************** 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. Module EYU0TAQA (TAQA - Query CSYSDEF Resources) sets CONTEXT and MPCMASID from the run-time environment. However the values are copied to the resource table image after the filter has been applied. In CICSPlex SM V4.2, the MQCONDEF resource table was updated to allow RESYNCMEMBER=GROUPRESYNC. If an MQCONDEF resource defined in a CPSM V4.2 CMAS with RESYNCMEMBER=GROUPRESYNC is installed in a MAS executing an earlier release of CICS Trans- action Server, the install will fail because the value GROUPRESYNC is not valid for the RESYNCMEMBER attribute in the earlier release of CICS. 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 V4R1M0 of CPSM. A CPSM user will be able to issue the RELEASE action for PROGRAM re- sources in MASes connected to CMASes executing CPSM V4R1M0, 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 EYU0TAQA was modified to set attributes CONTEXT and MPCMASID before applying filter criteria against a CSYSDEF resource table. Module EYU0BNCD (BNCD - Install MQCONDEF, ENQMDEF, and ATOMDEF) was updated to replace the RESYNCMEMBER attribute value GROUPRESYNC with NO. 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 PM53325 FOR DESCRIPTION
APAR Information
APAR number
PM30655
Reported component name
CICS TS Z/OS V4
Reported component ID
5655S9700
Reported release
60M
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2011-01-18
Closed date
2011-05-24
Last modified date
2011-12-07
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Modules/Macros
EYUCMSIN EYUCXXRS EYUQCSBC EYUQCSBR EYUQMSIN EYUQNAGR EYUQNRGR EYUQWABU EYUQXXRC EYUQ0017 EYUQ0127 EYURCSBC EYURCSBR EYURMSIN EYURNRGR EYURWABU EYUTMOMI EYUTMOSD EYUTNAGA EYUTNAGB EYUTNAGC EYUTRCOM EYUTRDIR EYUTRMAS EYUTRMON EYUTRWLM EYUTVOSX EYUUXXFI EYUUXXRS EYUUXXTC EYUYCSBC EYUYCSBR EYUYMSIN EYUYNRGR EYUYWABU EYUZCSBC EYUZCSBR EYUZMSIN EYUZNRGR EYUZWABU EYU0BNCD EYU0BNC1 EYU0BNC2 EYU0BNC3 EYU0CSBC EYU0CSBR EYU0MSIN EYU0NHCT EYU0NLRT EYU0NPGR EYU0NQGF EYU0NQGR EYU0NQGT EYU0NQHT EYU0NQRA EYU0NQRB EYU0NQRC EYU0NQRD EYU0NQRE EYU0NQRG EYU0NRGR EYU0NSDC EYU0NSFL EYU0NSGR EYU0TAAC EYU0TAQA EYU0WABU EYU0WMQB EYU0WMWC EYU9CMPU EYU9CMP3 EYU9CMP4 EYU9MNPU EYU9MNP3 EYU9MNP4 EYU9NAPU EYU9NAP3 EYU9NAP4 EYU9NAP6 EYU9WMPU EYU9WMP3 EYU9WMP4 EYU9XECS EYU9XENF JCI660MJ
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
R60M PSY UK68030
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":"4.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":"4.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
07 December 2011