Configuring the cross-launch application

The probe is supplied with a launch-in-context feature that enables you to launch the SAM Fault Management Web app from Netcool/OMNIbus Web GUI Event Viewer right-click tool using two separate methods. Users can configure the GUI manually. Users may also configure the Web GUI using WAAPI which requires createCrossLaunchTool.xml and modifyAlertsMenu.xml.

Users must run addObjectFullName.sql by running one of these commands according to the platform to add ObjectFullName field in alerts.status.

The files are located here:

On Unix:

$OMNIHOME/bin/nco_sql –server <objectserver_name> –user <username> –password <password> < <path_to_file>/addObjectFullName.sql

On Windows:

%NCHOME%\bin\redist\isql.exe -S <objectserver name> -U <username> -P <password> -i <path_to_file>\addObjectFullName.sql

The createCrossLaunchTool.xml, modifyAlertsMenu.xml and addObjectFullName.sql are located here:

$OMNIHOME/probes/<arch>/5620_SAM_CrossLaunch/

$OMNIHOME/probes/<arch>/5620_SAM_CrossLaunch/addObjectFullName.sql

addObjectFullName.sql is required for the two methods. After running this, you need to uncomment the following lines in the rules file:

#if (exists($objectFullName))
	#{
		#@ObjectFullName = $objectFullName
	#}
Note: createCrossLaunchTool.xml and modifyAlertsMenu.xml are not required if you are configuring Web GUI manually.

Configure the Web GUI manually

To configure the Web GUI manually, complete the following steps.


  1. Edit the object server alerts.status table to add ObjectFullName field using sql file addObjectFullName.sql

    For example:

    $OMNIHOME/bin/nco_sql -server NCOMS -username root -password
    '' </opt/IBM/tivoli/netcool/omnibus/probes/
    linux2x86/5620_SAM_CrossLaunch/addObjectFullName.sql

  2. Login into the IBM Tivoli Netcool/OMNIbus WebGUI Dashboard Application Service Hub.

    https://<DASH IP or hostname>:16311/ibm/console

    Refer to the IBM Tivoli Netcool/OMNIbus Web GUI Administration and User's Guide to create a new tool of script type named 5620SAM-CrossLaunch with the following inputs.


    For example:

    1. Open the Event Management Tool (from the Dashboard's side bars)
    2. Select 'Tool Configuration' and create a new tool named "5620SAM-CrossLaunch"
    3. Choose type as script and input script as below:
      var objName=’{@ObjectFullName}’; var samhost = ’127.0.0.1’; 
      var address = ’http://’ + samhost + ’/FaultManagement?view=alarmListImpacts&objectFullName=’+ objName;
      window.open (address,"5620SAM Cross Launch");
    4. * replace the IP <127.0.0.1> with 5620 SAM IP / hostname accordingly

  3. Refer to IBM Tivoli Netcool/OMNIbus Web GUI Administration and User's Guide to perform the menu configuration and modify alert menu to include 562SAM-CrossLaunch that should be created in step 2 from available items.

    For example:

    1. Open Event Management Tool > Menu Configurations
    2. Click on "alerts" from the available menu and click on the "Modify" button.
    3. Add the 5620SAM-CrossLaunch tool that was previously created in step 2 from the available items to the current items.
    4. Click Save.
    5. Open Event Viewer.
    6. Click Refresh.
    7. Right click on one of the alarms received from SAM. You should see 5620SAM-CrossLaunch as an option.

Configure the Web GUI using WAAPI

To configure the Web GUI using the WAAPI, complete the following steps.


  1. Refer to the IBM Tivoli Netcool/OMNIbus Web GUI Administration API (WAAPI) User's Guide to create a new tool by using createCrossLaunchTool.xml. 5620SAM-CrossLaunch must not exist before this step.

    For example:

    1. Go to WebGUI WAAPI bin dir.
    2. Modify the createCrossLaunchTool.xml to change the samhost in below line to your SAM EMS host ip or name and save the xml file.
    3. After reviewing and modifying createCrossLaunch.xml run this command:
      $WAAPI_BIN_DIR/bin/runwaapi -file 
      $OMNIHOME/probes/<platforms>/5620_SAM_CrossLaunch/createCrossLaunchTool.xml
      -username <WAS_USER_ID> -password <WAS_USER_PASSWORD>
  2. Refer to the IBM Tivoli Netcool/OMNIbus Web GUI Administration API (WAAPI) User's Guide to modify the alert menu by using modifyAlertsMenu.xml.
    Note: Running the modifyAlertsMenu.xml will overwrite your existing alerts menu items. Make sure in modifyAlertsMenu.xml the content under modify.menu does not overwrite any of your existing items in the Alerts menu.

    Make any changes if required, or you can run the manual step in above section to add in the newly created 5620SAM-CrossLaunch tool to the Event Viewer alerts right-click tool menu.

  3. After reviewing and modifying the modifyAlertsMenu.xml run this command:
    $WAAPI_BIN_DIR/bin/runwaapi -file 
    $OMNIHOME/probes/<platforms>/5620_SAM_CrossLaunch/modifyAlertsMenu.xml
    -username <WAS_USER_ID> -password <WAS_USER_PASSWORD>
  4. Open Event Viewer and click Refresh.
  5. Right click on one of the alarms received from SAM. You should see 5620SAM-CrossLaunch as an option.