Properties (Magic xpa 2.x)
The properties for a local COM object are described below. Any modification of these properties will affect the next method call.
|
|
ApplicationName
|
This property keeps the name of the application by which all methods should be handled.
Each public program that corresponds to a Method call is expected to be found in the application defined by this property. At any stage this property can be set or retrieved.
|
MessagingServer
|
The address of the Magic broker that receives the requests. The address is specified in a host and port number syntax, such as mymachine/3300.
|
BrokerTimeout
|
The maximum time in seconds that the COM object waits for an available engine to be returned by the Magic broker. If the Magic broker cannot provide an available engine within the specified time, the method call fails.
|
RequesterTimeout
|
The maximum time in seconds that the COM object waits for the called public program to be completed. If the value is 0, the COM object waits indefinitely.
|
Priority
|
The priority of the requests generated by the method call. The priority is determined by a number from 0 to 9, where 9 has the highest priority.
|
UserName
|
The user name used by the Magic enterprise server for the execution of the call method.
|
Password
|
The password used by the Magic enterprise server for the execution of the call method.
|
AltMessagingServer
|
You can define an address of an alternate Magic broker. The COM object will refer to this address when the connection to the main messaging server fails.
|
RetryMainTime
|
When the COM object connects to the alternate Magic broker, as specified in the AltMessagingServer property, the Magic xpa engine will try to reconnect to the main Magic broker in the time interval specified. The time interval is the number of minutes the COM object waits before trying to reconnect to the main broker, as set in the MessagingServer property. The default value is 5. The minimum value is 1.
This property can be set only prior to the first method call. After the first method is called, the value of this property cannot be changed.
|