Remote Server

Synopsis

[Gateways]
Name=Remote,Port,Resource,Address,(not used),(not used),[optional fields]

Description

There is no remote server defined in the [Gateways] section of the default CPF, but remote gateways can be created and existing gateways can be edited or deleted as described in [Gateways]. Each definition consists of a name followed by = and then a comma-separated list of values defining the gateway; some fields are required, and others can be left blank, in which case default values are used. Fields specific to remote gateways and those that can be used with all gateways are described in the following two sections.

Remote Gateway Fields

The first three fields in a remote gateway definition are common to all gateways and the next three are specific to remote gateways. These are shown in order in the following:

• Type (required) — Type of the gateway. When defining a remote gateway, this is set to remote.

• Port (required) — TCP port number for communication between the gateway and the proxy classes in InterSystems IRIS. This port number must not conflict with any other local TCP port on the remote server.

• Resource — The gateway resource that controls access to this gateway. For a remote gateway created using the Management Portal (see [Gateways]), the default is %Gateway_Object.

  Important:

  If no resource is specified, the gateway is public, but InterSystems strongly recommends protecting all gateways using this mechanism.

• Address — The IP address or hostname of the remote system on which you are defining the gateway.

• (not used) — Leave this field empty (consecutive commas).

• (not used) — Leave this field empty (consecutive commas).

General Gateway Fields

The remaining eight fields can be used in any gateway definition, and are shown in the General Gateway Fields section under %DotNet Server.

Changing This Parameter

For information about changing and adding gateway definitions, see [Gateways].