IBM Support

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

Subscribe

You can track all active APARs for this component.

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 number

    PI26973

  • Reported component name

    RD/Z HOST

  • Reported component ID

    5724T0723

  • Reported release

    850

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-10-03

  • Closed date

    2015-01-20

  • Last modified date

    2015-02-05

  • 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.



Document information

More support for: Rational Developer for System z

Software version: 8.5

Reference #: PI26973

Modified date: 05 February 2015