C/C++ External Procedure Agent Properties#
EXTPROC_AGENT_CONNECT_TIMEOUT#
Data Type#
Unsigned Integer
Default Value#
60 Seconds
Attributes#
Read-Only, Single Value
Range#
[5, 232-1]
Description#
This property specifies the maximum length of time in seconds during which Altibase attempts to connect to the external procedure agent when the user calls an external procedure. If the connection does not succeed within the time specified in this property, the call is terminated with the error message displaying that the external procedure call failed. Once a connection is made, external procedure calls are not affected by the value of this property.
EXTPROC_AGENT_CALL_RETRY_COUNT#
Data Type#
Unsigned Integer
Default Value#
1
Attributes#
Read-Write, Single Value
Range#
[1, 10]
Description#
When the user calls an external procedure, EXTPROC_AGENT_CALL_RETRY_COUNT specifies the number of times Altibase tries to reconnect to the external procedure agent.
Altibase first needs to check whether the external procedure agent exists. The external procedure agent may have been timed out and terminated due to the value specified for the EXTPROC_AGENT_CONNECT_TIMEOUT property. In this case, EXTPROC_AGENT_CALL_RETRY_COUNT specifies the number of times Altibase tries to reconnect to the external procedure agent.
The value of this property can be altered with the ALTER SYSTEM statement while Altibase is running.
EXTPROC_AGENT_IDLE_TIMEOUT#
Data Type#
Unsigned Integer
Default Value#
300 Seconds
Attributes#
Read-Only, Multiple Value
Range#
[5, 232-1]
Description#
This property specifies the maximum length of time, in seconds, in which the external procedure agent process is to stand by in an idle state. If an external procedure call is made when the external procedure agent process is standing by in an idle state, response time is optimized, as the procedure is executed without connecting to the agent process. However, standby of the agent process in the absence of an external procedure call is a waste of resources; the extension of standby time is recommended only when external procedure calls are highly frequent.
EXTPROC_AGENT_SOCKET_FILEPATH#
Data Type#
String
Default Value#
$ALTIBASE_HOME/trc
Attributes#
Read-Only, Single Value
Range#
None
Description#
This is a socket file's path created for Altibase server to connect with the external procedure agent. If the external procedure uses, the session creates a socket file with socket_sessionID when creating an external procedure agent. The socket file is automatically deleted when the session is closed normally. And, be careful not to delete this file.