load_fcccache

Prepopulates the FMS client cache (FCC) using ITK calls, resulting in improved cache performance. You can also use this utility to read the PLM XML file generated by the bomwriter utility, and then parse the UIDs and generate read tickets. The read tickets can be prepopulated on the target FCC process. Additional options include: Prepopulate the FCC based on dataset type. Manage integrated clash management (ICM) behavior. Copy JT files to a local staging area. Update the PLM XML file to point to local JT files. Syntax load_fcccache [-u=user-id {-p=password | -pf=password-file} -g=group] -f=list [-plmxml=file-name][-dataset_type=dataset-type-name] -f=load [-plmxml=file-name] [-input_file=file-name] [-dataset_type=dataset-type-name] [-latest_version= yes | no] [-output_file=file-name] [-copy_out=directory] [-output_plmxml=file-name] [-use_absolute_location= yes | no] [-config=configuration-file] [-log_filename=log-file-name] [-log_types=levels] [-copy_out_lifetime=value] [-lifetime_check = yes | no] [-lifetime_check_interval=value] [-lifetime_process_limit=value] [-purge] [-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. -f Runs either the list or load function. The list function lists specified UIDs, which can then be used to prepopulate the FCC using the load function. The list function accepts the following input: -plmxml=file-name Lists the UIDs of all datasets in the PLM XML file generated by the bomwriter utility. -dataset_type=dataset-type-name Lists the UIDs of all datasets of the specified dataset type. The load function prepopulates the FCC as specified by the following input: -plmxml=file-name Prepopulates the FCC with all the datasets in the PLM XML file generated by the bomwriter utility. -input_file=file-name Prepopulates the FCC based on the UIDs previously generated by the list function. -dataset_type=dataset-type-name Prepopulates the FCC with all datasets of the specified dataset type. -latest_version Use yes to prepopulate the FCC with only the latest dataset version or no to use the version specified by the UID. The default value is yes. Use this argument with the load function. -output_file Direct the output to a specific file by specifying a file name. If this argument is not used, the default output file is stdout. -copy_out Copy each downloaded file to a specific directory by specifying the directory name. Use this argument with the load function. -output_plmxml If the load function is set to prepopulate the FCC with a PLM XML file, and the -copy_out argument is used to specify a specific directory location to which copies of each downloaded file is loaded, and then use this argument to update the PLM XML with the same directory location as specified by the -copy_out argument. You must use this argument with the load function and the -copy_out argument. -use_absolute_location Use yes to create absolute location references in the output PLM XML file. For more information about configuring default settings, use -h -config. -config Specifies the file containing default settings. For more information about configuring default settings, use -h -config. -log_filename Specifies the file to which logging messages are printed. If not set, the default location is the stderr file. For more information about configuring logging messages, use -h -log_types. -log_types Specifies which types of messages are logged. Valid values are: NONE ERROR WARNING INFORMATION DEBUG PERFORMANCE ALL Combine log types using the plus (+) symbol as a delimiter. For example: Copy ERROR+WARNING+INFORMATION For more information about configuring logging messages, use -h -log_types. -copy_out_lifetime Specifies the lifetime date of the files stored in the directory specified by the -copy_out directory. The directory is scanned for files that are older than the specified lifetime date. Use this argument to automatically clean up older files that are no longer used. This argument must be used in conjunction with the -copy_out argument. Use -h -config to display more information about configuring default settings. -lifetime_check Use yes to scan the directory specified by the -copy_out directory during startup and perform a lifetime check. The lifetime check is performed in random order. This argument must be used in conjunction with the -copy_out and -copy_out_lifetime arguments. Use -h -config to display more information about configuring default settings. -lifetime_check_interval Specifies how frequently to scan the directory specified by the -copy_out directory and perform a random cleanup based on the interval value. For example, if set to 10, a lifetime check is performed once every ten executions. This argument must be used in conjunction with the -copy_out, -copy_out_lifetime and -lifetime_check arguments. If the directory specified by the -copy_out argument contains many files, and if it is not important to check the lifetime on each execution, setting the -lifetime_check_interval argument can improve performance. Use -h -config to display more information about configuring default settings. -lifetime_process_limit Specifies how long (in seconds) lifetime processing can continue. The lifetime check is performed in random order. If the directory specified by the -copy_out directory contains a large number of files, lifetime processing can be lengthy. You can use this argument to randomly process a subset of the files by setting a low value. This argument must be used in conjunction with the -copy_out, -copy_out_lifetime and -lifetime_check arguments. Use -h -config to display more information about configuring default settings. -purge Purges all files from the directory specified by the -copy_out directory. -h Displays help for this utility. Use -h -config to display more information about configuring default settings. Use -h -log_types for more information about logging output. Environment As specified in Setting up a Teamcenter command-line environment. Files As specified in Log files produced by Teamcenter. Restrictions None. Examples To ensure the JT files referenced in the xyz001.plmxml file are using the same dataset versions as when it was generated (rather than the latest version), enter the following command on a single line: Copy load_fcccache -u=username -p=password -f=load -plmxml=xyz001.plmxml -latest_version=no -copy_out=plmxml_cache -output_plmxml=xyz001_local.plmxml