Progress
Version 9
Product Update Bulletin
IN-HANDLE Attribute
A handle to one of the following:
Data Type: HANDLE
- A persistent procedure you just started up dynamically (by invoking an external procedure with the PERSISTENT attribute set to TRUE)
- A running persistent procedure containing an internal procedure or user-defined function you want to invoke dynamically
- An object whose attributes you want to get or set dynamically, or whose methods you want to run dynamically
Access: Readable/WritableApplies To: CALL ObjectSYNTAX
handle-expression
A HANDLE expression. Table D–6 explains what the handle can indicate and who sets it.
char-expression
A CHARACTER expression indicating the name of a system object, such as “SESSION” or “FILE-INFO.”
The default is ? (the unknown value).
When you use IN-HANDLE to call an internal procedure, IN-HANDLE affects INVOKE() the same way the IN proc-handle phrase affects the RUN statement. Similarly, when you use IN-HANDLE to call a user-defined function, it affects INVOKE() the same way the IN proc-handle phrase affects the DYNAMIC-FUNCTION function. In both cases, IN-HANDLE specifies the instance of the external procedure that contains the internal procedure or user-defined function.
When IN-HANDLE is used to get or set an attribute or to invoke a method, it represents a handle to the object the attribute applies to. If the attribute applies to a system object such as the SESSION handle or the FILE-INFO handle, IN-HANDLE can be set to a character string such as “SESSION” or “FILE-INFO” that indicates the name of the system object.
NOTE: When you create a running persistent procedure by running an external procedure persistently, you can do this statically or dynamically. Similarly, you can run any of the persistent procedure’s internal procedures and user-defined functions statically or dynamically.For information on dynamically invoking logic that resides on a Progress AppServer, see the SERVER Attribute reference entry in this bulletin.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |