A fix is available
APAR status
Closed as program error.
Error description
CICS validation routine for IPCONN ensures that One-Way IPCONNs cannot have AUTOCONNECT(yes). The equivalent validation needs to be done for CPSM's IPCONDEF, where an IPCONN is defined with PORT(NO) then AUTOCONNECT(YES) is invalid.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V3R2M0 Users * **************************************************************** * PROBLEM DESCRIPTION: Incorrect validation is being * * performed on the PORT, HOST, TCPIP * * and SENDCOUNT attributes when * * creating or updating an IPCONDEF * * resource table. * * * * Invalid combinations or blank values * * can be defined in the attributes * * listed above. When these invalid * * definitions are installed using the * * Web User Interface, messages EYUVC1273I * * and EYUVC1279I will be issued, * * reporting a CREATE IPCONN failure. * * * * Examination of the MAS that was the * * target system of the install will * * show message DFHCA5501. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes must be recycled to pick * * up the new code. Note that the restarts * * do not need to be done at the same time. * * * * Additionally users of the CICSPlex SM * * supplied starter set viewsets and menus must * * re-import the updated starter set viewset * * and menu definitions into each Web User * * Interface (WUI) server's repository in order * * to pick up the changes. * * * * The starter set viewsets and menus can be * * re-imported either via the AUTOIMPORTDSN and * * AUTOIMPORTMEM WUI server initialization * * parameters or the IMPORT (from a dataset) * * function of the COVC WUI transaction. * * * * If COVC is used to re-import the starter * * set, ensure that the OVERWRITE import option * * is specified if the WUI server's repository * * previously contained that starter set * * viewsets and menus. * * * * For details on the AUTOIMPORTDSN and * * AUTOIMPORTMEM WUI server initialization * * parameters see 'Specify the Web User * * Interface server initialization parameters' * * in the CICS Transaction Server for z/OS * * Version 3 Release 2 Installation Guide * * (GC34-6812). * * * * For details on the COVC IMPORT function see * * 'The CICSPlex SM Web User Interface * * transaction (COVC)' in the CICS Transaction * * Server for z/OS Version 3 Release 2 CICSPlex * * SM Web User Interface Guide (SC34-6841). * * * * The updated starter set member name that * * needs to be imported is: * * * * ViewSet : EYUxA2YK * * * * Replace x with the required language version * * to be imported: E - English, K - Japanese, S * * - Chinese. * * * * Insure that the import references the * * SEYUVIEW dataset that was updated by the PTF * * that resolves this APAR. * **************************************************************** EYU0BCAB is missing some validation rules for an IPCONDEF UPDATE or CREATE action: - if AUTOCONNECT=YES then PORT must contain a valid numeric port number and the TCPIP attribute must not be blank. - if SENDCOUNT>0 then PORT and HOST must contain valid numeric values. Additionally, some annotations are missing from the EYUSTARTIPCONDEF CREATE and UPDATE views.
Problem conclusion
The validation checking for IPCONDEF in EYU0BCAB has been changed and the EYUSTARTIPCONDEF view has been updated.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
Incorrect validation is being performed on the PORT, HOST, TCPIP and SENDCOUNT attributes when creating or updating an IPCONDEF resource table. Invalid combinations or blank values can be defined in the attributes, listed above. When these invalid definitions are installed using the Web User Interface Install action messages EYUVC1273I and EYUVC1279I will be issued, reporting a CREATE IPCONN failure. Examination of the MAS that was the target system of the install will shows messages such as DFHCA5501. After applying the PTF that resolves this APAR, all CMASes must be recycled to pick up the new code. Note that the restarts do not need to be done at the same time. Additionally users of the CICSPlex SM supplied starter set viewsets and menus must re-import the updated starter set viewset and menu definitions into each Web User Interface (WUI) server's repository in order to pick up the changes. The starter set viewsets and menus can be re-imported either via the AUTOIMPORTDSN and AUTOIMPORTMEM WUI server initialization parameters or the IMPORT (from a dataset) function of the COVC WUI transaction. If COVC is used to re-import the starter set, ensure that the OVERWRITE import option is specified if the WUI server's repository previously contained that starter set viewsets and menus. Users who have copied the IBM supplied starter set viewsets and menus to another name will have to manually apply the changes made by the PTF that resolves this APAR to those copies. For details on the AUTOIMPORTDSN and AUTOIMPORTMEM WUI server initialization parameters see 'Specify the Web User Interface server initialization parameters' in the CICS Transaction Server for z/OS Version 3 Release 2 Installation Guide (GC34-6812). For details on the COVC IMPORT function see The CICSPlex SM Web User Interface transaction (COVC)' in the CICS Transaction Server for z/OS Version 3 Release 2 CICSPlex SM Web User Interface Guide (SC34-6841). The updated starter set member name that need to be imported is: ViewSets : EYUEA2YK Replace x with the required language version to be imported: E - English, K - Japanese, S - Chinese. Insure that the import references the SEYUVIEW dataset that was updated by the PTF that resolves this APAR. EYU0BCAB is missing some validation rules for an IPCONDEF UPDATE or CREATE action: - if AUTOCONNECT=YES then PORT must contain a valid numeric port number and the TCPIP attribute must not be blank. - if SENDCOUNT>0 then PORT and HOST must contain valid numeric values. Additionally, some annotations are missing from the EYUSTARTIPCONDEF CREATE and UPDATE views. The validation checking for IPCONDEF in EYU0BCAB has been changed and the EYUSTARTIPCONDEF view has been updated.
APAR Information
APAR number
PK48739
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
2007-07-11
Closed date
2007-08-17
Last modified date
2007-09-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK28291
Modules/Macros
EYUEA2YK EYUKA2YK EYUSA2YK EYU0BCAB
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R50M PSY UK28291
UP07/08/22 P F708
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:
04 September 2007