Enlighten on Documentation - V2

Enlighten - FAQ

Mon, 01 Jan 0001 00:00:00 +0000

Enlighten

Minimum Database rights to access Enlighten for Oracle and CSS

To access Enlighten,the minimum database rights required for Oracle and CSS is Read/Write access

Minimum Database rights to access Architecture Checker for Oracle and CSS

To access Architecture Checker, the minimum database rights required for Oracle and CSS is Read access

Minimum Database rights to access Action Plan Optimizer for Oracle and CSS

To access Action Plan Optimizer,the minimum database rights required for Oracle and CSS is Read/Write access.

Enlighten - Information - Example of how to deploy CAST product over Citrix

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page describes how to deploy enlighten over citrix when users do not have access to the machine over Remote Desktop

Applicable in CAST Version

Release	Yes/No
8.1.x	✅
8.0.x	✅
7.3.x	✅
7.2.x	✅
7.0.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅
CSS1	✅

Details

The page describe the modification required in the following scenario:

Installing enlighten on a production server.
Give access to users for accessing enlighten from Citrix link.

You need to perform the following in order to be able to use Enlighten over Citrix:

Enlighten - Information - How to add missing connections to enlighten

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page gives information on how to update the missing connection profiles to CAST components such as enlighten after you have moved from SQL SERVER/Oracle to CSS or you restore your triplet on another machine.

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅
8.1.x	✅
8.0.x	✅
7.3.x	✅
7.2.x	✅
7.0.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅
CSS1	✅

Details

Enlighten - Information - How to delete diagrams

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

The page describes the process to delete Enlighten diagrams

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅
8.1.x	✅
8.0.x	✅
7.3.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	❌
Microsoft SQL Server	❌
CSS2	✅
CSS1	✅

Details

Run the following query in PGAdmin:

(replace %Generated% by your enlighten blueprint name and <local_cast_db> by your local cast database name)
set schema '<local_cast_db>';
SET @LOOP_MOD = select IdMod, ModNam from Mod where Modnam LIKE
'%Generated%';
SET @CTN = 0;
SET @MAXCT = LINES(@LOOP_MOD);
WHILE @CTN < @MAXCT
BEGIN 
SET @modid = @LOOP_MOD[@CTN][0]; 
SET @modnam = @LOOP_MOD[@CTN][1]; 
PRINT 'Delete ModId: ' + CAST(@modid AS STRING) + ' ' + @modnam; 
SELECT mod_free (@modid, 1, '@modnam'); 
SET @CTN = @CTN + 1;
END

Notes/comments

Enlighten - Information - How to drop links

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

The page describes the process to delete links from Enlighten.

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅
8.1.x	✅
8.0.x	✅
7.3.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅

Details

In order to delete a link in Enlighten, please perform the following steps:

Select the Link
Right click on the Link.
Select ‘Remove Link’.
Select ‘Drop Link’.

Notes/comments

Related Pages

Enlighten - Information - How to get the number of objects returned by the OLIA

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page describes how to get the number of objects returned by the OLIA.

Applicable in CAST Version

Release	Yes/No
8.1.x	❌
8.0.x	❌
7.3.x	❌
7.2.x	❌
7.0.x	?

Details

The number of objects returned by OLIA can be obtained by following the steps below:

Change the temporary table SESSIONTMPOLIA to a permanent table by dropping it and recreating it without the keyword temporary.
For example in CAST version 6.3.1, run:
Drop table SESSIONTMPOLIA
/
/****************** CREATE ORDER ******************/
Create table SESSIONTMPOLIA
(
IDCNX NUMBER NULL ,
IDSOURCE NUMBER NULL ,
IDTARGET NUMBER NULL ,
ACCTYPLO NUMBER NULL ,
ACCTYPHI NUMBER NULL ,
ACCTYPLO2 NUMBER NULL ,
ACCTYPHI2 NUMBER NULL ,
INTERNALLEVEL NUMBER NULL ,
WAYS NUMBER NULL
)
ON COMMIT PRESERVE ROWS
/
Connect to Enlighten
Run a call hierarchy
WIthout clicking on the Continue button in the Preview Call hierarchy window, get the number of links by executing the following query:
Select count ( * ) from SESSIONTMPOLIA
Clean the table before running a new call hierarchy by executing the following query:
Truncate table SESSIONTMPOLIA

Notes / Comments

Enlighten - Information - How to identify and open an object in Enlighten Graphical View

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This information page explains how to correctly identify an object in Enlighten. For more information, refer to:

For CAST 8.3.x: ENL - Objects

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅
8.1.x	✅
8.0.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅

Details

Open Enlighten and search for the object in the knowledge base as described in ENL - Finding/locating objects in the Knowledge Base. The search results return objects based on your criteria with regard to the Object Name, Full Name and Type.
Place all objects retrieved from previous step on the Enlighten Graphical View, open the objects properties view as described in ENL - Viewing properties and retrieve the objects source file path/name.
Retrieve the ObjectID for each object. There are 2 ways to do this
- Open pgAdmin, connectto the knowledge base and run the queries found in SQL Queries - CAST Knowledge Base - Queries on objects - How to get the ID of an object from its object name or full name

Enlighten - Information - How to identify if a link is a default link

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page explains how to determine, if a link is a default link or is one created by the user using tool after analysis.

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅
8.1.x	✅
8.0.x	✅
7.3.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅

Details

Link created by user using any SQL tool, is identified from Enlighten. If this link is not a default one then It will have the sign “X” as you can see in the following example.

