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

You can track all active APARs for this component.

 

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"},"Platform":[{"code":"PF054","label":"z\/OS"}],"Version":"11.1"}]

Document Information

Modified date:
02 September 2021