For AppServer, returns the first entry in the list of remote persistent, single-run, and singleton procedures that are active on the connected AppServer. For Web services, returns the first entry in the list of procedure objects associated with the Web service.
If the current session has no active persistent procedures or the AppServer has no active remote persistent, single-run, or singleton procedures, FIRST-PROCEDURE returns the Unknown value (?). To find the next procedure given the first, use the NEXT-SIBLING attribute of the procedure handle.
Note: The
PERSISTENT attribute of a remote persistent procedure returned by FIRST-PROCEDURE is TRUE only if the
RUN statement that executes the procedure was invoked with the PERSISTENT option. The PERSISTENT attribute is FALSE if the persistent procedure was invoked with the SINGLE-RUN or SINGLETON option of the RUN statement.
For information on creating persistent, single-run, or singleton procedures, see the
RUN statement reference entry. For more information on the AppServer, see
OpenEdge Application Server: Developing AppServer Applications. To check a handle for validity, use the
VALID-HANDLE function.