Enlighten - Information - How to launch Enlighten in SHOW SQL mode

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page explains how to activate SQL traces in Enlighten.

Applicable in CAST Version

Release	Yes/No
8.3.x	✅

Applicable RDBMS

RDBMS	Yes/No
CSS2	✅

RDBMS

Yes/No

CSS2

✅

Action Plan

SHOW SQL mode can be activated for Enlighten with one of the following methods:

From The graphical interface of Enlighten. You can do this from the keyboard:

CTRL + SHIFT + Q

2. From command line by using the option -SHOW(SQL):

 ```sql
 <Cast install folder>Enlighten.exe -SHOW(SQL)

Enlighten log file is located at Enlighten log file location

Enlighten - Information - How to reproduce user issues

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page lists the prerequisites, entities involved and steps to reproduce customer issues involved with Enlighten

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅
8.1.x	✅
8.0.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅

Details

In order to proceed with the below steps, get the Relevant input
Always use a CAST AIP setup installation. For reproducing issues, flat installation is not recommended because the analysis/snapshot may fail. This can be due to files that are missing in the flat installation.
For Crashes, reproduce the issue on the support environment using the customer Knowledge schema with the provided step by step scenario. If the issue is not reproduced on the support environment then reproduce the issue on user environment and create a dump file of Enlighten process using Task Manager, for more information refer to What is a dump, and how do I create one?

Relevant input

Screenshot(s) showing the crash
CAST Support Tool (CST) - alias Sherlock export with the following options CAST Bases Checker, Export Logs, Export Configuration files, **Export Computer Environment,**Export CAST Bases with Knowledge Base

Notes/comments

Enlighten - Information - Incorrect links for Equals and GetHashCode methods

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page explains how Incorrect links for Equals and GetHashCode methods are formed.

Applicable in CAST Version

Release	Yes/No
8.1.x	✅
8.0.x	✅
7.3.x	✅
7.2.x	✅
7.0.x	✅

Details

Situation

Version : 7.0.13

Case 1: All GetHasCode() methods are linked to base class GetHashCode() method in Enlightenhow

Case 2: All Equals() methods are linked to base class Equals() method in Enlighten

Solution

This is normal behavior given how the inference engine (IE) works.
When a virtual call is encountered if the runtime type of the qualifier is unknown IE puts links towards all overrides of the base method (here System.Object::GetHashCode and System.Object::Equals)

Enlighten - Information - Sharing connection profiles

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page describes how to distribute the same connection profiles for multiple users of enlighten.

Applicable in CAST Version

Release	Yes/No
8.1.x	✅
8.0.x	✅
7.3.x	✅
7.2.x	✅
7.0.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅
CSS1	✅

Details

We can share the same enlighten.ini file by changing the following tag
CAST_CURRENT_USER_WORK_PATH=%APPDATA%\CAST\CAST$CAST_MAJOR_VERSION$.$CAST_MINOR_VERSION$\
in the “CastGlobalSettings.ini” file on the installation folder.

Note : Trying the above configuration might pose problems as this file is open in R/W mode and there is a chance of corruption when multiple users opens this file.
The recommended option is to copy the same file on the individual user system.

Enlighten - Information - USE Insert or Select or Update Links not created

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page explains why USE Insert or Select or Update Links are not created.

Applicable in CAST Version

Release	Yes/No
8.1.x	❌
8.0.x	❌
7.3.x	❌
7.2.x	❌
7.0.x	✅

Details

Situation

Version : 7.0.11

Analyze VB.Net source code with Participating Database (Oracle 10g). Searching for linked objects in Enlighten shows regular “U” link for functions containing Select / Update / Insert query but not the expected “Ui” / “Us” / Uu" links.

Enlighten - Information - Using Link Properties in Enlighten to find out more information about a link between objects

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page provides information on how to use link properties in Enlighten to find out more information about a link between objects.

For more information, refer to:

For Cast 8.2: Property window
For Cast 8.1: Property window
For Cast 8.0: Property window

Applicable in CAST Version

Release	Yes/No
8.2.x	✅
8.1.x	✅
8.0.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅

Details

Using the property window on a link between two objects can provide valuable information on how the link was created.

Enlighten - Information - How to identify cyclical calls when Escalated links are activated

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

Situation

Case 1: Dot Net: Dashboard shows violations for the rule Avoid cyclical calls and inheritances between namespaces content. Need to understand the details of cyclic calls in Enlighten.

Case 2: J2EE: Dashboard shows violations for the rule Avoid cyclical calls and inheritances between packages content. Need to understand the details of cyclic calls in Enlighten

Expectation

Identify cyclical calls in Enlighten

Figure 1

Figure 2

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅
8.1.x	✅
8.0.x	✅
7.3.x	✅
7.2.x	✅
7.0.x	✅

Observed on RDBMS

Enlighten - Information - How to Identify cyclical calls when Escalated links are not activated

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page describes specific case to find cyclical calls without activating escalated links.

Using the consultant tool provided in page (Avoid cyclical calls and inheritances between packages) it is possible to investigate cyclical calls without the need of escalated link activation.

Info

Currently (January 2015), This tool is only working for the J2EE diagnostic “Avoid cyclical calls and inheritances between packages” and on Oracle/CSS RDBMS.

Situation

Dashboard shows violations for the rule Avoid cyclical calls and inheritances between packages content. Need to understand the details of cyclic calls in Enlighten.