IBM Support

IT27374: DB2DSDRIVER.CFG, XML COMMENTS DO NOT WORK ON A WHOLE BLOCK OF PARAMETERS, BUT ONLY ONE A SINGLE LINE AT A TIME

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

  • Comments syntax in db2dsdriver.cfg works only on a single line
    at a time. Having to add multiple
    lines into a single comment block of <!-- -->, the comments are
    completely ignored and these lines are parsed
    successfully.
    
    When using XML comment syntax in the db2dsdriver.cfg, if a
    single parameter is commented out, the comments do work
    successfully. However, if the comment syntax surrounds multiple
    lines, they are parsed as if no comments are present at all.
    
    For example, the following works, despite the comments
    surrounding the entire block of parameters:
    
    testconn40 "Database=SAMPLE"
    
    <?xml version="1.0" encoding="UTF-8" standalone="no" ?>
    
    <configuration>
    
    <dsncollection>
    
    <dsn alias="SAMPLE" name="SAMPLE" host="wm-avp-rh3"
    port="60007">
    
    </dsn>
    
    </dsncollection>
    
    <databases>
    
    <database name="SAMPLE" host="wm-avp-rh3" port="60007">
    
    <!-- <parameter name="Authentication" value="SERVER" />
    
    <parameter name="SecurityTransportMode" value="SSL"/>
    
    <parameter name="UserID" value="db2in105" />
    
    <parameter name="password" value="********" />
    
    <parameter name="enableDirectXA" value="true" />
    
    <parameter name="SSLClientKeystash"
    value="C:\abc\db2in105.sth"/>
    
    <parameter name="SSLClientKeystoredb"
    value="C:\abc\db2in105.kdb"/> -->
    
    </database>
    
    </databases>
    
    </configuration>
    ================================================================
    
    Since we do not support multi-line comments in db2dsdriver.cfg,
    we would add the comment like below in db2dsdriver.cfg.sample
    that is shipped with installation package
    
    <!-- Multi-line comments are not supported -->
    
    Information center would also be updated to reflect the fact
    that db2dsdriver.cfg supports only single-line comments.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * ALL                                                          *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See Error Description                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Upgrade to Db2 11.1 Mod 4 Fixpack 5 or higher                *
    ****************************************************************
    

Problem conclusion

  • First fixed in Db2 11.1 Mod 4 Fixpack 5
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT27374

  • Reported component name

    DB2 CONNECT

  • Reported component ID

    DB2CONNCT

  • Reported release

    B10

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-12-17

  • Closed date

    2020-01-16

  • Last modified date

    2020-01-16

  • 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

    DB2 CONNECT

  • Fixed component ID

    DB2CONNCT

Applicable component levels

  • RB10 PSN

       UP

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"11.1","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
14 December 2020