WPTools

WPTOOLS is a collection of OS/2 specific tools. Some tools in the archive are:
 * CHECKINI - Checks Workplace shell related stuff in the OS2.INI and OS2SYS.INI, mainly intended to keep the INI-Files clean and (relatively small) and thus have the best performance while using the workplace Shell;
 * WPSBKP - Make a backup of most workplace shell objects in a text file. This text file can be used to restore a customised workplace shell after the desktop has be reinstalled or to port parts to another machine;
 * WPSREST - Restores a backup made with WPSBKP;
 * RESETWPS - Resets the workplace shell without rebooting
 * WPTool.DLL - A dynamic link library that, amongst other things, can be used from REXX to query object settings. This DLL is also used by WPSBKP to query object settings. As far as I know this is the only tool in the world to query setup strings.
 * DEFASSOC.EXE- Manipulate Associations from the command line
 * GETOBJ.EXE- Query object settings from the command line

WPTOOLS.DLL is a Dynamic Link Library that contains code to query the settings for workplace shell objects. This DLL is used by WPSBKP.EXE but can also be used from REXX procedures.

For usage from REXX the following functions can be used:
 * WPToolsQueryObject - A function to query the object class, the title, the setup string and the location for any WPS object. Only for standard object classes, setup strings are returned.
 * WPToolsFolderContent - Returns the (alphanumeric) OBJECTID's or (numeric) object handles for all abstract objects present in a given folder. Optionally it can also return all filesystem objects.
 * WPToolsSetObjectData - Works more or less the same as SysSetObjectData, but can also be used with object handles returned by WPToolsFolderContent

History

 * WPTOOL31:
 * Added tests to fix some specific problems with filesystem object handles as stored in OS2SYS.INI. To be specific:
 * An error where all files and directories on a drive seem to have their drive letter replaced by something else, making the drive unusable from the workplace shell;
 * An error where the workplace shell internally keeps two versions of its handle-to-pathname translate table for one drive. This leads to different type of errors, but most likely a situation where certain objects do not function as they should.


 * WPTOOL32:
 * Various minor updates.

WPTOOLS.DLL is compiled using VAC 3.0. If you use WPTOOLxx, Association Editor or IconTool you must make sure you have the latest versions since the new WPTOOLS.DLL is not compatible with the old one.

Links

 * Source Code Git
 * More Information