consumer_license_violation_report

This report consolidates the customer license violation data from individual user log files into a single summary file for the Teamcenter administrator. User log files (user-id_license_violation.log) are created for each user during a Teamcenter session. The summary file, consumer_license_violation.csv, contains consolidated information collected from individual users' license violation logs. Consumer license violations are recorded during a session against the user where the user has logged on with the teamcenter_consumer access level and performs an operation of a given type that is only allowed for the teamcenter_author level. The violations are recorded in a file as the count of violations against a given pair of type (business object) and the operation performed on the given type. The persistent storage, which is a file, is created in the consumer_violations directory. Define the TC_LOG_DIR environment variable to indicate where the user violation log file (user-id_license_violation.log) is located. If you do not define the TC_LOG_DIR environment variable, the violation logs are saved in the $TEMP/consumer_violations directory. If the consumer_license_violation.csv file is present in the $TEMP/consumer_violations directory, then the existing copy of the report file is backed up with the name format: consumer_license_violation_YYYYDDMMHHMM.csv Syntax consumer_license_violation_report [-u=user-id {-p=password|-pf=password-file} -g=group] -logdir=license-violation-log-directory [-h] Arguments -u Specifies the user ID. This is a user with dba 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. -logdir Specifies the name of the license violation log directory, which contains the license violation logs. When this utility is run, these logs are consolidated into the license violation report. -h Displays the help for this utility. Examples The following example shows individual user log files for consumerA and consumerB and the summary file generated by the consumer_license_violation_report utility: A user with user ID consumerA logs on, creates an item (testItem), modifies it, and then deletes testItem. When consumerA logs out of the session, a summary file, consumerA_license_violation.log, is created in the TC_LOG_DIR/consumer_violations directory. This summary file contains the following data: Copy Item,Create,1 Item,Checkout,1 Item,Checkin,1 Item,Save,3 ItemRevision,Create,1 ItemRevision,Save,1 Item,Delete,1 ItemRevision,Delete,1 A user with user ID consumerB logs on and creates two parts (PartA and PartB) and an item (testItem). Then, consumerB modifies PartA, deletes PartA, and logs out of the session. A summary file, consumerB_license_violation.log, is created in the TC_LOG_DIR/consumer_violations directory. This file contains the following data: Copy Part,Delete,1 Part,Checkin,1 Part Revision,Create,2 Part,Create,2 Part Revision,Save,2 Item,Create,1 Part,Save,4 ItemRevision,Create,1 Item,Save,1 Part Revision,Delete,1 Part,Checkout,1 ItemRevision,Save,1 Run the consumer_license_violation_report utility: Copy consumer_license_violation_report -u=Tc_admin -pf=password-file -g=group -logdir=$TC_LOG_DIR/consumer_violations This creates the consumer_license_violation.csv file in the location specified by the -logdir argument, which in this case is the $TC_LOG_DIR/consumer_violations directory. The file contains the following updated logs: Copy User,Type,Operation,Count of Violation consumerA,Item,Create,1 consumerA,Item,Checkout,1 consumerA,Item,Checkin,1 consumerA,Item,Save,3 consumerA,ItemRevision,Create,1 consumerA,ItemRevision,Save,1 consumerA,Item,Delete,1 consumerB,Part,Delete,1 consumerB,Part,Checkin,1 consumerB,Part Revision,Create,2 consumerB,Part,Create,2 consumerB,Part Revision,Save,2 consumerB,Item,Create,1 consumerB,Part,Save,4 consumerB,ItemRevision,Create,1 consumerB,Item,Save,1 consumerB,Part Revision,Delete,1 consumerB,Part,Checkout,1 consumerB,ItemRevision,Save,1 Note You can open and manipulate a .csv file in Microsoft Excel, for example: Related Topics Organization Management