TeamcenterKnowledge

Maintenance utilities > Migration

convert_distribution_lists

Converts distribution lists to alias lists. Also allows users to create an alias list by importing data from a text file. Syntax convert_distribution_lists [-u=user-id {-p=password | -pf=password-file} -g=group] [-all] [-delete] [-dist_list_name=distribution-list-name] [-import_file=file-name] [-import=file-name] [-new_list_name=alias-list-name] [-overwrite] [-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. -all Converts all the distribution lists to alias lists. -delete Deletes distribution lists that were converted to alias lists. -dist_list_name Converts a specified distribution list to an alias list. -import Creates an alias list from the addresses specified in the file. The format of the ASCII file is: abc1@xyz.com abc2@xyz.com abc3@xyz.com -new_list_name Specifies the name of the new alias list. This argument must be used with the -import option. -overwrite Overwrites the existing alias list. -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 To convert all distribution lists in the database to alias lists, enter the following command on a single line: Copy convert_distribution_lists -all To create an alias list using the distribution list marketing_list and then delete the distribution list: Copy convert_distribution_lists -dist_list_name=marketing_list -delete To create a new alias list with the name Local_Alias_List, populate the list with the addresses listed in the address_local.txt file, and overwrite the existing address list, enter the following command on a single line: Copy convert_distribution_lists -import=address_local.txt -new_file_name=Local_Alias_List -overwrite

Source: https://docs.sw.siemens.com/documentation/external/PL20251212545240207/en-US/tc_help/utilities_reference/mna1737253705286/gvi1737253706589/convert_distribution_lists.html · retrieved Fri Jul 31 2026 00:00:00 GMT+0000 (Coordinated Universal Time)