Remote Control › Remote Control Viewer › gui_rcLaunch Command—Launch Viewer

gui_rcLaunch Command—Launch Viewer

The guiLaunch.exe program provides a command line interface for launching remote control functionality.

This command has the following format:

gui_rcLaunch.exe [{VIEW | REPLAY} [Options]]

If no command arguments are specified, the program just launches Remote Control. Use quoted "" strings for values containing spaces. Use \" to insert a quote.

VIEW

Specifies the Remote Control viewer component.

REPLAY

Specifies the Remote Control replayer component.

/M {STEALTH|VIEW|SHARED|CLASSROOM|EXCLUSIVE|SECURE|MEETING}

Indicates the type of connection.

Default: SHARED

/N computername

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.

/U username

Defines the user name.

/P password

Defines the user password.

/S {NORMAL|AUTOPAN|SCALE|SHRINK}

Indicates the type of scroll mode.

Default: NORMAL

/C {<32|16|12|8|6>BITCOLOR|<8|4|1>BITGREY}

Indicates the color depth for bitmaps.

Default: 32BITCOLOR

/R filename

Specifies the file name and path for recording the session, or the file name and path of a recorded session to be replayed.

Note: If /R is specified, the viewer records the current session to the specified file name.

/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.

/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 

More information:

Scroll Mode

Connection Settings Dialog

Remote Control Viewing Modes