load_fsccache

Reads a PLM XML file, parses it for globally unique identifiers (GUIDs) and generates read tickets for files referenced in the PLM XML file. The read tickets can be stored in the operating system (OS) file. The utility can also be used to load the file server cache (FSC) of a target/distant FSC serving the same database using the read tickets file. Syntax load_fsccache [-u=user-id {-p=password | -pf=password-file} -g=group] { [-f=list {-plmxml=file-name | -dataset_type=dataset-type-name} ] | [-f=load -fsctargets=string { [-plmxml=file-name] | [-input_file=file-name] | [-dataset_type=dataset-type-name] } } [-latest_version= yes | no] [-output_file=file-name] [[-config=file-name][-log_filename=file-name] [-log_types=log-level] [-h[-config] [-log_types] ] 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 creates a list of GUIDs for object in the specified PLM XML file, which can then be used to prepopulate the FSC using the load function. The list function requires one of the following input arguments: -plmxml=file-name Lists the GUIDs of all datasets in the specified PLM XML file. -dataset_type=dataset-type-name Lists the GUIDs of all datasets of the specified dataset type. The load function prepopulates the FSCs specified in the -fsctargets argument using the information provided by one of the following input arguments: -plmxml=file-name Prepopulates the FSC with all the datasets in the specified PLM XML file. -input_file=file-name Prepopulates the FSC based on the GUIDs previously generated by the list function. -dataset_type=dataset-type-name Prepopulates the FSC with all datasets of the specified dataset type. -latest_version Specifies the dataset version to use to prepopulate the FSC. Set to yes to send the latest dataset version or no to use the version specified by the GUID. The default value is yes. Use this argument with the load function. -output_file Directs the output to a specific file by specifying a file name. If this argument is not used, the default output file is stdout. -config Specifies the file containing default settings. For more information about configuring default settings, use the -h -config arguments. -log_filename Specifies the file to which logging messages are printed. If not set, the default location is the stderr file. To display information about configuring logging messages, use the -h and -log_types arguments together. -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 To display information about configuring logging messages, use the -h and -log_types arguments together. -h Displays help for this utility. Use the -h and -config arguments together to display more information about configuring default settings. Use -h and -log_types arguments together to display 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 display a list of GUIDs for datasets in the abc001.xml file: Copy load_fsccache -u=username -p=password -g=dba -f=list -plmxml=abc001.xml To prepopulate the FSC for cvg001 (identified with fscid fsc_cvg001_username) with the datasets in the abc001.xml file: Copy load_fsccache -u=username -p=password -g=dba -f=load -plmxml=abc001.xml -fsctargets=fsc_cvg001_username To create a readtickets.txt file containing the GUIDs of the datasets in the abc001.xml file: Copy load_fsccache -u=username -p=password -g=dba -f=list -plmxml=abc001.xml
-output_file=readtickets.txt To prepopulate the FSC for cvg001 (identified with fscid fsc_cvg001_username) with the datasets in the readtickets.txt file: Copy load_fsccache -u=username -p=password -g=dba -fsctargets=fsc_cvg001_username -f=load -input_file=readtickets.txt To create a readtickets.txt file containing the GUIDs of all the CAEAnalysisDS datasets: Copy load_fsccache -u=username -p=password -g=dba -f=list -dataset_type=CAEAnalysisDS -output_file=readtickets.txt To prepopulate the FSC for cvg001 (identified with fscid fsc_cvg001_username) with the datasets in the abc001.xml file and store all types of log messages to the load.out file: Copy load_fsccache -u=username -p=password -g=dba -fsctargets=fsc_cvg001_username -f=load -plmxml=abc001.xml -log_types=ALL -log_filename=c:\temp\load.out