IBM Support

PI17630: DWA DOCUMENTATION UPDATE: DOUBLE QUOTES FOR THE VALUES OF DBADMI N PARAMETERS -DCNBROKERURI AND -DCNCHANNELNAME SHOULD BE REMOVED

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as documentation error.

Error description

  • Currently the documentation for format of the dbadmin command in
    "Configuring the Rational DOORS database server" has Quotation
    marks for all -dcnBrokerUri and -dcnChannelName parameters.
    
    Link:
    http://pic.dhe.ibm.com/infocenter/doorshlp/v9r5m2/index.jsp?topi
    c=%2Fcom.ibm.rational.dwa.install.doc%2Ftopics%2Ft_setupddbs.htm
    l
    
    Format specified in the above Link: dbadmin -dcnEnable -data
    port@DOORSserver -P server_password -dcnBrokerUri
    テ  tcp://broker:61616テ   -dcnChannelName テ  dcnテ   -dwaHost
    DWAserver テ  dwaPort port テ  dwaProtocol http or https
    
    However, an error "CRCRD7222E Unable to connect to broker" is
    displayed when accessing File > OSLC > Working Sets
    if the dbadmin command has been run with the value for
    -dcnBrokerUri parameter enclosed within double quotes.
    Hence, these double quotes need to be removed for the value of
    -dcnBrokerUri parameter.
    
    It has also been observed that if the value of -dcnChannelName
    which is dcn by default, is enclosed within double quotes,
    though the ETL job completes and says its successful, no data
    would have been transferred to the Data Warehouse.  Hence, the
    double quotes need to be removed for the value of
    -dcnChannelName parameter.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * Users of DOORS Web Access                                    *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * Currently the documentation for format of the dbadmin        *
    * command in                                                   *
    * "Configuring the Rational DOORS database server" has         *
    * Quotation                                                    *
    * marks for all -dcnBrokerUri and -dcnChannelName parameters.  *
    *                                                              *
    * Link:                                                        *
    * http://pic.dhe.ibm.com/infocenter/doorshlp/v9r5m2/index.jsp? *
    * topi                                                         *
    * c=%2Fcom.ibm.rational.dwa.install.doc%2Ftopics%2Ft_setupddbs *
    * .htm                                                         *
    * l                                                            *
    *                                                              *
    * Format specified in the above Link: dbadmin -dcnEnable -data *
    * port@DOORSserver -P server_password -dcnBrokerUri            *
    * ǽ ¶ tcp://broker:61616ǽ ¶  -dcnChannelName ǽ ¶ dcnǽ ¶    *
    * -dwaHost                                                     *
    * DWAserver ǽ ¶ dwaPort port ǽ ¶ dwaProtocol http or https   *
    *                                                              *
    * However, an error "CRCRD7222E Unable to connect to broker"   *
    * is                                                           *
    * displayed when accessing File > OSLC > Working Sets          *
    * if the dbadmin command has been run with the value for       *
    * -dcnBrokerUri parameter enclosed within double quotes.       *
    * Hence, these double quotes need to be removed for the value  *
    * of                                                           *
    * -dcnBrokerUri parameter.                                     *
    *                                                              *
    * It has also been observed that if the value of               *
    * -dcnChannelName                                              *
    * which is dcn by default, is enclosed within double quotes,   *
    * though the ETL job completes and says its successful, no     *
    * data                                                         *
    * would have been transferred to the Data Warehouse.  Hence,   *
    * the                                                          *
    * double quotes need to be removed for the value of            *
    * -dcnChannelName parameter.                                   *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    

Problem conclusion

  • The documentation has been updated to clarify the current
    behaviour
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI17630

  • Reported component name

    TLOGIC DOORS WE

  • Reported component ID

    5724V97WA

  • Reported release

    952

  • Status

    CLOSED DOC

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-05-09

  • Closed date

    2014-09-11

  • Last modified date

    2014-09-11

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

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

Fix information

Applicable component levels



Document information

More support for: Rational DOORS

Software version: 9.5.2

Reference #: PI17630

Modified date: 11 September 2014