Class Reference
IRIS for UNIX 2019.2
InterSystems: The power behind what matters   
Documentation  Search
  [%SYS] >  [%Net] >  [Remote] >  [ObjectGateway]
Private  Storage   

persistent class %Net.Remote.ObjectGateway extends %Persistent

Object Gateway Server definitions.

Inventory

Parameters Properties Methods Queries Indices ForeignKeys Triggers
21 8 2 2


Summary

Properties
AllowedIPAddresses ClassPath ConnectionTimeout DotNetVersion
Exec64 FilePath HeartbeatFailureAction HeartbeatFailureRetry
HeartbeatFailureTimeout HeartbeatInterval InitializationTimeout JVMArgs
JavaHome LogFile MainClassName Name
Port Server Type UsePassphrase
passphraseList

Methods
%AddToSaveSet %AddToSyncSet %BMEBuilt %CheckConstraints
%CheckConstraintsForExtent %ClassIsLatestVersion %ClassName %ComposeOid
%ConstructClone %Delete %DeleteExtent %DeleteId
%DispatchClassMethod %DispatchGetModified %DispatchGetProperty %DispatchMethod
%DispatchSetModified %DispatchSetMultidimProperty %DispatchSetProperty %Exists
%ExistsId %Extends %GUID %GUIDSet
%GetLock %GetParameter %GetSwizzleObject %Id
%InsertBatch %IsA %IsModified %IsNull
%KillExtent %KillExtentData %LoadFromMemory %LockExtent
%LockId %New %NormalizeObject %ObjectIsNull
%ObjectModified %Oid %OnBeforeAddToSync %OnDetermineClass
%Open %OpenId %OriginalNamespace %PackageName
%PhysicalAddress %PurgeIndices %Reload %RemoveFromSaveSet
%ResolveConcurrencyConflict %RollBack %Save %SaveDirect
%SaveIndices %SerializeObject %SetModified %SortBegin
%SortEnd %SyncObjectIn %SyncTransport %UnlockExtent
%UnlockId %ValidateIndices %ValidateObject GatewayExists


Properties

