generate_ada_input

Allows you to create an input file for the ada_util utility to create new or modify existing ADA licenses on a new site. Using this input file, you can quickly create or modify multiple licenses. Use the following naming conventions for the input file: When creating ADA licenses on a new site: ada_input_file_for_create_licenses_date-stamp.txt When modifying existing ADA licenses on a new site: ada_input_file_for_update_licenses_date-stamp.txt Syntax generate_ada_input [-u=user-id {-p=password | -pf=password-file} g=group] { -from_date=date -to_date=date | -period=whole-number-0-to-365 [ { -from_date=date | -to_date=date } ] } [-outputFilePath=directory-path] [-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 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. -from_date Specifies the start date of the period using the format DD-MMM-YYYY HH:MM, for example, 28-OCT-2020 12:01. -to_date Specifies the end date of the period using the format DD-MMM-YYYY HH:MM, for example, 28-OCT-2020 12:01. -period Specifies the number of days in the period, either from the date provided in -from_date or the date provided in -to_date. If no -from_date or -to_date is specified, then -period is calculated backward from today's date. If both -from_date and -to_date are specified, then -period is calculated backward from -to_date. -outputFilePath (Optional) Specifies the directory location on the disk where the output file is created. If this argument is not specified, the file is created in the directory in which you invoke the utility. Rules The following rules apply: When you use -from_date alone, all licenses created after the -from_date until today's date are recorded. When you use -from_date -period, all licenses created after the -from_date for the period specified are recorded. When you use -to_date -period, all licenses created from the -to_date backward for the period specified are recorded. When you use -period alone, all licenses created from today's date backward for the period specified are recorded. When you use no -from_date/-to_date/-period arguments, no licenses are created, as one of these arguments must be specified. When you use -from_date and -to_date, all licenses are created from the -from_date to the -to_date. When you use -from_date, -to_date, and -period, all licenses created from today's date backward for the period specified are recorded. Examples Given today's date is 30-Jan-19 and an ITAR license, itar1, created on 15-Jan-19 is present and the following command is executed: Copy generate_ada_input -u=Tc-admin-user -p=password -g=group -from_date="1-Jan-19 00:00" One license is found and the contents of the ada_input_file_for_create_licenses_date-stamp.txt file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr| category|citizenship itar1|||ITAR_License||Para-1|Category A| No license is found and the contents of the ada_input_file_for_create_licenses_date-stamp.txt file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr| category|citizenships Given an ITAR license, itar1, created on 14-Jan-19 is present and following the command is executed: Copy generate_ada_input -u=Tc-admin-user -p=password -g=dba -from_date="1-Jan-19 00:00" -period=20 One license is found and the contents of the ada_input_file_for_create_licenses_date-stamp.txt file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr| category|citizenships itar1|||ITAR_License||Para-1|Category A| No license is found and the contents of the ada_input_file_for_create_licenses_date-stamp.txt file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr| category|citizenships Given an ITAR license, itar1, created on 14-Jan-19 is present and following the command is executed: Copy generate_ada_input -u=Tc-admin-user -p=password -g=dba -to_date="31-Jan-19 00:00" -period=20 One license is found and the contents of the ada_input_file_for_create_licenses_date-stamp.txt file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr| category|citizenships itar1|||ITAR_License||Para-1|Category A| No license is found and the contents of the ada_input_file_for_create_licenses_date-stamp.txt file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr| category|citizenships Given today's date is 31-Jan-19 and an ITAR license, itar1, created on 14-Jan-19 is present and following the command is executed: Copy generate_ada_input -u=Tc-admin-user -p=password -g=dba -period=20 One license is found and the contents of the ada_input_file_for_create_licenses_date-stamp.txt file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr| category|citizenships itar1|||ITAR_License||Para-1|Category A| No license is found and the contents of the ada_input_file_for_create_licenses_date-stamp.txt file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr| category|citizenships Given an ITAR license, itar1, created on 14-Jan-19 is present and following the command is executed: Copy generate_ada_input -u=Tc-admin-user -p=password -g=dba -from_date="1-Jan-19 00:00" -to_date="15-Jan-19 23:59" One license is found and the contents of the ada_input_file_for_create_licenses_date-stamp.txt file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr| category|citizenships itar1|||ITAR_License||Para-1|Category A| No license is found and the contents of the ada_input_file_for_create_licenses_date-stamp.txt file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr| category|citizenship Given an ITAR license, itar1, created on 14-Jan-19 is present and following the command is executed: Copy generate_ada_input -u=Tc-admin-user -p=password -g=dba -from_date="1-Jan-19 00:00" -to_date="15-Jan-19 23:59" -period=2 One license is found and the contents of the ada_input_file_for_create_licenses_date-stamp.txt file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr| category|citizenships itar1|||ITAR_License||Para-1|Category A| No license is found and the contents of the ada_input_file_for_create_licenses_date-stamp.txt file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr| category|citizenships Given today's date is 30-Jan-19 and an ITAR license, itar1, created on 15-Jan-19 and modified on 27-Jan-19 and another ITAR license, itar1, created on 26-Jan-19 and modified on 28-Jan-19 is present and following the command is executed: Copy generate_ada_input -u=Tc-admin-user -p=password -g=dba -period=5 One license is found and the contents of the ada_input_file_for_create_licenses_date-stamp.txt file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr| category|citizenships itar2|||ITAR_License||Para-1|Category A| One license is found and the contents of the ada_input_file_for_create_licenses_date-stamp.txt file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr| category|citizenships itar1|||ITAR_License||Para-1|Category A| Generally, the content of the file is: Copy !|license_id|date|reason|type|lock_date|qualifying_cfr|category|citizenships itar1|15-Aug-2019 00:00||ITAR_License||Para-1|Category A| itar2|15-Aug-2019 00:00||ITAR_License||Para-2|Category B|GB,IN,US ip1||reason 1|IP_License|15-Sep-2019 00:00||Category A| ip2|15-Sep-2019 00:00|reason 2|IP_License|||Category B| ip3||reason 3|IP_License|15-Sep-2019 12:45||Category A| where: The header is displayed as !|license_id|date|reason|type|lock_date|qualifying_cfr|category|citizenships. License data is displayed on every new line following the header. Related Topics Data Access Management