Product configuration utilities > Effectivity mode
effupgrade
Converts effectivity data created in iMAN versions prior to 7.0 into the effectivity model used in iMAN version 7.0 and later, Teamcenter Engineering and Teamcenter. The new effectivity model allows end item qualification and discontinuous ranges. The upgrade process goes through each unconverted release status and creates a 7.0 effectivity qualified against a null end item from the start date, end date or unit values on the release status. Syntax effupgrade [-u=user-id -p=password | -pf=password-file -g=group] [-s] | [-i=interval] [-v [-e]] [-h] Arguments -u Specifies the user ID. This is a user with Teamcenter administration privileges. Note If Security Services single sign-on (SSO) is enabled for your server, the -u and -p arguments are authenticated externally through SSO rather than being authenticated against the Teamcenter database. If you do not supply these arguments, the utility attempts to join an existing SSO session. If no session is found, you are prompted to enter a user ID and password. -p Specifies the password. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. For more information about managing password files, see Manage password files. This argument is mutually exclusive with the -p argument. -g Specifies the group associated with the user. If used without a value, the user's default group is assumed. -s Specifies a single run. Upgrade runs once and ignores locked statuses. -i Specifies multiple runs and an interval between reruns in minutes. The default interval is 60 minutes. -v Verbose mode. Shows additional messages. -e Displays effectivities of release statuses to be converted. Must be used with the -v argument. -h Displays help for this utility. Environment As specified in Setting up a Teamcenter command-line environment. Files As specified in Log files produced by Teamcenter. Restrictions None. Examples For cases where an upgrade is not going to be disruptive (less than 1000 effectivities), make sure all users are logged off, then upgrade with the -s argument. For example: Copy effupgrade -u=Tc-admin-user -p=password -g=group -s -v For extensive upgrades that are likely to take a long time (many thousands of effectivities), especially if statuses are likely to be locked (some users always logged on), run repetitively until complete. Copy effupgrade -u=Tc-admin-user -p=password -g=group Related Topics Structure Management on Rich Client ─ Usage
Source: https://docs.sw.siemens.com/documentation/external/PL20251212545240207/en-US/tc_help/utilities_reference/uaw1737253687881/kjk1737253692998/effupgrade.html · retrieved Fri Jul 31 2026 00:00:00 GMT+0000 (Coordinated Universal Time)