Previous Topic: Connect to a Smart Card ReaderNext Topic: Pass Default Parameters to the RC Web Viewer Interface


gui_rcLaunch Command—Launch Viewer

The guiLaunch.exe program provides a command prompt interface to launch the remote control functionality.

This command has the following format:

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

If no command arguments are specified, the program 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 the authentication that uses 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 it must use the log in credentials on the remote computer.

/I

Specifies interactive mode.

Note: If /I is specified, the viewer operates in an interactive mode, and the viewer displays the Connection Settings dialog, letting you set various options before you connect.

/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, the viewer connects after 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 as the password was not given:

gui_rcLaunch VIEW /A host1 /U myuser

More 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:

Connection Settings Dialog

Remote Control Viewing Modes