PI62339: TRUNCATED TEXT IN WTO FOR MESSAGE DFS1297E - MISSING LAST 4 CHARS OF TPIPE NAME

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Message DFS1297E is written both to MTO and System Console via
  DFSMCTI WTO(AND).
  Message text results complete in MTO:
  .
  DFS1297E  OTMA TRANSACTION COMPLETED. NO OUTPUT DUE TO MESSAGE S
  EXCEEDED
  32K
  
     (32767). MEMBER=HWSGPM21        , TPIPE=81266512
  .
  while its WTO to System Console results truncated; last 4 chars
  of TPIPE name at the end of the message are missing:
  .
  DFS1297E OTMA TRANSACTION COMPLETED. NO OUTPUT DUE TO MESSAGE SI
  SIZE
  EXCEEDED 32K   (32767). MEMBER=HWSGPM21        , TPIPE=8126<mm>
  .
  <mm> = missing 4 chars.
  .
  Analysis showed that message DFS1297E is too long for the
  DFSCMTI internal length limit.
  Blank spaces currently present inside the message should be
  removed so tha the entire message can be displayed.
  .
  It could be considered that Customer has also requested the
  Transaction name to be included in Message DFS1297E via RFE
  88022 / RTC 73837 .
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS V13 customers using OTMA or OTMA         *
  *                 destination descriptor for MQSeries          *
  ****************************************************************
  * PROBLEM DESCRIPTION: Incomplete DFS1297E message sent to     *
  *                      client. And IMS needs to support        *
  *                      MQSTR as a valid MQ format name for     *
  *                      OTMA destination descriptor for MQ      *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  DFS1297E was issued without the last few characters of OTMA
  tpipe name. And OTMA destination descriptor for MQSeries
  needs to support MQSTR as a valid MQ FORMAT name.
  

Problem conclusion

• GEN:
  KEYWORDS:
  
  *** END IMS KEYWORDS ***
  DFS1297E was enhanced to print the complete TPIPE name. And
  the message will include the transaction name. Also
  OTMA destination descriptor for MQSeries will now support
  MQSTR as a valid MQFORMAT name.
  
  Additional keyword: MSGDFS1297E
  
  
  The following modules were enhanced:
  DFSIC160 - ENHANCED CREATE OTMADESC COMMAND FOR MQSTR
  DFSIU160 - ENHANCED UPDATE OTMADESC COMMAND FOR MQSTR
  DFSYIDC0 - ENHANCED OTMA DESTINATION DESCRIPTOR FOR MQSTR
  DFSYQAB0 - ENHANCED DFS1297E TO PRINT TRANCODE AND TPIPE NAME
  
  The following is the DOC changes:
  
  ============================================================
  IMS Messages and Codes
  ============================================================
  Replace the existing DFS1297E message text with the following
  
    DFS1297E OTMA TRANSACTION COMPLETED. OUTPUT SEGMENT SIZE
    EXCEEDED FOR TRANS=trancode, MEMBER=member, TPIPE=tpipe
  
  Add the following to the Explanation section
  
    trancode
      The 8-byte original input transaction name
  
  ============================================================
  IMS System Definition
  ============================================================
  DFSYDTx
  OTMA destination descriptor syntax and parameters
  
  IBM MQ parameters
  
  MQFORMAT
   add MQSTR to be a supported MQFORMAT option
  
  MQSTR
   MQ format option: MQFMT_STRING
  
  
  ============================================================
  IMS Commands
  ============================================================
  
  CREATE OTMADESC command
  
  Syntax
    Add MQSTR to be a supported MQFORMAT option
  
  Keywords
    Add MQSTR to be a supported MQFORMAT option
  
  
  UPDATE OTMADESC command
  
  Syntax
    Add MQSTR to be a supported MQFORMAT option
  
  Keywords
    Add MQSTR to be a supported MQFORMAT option
  

Temporary fix

Comments

APAR Information

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

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

  UI39177

Modules/Macros

• DFSIC160 DFSIU160 DFSYIDC0 DFSYQAB0
  

Fix information

• Fixed component name

  IMS V13

• Fixed component ID

  5635A0400

Applicable component levels

• R300 PSY UI39177

     UP16/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.