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?

Products

• CA Automation Suite for Data Centers - Configuration Automation
• CA Client Automation - Asset Management
• CA Client Automation - IT Client Manager
• CA Client Automation
• CA Client Automation - Remote Control
• CA Client Automation - Asset Intelligence
• CA Client Automation - Desktop Migration Manager
• CA Client Automation - Patch Manager
• CA Server Automation

Issue/Introduction

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

Environment

Release: UASIT.99000-11.2-Asset Intelligence
Component: