ANSWER: Deregister the ACSAGENT.DLL by running the ACSTEST program in your UniMaint directory with the -Z parameter specified. (ACSTEST -Z). This will deregister the class. If this procedure fails, boot to maintenance mode, delete ACSAGENT.DLL from the UniMaint directory, and reattempt the installation.

FAQ: EXE/DLL Cross Reference fails.

ANSWER: Try setting the 'Force Rebuild' option on in the Cross Reference Defaults dialog. Occassionally a previous build contains an unexpected error which causes the new Cross Reference to fail. Selecting the 'Force Rebuild' option causes UniMaint to ignore the previous build.

FAQ:

Receiving error message 'Unknown Tool Type Code' when attempting to access any of the EXE/DLL Cross Reference icons.

ANSWER: This problem has been corrected. Apply the latest corrective services for UniMaint.

FAQ:

My system cannot locate the Desktop.

ANSWER:

The Desktop entry in the OS2.INI file is missing or corrupted.

1. Attempt to reestablish the Desktop ID using the 'Restore Desktop ID' option from the UniMaint Desktop menu.
2. If this is unsuccessful, it is likely the file handle specified for the Desktop does not match the file handle specified for the Desktop in the OS2.INI file. The following procedures may be used to correct this situation:

a. Select the Repair option from the UniMaint button bar or the 'Repair INI files' option from the UniMaint Recover menu.

b. Select 'Display Valid Dir/File Handles' from the Drop Down Combo Box, 'Report Only' for Type of Repair, and press the Execute button.

c. Locate the entry for the Desktop. This will be on your boot drive with the pathname DESKTOP, e.g., C:\DESKTOP. Note the file handle associated with the Desktop (e.g., 3196B).

d. Return to the UniMaint main display and ensure that the current INI file is the User INI file, OS2.INI. Select the PM_Workplace:Location Application in the Applications window.

e. Find in the Keys window. If the key does exist, then follow the following procedure:

1. Select the key in the Keys window.
2. Compare the file handle for the Desktop with the value listed in the User Data window. Note that the handle is in reverse byte notation. In other words, read the value backwards two characters at a time. For example, if the value in the User Data window is 6B19 0300, the actual value is 0003196B. Drop the leading zeroes for the comparison. Using the example handle above for the Desktop, 3196B, the values are in agreement and this procedure should not be used.
3. If the values do not agree, position the cursor in the User Data window and overtype the value with the file handle for the Desktop obtained earlier, again observing reverse byte notation. If the file handle is 3196B, then the entry should be 6B19 0300. Effectuate the change by changing Applications or Keys and selecting OK in the dialog box which appears.

f. If the key does not exist, then you will need to create it using the following procedure: From the UniMaint Actions menu, select the 'Add key and value' option.

When the Enter New Key dialog appears, enter the key. The brackets must be entered and upper case is required. Press the OK button.The Add Key Value dialog will appear. In the Hex Value field, enter the Desktop file handle obtained earlier in reverse byte notation with leading zeroes to equal four bytes. For example, if the file handle obtained is 3196B, the value entered in the Hex Value field should be 6B190300.

3. Reboot the machine.

FAQ:

I'm receiving a SYS2070 error.

ANSWER:

The incorrect version of the ACSAGENT.DLL is being used. UniMaint must use different versions of the ACSAGENT.DLL depending on whether the operating system is OS/2 2.1 or OS/2 Warp.

1. Open an OS/2 window and change to the UniMaint directory.
2. Rename the current ACSAGENT.DLL file, if it exists, to ACSAGENT.OLD entering the following command:

REN ACSAGENT.DLL ACSAGENT.OLD

3. If you are running OS/2 Warp, rename the ACSAGTWP.DLL file to ACSAGENT.DLL by entering the following command:

REN ACSAGTWP.DLL ACSAGENT.DLL

4. If you are running OS/2 2.1x, rename the ACSAGTNO.DLL file to ACSAGENT.DLL by entering the following command:

REN ACSAGTNO.DLL ACSAGENT.DLL

FAQ:

Invalid items reappear after performing an INI repair.

ANSWER:

This is due to some WPS anomalies. After performing the repair, reset the Desktop by selecting the 'Reset Desktop' option from the Desktop menu.