IBM Support

PI82557: TCP Channel access lists not documented

Fixes are available

17.0.0.4: WebSphere Application Server Liberty 17.0.0.4
18.0.0.1: WebSphere Application Server Liberty 18.0.0.1
18.0.0.2: WebSphere Application Server Liberty 18.0.0.2
18.0.0.3: WebSphere Application Server Liberty 18.0.0.3
18.0.0.4: WebSphere Application Server Liberty 18.0.0.4
19.0.0.1: WebSphere Application Server Liberty 19.0.0.1
19.0.0.2: WebSphere Application Server Liberty 19.0.0.2
19.0.0.3: WebSphere Application Server Liberty 19.0.0.3
19.0.0.4: WebSphere Application Server Liberty 19.0.0.4
19.0.0.5: WebSphere Application Server Liberty 19.0.0.5
19.0.0.6: WebSphere Application Server Liberty 19.0.0.6
19.0.0.7: WebSphere Application Server Liberty 19.0.0.7
19.0.0.8: WebSphere Application Server Liberty 19.0.0.8
19.0.0.9: WebSphere Application Server Liberty 19.0.0.9
19.0.0.10: WebSphere Application Server Liberty 19.0.0.10
19.0.0.11: WebSphere Application Server Liberty 19.0.0.11
19.0.0.12: WebSphere Application Server Liberty 19.0.0.12
20.0.0.1: WebSphere Application Server Liberty 20.0.0.1
20.0.0.2: WebSphere Application Server Liberty 20.0.0.2
20.0.0.3: WebSphere Application Server Liberty 20.0.0.3
20.0.0.4: WebSphere Application Server Liberty 20.0.0.4
20.0.0.5: WebSphere Application Server Liberty 20.0.0.5
20.0.0.6: WebSphere Application Server Liberty 20.0.0.6
20.0.0.7: WebSphere Application Server Liberty 20.0.0.7
20.0.0.8: WebSphere Application Server Liberty 20.0.0.8
20.0.0.9: WebSphere Application Server Liberty 20.0.0.9
20.0.0.10: WebSphere Application Server Liberty 20.0.0.10
20.0.0.11: WebSphere Application Server Liberty 20.0.0.11
20.0.0.12: WebSphere Application Server Liberty 20.0.0.12
21.0.0.3: WebSphere Application Server Liberty 21.0.0.3
21.0.0.4: WebSphere Application Server Liberty 21.0.0.4
21.0.0.5: WebSphere Application Server Liberty 21.0.0.5
21.0.0.6: WebSphere Application Server Liberty 21.0.0.6
21.0.0.7: WebSphere Application Server Liberty 21.0.0.7
21.0.0.8: WebSphere Application Server Liberty 21.0.0.8
21.0.0.9: WebSphere Application Server Liberty 21.0.0.9
21.0.0.1: WebSphere Application Server Liberty 21.0.0.1
21.0.0.2: WebSphere Application Server Liberty 21.0.0.2
21.0.0.10: WebSphere Application Server Liberty 21.0.0.10
21.0.0.11: WebSphere Application Server Liberty 21.0.0.11
21.0.0.12: WebSphere Application Server Liberty 21.0.0.12
22.0.0.1: WebSphere Application Server Liberty 22.0.0.1
22.0.0.2: WebSphere Application Server Liberty 22.0.0.2
22.0.0.3: WebSphere Application Server Liberty 22.0.0.3
22.0.0.4: WebSphere Application Server Liberty 22.0.0.4

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as documentation error.

Error description

  • Information needs to be added to metatype file to update
    Knowledge Centre information.
    
    Topic is:
    http://www.ibm.com/support/knowledgecenter/en/SSAW57_liberty
    /com
    .ibm.web
    sphere.wlp.nd.doc/ae/rwlp_config_tcpOptions.html
    
    Add options and description as follows:
    <---------------begin------------------>
    Attribute name          Data type            Default value
    Description
    addressExcludeList     string
    Specifies the list of addresses that are not allowed to make
    inbound
    
    connections on this channel. IPv4 or IPv6 addresses can be
    specified.
    
    All values in an IPv4 or PIv6 address must be represented by
    a
    number
    
    or an asterisk, which is the wildcard character.
    
    addressIncludeList       string
    Specifies the list of addresses that are not allowed to make
    inbound
    
    connections on this channel. IPv4 or IPv6 addresses can be
    specified.
    
    All values in an IPv4 or PIv6 address must be represented by
    a
    number
    
    or an asterisk, which is the wildcard character.
    
    hostNameExcludeList   string
    Specifies the list of host names that are not allowed to
    make
    inbound
    
    connections on this channel. Host names can start with an
    asterisk,
    
    which is the wildcard character. However, an asterisk must
    not
    appear
    
    elsewhere in the address. For example, *.ibm.com is valid,
    but
    *.ibm.*
    
    is invalid
    
    hostNameIncludeList     string
    Specifies the list of host names that are allowed to make
    inbound
    
    connections on this channel. Host names can start with an
    asterisk,
    
    which is the wildcard character. However, an asterisk must
    not
    appear
    
    elsewhere in the address. For example, *.ibm.com is valid,
    but
    *.ibm.*
    
    is invalid.
    <-----------------end-------------------->
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:  Users of IBM WebSphere Application Server   *
    *                  Liberty TCP Channel access lists            *
    ****************************************************************
    * PROBLEM DESCRIPTION: The TCP Channel access list             *
    *                      functionality                           *
    *                      was not documented for WebSphere        *
    *                      Liberty                                 *
    *                      Application Server                      *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    The TCP Channel provides the ability to define four access
    lists:
    address include, address exclude, hostname include, and hostname
    exclude. None of these were documented on the KnowledgeCenter.
    

Problem conclusion

  • The documentation was modified to include details on the access
    lists. This new information will be included under the "tcpOptio
    topic.
    
    The fix for this APAR is currently targeted for inclusion in fix
    pack 17.0.0.4.  Please refer to the Recommended Updates page for
    delivery information:
    http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI82557

  • Reported component name

    LIBERTY PROFILE

  • Reported component ID

    5724J0814

  • Reported release

    CD0

  • Status

    CLOSED DOC

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-06-05

  • Closed date

    2017-09-25

  • Last modified date

    2017-09-27

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"CD0","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
04 May 2022