PK24900: CICS SHOULD CONNECT TO THE DEFAULT STACK AS INDICATED IN THE SYSTCPD DD STATEMENT IN THE CICS JCL.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This APAR is being taken to provide the ability to connect to
  the default stack as indicated by the SYSTCPD DD statement in
  the CICS JCL.
  
  This will allow the CICS TCP/IP interface to attach to the
  TCP/IP stack designated by the TCP/IP Global Resolver, as
  identified in the 'TCPIPJOBNAME' statement.  This will avoid
  the need to use of the '_BPXK_SETIBMOPT_TRANSPORT'
  environmental variable.
  
  Additional Keywords:
  DFHSO0109 The TCPIPSERVICE could not be opened because the
  port is already in use on the IP address ANY
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: TCPIPSERVICES bind to all available     *
  *                      TCP/IP stacks unless a specific         *
  *                      IPADDRESS is used.                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  If a TCPIPSERVICE is defined with inaddr_any or a null IPADDRESS
  then it will bind to all available stacks in a CINET
  environment. There is no provision to be able to individually
  assign affinity to the default stack only.
  This makes it impossible to share a common TCPIPSERVICE
  definition across multiple z/OS systems which target the
  DEFAULT TCPIP stack.
  

Problem conclusion

• This APAR will allow a new value for the IPADDRESS parameter of
  the TCPIPSERVICE definition. The value DEFAULT can be specified
  which will assign affinity to the default TCP/IP stack in a
  multi stack CINET environment. If there is no default stack, for
  example in a non-CINET environment, then an exception trace
  entry will be produced and no affinity will be assigned. There
  are 3 new trace entries from the SO (sockets) domain.
  
  The CICS Transaction Server for z/OS V3.1 Resource Definition
  Guide (SC34-6430-03) will be changed in chapter 26 TCPIPSERVICE
  in the section "definition attributes" as follows:
  IPADDRESS({INADDR_ANY|value}) will be replaced with:
  IPADDRESS({INADDR_ANY|DEFAULT|value}).
  The following will be added after the description of INADDR_ANY:
  DEFAULT
        This will assign affinity to the TCP/IP stack that has
        been defined as the default in a multi stack CINET
        environment. If this is used in a non-CINET environment
        or there is no default TCP/IP stack, then an exception
        trace will be written and no affinity will be assigned.
  The CICS Transaction Server for z/OS Trace Entries V3.1
  (SC34-6443-02) will be changed in chapter 35 Socket Domain
  Trace Points as follows:
  The following will be added in the appropriate place in the
  table:
   _____________________________________________________________
  | SO   | DFHSOLS | SO  | settcpaff entry | 1. bpx interface   |
  | 0C59 |         | 2   |                 | 2. lte             |
  |      |         |     |                 | 3. stack name      |
  |______|_________|_____|_________________|____________________|
  | SO   | DFHSOLS | SO  | settcpaff exit  | 1. bpx interface   |
  | 0C5A |         | 2   |                 | 2. lte             |
  |      |         |     |                 | 3. stack name      |
  |______|_________|_____|_________________|____________________|
  | SO   | DFHSOLS | exc | settcpaff       | 1. bpx interface   |
  | 0C5B |         |     | failure         | 2. lte             |
  |      |         |     |                 | 3. stack name      |
  |______|_________|_____|_________________|____________________|
  
  
  The CICS Transaction Server for z/OS CICS Supplementary Data
  Areas v3.1 manual (LY33-6108-00) will be altered in the section
  "SOA Sockets Anchor block".
  The following will replace LTE_FLAG2:
  (51) BIT(8) 1 LTE_FLAG2
        1... .... LTE_CONNECTION_FAILURE  A connection has failed
        .1.. .... LTE_EIO                 EIO received
        ..1. .... LTE_EUNATCH             EUNATCH received
        ...1 .... LTE_DEFAULT_TCPIP       Default tcp stack used
        .... 1111 *                       Reserved
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK18979

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

  UK15981 UK15984

Modules/Macros

•    DESEISO  DESSOAD  DESSOAN  DESSOCK  DESSOCM
  DESSODM  DESSODUF DESSOIS  DESSOLS  DESSORD  DESSOST  DESSOTB
  DESSOTD  DESSOTRI DESSOUS  DFHEIN22 DFHEMT22 DFHESP22 DFHSOAD
  DFHSOADA DFHSOADM DFHSOADT DFHSOANC DFHSOAND DFHSOCBA DFHSOCBM
  DFHSOCBT DFHSOCCC DFHSOCK  DFHSOCKA DFHSOCKJ DFHSOCKM DFHSOCKT
  DFHSOCKV DFHSODCC DFHSODM  DFHSODUF DFHSOGH  DFHSOGH@ DFHSOIS
  DFHSOISA DFHSOISJ DFHSOISM DFHSOIST DFHSOISV DFHSOLS  DFHSOLSA
  DFHSOLSM DFHSOLST DFHSOPAA DFHSOPAM DFHSOPAT DFHSORD  DFHSORDA
  DFHSORDM DFHSORDT DFHSOREC DFHSOST  DFHSOTB  DFHSOTBA DFHSOTBM
  DFHSOTBT DFHSOTDC DFHSOTDD DFHSOTRI DFHSOUSC DFHSPSOB DFHSPSOC
  DFHSPSOE DFHSPSOV DFHWBRQS DFHWBSR
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK15981

     UP06/07/07 P F607

• R403 PSY UK15984

     UP06/07/07 P F607

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.