Utilities and Preferences

Overview

What are called utilities in Teamcenter ?

As like any other system , Utilities are small program
that provides an addition to the capabilities provided by
the operating system , Teamcenter also has its own set
of utilities to perform certain admin level and user level
tasks.
Most of the utilities can be run only by a Teamcenter
DBA.
All the utilities will be present in %TC_ROOT%\bin
folder

Types of Utilities

Configuration
Data Sharing
Workflow
Classification
Query
System Maintenance

Example to run a utility

Environment setup to run any

utility
To manually set the Teamcenter environment, enter the following
commands
1. Open a command prompt
2. Type the following commands ( Ensure the TC_ROOT and
TC_DATA paths are adhered to the installed locations as per
the machine )
set TC_ROOT=c:\tc2007
set TC_DATA=c:\tc2007\tcdata
call %TC_DATA%\tc_profilevars
3. Environment is ready to run the utilities

Configuration Utilities

am_install_tree
used to install the rule tree that can be used as the basis for access rule
maintenance

preferences_manager
Migrates legacy preference files to the database. In addition, this utility can
be used to convert legacy preference files to XML format and to import and
export preferences to and from the database.

bmide_manage_templates
Adds solution templates to the database table.

business_model_extractor
Extracts action rules in the database into extension rules format.

Data Sharing Utilities

data_share
Used for various Multi-Site Collaboration operations, such as publishing
and unpublishing objects collectively and sending objects to remote sites.

data_sync
Synchronizes copies of objects at remote sites with the latest version of the
object master. It also updates publication records when republishing
objects.

plmxml_export
Exports objects from Teamcenter in PLM XML format. If there are files for
export, as determined by transfer mode, a directory is created and the files
are exported into that directory.

plmxml_import
Imports objects to Teamcenter from a PLM XML file. In case there are files
for import as determined by transfer mode, the utility looks for files in the
path specified by the xml_file parameter. This utility is also used to import
workflow templates.

Workflow Utilities

delete_namedrevisions
Queries the database to retrieve tasks that have null_tags for a
parent_process attribute. Once it finds the task, it looks for the
releaseLevels that reference the task.

purge_processes
Purges completed processes based on the last-modified date of the
process

release_man
Releases objects in batch mode without creating jobs and audit files

verify_tasks
Finds all corrupted CM tasks, jobs, and other associated internal task
model objects in order to delete them from the database

Classification utilities
Used to define, maintain, import and export classification hierarchy data
smlutility
Updates shared Classification hierarchy definitions to all sites with which
they are shared.

icsxml
Exports the following types of Classification data through XML files

icsutility
Imports the following types of Classification data

Query Utilities
Used to reinstall default query forms, create queries to find recently saved
or released item revisions, build keyword indexes, and maintain and run
queries from an XML formatted file
Utilities
build_fts_index
Builds keyword indexes for the Autonomy search engine on an object-byobject basis

default_queries
Reinstalls one or more of the default query forms

find_recently_saved_item_rev
Allows you to create a query based on date and object type

find_released_item_rev
Allows you to create a query based on date and object type

query_xml
Creates, modifies, writes, deletes, and runs queries from an XML formatted
file.

System Maintenance Utilities

clearlocks
Clears dead process locks from the database. Dead process locks typically
occur when a Teamcenter session terminates abnormally

list_users
Creates a list of users currently logged on to Teamcenter and the node they
are using.

tc_mail_smtp
Sends SMTP (Simple Mail Transfer Protocol) e-mail. Use this platformindependent utility when sending e-mail on both UNIX and Windows
platforms

backup_xmlinfo
Provides information about Teamcenter volumes defined for a site in XML
format. Third-party backup systems require this information for 24x7 hot
backup of Teamcenter volumes and databases.

Install
Performs limited Teamcenter maintenance and Oracle database
administration.

Preferences
Preferences are special environment variables stored in the
Teamcenter database.
They are read during Teamcenter application usage. Each
application may have
associated preferences. Preferences allow you to configure many
aspects of a session of application behaviour, such as how
assemblies are revised, whether extension rules are bypassed for
specified operations, and which Teamcenter objects display in
integrations.

Choose EditOptions to open the Options dialog box. Use the Options dialog box to
search for preferences, set preference values, create new preferences, and remove
existing preferences.

Preference window

Types of Preferences and its

Precedence order
User

When scope is User, the system searches through preference

data in the
following order: User, Role, Group, Overlay, Site.

Role
When scope is Role, the system searches through preference data
in the
following order: Role, Group, Overlay, Site.
If the user changes group or role settings during a session, the
appropriate group
and role preferences are loaded.

Group
When scope is Group, the system searches through the
preference data in the
following order: Group, Overlay, Site.
If the user changes group or role settings during a session, the
appropriate group
and role preferences are loaded.

Site
When scope is Site, the system searches through the preference
data in the

General Overview

1 - > Create
new preference
2 -> Create
new Category
3 -> Import or
export
preference in
XML format

Thank you