IBM Support

PI20623: RATIONAL DEVELOPER FOR SYSTEM Z V9.0.1 - EQA9999W - DEBUG TOOL TCPIP ERROR

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • When attempting to run Code Coverage JCL procedure AKGCC in
    Rational Developer for System z (RDz) V9.0.1, the
    procedure fails message "EQA9999W - Debug Tool TCPIP error". The
    following messages are logged in the report
    generation at the time of the failure.
    
    10.33.17 JOB07624  +EQA9999W - Debug Tool TCPIP error
    10.33.17 JOB07624  +EQA9999W - FeName=EQACSMTP Loc=010
    Func=GETAIN Rc=-1       Fc=1
    10.33.17 JOB07624  +EQA9999W - Err: EPERM/EDOM      Not owner or
    Argument too large
    10.33.17 JOB07624  +EQA9999W - IP: 34999
    10.33.17 JOB07624  +EQA9999W - Port:  8001
    

Local fix

  • A workaround or bypass for the underlying problem, CC collector
    not retrieving the IP address, is to add the lines that
    are preceded by '''''' in the example below to the
    SAKGPROC(AKGCCX) procedure.
    
    -> Before
    000370   if OK
    000371     then say 'AKG0405I collector is using PID' Pid 'and
    port' Addr
    000372     else if Vars.!debug then say '> collector startup
    timed out'
    000373 end    /* wait for collector startup */
    000374
    000375 if OK
    000376 then say 'AKG0406I code coverage collector startup
    completed at' time()
    
    -> After
    
    000370   if OK
    000371     then say 'AKG0405I collector is using PID' Pid 'and
    port' Addr
    000372     else if Vars.!debug then say '> collector startup
    timed out'
    000373 end    /* wait for collector startup */
    000374
    '''''' if OK & pos('%',Addr) == 0
    '''''' then do
    ''''''   say 'AKG0416W missing IP address of collector, using
    localhost'
    ''''''   Addr='localhost%'Addr
    ''''''   cRC=max(cRC,4)
    '''''' end    /* */
    ''''''
    000375 if OK
    000376 then say 'AKG0406I code coverage collector startup
    completed at' time()
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: 01.All headless code coverage users who use  *
    *                    the -localonly parameter or the AKGCC     *
    *                    procedure.                                *
    ****************************************************************
    * PROBLEM DESCRIPTION: 01.EQA9999W - Debug Tool TCPIP error    *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    01.When using the -localonly parameter with the code coverage
       daemon, whether by command line, of by using the code
       coverage procedure AKGCC, the daemon is unable to determine
       the loopback ip address for binding for some TCP/IP
       configurations. This results in the localonly parameter
       being ignored, and also results in the code coverage session
       launched by AKGCC failing.
    

Problem conclusion

  • 01.The code coverage daemon used for headlesss will now
       properly detect the loopback address, and if no loopback
       address is defined, it will log an error indicating the
       problem. AKGCC is enhanced to attempt to bypass the problem
       when it occurs.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI20623

  • Reported component name

    RD/Z HOST

  • Reported component ID

    5724T0723

  • Reported release

    900

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-06-23

  • Closed date

    2014-08-21

  • Last modified date

    2015-06-03

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

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

Modules/Macros

  • AKGXCC01
    

Fix information

  • Fixed component name

    RD/Z UTILITIES

  • Fixed component ID

    5724T0733

Applicable component levels

  • R900 PSY UI20748

       UP14/08/25 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: 9.0

Reference #: PI20623

Modified date: 03 June 2015