Configuration codes and keywords used in access right definitions

When you define access rights in tekla.opt , you need to use correct abbreviations (codes) for the configurations, otherwise the definitions do not work. The access rights are defined using certain keywords.

Configuration codes

When you define access rights for different Tekla Structures configurations in the tekla.opt options file, you need to add a proper code for each configuration in the definition.

Note:

The configuration codes are backward compatible, and the codes used for licensing in older Tekla Structures versions still work. However, the commercial product name of the configuration may change between versions. For example, the commercial product name for STDL-C used to be Steel Detailing Limited, but now it is Primary.

The codes for the Tekla Structures configurations are listed below:

Configuration code	Configuration
CM-C	Construction Modeling
DEV-C	Developer
DFR-C	Drafter
EDU-C	Educational
FUD-C	Full
PCD-C	Precast Concrete Detailing
RCD-C	Rebar Detailing
SDE-C	Engineering
STD-C	Steel Detailing
PPC-C	Production Planner - Concrete
STDL-C	Primary
VIE-C	Project Viewer

Most common keywords

The most common keywords that are used for defining license access rights and restrictions in the tekla.opt options file are listed and described below:

Keyword	Description	Usage information
`EXCLUDE`	Prevent access to a Tekla Structures configuration.	Use with the abbreviation of the configuration.
`EXCLUDE_ENTITLEMENT`	Prevent license borrowing.	Use with the activation ID of the license.
`EXCLUDEALL`	Prevent access to all Tekla Structures configurations.
`GROUP`	Define a user group for use with any options.	Use with Windows user names (separated with spaces).
`HOST_GROUP`	Define a host group for use with any options.	Use with computer hostnames or IP addresses (separated with spaces).
`INCLUDE`	Allow a user to use a Tekla Structures configuration.	Use with the abbreviation of the configuration.
`INCLUDE_ENTITLEMENT`	Allow a user to borrow a license.	Use with the activation ID of the license.
`INCLUDEALL`	Allow a user to use all Tekla Structures configurations.
`MAX`	Limit the usage of a configuration.	Use with the number of licenses and the abbreviation of the configuration.
`RESERVE`	Reserve licenses for a user/host or a group of users/hosts.	Use with the number of licenses and the abbreviation of the configuration.

When somebody is allowed to use a configuration with the INCLUDE keyword, other users are automatically prevented from using the configuration.
When somebody is denied to use a configuration with the EXCLUDE keyword, other users are automatically allowed to use the configuration.
If no rules exist, everybody is allowed to use the configuration.

Some examples of definitions in a tekla.opt options file are given below:

Options file definition	Description
`INCLUDE PCD-C USER scarlett`	Only the user scarlett is allowed to use the Precast Concrete Detailing configuration.
`EXCLUDE FUD-C USER justin`	The user justin is not allowed to use the Full configuration. Other users are allowed to use the Full configuration.
`GROUP tsusers jessica joe neil` `INCLUDEALL GROUP tsusers`	The users jessica , joe and neil belong to the group tsusers. Only the group tsusers is allowed to use all configurations.
`EXCLUDEALL HOST pcrobert`	No configuration is allowed to be used on the computer pcrobert.
`INCLUDE_ENTITLEMENT qwer-1234-asdf-5678-zx USER gwen`	Only the user gwen is allowed to borrow a license whose activation ID is qwer-1234-asdf-5678-zx.
`EXCLUDE_ENTITLEMENT rtyu-9876-fghj-5432-cv USER matt`	The user matt is not allowed to borrow a license whose activation ID is rtyu-9876-fghj-5432-cv.
`GROUP students amy chloe andy dean` `MAX 3 EDU-C GROUP students`	The users amy , chloe , andy , and dean belong to the group students. The limit to the usage of the Educational configuration for the group students is three licenses.
`RESERVE 1 RCD-C USER vera`	One license of the Rebar Detailing configuration is reserved for the user vera.
`GROUP STUDENTS user1 user2 user3` `RESERVE 3 VIE-C GROUP STUDENTS`	The users user1 user2 user3 belong to the group STUDENTS. 3 licenses of the Project Viewer configuration are reserved for the group STUDENTS. STUDENTS is a group name. user1 - user 3 are Windows user names separated with spaces. The number 3 is the number of licenses to reserve. VIE-C is the configuration code for the Project Viewer configuration. Note that any licenses reserved for a group are dedicated to that group. Even when that group is not actively using the licenses, the licenses are unavailable to other users.
`INCLUDE VIE-C:VENDOR_STRING=Enterprise USER john`	Only the user john is allowed to use the Project Viewer configuration which is of type Enterprise.

Useful links

For more information about limiting certain Tekla Structures versions to certain users, see the following Support Article in Tekla User Assistance: How to limit certain Tekla Structures version to certain users