persistent class %Net.Remote.ObjectGateway
extends %Persistent
Object Gateway Server definitions.
• property AllowedIPAddresses
as %String [ InitialExpression = "0.0.0.0" ];
Which IP address, among the several IP addresses that the machine has, that allows incoming connections.
Specify 0.0.0.0 or "" 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.0,2.0",VALUELIST=",4.0,2.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 Ensemble Event Log -- this option is
only available for Ensemble, and 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 JDKVersion
as %String(DISPLAYLIST=",Java 1.6",VALUELIST=",JDK16") [ InitialExpression = "JDK16" ];
Version of JDK used to select the intended version of InterSystems .jar files.
It is used to locate and assemble the command to start the Gateway. The default is Java 1.6.
(This property applies only to Java Gateways.)
• 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 Caché/Ensemble and the Gateway Server.
Usually this setting should be left blank, and used only for trouble-shooting.
• 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 Ensemble.
• 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
• classmethod GatewayExists(name As %String)
as %Boolean
Check if there exists a Gateway with a given name.
• classmethod GatewayState(port As %String)
as %Integer
• 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
SQL Query
:
SELECT %ID, Name, %EXTERNAL(Type), Server, Port
FROM ObjectGateway
WHERE Name %STARTSWITH :name
ORDER BY Name
Lookup by Gateway name.
• index (ID on Name) [IdKey];
Index for property Name
• index (PortIndex on Port) [Unique];
Index for property Port
