Undocumented Perms List

Hey guys, find attached as promised my "undocumented perms" list, which contains the undocumented perms for DOORS 7.1, 8.0, 8.1, 8.2, 8.3, 9.0, 9.1, 9.2.0, 9.2-1, 9.2-2. The table is built, so that you can filter for a parameter type (e.g. all functions that operate on a Buffer). So each function will be listed in multiple lines if it has multiple parameters. By expanding the autofilter in the first column you always have a nice sorted list of functions in the current filter. Note that it contains also the basic perms. It does not contain the lists of constants (never had a special need for that). In some cases due to the parsing of function declarations you may find a variable name instead of a type in the 'Type' column (e.g. when a function was declared string func(string name, value) ), but that is no big problem.

This list has been extremly useful for me and it answers all kind of questions (e.g. how does the syntax of that statement work? How do I get a ModName_ from a ModuleVersion? etc.). So I hope you like it. If anyone can provide me with old installers for DOORS pre 7.1 I would be happy to update the perms lists for earlier versions. I will add DOORS 9.3 soon.

Regards, Mathias


Mathias Mamsch, IT-QBase GmbH, Consultant for Requirement Engineering and D00RS
Mathias Mamsch - Wed Feb 09 15:28:58 EST 2011

Re: Undocumented Perms List
SystemAdmin - Thu Feb 10 01:52:35 EST 2011

Thank you Mathias, this is great!

Re: Undocumented Perms List
SystemAdmin - Fri Feb 11 07:39:10 EST 2011

This will be really useful, thanks.

Re: Undocumented Perms List
Mathias Mamsch - Sun Feb 13 16:30:36 EST 2011

DOORS 5.2, 6.0 and 9.3 added. Have phun! Regards, Mathias

Mathias Mamsch, IT-QBase GmbH, Consultant for Requirement Engineering and D00RS
Attachments

attachment_14582129_doors_perms.zip

Re: Undocumented Perms List
pc300000 - Thu Oct 08 13:27:15 EDT 2015

What does "perms" stand for? I couldn't even find it in google and I hate unexplained acronyms.

Re: Undocumented Perms List
DOORSHAM - Thu Oct 08 16:44:55 EDT 2015

Computation Science BNF notation perm for permutation matrices

Re: Undocumented Perms List
Richard_Good - Fri Oct 09 08:05:19 EDT 2015

Blue rinse, kevin keegan, etc ;-)

Re: Undocumented Perms List
Mike.Scharnow - Tue Dec 29 05:31:48 EST 2015

pc300000 - Thu Oct 08 13:27:15 EDT 2015

What does "perms" stand for? I couldn't even find it in google and I hate unexplained acronyms.

Think of perms as the built-in-"functions/procedures" that the DXL interpreter provides in the DOORS.exe binary, they are explained in the DXL manual. As an additional source of information you can use  the lists of existing perms (at smartdxl.com or in the XLS in the post above), which tell you, e.g. how the built-in perm "create" can be called and what it returns. (the DXL manual is not always complete and up to date).

Re: Undocumented Perms List
Dinio - Wed Dec 30 09:29:50 EST 2015

SO these undocumented perms why are they created? In outer languages if there is some hidden function/method not documented that means that they are incubating mode not ready and hidden for users or deprecated or there is other reason. But here we have 8000 undocumented perms? More than the documented ones? Why the Doors team decided to do that? These functions are not ready or just not documented because they want to reveal the secret in some payed training course?

 

Can we use all these perms freely without worries that in the newer Doors some of them will behave in different way?

Re: Undocumented Perms List
Mike.Scharnow - Wed Dec 30 09:49:41 EST 2015

Dinio - Wed Dec 30 09:29:50 EST 2015

SO these undocumented perms why are they created? In outer languages if there is some hidden function/method not documented that means that they are incubating mode not ready and hidden for users or deprecated or there is other reason. But here we have 8000 undocumented perms? More than the documented ones? Why the Doors team decided to do that? These functions are not ready or just not documented because they want to reveal the secret in some payed training course?

 

Can we use all these perms freely without worries that in the newer Doors some of them will behave in different way?

The title is a bit misleading. Most of the functions are mentioned in the DXL manual. This post should rather be called "Complete Perms List".

One problem is that the DXL manual has not been very well maintained in the past and there were some errors. Plus, there are some quite useful parameters that been released officially only in recent versions of the DXL manual.

If you ask IBM, you should not rely on this list.

So, theoretically it could happen that a function is removed in a newer version or that the order of parameters changes.

But for the last years that has never happened, usually there have only been additions to the functionality. It's up to you.

Note that the 8000 rows do not represent 8000 different dxl functions. Instead, if a function has three parameters, you will find three rows in the xls. And if the same function can also be called with two parameters, you will find two more rows, plus there are more rows if the function returns different types.

As Mathias wrote, one of the main reasons for creating and using this list is to find out e.g. how to convert one type to another or which variants of a function exist. (Perhaps the word "perm" refers to the number of permutations of the parameters??) This list is very easy to use with Excels filter criteria. If you want to be on the safe side, you could first lookup the perm in the XLS and then look at the DXL manual of the specific DOORS version you work for to find out whether it's "official".

Re: Undocumented Perms List
MGDMGD - Fri Apr 27 16:13:57 EDT 2018

Mathias Mamsch - Sun Feb 13 16:30:36 EST 2011
DOORS 5.2, 6.0 and 9.3 added. Have phun! Regards, Mathias


Mathias Mamsch, IT-QBase GmbH, Consultant for Requirement Engineering and D00RS

Mathias, would you happen to have an updated copy of this data for v9.5 or v9.6?  

 

Awesome work.