audit_archive

Note This utility is deprecated and will be removed in a future version. Searches the database for audit log records based on input criteria. Once it finds the records that must be archived, it processes the archive. If the -delete_record argument is given, the utility deletes the audit log records. Audit log entries with an audit definition with a days kept value of -l are not archived, because -l indicates that the log record is permanent. Syntax audit_archive [-u=user-id {-p=password | -pf=password-file} -g=group] [-delete_record] [-type=type-name] [-class=class-name] [-event=event-type] [-id=object-id] [-revid=object-rev-id] [-name=object-name] [-owner=object-owner-id] [-created_before=archive-date] [-created_after=archive-date] [-group_name=owner-group-name] [-obj_seqno=object-sequence-number] [-secobj_type=secondary-object-type-name] [-secobj_id=secondary-object-id] [-secobj_name=secondary-object-name] [-secobj_revid=secondary-object-rev-id] [-secobj_seqno=secondary-object-sequence-no] [-error_code=error-code-of-failed-action] [-proj_id=project-id] [-proj_name=project-name] [-overwrite] [-h] Arguments -u Specifies the user ID. This must be 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 cannot be replaced 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. -delete_record Specifies that audit log records are deleted after being archived. -type Specifies that the audit logs of the specified object type needs to be archived. -class Specifies that the audit logs of the specified class of the object type needs to be archived. -event Specifies that the audit logs of the specified event type needs to be archived. -id Specifies that the audit logs of the specified ID of the object needs to be archived. -revid Specifies that the audit logs of the specified revision ID of the object needs to be archived. -name Specifies that the audit logs of the specified name of the object needs to be archived. -owner Specifies that the audit logs of the specified user who created the object needs to be archived. -created_before Specifies that the audit logs of objects created before the specified date need to be archived. -created_after Specifies that audit logs of objects created after the specified date need to be archived. -group_name Specifies that the audit logs of the specified group name associated with the user who created the object needs to be archived. -obj_seqno Specifies that the audit logs of the specified sequence number of the object needs to be archived. -secobj_type Specifies that the audit logs of the specified type of the secondary object associated with the object needs to be archived. -secobj_id Specifies that the audit logs of the specified ID of the secondary object associated with the object needs to be archived. -secobj_name Specifies that the audit logs of the specified name of the secondary object associated with the object needs to be archived. -secobj_revid Specifies that the audit logs of the specified revision ID of the secondary object associated with the object needs to be archived. -secobj_seqno Specifies that the audit logs of the specified sequence number of the secondary object associated with the object needs to be archived. -error_code Specifies that the audit logs of the specified error code associated with the failed actions on the object needs to be archived. -proj_id Specifies that the audit logs of the specified ID of the project needs to be archived. -proj_name Specifies that the audit logs of the specified project name needs to be archived. -overwrite Archives permanent audit records (those with days kept value of -1). When used in conjunction with the -delete_record argument, the permanent audit records are removed from the database. -h Displays help for this utility. Environment As specified in the Setting up a Teamcenter command-line environment. Files As specified in the Log files produced by Teamcenter. Restrictions Requires Teamcenter administrator privileges. Examples To archive audit log entries associated with the ITAR_license_01ITAR license for actions performed by the user1 user belonging to ADASiteAdministrator group and created before 30th June 2009: Copy audit_archive -u=Tc-admin-user -p=password -g=group -class=ADA_License -type=ITAR_License -id=ITAR_license_01 -owner=user1 -group=ADASiteAdministrator -created_before=30-jun-2009 12:00 To archive audit log entries related to all __Attach_License events associated with ITAR licenses attached to the Part12 item, revision A, sequence 2, created after 31st January 2009: Copy audit_archive -u=Tc-admin-user -p=password -g=group -class=ADA_License -type=ITAR_License -event=__Attach_License -secobj_id=Part12 -secobj_revid=A -secobj_seqno=2 -created_after=31-jan-2009 12:00 To archive audit log entries associated with project1 project name for actions performed by user1 user belonging to ProjectAdministrator group and created before 30th September 2010: Copy audit_archive -u=Tc-admin-user -p=password -g=group -class=Requirement -type=Requirement -proj_name=pcombine_audit_filesroject1 -owner=user1 -group= ProjectAdministrator -created_before=30-sep-2010 12:00 Related Topics Audit Logs Management