IBM Support

PI22376: SPECIAL CHARACTERS IN LICENSE SERVER LOG MAY PREVENT EXPORTING LICENSE REPORTS AS JSON OR XML.

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

APAR status

  • Closed as program error.

Error description

  • When the IBM Rational License Key Server (RLKS) Administration
    and Reporting tool (ART) is ued to generate license usage
    reports, and those are exported to JSON or XML formats, the
    report export will fail if:
    1) there are any characters in the output that fall in to the
    non-printable ASCII range (0x00-0x1a)
    2) There are link-local IPv6 addresses (with zone ID's) in the
    license server logs.
    
    In the case of #2 above, the link-local IPv6 address will
    resemble this:
    fe80::b9db:3a82:e8c8:d971%11
    
    The %11 is the zone ID. The Administration and reporting tool
    treats this value the same way that the browser would treat it
    if it were included in a URL, as a character whose actual value
    is 0x11, the ASCII "Device Control 1" (DC1) value.
    

Local fix

  • Output the files as .csv (comma separated value) files. The
    binary value may still be present, but the export will occur and
    can be removed in an editor.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * Users are unable to export report definitions in ART into    *
    * formats such as JSON and XML if the license server log file  *
    * logs the hostnames as link-local IPv6 addresses              *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * Users are unable to export report definitions in ART into    *
    * formats such as JSON and XML if the license server log file  *
    * logs the hostnames as link-local IPv6 addresses              *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    

Problem conclusion

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

Temporary fix

Comments

APAR Information

  • APAR number

    PI22376

  • 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-07-18

  • Closed date

    2014-12-22

  • Last modified date

    2014-12-22

  • 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 #: PI22376

Modified date: 22 December 2014