Initiate Method
The Initiate method connects to an appropriate server process that hosts the specified OpenROAD application image. An initiate must be done once—and only once—prior to using the Call4GL method.
This method has the following syntax:
Integer = RemoteServer.Initiate(image = imagepath, type = rptype
[, flags = startflags][, location = locationname ]
[, routing = routingstring])
This method has the following parameters:
image
Specifies the full path to the OpenROAD image file to be loaded
type
Specifies one of the following types:
• RP_LOCAL
• RP_PRIVATE
• RP_SHARED
The RP_LOCAL type is useful for development and debugging. When initiated in RP_LOCAL mode, all 4GL calls on the RemoteServer object are forwarded to a local instance of the named 4GL procedure (within the current application on its included applications) and not sent to an OpenROAD Server.
Descriptions of system constant values and their numeric equivalents are listed in
RemoteServer Settings (see
RemoteServer Settings).
startflags
Specifies a string containing OpenROAD application startup flags
location
Identifies the location where the application server is to be started
routing
Specifies a routing string. Specifying "unauthenticated" enables an explicitly unauthenticated connection.
Note: If the Initiate method is invoked directly to make a connection, the Name server is bypassed.