Setting the XFPL_SMCPATH environment variable for xfServerPlus

If you’re using more than one SMC, or an SMC that is not in the default location, you need to set the environment variable XFPL_SMCPATH on your Synergy server machine to point to the directory that contains the SMC files.

At runtime, each instance of xfServerPlus can reference only a single SMC; however, if you have multiple instances of xfServerPlus running on different ports, they can each reference a separate SMC if desired. This enables you to maintain, for example, SMC files for testing and development and separate SMC files for production.

Note

This topic explains only how to set XFPL_SMCPATH so that it can be read by xfServerPlus. To set XFPL_SMCPATH so that it can be read by the MDU, see Specifying which SMC to update.

Setting XFPL_SMCPATH on Windows

On Windows, use the Synergy Configuration Program to set environment variables for xfServerPlus. You can set XFPL_SMCPATH for all instances of xfServerPlus or for a specific instance of xfServerPlus.

You can specify an SMC on a remote machine using an xfServer file specification (e.g., c:\smcDir\@machineName).

To set XFPL_SMCPATH for all instances of xfServerPlus

This procedure sets XFPL_SMCPATH in the Windows registry under HKEY_LOCAL_MACHINE\SOFTWARE\Synergex\Synergy xfServer\Synrc.

1. Start the Synergy Configuration Program (from the Windows Control Panel, select Synergy Control Panel > Synergy Configuration Program) and go to the xfServer/xfServerPlus tab.
2. Select Default from the list of services, select the Modify Service button, and then select the Environment Settings button.
3. Select the Add button that is grouped with the “Settings for all services” list.
4. Type the variable name (XFPL_SMCPATH) and value in the Add Environment Setting dialog box, and select OK.
5. Select OK in the xfServer Information dialog box, and then select Apply in the Synergy Configuration Program.
6. You’ll be prompted to stop and restart all services so that the new settings take effect. Select Yes.

To set XFPL_SMCPATH for a specific instance of xfServerPlus

This procedure sets XFPL_SMCPATH in the Windows registry under HKEY_LOCAL_MACHINE\SOFTWARE\Synergex\Synergy xfServer\
serviceName\Synrc. This setting overrides the “all instances” setting for a specific instance of xfServerPlus.

1. Start the Synergy Configuration Program (from the Windows Control Panel, select Synergy Control Panel > Synergy Configuration Program) and go to the xfServer/xfServerPlus tab.
2. Select the service from the list, select the Modify Service button, and then select the Environment Settings button.
3. Select the Add button that is grouped with the “Settings for service name” list.
4. Type the variable name (XFPL_SMCPATH) and value in the Add Environment Setting dialog box, and select OK.
5. Select OK in the xfServerPlus Information dialog box, and then select Apply in the Synergy Configuration Program.
6. You’ll be prompted to stop and restart the selected service so that the new settings take effect. Select Yes.
Important

We do not recommend setting XFPL_SMCPATH in the xfpl.ini file because it overrides both settings shown above.

Setting XFPL_SMCPATH on UNIX

On UNIX, the xfServerPlus service reads settings from the environment and from the synrc file. There are synrc files at the system level (/etc/synrc) and at the user level (/usr/username/.synrc). At the system level, xfServerPlus supports both a generic synrc file and a port‑specific synrc file. See below for details.

Note

To include comments in the synrc file, precede the comment with a number sign (#).

Setting XFPL_SMCPATH on OpenVMS

We recommend setting XFPL_SMCPATH in DBLDIR:SERVER_INIT.COM.

$ DEFINE/SYS XFPL_SMCPATH altdir

where altdir is the directory in which the SMC files are located.

$ DEFINE/TABLE=LNM$RSDMS$MGR_port /USER ‑ XFPL_SMCPATH altdir

where port is the port number on which the specific xfServerPlus session is running, and altdir is the directory in which SMC files are located. This setting overrides the system‑level setting.

Important

We do not recommend setting XFPL_SMCPATH in the xfpl.ini file because it overrides both settings shown above. For additional information on defining rsynd logicals on OpenVMS, see Defining logical names for xfServer processes.