PK50261: LINK3270 FAILS ON GET CONTAINER

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are using the DFHWBTTC to run the 3270 application
  from the WEB.
  You have coded the program as a hybrid commarea/channel program.
  When a return is made to CICS, it is done using RETURN TRANSID
  /CHANNEL option - after copying the "commarea" and "tsq" areas
  into separate containers.
  .
  The next time the program is invoked, code is in place to check
  whether the program was invoked with a commarea. If it wasn't,
  then you issue the GET CONTAINER command to retrieve the
  "commarea" and "tsq" areas that were placed in the channel
  /containers by the prior call.
  .
  This works fine when you execute the program on a 3270 device,
  but using a browser through LINK3270, it comes down on second
  time into the program in the GET CONTAINER command:
   Function code     3414
   Response code     x'10' (invalid request)
   Response-2        x'04'
  .
  Further investigation, indicated that CICS didn't get a
  BIND_CHANNEL for the CHANNEL_TOKEN in LINK3270 vs. 3270 device
  case.
  .
  LINK3270 should support channels and containers, and it
  shouldn't make any difference whether the TCTTE is a real
  facility or a bridge facility.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: A GET CONTAINER CHANNEL instruction     *
  *                      fails in a program which was invoked    *
  *                      across a Web Bridge link                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Using the Web Bridge, one program creates a channel container,
  then invokes another program via an EXEC CICS RETURN TRANSID
  CHANNEL command. However, the program invoked by the EXEC CICS
  RETURN issues a CONTAINER NOT FOUND condition, as the channel
  was not successfully passed across.
  

Problem conclusion

• The Web Bridge client attach program DFHBRXM has been amended to
  include a PGCH BIND_CHANNEL call during BIND_XM_CLIENT
  processing. The absence of this PGCH call was causing the
  channel not to be passed through the Web Bridge.
  ................................................................
  The CICS Transaction Server for z/OS Version 3 Release 1 Trace
  Entries manual (SC34-6443-03) needs to be updated as follows:
  .
  In Table 81 on page 180, immediately after the entry for trace
  point 286C, the following entry should be added:
  .
  AP  286D  DFHBRXM    Exc   Bind channel failed    1    PGCH
                                                         parameter
                                                         list
  ................................................................
  The CICS Transaction Server for z/OS Version 3 Release 2 Trace
  Entries manual (SC34-6828-00) needs to be updated as follows:
  .
  In Table 81 on page 235, immediately after the entry for trace
  point 286C, the following entry should be added:
  .
  AP  286D  DFHBRXM    Exc   Bind channel failed    1    PGCH
                                                         parameter
                                                         list
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK32592 UK32593

Modules/Macros

•    DESBRTRI DESBRXM  DFHBRTRI DFHBRTR2 DFHBRXM
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK32592

     UP07/12/25 P F712

• R500 PSY UK32593

     UP07/12/25 P F712

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.