Environment
Situation
Reflection includes startup switches that you can append to the Reflection executable name to change the way Reflection starts. This technical note lists and describes the available switches.
Note the following:
- For a list of command line utility switches and options available for use with ssh, scp, sftp, ssh2, scp2, and sftp2, see KB 7021948.
- If you are using a 32-bit operating system, omit the (x86) after “Program Files” in path names.
Resolution
Startup Switch Syntax
The startup switch syntax is as follows:
<Program executable> [<option 1 >] ... [<option N>]The <Program executable> is the name of the Reflection executable file (R3win.exe) and <option 1> through <option N> are the startup switches. Enter the startup switches after the end quote in the Target box, for example:
"C:\Program Files (x86)\Attachmate\RSecure\R3win.exe" /S Toolbar.r3wIf you're using a server that supports UNC path naming conventions: Note that for any startup switch that requires a file name, you must use three backslashes at the beginning of the UNC path that points to the file. (Two backslashes at the beginning of a UNC path to a file name is only read as one backslash, so three backslashes will be read as two.)
For example, if you're using the /S switch to start Reflection and automatically load a settings file, the syntax could look like this:
"\\MyHost\My C Drive\Program Files (x86)\Attachmate\RSecure\R3win.exe" /S \\\Files\SSHclient.r3wAvailable Startup Switches
The startup switches are listed below:
/FMIGRATE
Causes the Reflection F-Secure Migration Wizard to display before Reflection starts.
/LAYOUT
Opens Reflection using the information contained in the layout file (*.rlo). For example, the following opens Reflection for UNIX and OpenVMS (R2win.exe) using the file SSHclients.rlo:
"C:\Program Files (x86)\Attachmate\RSecure\R2win.exe" /LAYOUT SSHclients.rlo/N
Suppresses the display of the Reflection startup screen.
/NOCONNECT
Loads the connection information but doesn't automatically make the connection. You would use this switch, for example, if you wanted to make changes to connection settings in a settings file before connecting.
/NOLOADSETTINGS
Specifies that the default settings file, or any other settings file specified, is not loaded. This forces Reflection to load with its factory default values or site default values, depending on how it's configured.
/S <settings file>
Where <settings file> is the name of a settings file to load. This switch may not be necessary for the first settings file. For example, the following two entries are equivalent:
"C:\Program Files (x86)\Attachmate\RSecure\R3win.exe" First.r3w /S Second.r3w"C:\Program Files (x86)\Attachmate\RSecure\R3win.exe" /S First.r3w /S Second.r3wNote: When you specify multiple settings files, each successive one overwrites the previous settings. This means that in the example above, the settings in the Second settings file will overwrite any toolbar settings that were in the First settings file.
If your settings file name includes spaces, the /S switch is required. For example:
"C:\Program Files (x86)\Attachmate\RSecure\r3win.exe" /S "C:\My path\My Settings.r3w"/U <path>
Where <path> designates what your user folder will be for the current session. If no path is provided, the user folder that was designated at Setup will be used.