Environment
Reflection for UNIX and OpenVMS version 13.0 through 14.x
Reflection for HP with NS/VT version 13.0 through 14.x
Situation
This technical note describes the executable command line options (parameters) that can be used when starting Reflection terminal emulation products.
Note: For Reflection X startup switches, see KB 7021674. Reflection for Secure IT (SSH Client for Windows) startup switches, see KB 7021985.
Resolution
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:
| R1win.exe | Reflection for HP |
| R2win.exe | Reflection for UNIX and OpenVMS |
| R4win.exe | Reflection for ReGIS Graphis |
| R8win.exe | 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:
Switch Support in Reflection for HP, UNIX, OpenVMS, or ReGIS
The following switches are supported by R1Win.exe, R2Win.exe, and R4Win.exe.
/FMIGRATE
Causes the Reflection F-Secure Migration Wizard to display before Reflection starts.
/LAYOUT <layout file>
Opens Reflection using the information contained in the layout file (*.rlo).
/N
Suppresses the display of the Reflection startup screen.
/NOCONNECT
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.
/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.
/RB <command>
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.
/RBS <script file name> [<script argument>]
Where <script file name> is a Reflection Basic script.
/RCL <command>
Where <command> is a Reflection command language command.
/RCLS <command language file name> [<command file argument>]
Where <command language file name> is a Reflection command language file (*.rcl).
/S <settings file>
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.r2wIf 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.)
/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.
/VBA <command>
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/W <telnet URL>
Opens Reflection from a telnet URL, such as in a web browser (see also KB 7021700). If you have multiple startup switches, then the /W switch must be the last switch in the string.
Switch Support in Reflection for IBM
The following switches are supported by R8Win.exe.
<file name>
Load a settings file (such as *.rsf). For more information on Reflection for IBM settings files, see KB 7021692.
/C <command>
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"," ")/N
Suppresses display of the Reflection startup screen.
/PROFILE=<profile>
Lets you run Reflection with a profile other than the default. See your system administrator or the Reflection Profiler help file for more information.
/PASSWORD=<password>
Lets you run a password-protected version of Reflection. See your system administrator or the Reflection Profiler help file for more information.
/U
Starts Reflection and sets the working directory to the user's Reflection folder.
/template <template file name>
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:
C:\Documents and Settings\<user>\Templates\Attachmate\Reflection
To open RIBM without a settings file and defaulting to 3270 emulation (same as installed shortcut “Host - Mainframe”):
<path>\r8win.exe /u /template Def3270D.rstTo open RIBM without a settings file and defaulting to AS400 emulation (same as installed shortcut “Host - AS400”):
<path>\R8WIN.EXE /u /template Def5250D.rst/W <tn3270 URL>
Opens Reflection from a telnet URL, such as in a web browser (see also KB 7021700). 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 %1The system replaces the %1 parameter with the tn3270:// URL (from the web browser or entered in the Start > Run dialog).