Welcome to Telelogic Product Support
  Home Downloads Knowledgebase Case Tracking Licensing Help Telelogic Passport
Telelogic DOORS (steve huntington)
Decrease font size
Increase font size
Topic Title: Link module descriptors in folders?
Topic Summary:
Created On: 3-Feb-2006 00:50
Status: Post and Reply
Linear : Threading : Single : Branch
Search Topic Search Topic
Topic Tools Topic Tools
Quick Reply Quick Reply
Subscribe to this topic Subscribe to this topic
E-mail this topic to someone. E-mail this topic
Bookmark this topic Bookmark this topic
View similar topics View similar topics
View topic in raw text format. Print this topic.
 3-Feb-2006 00:50
User is offline View Users Profile Print this message


Chris Jones

Posts: 177
Joined: 1-Jul-2005

I'm working on a script that will create a bunch of modules. We want to have each one set up with a 'linkset pairing' to a specified module.

Part of my confusion here is nomenclature: we have link module descriptors, which seem to refer to the same thing as linkset pairings, but some people (here at my workplace) seem to see 'linkset' as the same thing (which I can understand as you set them up in the 'Linksets' tab of the module properties). Then I tried the general DOORS online Help, and was even more confused.

From what I can tell using the DOORS GUI, LMDs are a per-module property (you find them in the 'Module Properties', after all); the online Help seems to corroborate this. But then we have this bit in the DXL manual:

quote:

A folder or project can specify the link modules to be used when a link is created between a pair of modules, the source of which is in the folder. This source/target module pairing is called a link module descriptor, which is represented by the LinkModuleDescriptor data type.


So, my main question is: What do folders have to do with anything? Can anybody shed some light here?

Thanks,
Chris
Report this to a Moderator Report this to a Moderator
 3-Feb-2006 08:35
User is offline View Users Profile Print this message


Paul Worrall

Posts: 87
Joined: 30-Sep-2003

In DXL, the data-type "LinkModuleDescriptor" is equivalent to a "Linkset Pairing" in the DOORS GUI.

Although the "Linkset Pairing" is set up on the Linksets tab of the Module Properties DB, they are not stored as part of the module - try setting one up and then closing the module without saving, the pairing will be preserved. It seems that they are stored in the Folder or Project (which is a special kind of Folder). It is possible (at least in v5.2) to delete a module that is the target of a "Linkset Pairing" but the pairing itself remains and appears on the module properties DB of the source module, but cannot be removed.

A "Linkset" is a data structure that is stored in a "Link Module" where the Link Attributes are stored.

The links themselves are stored in their source Formal modules

Simple ;-)
Report this to a Moderator Report this to a Moderator
 3-Feb-2006 08:43
User is offline View Users Profile Print this message


Tony Goodman

Posts: 1098
Joined: 12-Sep-2002

I can understand the confusion over terminology. I think the help files are lacking in some detail in this area too.

When you create a link between two modules, DOORS decides which link module to use according to the linkset pairings you have set up. Otherwise it attempts to use the default link module usually "DOORS Links".

In DXL, Link Module Descriptors (LMD's) are used to define what links can be made by the user.
A Link Module Descriptor consists of the following:
The fullname of the source module.
The fullname of a target module.
The fullname of the link module to use.

LMD's sre stored in the source module's parent folder.

In the world of the DOORS GUI, LMD's are referred to as Linkset Pairings.
Linkset Pairings are visible from the module properties dialog. A Linkset Pairing is the same as an LMD, except that the source module is not displayed in the dialog because you are viewing it from the source module.

Linksets are objects in link modules. These are (conceptually) where the links are stored.

-------------------------
Tony Goodman
http://www.smartdxl.com
Report this to a Moderator Report this to a Moderator
 3-Feb-2006 16:46
User is offline View Users Profile Print this message


Louie Landale

Posts: 2070
Joined: 12-Sep-2002

Yes, "LinkModuleDescriptors" LMDs is what DXL calls the "LinkSetPairings" in the GUI. Yes, many folks incorrectly call these "LinkSets". Yes, the GUI allows access to them via the Module's properties sheet but they are stored in the module's folder. (See DXL chapter "Finding Links" command "for linkModDesc in f do {".

LMDs are composed of Source, Target, and LinkModule name. There is also a Mandatory flag. There is some bug where both the GUI and DXL suggest there is also an "Overwritable" flag, but I believe that's just when Mandatory is false.

Yes, if you delete the module the LMD still exists but isn't accessible via the GUI. I've got an LMD removal script that looks for LMDs whose source, target, or LM name is blanks (and thus useless) and deletes them.

I cannot remember whether the internal LMD stores the full name of the module or if it stores the unique ID of the modules;but suspect its the Unique ID.

-Louie
Report this to a Moderator Report this to a Moderator
 7-Feb-2006 00:39
User is offline View Users Profile Print this message


Chris Jones

Posts: 177
Joined: 1-Jul-2005

Uhhhh.....okay. It's as clear as.....mud. Really thick mud too.
Anyway, I've got this script up and working. I guess I don't have to completely understand all the underlying stuff. Thanks for your help!
Report this to a Moderator Report this to a Moderator
 7-Feb-2006 10:02
User is offline View Users Profile Print this message


Tony Goodman

Posts: 1098
Joined: 12-Sep-2002

I would also recommend creating, and soft deleting, a link module called "DOORS Links" in every folder.
This will prevent links being created if there is not a linkset pairing for the two modules.

-------------------------
Tony Goodman
http://www.smartdxl.com
Report this to a Moderator Report this to a Moderator
 7-Feb-2006 22:14
User is offline View Users Profile Print this message


Dan Hopping

Posts: 75
Joined: 21-Nov-2002

I use the attached code to add 'link parings' to new modules whenever I have a fair number to parings to add.
The code could be cleaned up to pull the module names from an array in a loop, however, this is a quick and dirty to get the job done. At any rate it may clear up the 'mud' a bit...
Dan
Report this to a Moderator Report this to a Moderator
Statistics
20925 users are registered to the Telelogic DOORS forum.
There are currently 1 users logged in.
The most users ever online was 15 on 15-Jan-2009 at 16:36.
There are currently 0 guests browsing this forum, which makes a total of 1 users using this forum.
You have posted 0 messages to this forum. 0 overall.

FuseTalk Standard Edition v3.2 - © 1999-2009 FuseTalk Inc. All rights reserved.