Product SiteDocumentation Site

Chapter 8. Rexx Utilities (RexxUtil)

8.1. A Note on Error Codes
8.2. List of Rexx Utility Functions
8.3. RxMessageBox (Windows only)
8.4. RxWinExec (Windows only)
8.5. SysAddRexxMacro
8.6. SysBootDrive (Windows only)
8.7. SysClearRexxMacroSpace
8.8. SysCloseEventSem
8.9. SysCloseMutexSem
8.10. SysCls
8.11. SysCreateEventSem
8.12. SysCreateMutexSem
8.13. SysCreatePipe (Unix only)
8.14. SysCurPos (Windows only)
8.15. SysCurState (Windows only)
8.16. SysDriveInfo (Windows only)
8.17. SysDriveMap (Windows only)
8.18. SysDropFuncs
8.19. SysDropRexxMacro
8.20. SysDumpVariables
8.21. SysFileCopy
8.22. SysFileDelete
8.23. SysFileExists
8.24. SysFileMove (Windows only)
8.25. SysFileSearch
8.26. SysFileSystemType (Windows only)
8.27. SysFileTree
8.28. SysFork (Unix only)
8.29. SysFromUnicode (Windows only)
8.30. SysGetErrortext
8.31. SysGetFileDateTime
8.32. SysGetKey
8.33. SysGetMessage (Unix only)
8.34. SysGetMessageX (Unix only)
8.35. SysIni (Windows only)
8.36. SysIsFile
8.37. SysIsFileCompressed (Windows only)
8.38. SysIsFileDirectory
8.39. SysIsFileEncrypted (Windows only)
8.40. SysIsFileLink
8.41. SysIsFileNotContentIndexed (Windows only)
8.42. SysIsFileOffline (Windows only)
8.43. SysIsFileSparse (Windows only)
8.44. SysIsFileTemporary (Windows only)
8.45. SysLinVer (Linux Only)
8.46. SysLoadFuncs
8.47. SysLoadRexxMacroSpace
8.48. SysMkDir
8.49. SysOpenEventSem
8.50. SysOpenMutexSem
8.51. SysPostEventSem
8.52. SysPulseEventSem (Windows only)
8.53. SysQueryProcess
8.54. SysQueryRexxMacro
8.55. SysReleaseMutexSem
8.56. SysReorderRexxMacro
8.57. SysRequestMutexSem
8.58. SysResetEventSem
8.59. SysRmDir
8.60. SysSaveRexxMacroSpace
8.61. SysSearchPath
8.62. SysSetFileDateTime
8.63. SysSetPriority
8.64. SysShutdownSystem (Windows only)
8.65. SysSleep
8.66. SysStemCopy
8.67. SysStemDelete
8.68. SysStemInsert
8.69. SysStemSort
8.70. SysSwitchSession (Windows only)
8.71. SysSystemDirectory (Windows only)
8.72. SysTempFileName
8.73. SysTextScreenRead (Windows only)
8.74. SysTextScreenSize (Windows only)
8.75. SysToUnicode (Windows only)
8.76. SysUtilVersion
8.77. SysVersion
8.78. SysVolumeLabel (Windows only)
8.79. SysWait (Unix only)
8.80. SysWaitEventSem
8.81. SysWaitNamedPipe (Windows only)
8.82. SysWinDecryptFile (Windows only)
8.83. SysWinEncryptFile (Windows only)
8.84. SysWinGetDefaultPrinter (Windows only)
8.85. SysWinGetPrinters (Windows only)
8.86. SysWinSetDefaultPrinter (Windows only)
8.87. SysWinVer (Windows only)
RexxUtil is a Dynamic Link Library (DLL) package for Windows and *nix platforms; the package contains external Rexx functions. These functions:
All of the RexxUtil functions are registered by the ooRexx interpreter on startup so there is no need to register the functions either individually or via the SysLoadFuncs function.

8.1. A Note on Error Codes

On Windows, some of the REXXUTIL functions return operating system error codes on failure. The SysGetErrorText (Section 8.30, “SysGetErrortext”) function can be used retrieve a description of system error code. In addition, the meaning of these error return codes can be looked up in the Windows Operating System documentation provided by Microsoft.
The documentation is called the MSDN Library. The library is provided online for anyone to access. Plus, since May 2006, Microsoft has also provided the ISO images for the library free of charge. Anyone can download the ISOs, burn them to a CD, and install the library locally on their system.
The information below is provided to help the Rexx programmer locate the MSDN Library. All things on the Internet change. The URLs listed here are accurate at the time of this writing.
The online MSDN Library is currently located at:
http://msdn2.microsoft.com/en-us/library/default.aspx.
A direct link to the section on the System Error codes is:
http://msdn.microsoft.com/en-us/library/ms681381.aspx
A Google search of MSDN Library will turn up the link to the online MSDN Library. A Google search of MSDN "System Error Codes" will turn up the section on the error codes.
Directions to the downloadable ISO images of the MSDN Library have been posted on this blog entry:
http://blogs.msdn.com/robcaron/archive/2006/07/26/678897.aspx
A Google search using: "Rob Caron" General Downloads MSDN Library should also turn up the blog entry.