PH31247: MESSAGE HWSP1415E WITH MIXED RETURN AND ERROR CODES WHEN MESSAGE ISSUED FROM MODULE HWSSCVC0

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• TCP/IP read error code and return value are mixed up on
  HWSP1415E messages when module HWSSCVC0 issues the message:
  .
  HWSP1415E TCP/IP SOCKET FUNCTION CALL FAILED; F=READFAIL,
            R=1121, E=-1
  .
  The HWSP1415E messages are correct when module HWSSDRCV
  issues the message:
  .
  HWSP1415E TCP/IP SOCKET FUNCTION CALL FAILED; F=READ    ,
            R=-1, E=1121
  

Local fix

• No.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All IMS V15 IMS Connect users.                               *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * IMS Connect HWSP1415E message has return and error codes     *
  * swapped.                                                     *
  *                                                              *
  * HWSP1440E message has duplicate HWSP1440E text.              *
  *                                                              *
  * ICON recorder trace identifier ICONTO for OTMA protocol      *
  * violation is incorrect.                                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * INSTALL CORRECTIVE SERVICE FOR APAR/PTF                      *
  ****************************************************************
  This APAR hits three issues:
  
  1. The HWSP1415E message has R= and E= parm values incorrectly
  swapped.
  "HWSP1415E TCP/IP SOCKET FUNCTION CALL FAILED; F=READFAIL,
  R=1121, E=-1, M=SCVC, ID=HWS5MUIY, IPv6=0:0:0:0:0:FFFF:A58:943C"
  should be
  "HWSP1415E TCP/IP SOCKET FUNCTION CALL FAILED; F=READFAIL, R=-1,
  E=1121, M=SCVC, ID=HWS5MUIY, IPv6=0:0:0:0:0:FFFF:A58:943C".
  
  2. The HWSP1440E message has a duplicate 'HWSP1440E' text.
  "HWSP1440E HWSP1440E INVALID LENGTH SPECIFIED IN MESSAGE PREFIX;
  L=1195725856, M=SDRC, ID=DELDUMMY, IPv6=0:0:0:0:0:FFFF:11F7:50"
  should be
  "HWSP1440E INVALID LENGTH SPECIFIED IN MESSAGE PREFIX;
  L=1195725856, M=SDRC, ID=DELDUMMY, IPv6=0:0:0:0:0:FFFF:11F7:50".
  
  3. ICON recorder trace identifier ICONTO for OTMA protocol
  violation is incorrect.
  
  In an OTMA protocol violation scenario using the ICON recorder
  trace, the trace record identifier is incorrectly set to ICONTO
  for timeout instead of the correct identifier ICONSN for send of
  response error.
  The OTMA protocol violation scenario is as follows:
  - Client issued a ResumeTpipe wait forever request to IMS
  Connect.
  - After IMS Connect sends the ResumeTpipe request to IMS, it
  issues a TCP/IP read to listen for client disconnect.
  - Client is supposed to wait for and receive the response, but
  instead it sent data to ICON; hence violating the protocol.
  - Client was not terminated. When ICON tries to send the error
  message to the client, it succeeds, which then results in ICON
  setting CALLID=TO.
  

Problem conclusion

• Provided the following solutions for the three issues:
  
  1. In HWSSCVC0, the XRETVALU and XRETCODE places were swapped
  for HWSP1415E message to correct the R= and E= value change.
  
  2. In HWS1MENU, deleted 'HWSP1440E' text in HWSP1440 to correct
  the duplicate 'HWSP1440E' text.
  
  3. In HWSSCVC0, clear SESSPROT at the beginning of CMODE1
  routine. In TERMBLKS, check if SESSPROT bit is on. If SESSPROT
  is on, set USTAT_CALLID='SN'.
  

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:

  UI75189

Modules/Macros

• HWSSCVC0 HWSM1ENU
  

Fix information

• Fixed component name

  IMS V15

• Fixed component ID

  5635A0600

Applicable component levels

• R500 PSY UI75189

     UP21/05/01 P F104

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.