Data sharing utilities
transaction_monitor
Deletes a designated range of the records being monitored using Data Exchange Transactions in Active Workspace. Syntax transaction_monitor -u=user-ID {-p=password | -pf=password-file} -g=group -function={delete} -from="start_date" -to="end_date" [-final_status={Success | Fail}] [-filename="input_file_name"] [-dryrun] [-h] Arguments -u Specifies the user ID. If this argument is used without a value, the operating system user name is used. 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 user password. If used without a value, the system assumes a null value. If this argument is not used, the system assumes the user-ID value to be the password. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. If used without a value, the system assumes a null value. If this argument is not used, the system assumes the user-ID value to be the password. 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=delete Deletes the records in the range specified with the -from and -to arguments. -from Specifies the starting date (inclusively) for deleting transaction records. Use this argument with the -to argument. The format of the date is "YYYY-MM-DD HH:MM:SS", with HH being an hour from 00 to 24. Place the value inside double quotes because of the space between the day and the hour. Not valid when using the -filename argument. -to Specifies the ending date (inclusively) for deleting transaction records. Use this argument with the -from argument. The format of the date is "YYYY-MM-DD HH:MM:SS", with HH being an hour from 00 to 24. Place the value inside double quotes because of the space between the day and the hour. Not valid when using the -filename argument. -final_status Deletes only those transaction records with the specified status value. Not valid when using the -filename argument. If not provided, all transactions within the date range are deleted. -filename Specifies the path and file containing a list of transaction record ID values to be deleted. Each line in the file must contain one ID value. Enclose the value in double quote marks when the path or file name contains spaces. -dryrun Runs the command without deleting any transaction records. Displays the transaction records deleted if the command is run without the -dryrun option. -h Displays the help for this utility. Environment As specified in Manually configure the Teamcenter environment.. Files As specified in Log files produced by Teamcenter. Examples Delete transaction records in a date range: Copy transaction_monitor -u=userID -p=password -g=group -f=delete -from="2020-09-01 15:00:00" -to="2020-09-30 15:00:00" Delete transaction records in a date range with a final status of Success: Copy transaction_monitor -u=userID -p=password -g=group -f=delete -final_status=Success -from="2020-09-01 15:00:00"-to="2020-09-30 15:00:00" Delete transaction records with a file containing TxnRecord object UIDs: Copy transaction_monitor -u=userID -p=password -g=group -f=delete -f=delete -filename="input_file_name" Related Topics TC XML and PLM XML Configuration for Data Import and Export Multi-Site Collaboration
Source: https://docs.sw.siemens.com/documentation/external/PL20251212545240207/en-US/tc_help/utilities_reference/avt1737253695886/xid2021903.html · retrieved Fri Jul 31 2026 00:00:00 GMT+0000 (Coordinated Universal Time)