How to launch the Unicenter Remote Control Viewer from the command line?

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

Introduction: 

How to launch the Remote Control Viewer from the command line?

 

Background:  

Remote Control Viewer command prompt interface to launch the remote control functionality

 

Environment:  

Client Automation - All Versions

 

Instructions: 

The Command line interface to launch Remote Control Viewer is:             gui_rclaunch.exe

This command has the following format:

All arguments except VIEW or REPLAY are optional.

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:

 

gui_rcLaunch {{VIEW | REPLAY} [Options] | [None]} 

Note: Use quoted strings for values containing spaces. Use \ to insert a quote.

OPTIONS:

 

/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|SPX|CAPI|HTTP}

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 command connects to host1 and displays the Remote Control viewer:

                gui_rcLaunch VIEW /A host1 /U myuser /P secret

 •The following command 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 command displays the Connection Settings dialog since the password is not specified:

               gui_rcLaunch VIEW /A host1 /U myuser

 

Additional Information:

 The gui_rcLaunch command is not supported in Linux.