PPWIZARD is a free preprocessor for HTML, REXX, Visual Basic or any text files.

_SysFileTree()

This is a rexx function provided by PPWIZARD. This routine is named similar to an OS/2 specific call with a similar purpose, this PPWIZARD version works in all operating systems supported by PPWIZARD.

This function takes two parameters as follows:

1. The name of a file or directory to look for (normally containing wildcard characters appropriate to the operating system being used).

   In linux specify a directory name with a terminating slash to capture all files or subdirectories in that directory.

2. The name of a rexx stem (array) to place the list of matching files (example "Files"). On return "Files.0" contains the number of files, "Files.1" contains the first filename etc.

3. List of options, supported are:
   • F - Files only (default).
   • D - Directories only.
   • FS - Files and follow subdirectories.
   • DS - Directories and follow subdirectories.

If successful a return code of 0 is returned. The contents of the "array" may not be valid if an error occurred so always either check the return code or preset the ".0" element to 0 before making the call.

The full (absolute) name of files is always returned, however the names of directories may be absolute or relative depending on what you passed as the first parameter to this routine.

PPWIZARD Manual

Thursday January 17 2002 at 6:27pm