IBM Support

PI19930: +DEBUGLOG options file entry created by Reporting agent adds on to existing line, thus corrupting the options file

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • When reporting on a license server is started through the IBM
    Rational License Key Server (RLKS) Administration and Reporting
    Tool (ART), the agent appends a +DEBUGLOG option to any existing
    RLKS 'options' file.
    
    If the last line does not end in a newline character, the agent
    will append the +DEBUGLOG setting to the end of that line and
    not on a separate line. This will corrupt that entry in the
    option file and cause 2 issues:
    1) the log file that the agent is supposed to use may not
    actually get created
    2) Whatever option was set in the last line of the options fail
    may not correctly take effect. This can lead to various license
    checkout failures depending on the nature of the 'lost' entry.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * This issue is reported when using RLKS Administration agent  *
    * version 8.1.4.2. The issue is seen on all platforms on which *
    * agent is supported (Windows, Unix, Linux).                   *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * The RLKS 8.1.4.2 Agent adds a DEBUGLOG line to the options   *
    * file when the user performs "Start Reporting" operation. If  *
    * the customer already uses an options file which does not end *
    * with a carriage return / line feed, this DEBUGLOG line gets  *
    * appended to the end of the last line in the options file     *
    * instead of being added as a new line.                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    

Problem conclusion

  • This issue has been fixed in RLKS Administration and Reporting
    Tool version 8.1.4.3.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI19930

  • Reported component name

    RATIONAL LICENS

  • Reported component ID

    5648LIC00

  • Reported release

    814

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-06-12

  • Closed date

    2014-07-03

  • Last modified date

    2014-07-03

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

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

Fix information

  • Fixed component name

    RATIONAL LICENS

  • Fixed component ID

    5648LIC00

Applicable component levels

  • R814 PSY

       UP



Document information

More support for: Rational License Key Server

Software version: 814

Reference #: PI19930

Modified date: 03 July 2014