IBM Support

PK48739: AUTOCONNECT(YES) IS INVALID WITH PORT(NO) ON IPCONN DEFINITION

A fix is available

Subscribe

You can track all active APARs for this component.

 

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