acc_check_client

Logs onto Teamcenter, performs an accountability check, stores the results in occurrence groups and/or an Excel report and logs off. You can run this utility from a Teamcenter command window or from a batch file that is developed to perform a specific check on two specific structures. When running Teamcenter in a two-tier environment, the batch file normally starts its own server. For more information about running accountability checks in batch mode, see Manufacturing Process Planning ─ Deployment and Administration. Syntax acc_check_client -u=user-id {-p=encrypted-password | -pf=password-file} [-g=group] -host="server-connection-url-or-IIOP" -sourceSC=source-structure-context-name|-sourceBVR=source-BOM-view-revision -targetSC=target-structure-context-name|-targetBVR=target-BOM-view-revision -sourceClosureRule=source-closure-rule -targetClosureRule=target-closure-rule [-occGroupName=name-of-occurrence-group] [-createOccGroupOnTarget=occurrence-group-output-to-target] [-reportName=dataset-name-containing-Excel-report] -check="full,missingTarget,missingSource,multiple" -partialMatchProperties="list-of-properties" [-sourceRevisionRule=source-revision-rule] [-targetRevisionRule=target-revision-rule] [-sourceVariantRule=source-variant-rule] [-targetVariantRule=target-variant-rule] [-sourceDateEff=source-effectivity-date] [-targetDateEff=target-effectivity-date] [-showUnconfigured="variants,changes,assignments"] [-skipScopeLines=source-and-target-scope-lines-to-be-excluded-from-results] [-showResults] [-descrim=server-login-descriminator-value] [-loginRetries=number-of-times-client -will-attempt-to-login] [-h] Arguments -u Specifies the user ID. This is a user with Teamcenter administration privileges. The user needs appropriate write access to the source and target structures in order to create occurrences groups and attach reports. 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 password must be encrypted You can obtain an encrypted password by typing: Copy ipa_b_executer -p=plain-text-password -encrypt Teamcenter returns the encrypted password as output. 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. -host Specifies server connection information. A URL or an IIOP must be specified. Four-tier example: "http://server:port/tc" Two-tier example: "corbaloc:iiop:localhost:7777/localserver7777" Quotation marks must be included. -sourceSC Specifies the unique name of a structure context in the database that contains the source structure. Teamcenter uses this value to open the source structure. Teamcenter requires either a source structure context specified in this argument or a source BOM view revision specified in the -sourceBVR argument. -sourceBVR Specifies the UID (internal unique identifier) of the BOM view revision for opening the source structure. Teamcenter requires either a source structure context specified in the -sourceSC argument or a source BOM view revision specified in this argument. -targetSC Specifies the unique name of the structure context in the database that contains the target structure. Teamcenter uses this value to open the target structure. Teamcenter requires either a target structure context specified in this argument or a target BOM view revision specified in the -targetBVR argument. -targetBVR Specifies the UID (internal unique identifier) of the BOM view revision for opening the target structure. Teamcenter requires either a target structure context specified in the -targetSC argument or a target BOM view revision specified in this argument. -sourceClosureRule Specifies the filtering rule for the source structure. -targetClosureRule Specifies the filtering rule for the target structure. -occGroupName Specifies the name of the occurrence group that is created or updated on the source structure. If no name is specified, no groups are created or modified. -createOccGroupOnTarget Specifies the occurrence group output to the target. If the missingSource check is specified, the output to target is automatically turned on. -reportName Specifies the name of the dataset to which the Excel report is attached. If no name is specified, no report is generated. -check Specifies the type of result the check reports. This argument can have one or more of the following comma-separated values: full,missingTarget,missingSource,multiple -partialMatchProperties Specifies the internal property names to be checked for partial match. This argument can contain multiple property names separated by a comma. -sourceRevisionRule Specifies the revision rule on the source structure. The default is determined by the source structure context or by a system setting. -targetRevisionRule Specifies the revision rule on the target structure. The default is determined by the target structure context or by a system setting. -sourceVariantRule Specifies the classic variant rule on the source structure. The default is determined by the source structure context or no rule. -targetVariantRule Specifies the classic variant rule on the target structure. The default is determined by the target structure context or no rule. -sourceDateEff Specifies the GMT date for the effectivity on the source structure. If no date is specified, the effectivity from the source structure context is used. The format is yyyy-MM-ddThh:mm:ss zz:zz. For example: 2005-05-20T14:32:05-08:00 -08:00 represents minus 8 hours from GMT (resulting in Pacific Standard Time) -targetDateEff Specifies the GMT date for the effectivity on the target structure. If no date is specified, the effectivity from the target structure context is used. -showUnconfigured Lists which unconfigured occurrences to show or hide on both structures. If this argument is not specified, all unconfigured lines are hidden. Valid values are one or more of the following: variants,changes,assignments -skipScopeLines Specifies that the source and target scope lines should not be included in the results. -showResults Prints accountability check results statistics. If this argument is not included, result statistics are not printed. -descrim Specifies a value to be used as the server login descriminator. If not provided, the client will generate a random string to be used as the server login descriminator. -loginRetries Specifies the maximum number of times the client application will attempt to login. The default value is 30 at 6-second intervals. The value must be greater than 0. -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. Example This example shows the input for an accountability check that searches for lines that are missing in the target structure. It outputs a Microsoft Excel report called TestReport that displays the results. Input: Copy acc_check_client -u="tcadm" -p="tcadm-password" -sourceClosureRule="AccountabilityAll" -targetClosureRule="AccountabilityAll" - host="corbaloc:iiop:localhost:7777/localserver7777" -check="missingTarget" -reportName="TestReport" -sourceBVR="QTZJ29zQAABaaA" -targetBVR="g7UJ29zQAABaaA" -u=tcadm -p=tcadm-password -sourceClosureRule=AccountabilityAll -targetClosureRule=AccountabilityAll -host=corbaloc:iiop:localhost:7777/localserver7777 -check=missingTarget -reportName=TestReport -sourceBVR=QTZJ29zQAABaaA -targetBVR=g7UJ29zQAABaaA Output: