IBM Support

How to disable the DOORS welcome screen

Question & Answer


Question

How do you disable the IBM Rational DOORS 'Welcome' screen appearing after logging into DOORS 9.1 or 9.2 for all users?

Cause

DOORS Welcome screen appears after a user successfully logs into DOORS.

Answer

Single user:

You may disable DOORS Welcome screen by unchecking the check box which is at the bottom of the DOORS welcome screen.

Once the check box is unchecked, the welcome screen will not appear next time you log in to DOORS.

All users on the same host:

If you wish to disable the DOORS welcome screen for all DOORS users who share a DOORS client on a single/standalone machine, follow the instructions below (this is done on the machine where the DOORS client is installed):

Note: This will only affect a particular DOORS 9.1 or 9.2 client machine, and not all DOORS clients.

  1. Log out of DOORS
  2. Navigate to $DOORSHOME$\lib\dxl\wizard\welcome
    Default location: "C:\Program Files\IBM\Rational\DOORS\9.2\lib\dxl\wizard\welcome"
  3. Locate the 'welcomewiz.dxl' file in the 'welcome' directory
  4. Open the 'welcomewiz.dxl' in a text editor (for ex: notepad)
  5. In the beginning of the dxl code, you will find a function called "welcomeGetShowWELCOME" which returns Boolean true to show welcome screen on startup
  6. At the very end of the "welcomeGetShowWELCOME" function, comment out the line 'return bRetval' and add another line 'return false' underneath it (See comments #1 & #2 in bold letters below)

    For example, the "welcomeGetShowWELCOME" looks like:

    /*
    +---------------------------------------------------------------+
    |
    | Function : welcomeGetShowWELCOME
    | Description: - Retreived the user config value for whether to show welcome screen on startup
    | Returns : - Boolean true to show welcome screen on startup
    |
    +---------------------------------------------------------------+
    */
    bool welcomeGetShowWelcome()
    {
    ....code...
    .......more code....
    .........see comments #1 & #2 below...
    .
    .
    //return bRetval #1: Add 2 forward slashes (//) to comment out
    return false #2: Add this line of code to return the value 'false'
    }
    **********END OF welcomeGetShowWelcome FUNCTION**********


  7. Save the file after modifying 'welcomewiz.dxl' file as mentioned above.
  8. Launch the DOORS client and log in as any user, the welcome screen should not appear after log in.

[{"Product":{"code":"SSKR2T","label":"IBM Engineering Requirements Management DOORS"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"General Information","Platform":[{"code":"PF033","label":"Windows"}],"Version":"9.2;9.1.0.2;9.1","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
01 May 2020

UID

swg21397800