Changeset 29 for rxutilex/trunk/FUNCTIONS

Timestamp:

Jan 26, 2016, 4:13:36 PM (10 years ago)

Author:

Alex Taylor

Message:

Added optional second parameter to Sys2LocateDLL, and updated/clarified function documentation.

File:

• rxutilex/trunk/FUNCTIONS (modified) (3 diffs)

rxutilex/trunk/FUNCTIONS

@@ -25 +25 @@
 Sys2ReplaceModule           - Unlock a DLL (DosReplaceModule wrapper)
 Sys2Seek                    - Set file read/write pointer (with >2GB support)
+Sys2SyncBuffer              - synchronize read/write (DosResetBuffer wrapper)
 Sys2Version                 - Get the version of this library
 Sys2Write                   - Write bytes to a file or named pipe
@@ -278 +279 @@
 
 If a DLL with the given name is currently loaded, that instance of the
-DLL will be returned.  Otherwise, standard DLL loading rules (according
-to the current LIBPATH and/or extended LIBPATH configuration) are used to
-search for a DLL whose module name matches the one specified.
+DLL will be returned.  Otherwise, unless 'L' is specified in the second 
+parameter, standard DLL loading rules (which will be governed by the 
+current LIBPATH and/or extended LIBPATH configuration) are used to
+search for a loadable DLL whose module name matches the one specified.
+(A loadable DLL is one whose runtime dependencies are also loadable,
+and whose initialization routine can be executed successfully.)
 
 REXX ARGUMENTS:
   1. The name of the DLL to search for.  (REQUIRED)
+  2. Flag to limit search context, must be one of:                       
+       A : 'All', search for both loaded and loadable DLLs      (DEFAULT)
+       L : 'Loaded', search only for currently-loaded DLLs 
 
 
@@ -490 +497 @@
 
 -------------------------------------------------------------------------
-Sys2SyncBuffer                                                           
+Sys2SyncBuffer
 
 Used to synchronize buffer read/write transactions (wrapper to 
-DosResetBuffer)  For external files, writes the buffer to disk. 
+DosResetBuffer).  For external files, writes the buffer to disk. 
 For named pipes, blocks until the remote client end of the pipe has read 
 the contents.