Reuse Elements From the Default Welcome Page

There are elements in the IBM® Cognos® Welcome page that may be difficult to implement, especially the logon link and the links to different studios.

To make your job easier, you can reuse these elements from the default Welcome page. You can create a page with any content that, through an iFrame, frame, and so on, references the links-only section of the Welcome page.

If you want to change the background color, modify the welcomeToolPanel parameter in the default.css file associated with the style you are using. For more information, see Example - Customize the Default Welcome Page.

Procedure

  1. In a text editor, such as Notepad, type the code for the page using the following parameters in the page URL.
    Table 1. Customize welcome page parameters and values

    Parameter

    Values

    Description

    basewelcome

    yes

    no

    This mandatory parameter renders the default Welcome page that only contains the links.

    wtarget

    top

    parent

    self (default)

    This optional parameter specifies where the links appear in the custom Welcome page.

    Do not include this parameter if you want the links to appear in the same frame.

    The following URL renders the links-only, default Welcome page:

    http://localhost/ibmcognos/cgi-bin/cognos.cgi?b_action=xts.run&
    m=portal
    /welcome/welcome.xts&basewelcome=yes&wtarget=top

    For example, if you want to create a custom Welcome page with only one iFrame that uses the links-only page, the source code for the page could be as follows:

    <html>
    <head></head>
    <body>
    <iframe width="100%" height="100%"
    src="http://localhost/ibmcognos/cgi-bin/cognos.cgi?b_action=cognosViewer&
    m=portal
    /welcome/welcome.xts&basewelcome=yes&wtarget=top"/>
    </body>
    </html>
  2. Save the file.