Show Contents / Index / Search

Run a Startup Macro

You can set up a Visual Basic for Applications (VBA) macro to run when a Reflection workspace starts, rather than when a session opens and connects to the host.

This allows you to gather information about how users will connect and then use that information to configure session settings.

For example, you can create a startup macro to perform tasks such as:

  • displaying a VBA UserForm to gather information from the user before connecting to the host
  • reading from an .ini file
  • checking for host or router availability
  • configuring Reflection settings

    Caution: You can configure only macros in the Common project to run when the workspace starts. Do not configure the "Run Reflection Workspace Macro" action to run a macro present in a session document (rd0x, rd3x, rd5x). This prevents Reflection from starting properly.

To set up a startup macro

  1. From the Reflection button, choose Reflection Workspace Settings.
  2. Under Workspace Settings, click Configure Workspace Settings.
  3. Under Workspace and Documents, in the When starting workspace list, select Run Startup action.
  4. Click Select Action.
  5. Under Action, select Run Reflection Workspace Macro.
  6. Under Action parameters, choose Select macro.
  7. In the Select a macro box, select the macro you want to run when Reflection starts.

Related Topics

Creating and Using Macros

Run a Macro

Set Up a Workspace Startup Action Sequence