How to use the gui_rclaunch.exe command line to connect to a rchost from a viewer that is not on the domain to a host that is on the domain?

Document ID : KB000051062
Last Modified Date : 14/02/2018
Show Technical Document Details

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.

  • /L
    Specifies authentication using the credentials of the current user. This permits you to connect to a remote host without specifying a user name or password. The system assumes that the logon credentials are also to be used on the remote machine.
  • /M {STEALTH|VIEW|SHARED|CLASSROOM|EXCLUSIVE|SECURE|MEETING}
    Indicates the type of connection.
    Default: SHARED
  • /N {Computer Name}
    Specifies the remote computer display name.
  • /A {Address}
    Specifies the address of the remote computer.
  • /T {TCP}
    Indicates the connection protocol.
    Note: Only TCP is supported currently.
    Default: TCP
  • /U {UserName}
    Defines the user name.
  • /V
    Auto-detects the version of Remote Control on the remote computer.
  • /P {Password}
    Defines the user password.
  • /S {NORMAL|AUTOPAN|SCALE|SHRINK}
    Indicates the type of scroll mode.
    Default: NORMAL
  • /C {32BITCOLOR|16BITCOLOR|8BITCOLOR|8BITGREY|4BITGREY}
    Indicates the color depth for bitmaps.
    Default: 32BITCOLOR
  • /R {Filename}
    Specifies the file name for the recording of a session.
    Note: If /R is specified, the viewer records the current session to the specified file name.
  • /I
    Specifies interactive mode.
    Note: If /I is specified, the viewer operates in an interactive mode and displays the Connection Settings dialog, letting you set various options before connecting.
  • /F
    Specifies full screen mode.
  • /D
    Specifies that reduced bitmaps be dithered.
  • /E
    Specifies that fonts not be embedded.

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