PK29786: PROVIDE SUPPORT FOR THE XML ADAPTER ENHANCEMENT DELIVERED BY IMS CONNECT APAR PK24912

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Provice support for the XML adapter enhancment delivered by IMS
  CONNECT APAR PK24912.
  If you use IMS Performance Analyzer V4.1 for reporting of IMS
  Connect Extensions data, apply PTF UK19335 to IMS PA after
  applying UK18943 for this APAR.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Users of IMS Connect Extensions V1.2.    *
  ****************************************************************
  * PROBLEM DESCRIPTION: IMS Connect Extensions APAR PK29786     *
  *                      provides a number of enhancements       *
  *                      including support for:                  *
  *                      IMS V9 SPE APAR PK24912 - IMS Connect   *
  *                      XML conversion support for IMS SOAP     *
  *                      Gateway v9.2 - Adapter Task Manager     *
  *                      and XML Adapter.                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  IMS Connect Extensions APAR PK29786 provides a number of
  enhancements including support for:
  
  IMS V9 SPE APAR PK24912 - IMS Connect XML conversion support
  for IMS SOAP Gateway v9.2 - Adapter Task Manager and XML
  Adapter.
  

Problem conclusion

Temporary fix

Comments

• Summary of Changes:
  1. Full support for IMS Connect XML Adapter.
  2. New event data:
  2.1 New XML Adapter data fields in Type 62 event record -
      RXML function return and reason codes, XML adapter name
      and XML map name.
  2.2 Message reroute/purge data in Type 62 event record -
      flag settings and client reroute name.
  2.3 Initial client id in Type 62 and 168 event records.
  2.4 OTMA state and user data in Types 65 and 66 event
      records.
  2.5 New XML AR and AX trace data in Types 161 and 162 event
      records.
  2.6 Security section true length in Type 163 event record.
  2.7 XML Adapter trace data in new Type 169 event record -
      RXML input message.
  3.  New Active Session Monitor fields:
  3.1 New XML Adapter data fields displayed - RXML function
      return and reason codes, XML adapter name and XML map
      name.
  3.2 Message reroute/purge data displayed - flag settings
      and client reroute name.
  3.3 Initial client id displayed as well as current client
      id.
  4.  New messages:
  4.1 CEX5051I IMS Connect XML adapter is active
  4.2 CEX5052I Exit exitname not defined to IMS Connect
      Extensions, advanced features disabled for this message
      exit
  4.3 CEX5406I Listener initialized; console services now
      available
  4.4 CEX5407I IMS Connect Extensions initialization complete
  5.  New TRACE command in the batch command utility:
  5.1 TRACE JCL example:
      //STEP01   EXEC PGM=FUNEXEC,PARM='CEXDFCMD'
      //STEPLIB  DD DISP=SHR,DSN=FUN.V1R2M0.SFUNLINK
      //         DD DISP=SHR,DSN=CEX.V1R2M0.SCEXLINK
      //MSGOUT   DD SYSOUT=*
      //SYSUDUMP DD SYSOUT=*
      //SYSIN    DD *
      CONNECT DNSNAME=host_name,PORT=console_port,HWSID=sys_id
      TRACE LEVEL=trace_level,PORT=port,COND=(USERID,user_id)
  5.2 TRACE syntax:
                             .-PORT=*----.
    >>-TRACE--+-LEVEL=0-+--+-----------+------------------------>
              +-LEVEL=1-+  '-PORT=port-'
              '-LEVEL=2-'
    >--+-------------------------------------+-----------------><
       +-COND=(CLIENT_NAME,client_name)------+
       +-COND=(TRANSACTION,transaction_name)-+
       +-COND=(MESSAGE_EXIT,exit_name)-------+
       +-COND=(USERID,user_ID)---------------+
       +-COND=(LTERM,logical_terminal)-------+
       '-COND=(IP_ADDRESS,host_name_or_IP)---'
  5.3 TRACE statement operands:
      LEVEL= Tracing level (required):
        0  Tracing off
        1  Tracing on - OTMA, IRM and RSM data.
        2  Tracing on - OTMA, IRM, RSM and application data.
      PORT= Port number selected for tracing (optional):
        n  1-65535
        *  All ports (default)
      COND=(type,name)
        Conditional tracing option (optional) - specifies type
        and name pair of the resource to be filtered:
        COND=(type,...)
          Type of resource to be filtered - specify one of the
          following:
            CLIENT_NAME   Client name
            TRANSACTION   Transaction code
            MESSAGE_EXIT  Message exit name
            USERID        User ID
            LTERM         LTERM
            IP_ADDRESS    IP address
      COND=(..,name)
        Name of the resource to be filtered
  5.4 For more information, refer to the sample job CEXBCMD in
      the SCEXSAMP sample library.
  

APAR Information

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

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

  PK31784 UK18943

Modules/Macros

• CEXAPISR CEXBCMD  CEXBCMD0 CEXBCMD1 CEXCERE
  CEXCMDT  CEXCOMM  CEXCONS  CEXCONSJ CEXCONSS CEXCOPRP CEXCR62
  CEXCR65  CEXCR66  CEXCR88  CEXCSETP CEXCSKT  CEXDFDRV CEXEVTPR
  CEXEVT01 CEXEVWTR CEXEXRTR CEXLGDRV CEXMAIN  CEXMPDEP CEXMSGL
  CEXMSGT  CEXOKEYS CEXPRED0 CEXPRED1 CEXPRSR  CEXPRTSR CEXPUBMN
  CEXPUDRV CEXRCDPR CEXRCDUT CEXRSNT  CEXR161  CEXR162  CEXR163
  CEXR168  CEXR169  CEXSALUT CEXSERDB CEXSERDE CEXSERDI CEXSERM
  CEXSETT  CEXSMDRV CEXSVC01 CEXTECL  CEXTECL1 CEXTEOT  CEXTPLST
  CEXTRSCP CEXVUSER H28S120J
  

Fix information

• Fixed component name

  IMS CONNECT EXT

• Fixed component ID

  5655K4800

Applicable component levels

• R120 PSY UK18943

     UP06/10/24 P F610

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.