PH21519: EXCI CALL INQUIRE CHANNEL RESPONSE CODE=16 AND REASON CODE=633 (INQUIRE_CHANNEL_FAILED).

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• EXCI CALL interface is used to call a Java EE application
  running in an integrated mode Liberty JVM Server in CICS 5.5
  from within a traditional batch JOB implemented in COBOL 6.2.
  Version 3 of the DPL_Request command is used to communicate
  with the Java service via Channel and Containers.
  
  The KC states for the Channel parameter "If the channel does not
  exist, it is created.". If you want to use the Channel only for
  output from the serving JEE application, you should be able to
  use any PIC X(16) field holding a valid channelname as the
  Channel parameter, which will cause the creation of a new empty
  Channel of that name.  But when you do so, the COBOL client
  JOB abends with Response Code = 16 and Reason Code = 633
  (INQUIRE_CHANNEL_FAILED).
  
  EXCI trace, returns the following exception trace:
  
  XCI  EXCI EX 0633 XCPRH EXC PGCH_INQUIRE_CHANNEL_CALL_FAILED.
  

Local fix

• You could for the time being code a PUT CONTAINER before the
  first call and this would ensure the CHANNEL is there to be used
  on the LINK call.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Severe error x'0279' when an EXCI       *
  *                      client program does EXEC CICS LINK      *
  *                      CHANNEL                                 *
  ****************************************************************
  EXCI Client program performs an EXEC CICS LINK CHANNEL with a
  CHANNEL that has not been created.  This causes the LINK to fail
  with a severe error.  The same issue can occur using the call
  interface.
  
  Additional Keywords: 0279 x0279 DFHEX0002 EX0002 msgDFHEX0002
  

Problem conclusion

• EXCI has been updated to create an empty CHANNEL if the CHANNEL
  does not exist.
  
  A new trace point has been added if an invalid channel is passed
  in.  The new trace point id is 0808x.
  

Temporary fix

Comments

• ×**** PE20/09/09 FIX IN ERROR. SEE APAR PH29294  FOR DESCRIPTION
  

APAR Information

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

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

  UI69949

Modules/Macros

• DFHCCNV2 DFHCCNV6 DFHCNV00 DFHCNV01 DFHCNV02 DFHCNV03 DFHCNV04
  DFHCNV05 DFHCNV06 DFHCNV07 DFHCNV08 DFHCNV09 DFHCNV10 DFHCNV11
  DFHCNV12 DFHCNV13 DFHCNV14 DFHCNV15 DFHCNV16 DFHCNV17 DFHCNV18
  DFHCNV19 DFHCNV20 DFHCNV21 DFHCNV22 DFHCNV23 DFHCNV24 DFHCNV25
  DFHCNV26 DFHCNV27 DFHCNV28 DFHCNV29 DFHCNV30 DFHCNV31 DFHCNV32
  DFHCNV33 DFHCNV34 DFHCNV35 DFHCNV36 DFHCNV37 DFHCNV38 DFHCNV39
  DFHCNV40 DFHCNV41 DFHCNV42 DFHCNV43 DFHCNV44 DFHCNV45 DFHCNV46
  DFHCNV47 DFHCNV48 DFHCNV49 DFHCNV50 DFHCNV51 DFHCNV52 DFHCNV53
  DFHCNV54 DFHCNV55 DFHCNV56 DFHCNV57 DFHCNV58 DFHCNV59 DFHCNV60
  DFHCNV61 DFHCNV62 DFHCNV63 DFHCNV64 DFHCNV65 DFHCNV66 DFHCNV67
  DFHCNV68 DFHCNV69 DFHCNV70 DFHCNV71 DFHCNV72 DFHCNV75 DFHCNV76
  DFHCNV77 DFHCNV78 DFHCNV79 DFHCNV80 DFHCNV81 DFHCNV82 DFHCNV83
  DFHCNV84 DFHCNV85 DFHCNV86 DFHCNV87 DFHCNV88 DFHEXDUF DFHEXTRI
  DFHTREX  DFHXCBAM DFHXCCH  DFHXCCP  DFHXCCR  DFHXCDMP DFHXCEIP
  DFHXCGUR DFHXCNVG DFHXCPRH DFHXCSCR DFHXCSTB DFHXCTRA DFHXCTRD
  DFHXCTRI DFHXCTRP DFHXCV64
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R200 PSY UI69949

     UP20/06/12 P F006

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.