generate_client_meta_cache

Generates the shared client metadata cache. This a group of datasets in the Teamcenter database that are organized within the ClientCache folder under Teamcenter administrator's home folder. These datasets can contain any types of files, for example: zip files, png files, and xml files. This utility is run during the installation and upgrade, and can be run manually as desired. Following are some of the situations when you should run this utility: Generate the full client cache (all argument) if the client cache folder has been deleted. Generate the style sheet cache (stylesheets argument) after a style sheet is created or edited. This keeps the style sheet feature in the client cache folder up-to-date. For more information, see Rich Client Customization. Generate the text server cache (textservers argument) after text server data has been updated. For more information about working with text server files, see Teamcenter Localization. Metadata is cached on the client computer, eliminating server calls for the cached metadata. When the rich client connects to the server, it requests the client metadata cache files from the File Management System (FMS), which automatically downloads, refreshes, and maintains local copies as needed. The following are some features of the client metadata caching functionality: Caching refresh notification Notifies you when the cache is refreshed. When you log on to the rich client, a check is made for new metadata on the server. If new metadata is found, the cache on the rich client is refreshed, and the following message is displayed: Copy Synchronizing the Rich Client install files with the Teamcenter Server. The ClientCache Teamcenter folder Stores cached metadata. If you are logged on to the rich client as the Teamcenter administrator who generated the cache, you see the folder under the Home location. There are folders which organize datasets into categories. These datasets contain the individual files. Warning If the administrator moves, renames, or deletes this folder, all clients fall back to a nonclient-cached mode. This folder name, and all those under it must be unique within Teamcenter. Generate Client Cache check box Runs the generate_client_meta_cache utility. The check box appears in Teamcenter Environment Manager (TEM) and the Business Modeler IDE. For more information, see Teamcenter Environment Manager ─ Usage and BMIDE for Data Model Design. TC_SKIP_CLIENT_CACHE Causes the rich client to run in legacy mode and avoid downloading or using a local client meta cache. For more information, see the Teamcenter Environment Variables. Syntax generate_client_meta_cache [-u=Tc-admin-user {-p=password | -pf=password-file} -g=group] command [generate | update | delete | report | tickets | context] cache [all | types | lovs | stylesheets | textservers] -log=log-file-path -delta=differences-file-path l1=language l2=language -err=error-file-name -t=timings -remote -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 user and password 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 user's 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. command Specifies the command to run. (You must run the command as a user with Teamcenter administration privileges.) generate Generates the client cache. update Updates the client cache as needed. This is the default setting. delete Deletes the client cache. report Reports on the state of the client cache. tickets Generates tickets for the feature. context Checks context for LOVs. cache Specifies the client cache to work on. all Generates all the available client cache files. This is the default setting. types Generates the types cache. This includes the metadata of business objects, property descriptions, and lists of values. lovs Generates the list of values (LOVs) cache. icons Generates the icons cache. stylesheets Generates the stylesheets cache. textservers Generates the text server cache. tools Generates the tools cache. contextmenusuppressionrules Generates the context menu suppresson rules cache. -log Specifies file path and name of the log file that contains the results of this execution. The default log file is written to the TEMP directory. This argument is optional. -delta Specifies the file path and name of the file into which data model differences are written. -l1 Specifies the first language for which to generate the client cache, for example, en_US, de_DE, es_ES, fr_FR, pt_BR. -l2 Specifies the second language for which to generate the client cache. -err Specifies the error file name. The default error file is written to the TEMP directory. -t Specifies time function calls. -remote Specifies remote start. This generates log files. -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 generate or regenerate all the client meta cache, enter the following command on a single line. Copy generate_client_meta_cache -u=Tc-admin-user -p=password -g=group generate all This command keeps the previous version of cache data in the server. To generate style sheet client meta cache, enter the following command on a single line. Copy generate_client_meta_cache -u=Tc-admin-user -p=password -g=group generate stylesheets To generate text server files client meta cache, enter the following command on a single line. Copy generate_client_meta_cache -u=Tc-admin-user -p=password -g=group generate textservers