Description:
CA Remote Control supports the use of a command line to establish the connection instead of using the GUI.
The syntax for this is documented in the Remote Control Viewer Help
gui_rcLaunch Command-Launch Viewer
By default, gui_rcLaunch.exe assumes that the host computer is running CA ITCM and launches the current Remote Control viewer. You can override this behavior by using the /6 parameter appropriately. All arguments except VIEW or REPLAY are optional. If no arguments are specified, the program launches Remote Control. If required, a dialog asks for the address, user name, or password. By default, a shared connection is made and the viewer appears in windowed mode using the same color depth as the host.
This syntax illustrates the command line parameter options for a viewer session and has the following format:
gui_rcLaunch {{VIEW | REPLAY} [Options] | [None]}
Note: Use quoted strings for values containing spaces. Use \ to insert a quote.
Note: The viewer always displays the Connection Settings dialog if the user name, password, or address is not specified on the gui_rcLaunch command line.
Examples
The following example connects to host1 and displays the Remote Control viewer:
gui_rcLaunch VIEW /A host1 /U myuser /P secret
This example displays the Connection Settings dialog, but the viewer does not connect until the Connect button is clicked:
gui_rcLaunch VIEW /A host1 /U myuser /P secret /I
Even though /I is not specified, this example displays the Connection Settings dialog since the password was not given:
gui_rcLaunch VIEW /A host1 /U myuser
Additional examples:
"C:\Program Files\CA\DSM\bin\gui_rcLaunch.exe" VIEW /A 123.45.678.999/U Administrator/P Test
"C:\Program Files\CA\DSM\bin\gui_rcLaunch.exe" VIEW /M SHARED/A 123.45.678.999/U Administrator/P Test/I
If the Viewer and host are on different domains or the user account required to connect to the host is in a different repository to the logged on user on the viewer then the following error may be seen.
Error:
Establishing network connection to xxxxxxxxx...
Verifying username and password...
Unable to establish a remote control session:
Unable to authenticate the specified user, because the host and viewer cannot negotiate a suitable security scheme.
This is probably because the host does not support the repository specified in the URI.
Try using the Repository drop-down to select a repository that the host can authenticate against.
Solution:
Specify the full repository in the /u parameter
gui_rcLaunch VIEW /A host1 /U winnt://company/myuser /P secret