PI26973: RATIONAL DEVELOPER FOR SYSTEM Z (RDZ): A TSO COMMAND THROUGH APPC MAY FAIL WITH ERROR: "ERR: RECEIVE OF HOST IP, PORT"

8.5.1.6: UI24911 PTF for Rational Developer for System z Host Options
Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Rational Developer for System z - RDz - V8.5.1.4
  
  In RDz, running a TSO command through APPC may fail with the
  error:
  "ERR: Receive of Host IP, port" if:
  - the APPC transaction uses a passticket generated outside RDz
  (by a custom plugin for example)
  - and the APPC transaction has timed out
  - and the passticket has timed out
  
  Re-creation steps:
  
  For instance, use the following:
  1- a custom plugin generates a passticket and pass it to RDz
  to automatically connect the user
  2- in SDSF, cancel the APPC task for the connected user
  3- wait 11 minutes (RACF timeout for passticket is 10 minutes)
  4- In RDz client, open a TSO command shell and type a command
  (LU MYUSER). The following error is displayed:
  Error in RDZ client "Connection refused"
  5- In RDz client, open a TSO command shell and type a command
  (LU MYUSER). The following error is displayed:
  Error in RDZ client "ERR: Receive of Host IP, port"
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: 01.All RDz users who connect to an APPC      *
  *                    enabled RDz server                        *
  *                 02.All RDz users                             *
  ****************************************************************
  * PROBLEM DESCRIPTION: 01.APPC command server in RDz server    *
  *                         should use passtickets               *
  *                      02.The condition handler registered in  *
  *                         the resource serialization logic     *
  *                         sets the wrong result value.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  01.RDz server with APPC command server enabled assumes RDz
     client passes user id and password and the passed password
     should be valid while the client is connecting. If the
     passed password has a short life time like a passticket,
     when the password is expired, RDz server can not call APPC
     command server correctly and it causes errors.
  02.Because a condition handler sets the wrong result value of
     20, it is called repeatedly when an exception occurs while
     serializing a resource.
  

Problem conclusion

• 01.RDz server is updated not to expect client to pass password
     but to generate passticket internally. The APPLID for this
     passticket must be the partner-LU, and must be defined as
     _FEKFSCMD_PARTNER_LU_ variable in rsed.envvars.
  02.The condition handler is updated to set the correct result
     value of 10 to be called just once when an exception occurs
     while serializing a resource.
  

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:

Modules/Macros

•    FEKDSI   FEKFENVR FEKFLDSL FEKFMAIN FEKFMAI6
  FEKFMINE FEKFTSO  FEKFZOS
  

Fix information

• Fixed component name

  RD/Z HOST

• Fixed component ID

  5724T0723

Applicable component levels

• R850 PSY UI24911

     UP15/02/05 I 1000

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.