Enterprise Administration > Business Administrative Change Promotion > Running the Business Administrative Change Promotion Command-Line Utility > Register System Command
  
Register System Command
Each source Windchill system has one or more Windchill systems registered as a target system. The following sections provide the commands for registering a new target system.
displayRepository — Target System
The displayRepository command is used to show the globally unique identifier (GUID) and host name of the target system. The GUID and host name are needed to register the target system.
Option
Required?
Description
-u
--user
No
The user name of the Windchill user running the command. The user running the command must be a valid Windchill user and a site administrator.
-p
--password
No
The password of the Windchill user running the command.
-h
--help
No
Use this option to display help text for the utility. The help text lists full descriptions of each option as well as the syntax for running the utility.
To run the utility in a Windchill shell, specify the following command with the options listed in the table: windchill wt.scm.client.SCMCMD displayRepository -u "<username>" -p "<password>"
The output of the command displays the host name and GUID of the system on which the command is run.
manageRepository — Source System
The manageRepository command is used to add, remove, or list registered target systems.
Option
Required?
Description
-a
--add
Add: Yes
Remove: No
List: No
Required option for registering a new target system.
This option is not included with the --remove or --list options.
-r
--remove
Add: No
Remove: Yes
List: No
Required option for removing a registered target system.
This option is not included with the --add or --list options.
-l
--list
Add: No
Remove: No
List: Yes
Required option for listing all registered target systems. The registered systems are listed in the command prompt window.
This option is not included with the --add or --remove options.
-n
--name
Add: Yes
Remove: Yes
List: No
The name of the target system.
This option creates a new name for the target system when used with the --add option. All target systems must have a unique name.
This option is required for the --add and --remove options. This option is not included with the --list option.
-g
--guid
Add: Yes
Remove: No
List: No
The globally unique identifier (GUID) for the target system. All target systems must have a unique GUID. You can find the GUID of the target system using the displayRepository command on the target system.
This option is required for the --add option. This option is not included with the --remove or --list options.
-d
--hostname
Add: Yes
Remove: No
List: No
The host name of the target system. All target systems must have a unique host name. You can find the host name of the target system using the displayRepository command on the target system.
This option is required for the --add option. This option is not included with the --remove or --list options.
-t
--type
Add: Yes
Remove: No
List: No
The target system type. The following system types are available:
SYNCHRONIZED: Specify this system type if the target system and source system originated from the same source.
SELECTIVEMODE: Specify this system type if the target system and source system did not originate from the same source.
For more information about the system types, see Registering Systems.
This option is required for the --add option. This option is not included with the -remove or --list options.
-u
--user
Add: No
Remove: No
List: No
The user name of the Windchill user running the command. The user running the command must be a valid Windchill user and a site administrator.
-p
--password
Add: No
Remove: No
List: No
The password of the Windchill user running the command.
-h
--help
No
Use this option to display help text for the utility. The help text lists full descriptions of each option as well as the syntax for running the utility.
To run the utility in a Windchill shell, specify the following command with the appropriate options listed in the table for the action you want to take: windchill wt.scm.client.SCMCMD manageRepository
For example, the following command is used to register a target system with the name “Integration”: windchill wt.scm.client.SCMCMD manageRepository -a -u "user" -p "password" -n "Integration" -g "12345-67890" -d "example.ptcnet.ptc.com" -t "SELECTIVEMODE"
To remove the “Integration” target system, the following command is used: windchill wt.scm.client.SCMCMD manageRepository -r -u "user" -p "password" -n "Integration"