This technical note describes the executable command line options that can be used when starting Reflection terminal emulation products.
Reflection supports executable command line startup switch options that can change how Reflection starts. You can append switches where you start Reflection, such as in the shortcut properties, Windows Explorer file extension associations, Start>Run command, Command Window prompt, or DOS batch file (*.bat). The startup switch syntax is as follows:
<executable> [<option1>] ... [<optionN>]
The executable (.exe file) is typically located in the “C:\Program Files\Reflection” folder. Executable names are as follows:
||Reflection for HP
||Reflection for UNIX and OpenVMS
||Reflection for ReGIS Graphis
||Reflection for IBM
Each switch option begins with a forward slash (/). You can append multiple switch options.
The available switch options are described in the following sections, depending on your Reflection product:
The following switches are supported by R1Win.exe, R2Win.exe, and R4Win.exe.
Causes the Reflection F-Secure Migration Wizard to display before Reflection starts.
Opens Reflection using the information contained in the layout file (*.rlo).
Suppresses the display of the Reflection startup screen.
Loads the connection information but doesn't automatically make the connection. You would want to use this switch, for example, if you wanted to make changes to connection settings in a settings file before connecting.
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.
Where <command> is a Visual Basic command. Although the switch is called /RB, the Visual Basic compiler is used, not the older Reflection Basic compiler. This startup switch is identical to /VBA.
Where <script file name> is a Reflection Basic script.
Where <command> is a Reflection command language command.
Where <command language file name> is a Reflection command language file (*.rcl).
Where <settings file> is the name of a settings file to load.
When you specify multiple settings files, each successive one overwrites the previous settings. In the following example, the settings in the Second settings file will overwrite any toolbar settings that were in the First settings file.
"C:\Program Files\Attachmate\Reflection\R2win.exe" /S First.r2w /S Second.r2w
If your settings file name includes spaces, quotes are required. For example:
"C:\Program Files\Attachmate\Reflection\r2win.exe" /S "C:\My path\My Settings.r2w"
If you use a UNC path for the file, it must begin with 3 backslashes.
(The /S switch can be omitted for the first settings file if it does not contain spaces.)
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.
Where <command> is a Visual Basic command. This startup switch is identical to /RB.
Use quotation marks around path names and/or commands that include spaces. Use a double set of quotation marks for macro data contained within other quotation marks, for example:
"C:\Program Files\Attachmate\Reflection\R2win.exe" /VBA ".ConnectionType = ""TELNET"" " /VBA .Connect
Opens Reflection from a telnet URL, such as in a web browser (see also Technical Note 2307). If you have multiple startup switches, then the /W switch must be the last switch in the string.
The following switches are supported by R8Win.exe.
Load a settings file (such as *.rsf). For more information on Reflection for IBM settings files, see Technical Note 1820.
Lets you specify a command to execute on startup. Available commands are marked with an asterisk in the index of Reflection methods.
Note: If you use commands that require arguments, you must use the original Reflection command syntax (not the VBA method syntax).
For example, the following switch uses the rcRunMacro command (which is equivalent to the RunMacro method):
/C rcRunMacro("Hello"," ")
Suppresses display of the Reflection startup screen.
Lets you run Reflection with a profile other than the default. See your system administrator or the Reflection Profiler help file for more information.
Lets you run a password-protected version of Reflection. See your system administrator or the Reflection Profiler help file for more information.
Starts Reflection and sets the working directory to the user's Reflection folder.
Opens an Untitled Reflection session using a default template file. The template file can be created by an administrator to for a variety of hosts or different connection types for users. Note: Files opened with /template must either be specified with their full path, be in the same directory as R8win.exe, or be in one of these two template folders:
To open RIBM without a settings file and defaulting to 3270 emulation (same as installed shortcut “Host - Mainframe”):
<path>\r8win.exe /u /template Def3270D.rst
To open RIBM without a settings file and defaulting to AS400 emulation (same as installed shortcut “Host - AS400”):
<path>\R8WIN.EXE /u /template Def5250D.rst
Opens Reflection from a telnet URL, such as in a web browser (see also Technical Note 2307). If you have multiple startup switches, then the /W switch must be the last switch in the string. For example, the system URL:TN3270 Protocol file type could be configured for the following application:
"C:\Program Files\Attachmate\Reflection\R8win.exe" browser.rsf /W %1
The system replaces the %1 parameter with the tn3270:// URL (from the web browser or entered in the Start > Run dialog).