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

9.0.1.3: UI20747 and UI20748 PTFs for Rational Developer for System z Host Utilities
Obtain the fix for this APAR.

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