Getting started with xfNetLink Synergy

To successfully set up and run your xfNetLink Synergy – xfServerPlus system, you need to do complete the following steps.

1. Install the necessary Synergy software.

For development purposes, you’ll need to install Professional Series Development Environment (or Professional Series Workbench). However, because the xfNetLink Synergy routines are part of the runtime, when it comes time to deploy your application at a customer site, the client machine will need only Core Components (Windows) or Synergy DBL (UNIX and OpenVMS).

2. Modularize your existing Synergy code for the routines that you want to call remotely. Encapsulate the code in ELBs or shared images (on OpenVMS). See Preparing Your Synergy Server Code for more information.
3. Populate the Synergy Method Catalog (SMC) with information about your Synergy routines. You can do this by attributing your code or by entering data with the Method Definition Utility. If you choose to put the SMC somewhere other than DBLDIR, set the XFPL_SMCPATH environment variable. See Defining Your Synergy Methods for details.
4. In the xfpl.ini file, set logging options for the xfServerPlus log and set logicals that point to the ELBs you specified in the SMC. You may also need to set other options in the xfpl.ini file; see Appendix A: Configuration Settings for a complete list of xfpl.ini configuration settings.

If you choose to put the xfpl.ini file somewhere other than DBLDIR, set the XFPL_INIPATH environment variable.

For information on the log and XFPL_INIPATH, see Using server‑side logging and Setting the XFPL_INIPATH environment variable. See Defining logicals for information on setting logicals that point to your ELBs.

5. Create a user account on the xfServerPlus machine to run xfServerPlus sessions, and then start xfServerPlus. See the topic for your operating system:
6. (optional) Configure xfNetLink Synergy by setting defaults for host name and port, time‑out values, and debug options. On Windows, do this in the synergy.ini file; on UNIX and OpenVMS, use environment variables. See Configuring xfNetLink Synergy.
7. Create the user interface for your Synergy client. Include code that requests a remote execution session using the xfNetLink Synergy API. See Calling Synergy Routines Remotely from Synergy for “how‑to” information about using the API and see xfNetLink Synergy API for the API routines.
8. Run your client program.