When you execute a remote persistent, single-run, or singleton procedure in an ABL client application, two procedure handles are created: one within the client application session and another separate handle within the server session where the remote procedure is created. OpenEdge internally maintains a mapping between the two handles:
The handle within the client application is a proxy procedure handle, and its
PROXY attribute is set to
TRUE. The handle also has
PERSISTENT,
SINGLE-RUN, and
SINGLETON attributes. Of these, the one that corresponds to the option used with the
RUN statement that called the remote procedure is set to
TRUE, and the other two are set to
FALSE.
The corresponding handle within the server session is a remote procedure handle, and its
REMOTE attribute is set to
TRUE. The values of its
PERSISTENT,
SINGLE-RUN, and
SINGLETON attributes match those of the proxy procedure handle.
For more information on the relationship between proxy and remote procedure handles, see the information on procedure handles in
Design and Implementation Considerations.
