Full text search
function	FS_ChangeDirectory

Library: File System Utilities Include: omfsys.xin

Declaration

  define external function FS_ChangeDirectory
                  value      stream  newpath
     status       modifiable stream  statusvalue

This function sets the current (working) directory.

Input argument:

• "newpath". The abolute or relative path name of the new directory.

Output argument:

• "statusvalue". This argument will contain either a zero length string if the function succeeds, or one of the following error codes:
  • "EACCES" -- no search permission on a component of the path name
  • "EINTR" -- a signal was caught during the function execution
  • "EIO" -- a file system I/O error occurred
  • "ELOOP" -- (UNIX only) link recursion was detected
  • "ENAMETOOLONG" -- the path name exceeds the system limits
  • "ENOENT" -- the specified path does not exist
  • "ENOLINK" -- (UNIX only) a required link to a remote machine is inactive
  • "ENOTDIR" -- the path name is not a valid directory
  • "EMULTIHOP" -- (UNIX only) remote machine access is required but not allowed

Note that "newpath" must refer to a valid path name, and you must have execute (search) access to the specified directory.