• property AllowedIPAddresses as %String [ InitialExpression = "127.0.0.1" ];
Which IP address, among the several IP addresses that the machine has, that allows incoming connections. The default is 127.0.0.1. Specify 0.0.0.0 to listen on all IP addresses local to the machine (127.0.0.1, VPN address, etc.). You can also specify a single existing local IP address to restrict the listener to that IP address.
(This property applies only to .NET Gateways.)
• property ClassPath as %String(MAXLEN=32000);
CLASSPATH containing the files required to be passed as an argument when starting the JVM. The user should typically provide here the files containing the classes used via the Java Gateway. There is no need to include InterSystems' .jar files used by the Java Gateway. We assume that the user has properly quoted the classpath and supplied the correct separators for the platform in case of multiple files.
(This property applies only to Java Gateways.)
• property ConnectionTimeout as %Integer(MAXVAL=300,MINVAL=2) [ InitialExpression = 5 ];
Number of seconds to wait for a connection to be established with the Gateway Server.
• property DotNetVersion as %String(DISPLAYLIST=",4.5,4.0,2.0,Core2.0",VALUELIST=",4.5,4.0,2.0,Core2.0") [ InitialExpression = "2.0" ];
Version of .NET used to select the directory for the intended Gateway server executable. The default is version 2.0.
(This property applies only to .NET Gateways.)
• property Exec64 as %Boolean [ InitialExpression = 0 ];
On 64-bit platforms, indicates if the Object Gateway server is to be executed as 32-bit (default) or 64-bit.
(This property applies only to .NET Gateways and to 64-bit platforms.)
• property FilePath as %String(MAXLEN=1023);
Location of the Gateway Server executable. It is used to find the target executable and assemble the command to start the Gateway on a local machine.
If this setting is not specified, the default directory used is ...\dev\dotnet\bin\ under the instance's installation directory.
(This property applies only to .NET Gateways.)
• property HeartbeatFailureAction as %String(DISPLAYLIST=",None,Restart,Alert,Restart and Alert",VALUELIST=",N,R,A,RA") [ InitialExpression = "R" ];
When heartbeat is enabled, this defines what action(s) to take if the Gateway Server goes into failure state. Setting it to Restart (default) will cause the Gateway Server to be restarted. Setting it to Alert will generate an Alert entry in the Interoperability event log -- this option is independent of the Alert on Error setting.
Note: If Server points to a remote system, this feature can't be set to restart the Server.
See also properties HeartbeatInterval, HeartbeatFailureTimeout and HeartbeatFailureRetry.
• property HeartbeatFailureRetry as %Integer(MAXVAL=86400,MINVAL=0) [ InitialExpression = 300 ];
When heartbeat is enabled, in case the Gateway Server goes into failure state, and stays in failure state, this setting defines how much time to wait before retrying the HeartbeatFailureAction. The default value is 300 seconds or 5 minutes. The maximum value is 86400 seconds or 1 day. A value of 0 disables this retry, meaning that once there is a failure that can't be immediately recovered, there won't be automatic attempts to recovery.
See also properties HeartbeatInterval, HeartbeatFailureTimeout and HeartbeatFailureAction.
• property HeartbeatFailureTimeout as %Integer(MAXVAL=86400,MINVAL=0) [ InitialExpression = 30 ];
When heartbeat is enabled, this is the number of seconds without responding to the heartbeat, to consider that the Gateway Server is in failure state. If this value is smaller than property HeartbeatInterval, it will be considered in failure state every time the Gateway communication check fails. The default is 30 seconds. The maximum value is 86400 seconds or 1 day.
See also properties HeartbeatInterval, HeartbeatFailureAction and HeartbeatFailureRetry.
• property HeartbeatInterval as %Integer(MAXVAL=3600,MINVAL=0) [ InitialExpression = 10 ];
A non-zero value for this property enables heartbeat, which is periodic communication with the Gateway Server to check if it's active. The default is 10 seconds. When enabled, the minimum value is 5 seconds and the maximum value is 3600 seconds or 1 hour.
When heartbeat is disabled the monitor process won't be started and the related settings are ignored.
See also properties HeartbeatFailureTimeout, HeartbeatFailureAction and HeartbeatFailureRetry.
• property InitializationTimeout as %Integer(MAXVAL=300,MINVAL=2) [ InitialExpression = 5 ];
Number of seconds to wait for a response during initialization of the Gateway Server.
• property JVMArgs as %String(MAXLEN=32000);
Optional arguments to be passed to the Java Virtual Machine (JVM) to include when assembling the command to start the Gateway.
For example, you can specify system properties: Dsystemvar=value
or set the maximum heap size: Xmx256mb
and so on, as needed.
(This property applies only to Java Gateways.)
• property JavaHome as %String(MAXLEN=1023);
Location of the JVM (similar to the JAVA_HOME environment variable). It is used to find the target JVM and assemble the command to start the Gateway.
Note: If there is a default JVM on the machine that is usable without the need to specify its location, this setting may be left blank.
(This property applies only to Java Gateways.)
• property LogFile as %String(MAXLEN=1023);
Fully qualified name of a file to log all communication between InterSystems IRIS and the Gateway Server. Usually this setting should be left blank, and used only for trouble-shooting.
• property MainClassName as %String [ InitialExpression = $$$javaGatewayClass ];
Name of the Java class that will be specified in the command to launch the gateway. This is the class whose main method launches the server.
• property Name as %String [ Required ];
• property Port as %String [ Required ];
TCP port number for communication between the Java Gateway Server and the proxy classes in InterSystems IRIS.
• property Server as %String [ InitialExpression = "127.0.0.1",Required ];
IP address or name of the machine where the JVM to be used by the Gateway Server is located.
• property Type as %String(DISPLAYLIST=",Java,.NET",VALUELIST=",1,2") [ Required ];
Type of the Object Gateway. It can have one of the following values:
Type = 1 for Object Gateway for Java
Type = 2 for Object Gateway for .NET
• property UsePassphrase as %Boolean [ InitialExpression = 0 ];
If Gateway is to be started requiring a passphrase for connection
• property passphraseList as %String [ Transient ];

Methods

• classmethod GatewayExists(name As %String) as %Boolean
Check if there exists a Gateway with a given name.

Queries

• query ByGateway()
Selects Name, Type, Server, Port, State, StateExt
Lookup all Gateways; include current state.
• query ByName(name As %String = "")
Selects ID, Name, Type, Server, Port, Interface
SQL Query :
SELECT %ID, Name, %EXTERNAL(Type), Server, Port, AllowedIPAddresses AS Interface
FROM ObjectGateway
WHERE Name %STARTSWITH :name
ORDER BY Name
Lookup by Gateway name.

Indices

•index (ID on Name) [IdKey];
Index for property Name
•index (PortIndex on Port) [Unique];
Index for property Port


Copyright (c) 2019 by InterSystems Corporation. Cambridge, Massachusetts, U.S.A. All rights reserved. Confidential property of InterSystems Corporation.