3.6.5 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

Open the Reflection Workspace Settings dialog box.

The steps depend on your user interface mode.

User Interface Mode	Steps
Ribbon	On the File menu or the Reflection button (if using the Office 2007 Look and Feel), choose Reflection Workspace Settings.
Reflection Browser	On the Reflection menu, choose Settings and then Reflection Workspace Settings.
TouchUx	Tap the Gear icon and then select Reflection Workspace Settings.

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