AWSJZI002E

An internal error has occurred. The command or script "command_or_script" has failed. The exit code is as follows: "exit_code". Contact the Software Support.

See message.

command_or_script is the command that has failed. It might be an operating system command or a HCL Workload Automation installation script.

exit_code is the error code given by the command or script.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Proceed as follows:

- Interactive wizard

Click OK to close the error popup window. The Diagnose Failure window is opened.
If you want to diagnose the problem without leaving the wizard (recommended) select Diagnose failure and click Next, and follow the procedure described in the Planning and Installation Guide for diagnosing a failed installation.
Otherwise, select Quit installation. The wizard closes.

- Silent wizard

Look in the installation log to see if there is any additional information.

Check any available information related to the exit_code. In the case of an operating system command you might have to consult the operating system documentation.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.

If you cannot correct the problem, contact the Software Support for assistance.

If you think you can solve the problem, make any necessary corrections to the installation environment. Proceed as follows:

- Interactive wizard

Restart the step that has failed.

- Silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed.

AWSJZI008E

The passwords do not match. Retype the password and the verification password, ensuring that they are both the same.

You have supplied a password for the "<TWSUser>" and have confirmed it, but the passwords are different.

The wizard stops.

Click OK to close the error popup.
Retype the passwords, ensuring that they are both the same.
Click Next to continue.

AWSJZI009E

The following field: "field_name" is longer than the maximum of max_length characters.

See message.

field_name is the name of the field that is too long.

max_length is the maximum number of characters it can be.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Proceed as follows:

- Interactive wizard

Click OK to close the error popup.
Re-enter the indicated field, ensuring that it does not exceed the maximum length, and click Next to continue.

- Silent wizard

Edit the response file, and ensure that the field does not exceed the maximum length.
Rerun the wizard.

AWSJZI010E

The following field: "field_name" is outside the following range: "from_value - to_value".

See message.

field_name is the name of the field that is out of range.

from_value and to_value indicate the minimum and maximum values it can take.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Proceed as follows:

- Interactive wizard

Click OK to close the error popup.
Re-enter the indicated field, ensuring that the value falls within the indicated range, and click Next to continue.

- Silent wizard

Edit the response file, and ensure that the field value falls within the indicated range.
Rerun the wizard.

AWSJZI011E

The supplied installation path is not valid.

See message. For example, you might have supplied one or more characters that cannot be used in a file path.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Proceed as follows:

- Interactive wizard

Click OK to close the error popup.
Re-enter the installation path, ensuring that the path is fully qualified and valid, and click Next to continue.

- Silent wizard

Edit the response file, and ensure that the installation path is fully qualified and valid.
Rerun the wizard.

AWSJZI012E

There is insufficient disk space available in the directory directory to complete the installation. The installation requires required_space megabytes, but only available_space megabytes are available. Either make more space available or change the installation directory.

See message.

directory is the install directory that has insufficient space.

required_space and available_space indicate what space the installation requires and how much is available.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

- Make space in the original path

If you want to persist with the original installation path, use the operating system's commands and utilities to make more space available. When you have done this, proceed as follows:

Interactive wizard

Click OK to close the error popup.
Click Next to continue.

Silent wizard

Rerun the wizard.

- Choose another directory

If you cannot make sufficient space, you must change the installation path to one with sufficient available space. To do this, proceed as follows:

Interactive wizard

Click OK to close the error popup.
Re-enter the installation path, ensuring that the path is fully qualified and valid, and points to a directory with sufficient space. Click Next to continue.

Silent wizard

Edit the response file, and ensure that the installation path is fully qualified and valid, and points to a directory with sufficient space.
Rerun the wizard.

Proceed as follows:

AWSJZI017E

You are correcting an installation parameter by editing the parameters of an installation step, but an incorrect parameter has been supplied during the correction.

See message.

The installation cannot continue.

Check the parameters that you have changed or supplied during the restart of an installation, and ensure that you have supplied valid values:

If you locate the error, correct it and continue.
If you cannot locate the error quit the installation and restart it.

AWSJZI019E

An internal error has occurred. The directory to be used for the install location of the embedded WebSphere Application Server does not exist.

The install directory for the embedded WebSphere Application Server is created by the install program within the HCL Workload Automation install directory. This message could arise if the directory in question has not been created correctly, or has been deleted before being used.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Check the installation log to see if there is any further information that helps you to understand why the directory could not be found.

The problem is resolved by just rerunning the installation.

- Rerun the interactive wizard

If you are running the interactive wizard, click OK to close the error popup window. The Diagnose Failure window is opened.
Select Quit installation. The wizard closes.
If you previously copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI021E

An internal error has occurred. The application server profile "profile" for the embedded WebSphere Application Server could not be created.

The installation program needs to create an application server profile for the embedded WebSphere Application Server, and then populate it with the information specific to HCL Workload Automation. This message is displayed because the profile could not be created.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Check that the computer where you are installing HCL Workload Automation satisfies the prerequisite requirements of the embedded WebSphere Application Server. These can be found by clicking the System requirements link on the IBM WebSphere Application Server - Express product information Web page at www.ibm.com.

Check that there is sufficient space in the standard temporary directory of the computer.

Check that you have copied the installation images correctly to the computer where you are running the installation wizard.

Check that there is sufficient free memory. The presence of many processes in memory can block the installation. You must have a minimum of 512 MB of free memory.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you are running the silent wizard, check the installation log for more information.

The problem is resolved by just rerunning the installation.

- Rerun the interactive wizard

If you are running the interactive wizard, close the Step Status window and click Finish on the Step List window. The wizard closes.
If you previously copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI022E

An internal error has occurred. The application server profile archive "profile_archive" for the embedded WebSphere Application Server could not be read.

The installation program needs to create an application server profile for the embedded WebSphere Application Server, and then populate it with the information specific to HCL Workload Automation. This message is displayed because the profile archive that contains the information needed to populate the profile could not be read.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Check that you have copied the installation images correctly to the computer where you are running the installation wizard.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you are running the silent wizard, check the installation log for more information.

The problem is resolved by just rerunning the installation.

- Rerun the interactive wizard

If you are running the interactive wizard, close the Step Status window and click Finish on the Step List window. The wizard closes.
If you previously copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI023E

An internal error has occurred. The update of the configuration of the embedded WebSphere Application Server has failed.

The embedded WebSphere Application Server is installed with a default configuration, which is then updated for HCL Workload Automation. The update has failed.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Check that you have copied the installation images correctly to the computer where you are running the installation wizard.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you are running the silent wizard, check the installation log for more information.

The problem is resolved by just rerunning the installation.

- Rerun the interactive wizard

If you are running the interactive wizard, close the Step Status window and click Finish on the Step List window. The wizard closes.
If you previously copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI024E

The application server "application_server" could not be started.

The indicated application_server runs HCL Workload Automation on the embedded WebSphere Application Server, but the application server could not be started after the installation.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Check the application server's logs to determine why the server could not be started.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you can solve the problem, do so, and proceed as follows:

You might be able to restart the step, or you might have to rerun the installation from the beginning.

- Interactive wizard

Restart the step of the interactive wizard

On the Status tab set the status to Ready
Click Apply. The Step List window is displayed.
Click Run all to restart the installation from that step.

If the problem is not resolved, try exiting from the wizard and recommencing the installation, as follows.

Rerun the interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Silent wizard

Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed.

If this does not resolve the problem, try rerunning the silent wizard, as follows.

Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI025E

An internal error has occurred. The script "script" used by the installation wizard has failed.

See message.

script identifies the script that has failed.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Check the installation log to determine why the script failed.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you can solve the problem, do so, and proceed as follows:

You might be able to restart the step, or you might have to rerun the installation from the beginning.

- Interactive wizard

Restart the step of the interactive wizard

On the Status tab set the status to Ready
Click Apply. The Step List window is displayed.
Click Run all to restart the installation from that step.

If the problem is not resolved, try exiting from the wizard and recommencing the installation, as follows.

Rerun the interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Silent wizard

Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed.

If this does not resolve the problem, try rerunning the silent wizard, as follows.

Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI029E

An internal error has occurred. The directory where the installation expected to find the JRE files does not exist.

The installation program is trying to locate the directory where the Java Runtime Environment files were unpacked at the beginning of the installation, but has failed to find it. Either the unpacking of the installation bundle failed, or the directory has subsequently been renamed or deleted.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

Ensure that you are not trying to run two installations concurrently, which is not possible.

If you can solve the problem, do so, and proceed as follows:

The problem is resolved by just rerunning the installation.

- Rerun the interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance

AWSJZI030E

An internal error has occurred. The build file that the installation program expected to find does not exist.

The installation program is trying to locate the build file that was unpacked at the beginning of the installation, but has failed to find it. Either the unpacking of the installation bundle failed, or the file has subsequently been renamed or deleted.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

Ensure that you are not trying to run two installations concurrently, which is not possible.

If you can solve the problem, do so, and proceed as follows:

The problem is resolved by just rerunning the installation.

- Rerun the interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance

AWSJZI031E

An internal error has occurred. An internal program has failed.

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you can solve the problem, do so, and proceed as follows:

You might be able to restart the step, or you might have to rerun the installation from the beginning.

- Interactive wizard

Restart the step of the interactive wizard

On the Status tab set the status to Ready
Click Apply. The Step List window is displayed.
Click Run all to restart the installation from that step.

If the problem is not resolved, try exiting from the wizard and recommencing the installation, as follows.

Rerun the interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Silent wizard

Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed.

If this does not resolve the problem, try rerunning the silent wizard, as follows.

Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI032E

An internal error has occurred. An internal program has not been supplied with a required parameter.

The internal program that creates the HCL Workload Automation instance (Ant) is called by the installation program, which supplies the parameters it requires. One of these parameters is missing. It is possible that during a previous restart of a failed installation, a required value was inadvertently deleted from a step or modified.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you have already tried restarting this installation, check that you did not inadvertently invalidate any of the step parameters, by looking at the values in the Properties tab on the Step Status panel of the step that failed. You might have to return to a previous step to be able to modify the field.

If you can solve the problem, do so, and proceed as follows:

In the interactive wizard, if you think you have corrected an error in the step properties, you might be able to restart the modified step, or you might have to rerun the installation from the beginning.

- Interactive wizard

Restart the step of the interactive wizard

On the Status tab set the status to Ready
Click Apply. The Step List window is displayed.
Click Run all to restart the installation from that step.

If the problem is not resolved, try exiting from the wizard and recommencing the installation, as follows.

Rerun the interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Silent wizard

Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed.

If this does not resolve the problem, try rerunning the silent wizard, as follows.

Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI036W

The temporary directory created previously by the HCL Workload Automation installation does not exist.

The internal program that cleans up after the HCL Workload Automation instance is trying to delete the temporary files that the installation used, but the directory that contains those files cannot be found. It might have been deleted or renamed during the installation by a user or process other than the installation. Alternatively, the value of the directory name might have been inadvertently changed during the editing of the data in a step while recovering from an installation failure.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

The installation has completed at this point, so remedial action is not necessary. The temporary files might still be present on your disk, and if you can easily find them and delete them, do so. However, they might not be easy to find (if another user or process has changed the directory name) and do not occupy enough space to make it worth while spending time searching for and deleting them.

AWSJZI038E

An internal error has occurred. An unspecified internal error has occurred during the installation process.

The installation process has determined that an error has occurred, but is unable to give any more-detailed information.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

Ensure that you are not trying to run two installations concurrently, which is not possible.

If you can solve the problem, do so, and proceed as follows:

The problem is resolved by just rerunning the installation.

- Rerun the interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance

AWSJZI041E

The installation cannot add the following key to the Windows registry: registry_key.

The installation was attempting to add the following registry key

\IBM\IBM Workload Scheduler

to the standard

HKEY_LOCAL_MACHINE\SOFTWARE

registry key.

The attempt has failed, probably because the standard

HKEY_LOCAL_MACHINE\SOFTWARE

registry key has been deleted or renamed.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

The product cannot run successfully without the indicated registry key. You are strongly advised to treat this as an internal error and contact the Software Support for assistance.

However, you might decide to attempt to use regedit to add the key. Bear in mind that Microsoft warn you that the incorrect use of regedit might render the computer unusable. If you do decide to go ahead using regedit, verify that your Windows registry has the key

HKEY_LOCAL_MACHINE\SOFTWARE

. Add it if it does not. Remember to close regedit before proceeding.

The installation can now be restarted at the failed step, as follows:

- Restart the step of the interactive wizard

Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Double-click the failed installation step and the Step Status window opens.
On the Status tab set the status to Ready
Click Apply. The Step List window is displayed again.
Click Run all to restart the installation from that step.

- Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed, as described above.

If the problem persists contact the Software Support for assistance.

AWSJZI042E

The installation cannot add the following key to the Windows registry: registry_key with values registry_key_values.

The installation is attempting to add the indicated values to a key it expects to exist. Perhaps the key does not exist or has been renamed.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

The product cannot run successfully without the indicated registry key. You are strongly advised to treat this as an internal error and contact the Software Support for assistance.

However, you might decide to attempt to use regedit to add the key. Bear in mind that Microsoft warn you that the incorrect use of regedit might render the computer unusable. If you do decide to go ahead using regedit, verify that your Windows registry has the indicated key. Add it if it does not. Remember to close regedit before proceeding.

The installation can now be restarted at the failed step, as follows:

- Restart the step of the interactive wizard

Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Double-click the failed installation step and the Step Status window opens.
On the Status tab set the status to Ready
Click Apply. The Step List window is displayed again.
Click Run all to restart the installation from that step.

- Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed, as described above.

If the problem persists contact the Software Support for assistance.

AWSJZI043E

The installation cannot delete the following key from the Windows registry: registry_key.

The installation is attempting to delete the indicated registry key that it expects to exist. Maybe the key does not exist or has been renamed.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

The product cannot run successfully without deleting the indicated registry key. You are strongly advised to treat this as an internal error and contact the Software Support for assistance.

However, you might decide to attempt to use regedit to delete the key. Bear in mind that Microsoft warn you that the incorrect use of regedit might render the computer unusable. If you do decide to go ahead using regedit, verify whether your Windows registry has the indicated key. Delete it if it does. Remember to close regedit before proceeding.

The installation can now be restarted at the failed step, as follows:

- Restart the step of the interactive wizard

Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Double-click the failed installation step and the Step Status window opens.
On the Status tab set the status to Ready
Click Apply. The Step List window is displayed again.
Click Run all to restart the installation from that step.

- Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed, as described above.

If the problem persists contact the Software Support for assistance.

AWSJZI044E

The installation cannot install the following Windows service: service_name.

The reason might be that you do not have the correct rights to install services, the service might already exist or the user account name specified might not exist.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Follow these steps:

Using the Windows user account management facilities, check that the user performing the installation exists, and has the right to install services. If not, add this right. Remember to close the user account management facilities window before proceeding.
If the user exists and its rights are correct, open the Windows Services panel. Check if the indicated service already exists. If it does, probably a previous uninstallation of HCL Workload Automation failed, without deleting the service. If you suspect this to be the case, contact the Software Support. Remember to close the Windows Services panel before proceeding.

If you are able to solve the problem so that the installation is capable of installing a service, the installation can be restarted at the failed step, as follows:

- Restart the step of the interactive wizard

Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Double-click the failed installation step and the Step Status window opens.
On the Status tab set the status to Ready
Click Apply. The Step List window is displayed again.
Click Run all to restart the installation from that step.

- Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed, as described above.

If the problem persists contact the Software Support for assistance.

AWSJZI045E

The installation cannot delete the following Windows service: service_name.

The reason might be that you do not have the correct rights to delete services, or the service might not exist.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Follow these steps:

Using the Windows user account management facilities, check that the user performing the installation exists, and has the right to delete services. If not, add this right. Remember to close the user account management facilities window before proceeding.
If the user exists and its rights are correct, open the Windows Services panel. Check if the indicated service already exists. If it does not, it might have been manually deleted in error. If you suspect this to be the case, contact the Software Support. Remember to close the Windows Services panel before proceeding. You are not advised to attempt to add the service manually.

If you are able to solve the problem so that the installation is capable of deleting a service, the installation can be restarted at the failed step, as follows:

- Restart the step of the interactive wizard

Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Double-click the failed installation step and the Step Status window opens.
On the Status tab set the status to Ready
Click Apply. The Step List window is displayed again.
Click Run all to restart the installation from that step.

- Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed, as described above.

If the problem persists contact the Software Support for assistance.

AWSJZI046E

The installation could not find an operating system dll to complete the user verification tasks.

The installation needs to use a standard operating system dynamic link library (dll) to complete its task of verifying, and if necessary creating, the supplied user.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Verify that the Path system variable points to the location of all the operating system dlls, and that the dlls are available. Depending on what you find, you might need to reinstall the operating system before continuing with the installation.

If you are able to solve the problem so that the installation is capable of using the operating system dlls to verify and create users, the installation can be restarted at the failed step, as follows:

- Restart the step of the interactive wizard

Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Double-click the failed installation step and the Step Status window opens.
On the Status tab set the status to Ready
Click Apply. The Step List window is displayed again.
Click Run all to restart the installation from that step.

- Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed, as described above.

If the problem persists contact the Software Support for assistance.

AWSJZI047E

The installation encountered an error running the HCL Workload Automation Windows configuration script.

The reason for the failure is documented in the installation log file.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you are running the silent wizard, see the installation log file for the error messages that explain why the configuration script failed.

If you can solve the problem, do so, and proceed as follows.

You might be able to restart the step, or you might have to rerun the installation from the beginning.

- Interactive wizard

Restart the step of the interactive wizard

On the Status tab set the status to Ready
Click Apply. The Step List window is displayed.
Click Run all to restart the installation from that step.

If the problem is not resolved, try exiting from the wizard and recommencing the installation, as follows.

Rerun the interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Silent wizard

Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed.

If this does not resolve the problem, try rerunning the silent wizard, as follows.

Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI048E

The installation cannot read the following file: file_name.

The file_name is the fully qualified path of the file that cannot be read.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Verify that the file exists and has read permission for the user performing the installation. Ensure that it has not been locked by another application, such as a file editor.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you are running the silent wizard, see the installation log file for the error messages that explain why the file cannot be read.

If you can solve the problem, do so, and proceed as follows.

You might be able to restart the step, or you might have to rerun the installation from the beginning.

- Interactive wizard

Restart the step of the interactive wizard

On the Status tab set the status to Ready
Click Apply. The Step List window is displayed.
Click Run all to restart the installation from that step.

If the problem is not resolved, try exiting from the wizard and recommencing the installation, as follows.

Rerun the interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Silent wizard

Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed.

If this does not resolve the problem, try rerunning the silent wizard, as follows.

Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI049E

The installation cannot write the following file: file_name.

The file_name is the fully qualified path of the file that cannot be written.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Verify that the user performing the installation has write permission for the file. Check if the file exists, and ensure that it has not been locked by another application, such as a file editor.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you are running the silent wizard, see the installation log file for the error messages that explain why the file cannot be written.

If you can solve the problem, do so, and proceed as follows.

You might be able to restart the step, or you might have to rerun the installation from the beginning.

- Interactive wizard

Restart the step of the interactive wizard

On the Status tab set the status to Ready
Click Apply. The Step List window is displayed.
Click Run all to restart the installation from that step.

If the problem is not resolved, try exiting from the wizard and recommencing the installation, as follows.

Rerun the interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Silent wizard

Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed.

If this does not resolve the problem, try rerunning the silent wizard, as follows.

Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI050E

The installation cannot move the following file: file_name.

The file_name is the fully qualified path of the file that cannot be moved.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Verify that the file being moved has read permission for the user performing the installation. Verify that the directory where the installation wants to move the file to has write permission for the user performing the installation.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you are running the silent wizard, see the installation log file for the error messages that explain why the file cannot be moved.

If you can solve the problem, do so, and proceed as follows.

You might be able to restart the step, or you might have to rerun the installation from the beginning.

- Interactive wizard

Restart the step of the interactive wizard

On the Status tab set the status to Ready
Click Apply. The Step List window is displayed.
Click Run all to restart the installation from that step.

If the problem is not resolved, try exiting from the wizard and recommencing the installation, as follows.

Rerun the interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Silent wizard

Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed.

If this does not resolve the problem, try rerunning the silent wizard, as follows.

Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI051E

The installation cannot install the Autotrace software.

See message text.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you are running the silent wizard, see the installation log file for the error messages that explain why the Autotrace software cannot be installed.

If you can solve the problem, do so, and proceed as follows.

You might be able to restart the step, or you might have to rerun the installation from the beginning.

- Interactive wizard

Restart the step of the interactive wizard

On the Status tab set the status to Ready
Click Apply. The Step List window is displayed.
Click Run all to restart the installation from that step.

If the problem is not resolved, try exiting from the wizard and recommencing the installation, as follows.

Rerun the interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Silent wizard

Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed.

If this does not resolve the problem, try rerunning the silent wizard, as follows.

Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI052E

The installation could not run the final installation "commit" phase.

See message text.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you are running the silent wizard, see the installation log file for the error messages that explain why the installation could not run the final installation "commit" phase.

If you can solve the problem, do so, and proceed as follows.

You might be able to restart the step, or you might have to rerun the installation from the beginning.

- Interactive wizard

Restart the step of the interactive wizard

On the Status tab set the status to Ready
Click Apply. The Step List window is displayed.
Click Run all to restart the installation from that step.

If the problem is not resolved, try exiting from the wizard and recommencing the installation, as follows.

Rerun the interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Silent wizard

Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Restart the step that failed.

If this does not resolve the problem, try rerunning the silent wizard, as follows.

Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI053E

In the installation wizard, the script used by the current step failed.

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent installation, the installation fails.

Proceed as follows:

Interactive wizard

Do the following:

Check the installation log to determine why the script failed.
Look at the Output tab on the failed installation step for further information. Do the following:
1. Note down the error code (so that you can later find it in the Installation Guide, if needed)
2. Click OK to close the error popup window. The Diagnose Failure window is opened.
3. Select Diagnose failure and click Next. The Step List window is opened.
4. Select the failed installation step and double click it to open the Step Status window.
5. Select the Output tab and analyze the content to determine the error cause. When you solve the problem proceed as follows:
  1. On the Status tab set the status to Ready.
  2. Click Apply. The Step List window is displayed.
  3. Click Run all to restart the installation from that step.

Silent installation

You cannot troubleshoot a failed installation with the silent installation. Instead, do as follows:

Resume the installation adding the parameter -resume. The interactive wizard resumes in interactive mode at the Step List window showing the failed step.
Restart the step that failed.

If you have copied the installation images to the local hard disk or to a remote workstation, do as follows:

ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

AWSJZI054E

The directory that contains the installation files for the embedded WebSphere Application Server cannot be found.

The installation program is trying to locate the directory where the files of the embedded WebSphere Application Server were unpacked at the beginning of the installation, but has failed to find it. Either the unpacking of the installation bundle failed, or the directory has subsequently been renamed or deleted.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

The problem might be resolved by restarting the installation from the beginning.

If you are running the interactive wizard, click Cancel to exit from the wizard.
If you are running the silent wizard, the wizard has already stopped.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.

Rerun the installation. If the problem persists contact the Software Support.

AWSJZI055E

The tar file that contains the installation files of the embedded WebSphere Application Server cannot be found.

The installation program is trying to locate the tar file that contains the files of the embedded WebSphere Application Server, but has failed to find it. Either the unpacking of the installation bundle failed, or the file has subsequently been renamed or deleted.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

The problem might be resolved by restarting the installation from the beginning.

If you are running the interactive wizard, click Cancel to exit from the wizard.
If you are running the silent wizard, the wizard has already stopped.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.

Rerun the installation. If the problem persists contact the Software Support.

AWSJZI056E

The fully qualified domain name of this computer is null. The installation requires the fully qualified domain name to configure HCL Workload Automation correctly.

The computer where you are installing HCL Workload Automation is not correctly set up in your network with its fully qualified domain name. Perhaps you are installing HCL Workload Automation on a new computer which has not yet been configured for network access. The installation program requires the fully qualified domain name (for example, mycomputer.rome.ibm.com) to be defined on the local computer to configure HCL Workload Automation correctly.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Resolve the problem by configuring the computer for network access.

If you are running the interactive wizard, stop the installation program to reconfigure the network access. Do this as follows:

Click OK to close the error popup. The Diagnose Failure window is opened.
Click Quit to close the wizard.

Restart either an interactive or a silent installation from the failed step by rerunning the installation program, adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step. Proceed as follows:

Double-click the failed installation step and the Step Status window opens.
On the Status tab set the status to Ready
Click Apply. The Step List window is displayed again.
Click Run all to restart the installation from that step.

If the problem persists contact the Software Support for assistance.

AWSJZI057E

The supplied "TWSUser" could not be created.

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you are running the silent wizard, see the installation log file for the error messages that might explain why the user cannot be created.

The probable cause is that in correcting a failed installation using the step restart facility, the <TWSUser> ID was changed to a non-valid ID. This is because the ID was checked for validity at input, and you would not have been able to start the installation if the user ID was not valid.

The reason why the ID has now been rejected could be one of the following:

The user performing the installation does not have the rights to create a user
The supplied user name does not satisfy the requirements of the local account policy
The supplied password of the <TWSUser> does not satisfy the requirements of the local security policy
The Windows account management administration wizard is open

Correct any errors you find.

You might be able to restart the step, or you might have to rerun the installation from the beginning.

- Interactive wizard

Restart the step of the interactive wizard

On the Properties tab change the <TWSUser> ID. If it is not available for editing, return to previous steps, until you find one where you can edit the value or values.
Repeat this step for all other steps, checking to see if the user account is included as a property for that step, and changing it if it is. This is because the installation wizard creates each step as a separate action, complete with its properties; changing a value on one does not change it automatically also on the others.
On the Status tab set the status to Ready
Click Apply. The Step List window is displayed.
Click Run all to restart the installation from that step.

If the problem is not resolved, try exiting from the wizard and recommencing the installation, as follows.

Rerun the interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the wizard.

- Silent wizard

Restart the step of the silent wizard

You cannot troubleshoot a failed installation with the silent wizard. Instead, do as follows:

Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Follow the procedure described for the interactive wizard to correct the user ID and restart the installation.

If this does not resolve the problem, try rerunning the silent wizard, as follows.

Rerun the silent wizard.

If you have copied the installation images to the local hard disk or to a remote workstation, ensure that the entire disk image was copied, and that the binary option was set if ftp was used.
Rerun the silent wizard.

If the problem persists contact the Software Support for assistance.

AWSJZI058W

The supplied "TWSUser" exists on the local computer but does not have the correct rights. The installation is attempting to modify the rights.

See message.

The wizard continues. When the installation starts, the wizard will attempt to modify the rights of the <TWSUser>.

None.

AWSJZI060E

The supplied password is incorrect for the supplied "TWSUser".

You have specified an existing user but the supplied password is not correct for that user.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Supply a different password or a different user ID and password.

Proceed as follows:

- Interactive wizard

Click OK to close the error popup window.
Either change the <TWSUser>, or its password, (or both) so that the correct password is supplied for the user.
Click Next to continue.

- Silent wizard

Look in the installation log to see if there is any additional information
Edit the response file used by the silent wizard, changing the <TWSUser>, or its password, (or both), so that the correct password is supplied for the user.
Rerun the wizard.

AWSJZI061E

The supplied"TWSUser" account cannot be verified automatically. This is because the user running the installation program does not have the "Act as part of the operating system" privilege, or the password of the user has expired.

The user running an installation on Windows 2000 (but not on Windows XP and later) requires the "Act as part of the operating system" privilege. The check for this privilege also fails if the password has expired, whether or not the account has the privilege.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Add the privileges to the account of the user running the installation, renew the password, or rerun the installation as a different user. If you change the account on the computer you must reboot the computer. Thus, in all cases, if you are running the interactive wizard you must stop it, as follows:

Click OK to close the error popup window.
Click Cancel to exit from the installation.

Change the account or its password, or log off and on again using a different user that has the correct privileges or whose password has not expired.

Rerun the wizard from scratch.

Note:This message might also be given when the Create User step is run. This only occurs if, between the time that the wizard validates the input values for the user ID and password, and the time it runs the Create User step, any changes are made to the user ID or its password, either on the computer or in the step properties dialogs as a result of a failed installation. This is unlikely to occur, but if it does you must rerun the installation.

AWSJZI062E

The user running the installation does not have the correct privileges to verify the privileges of the supplied "TWSUser".

The installation program has verified that either the "Act as part of the operating system" privilege is not required, or is present in the profile of the user running the installation, but the attempt to verify the <TWSUser> has failed for another reason associated with privileges. It might be that the user does not have the Windows default Administrator privileges.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Add the Windows default Administrator privileges to the account of the user running the installation, or rerun the installation as a different user. If you change the account on the computer you must reboot the computer. Thus, in either case, if you are running the interactive wizard you must stop it, as follows:

Click OK to close the error popup window.
Click Cancel to exit from the installation.

Change the account, or log off and on again using a different user that has the correct privileges.

Rerun the wizard from scratch.

Note:This message might also be given when the Create User step is run. This only occurs if, between the time that the wizard validates the input values for the user ID, and the time it runs the Create User step, any changes are made to the user ID, either on the computer or in the step properties dialogs as a result of a failed installation. This is unlikely to occur, but if it does you must rerun the installation.

AWSJZI063E

The installation was unable to check the existence of the supplied "TWSUser".

The user running the installation has the correct privileges to verify the existence of the <TWSUser>, but a problem associated with the user ID or password has prevented it from doing so. It is possible that the user name or password you supplied contained special characters or characters that do not belong to the codeset of the computer. It is possible that the account management facilities of the computer are in use, not working or are blocked in some other way.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Ensure the following:

Ensure that the <TWSUser> ID and password do not contain any unusual characters that might give codeset translation problems
Ensure that the user account management facilities on the computer are not in use by you or any other user
Ensure that the user account management facilities are available and working. To do this, attempt to access the details of a user account, but be sure to close the account management facilities window when you have finished

If you have found and fixed a problem with the account management facilities you can continue the installation. Otherwise, close the installation and rerun it as a different user

- Interactive wizard

Continue the installation

Click OK to close the error popup window.
Click Next to continue.

Rerun the installation

Click OK to close the error popup window.
Click Cancel to quit the installation.
Log on as a different user.
Rerun the wizard.

- Silent wizard

Just rerun the wizard in either case.

Note:This message might also be given when the Create User step is run. This only occurs if, between the time that the wizard validates the input values for the user ID, and the time it runs the Create User step, any changes are made to the user ID, either on the computer or in the step properties dialogs as a result of a failed installation. This is unlikely to occur, but if it does you must rerun the installation.

AWSJZI064E

The installation could not modify the privileges of the supplied "TWSUser".

You have supplied a <TWSUser> that exists on the local computer but has insufficient rights. The installation has tried to modify those rights but cannot. Probably, the user that is running the installation does not have the correct rights to modify the supplied user's rights.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Add the Windows default Administrator privileges to the account of the user running the installation, or rerun the installation as a different user. If you change the account on the computer you must reboot the computer. Thus, in either case, if you are running the interactive wizard you must stop it, as follows:

Click OK to close the error popup window.
Click Cancel to exit from the installation.

Change the account, or log off and on again using a different user that has the correct privileges.

Rerun the wizard from scratch.

Note:This message might also be given when the Create User step is run. This only occurs if, between the time that the wizard validates the input values for the user ID, and the time it runs the Create User step, any changes are made to the user ID, either on the computer or in the step properties dialogs as a result of a failed installation. This is unlikely to occur, but if it does you must rerun the installation.

AWSJZI065E

The installation could not add the supplied "TWSUser" to the "Administrators" group.

You have supplied a <TWSUser> ID that did not exist on the computer and the installation has created an account for it. However, it could not add the account to the "Administrators" group. Probably, the user that you are using to run the installation does not have the correct privileges to add a user to that group.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Add the Windows default Administrator privileges to the account of the user running the installation, or rerun the installation as a different user. If you change the account on the computer you must reboot the computer. Thus, in either case, if you are running the interactive wizard you must stop it, as follows:

Click OK to close the error popup window.
Click Cancel to exit from the installation.

Change the account, or log off and on again using a different user that has the correct privileges.

Rerun the wizard from scratch.

Note:This message might also be given when the Create User step is run. This only occurs if, between the time that the wizard validates the input values for the user ID, and the time it runs the Create User step, any changes are made to the user ID, either on the computer or in the step properties dialogs as a result of a failed installation. This is unlikely to occur, but if it does you must rerun the installation.

AWSJZI066E

The installation could not find an operating system dll to complete the "TWSUser" verification tasks.

The installation needs to use a standard operating system dynamic link library (dll) to complete its task of verifying, and if necessary creating, the supplied user.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Verify that the PATH system variable points to the location of all the operating system dlls, and that the dlls are present (your operating system documentation might identify which dlls are responsible for user account verification). Depending on what you find, you might need to reinstall the operating system before continuing with the installation. Verify also that the user running the installation has execute permission for operating system dlls.

Whatever the solution to the problem, you must rerun the wizard. If you are running the interactive wizard you need to stop the installation program. Do this as follows:

Click OK to close the error popup.
Click Cancel to close the wizard.

Rerun the wizard from scratch.

Note:This message might also be given when the Create User step is run. This only occurs if, between the time that the wizard validates the input values for the user ID, and the time it runs the Create User step, any changes are made to the dlls. This is unlikely to occur, but if it does you must rerun the installation.

AWSJZI067E

The supplied "TWSUser" could not be created.

You have supplied a <TWSUser> ID that did not exist on the computer but the installation has not been able to create it.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

If you are running the interactive wizard, look at the Output tab on the failed installation step for further information. Do the following:

Note down the error code (so that you can later find it in the Planning and Installation Guide, if needed)
Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Select the failed installation step and double click it to open the Step Status window.
Select the Output tab.

If you are running the silent wizard, see the installation log file for the error messages that might explain why the user cannot be created.

Ensure the following:

Ensure that the <TWSUser> ID and password respect local security policy
Ensure that the user running the installation has the rights to create a user. Remember to close the account management facilities before proceeding. If it does not, add those rights, or run the installation using a user that has those rights.

The problem resolution depends on what you found:

- Problems with an existing <TWSUser> ID or password

Supply a different <TWSUser> ID and password. As everything in the installation relates to this user, you must rerun the installation, supplying the new <TWSUser> ID.

Proceed as follows:

Interactive wizard

Click OK to close the error popup window.
Click Quit to exit from the installation.
Rerun the installation, supplying a different <TWSUser> ID and password.

Silent wizard

Edit the response file used by the silent wizard, changing the <TWSUser> and its password.
Rerun the wizard.

- Problems with the password supplied for a <TWSUser> that is being created

Supply a different password.

Proceed as follows:

- Interactive wizard

Click OK to close the error popup window. The Diagnose Failure window is opened.
Select Diagnose failure and click Next. The Step List window is opened.
Double-click the failed installation step and the Step Status window opens.
On the Properties tab change the <TWSUser> password. If it is not available for editing, return to previous steps, until you find one where you can edit the value or values.
Repeat this step for all other steps, checking to see if the password is included as a property for that step, and changing it if it is. This is because the installation wizard creates each step as a separate action, complete with its properties; changing a value on one does not change it automatically also on the others.
On the Status tab set the status to Ready
Click Apply. The Step List window is displayed.
Click Run all to restart the installation from that step.

- Silent wizard

Edit the response file used by the silent wizard, changing the <TWSUser> password.
Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Follow the procedure described for the interactive wizard to correct the user ID and restart the installation.

- Problems with the user privileges

Choose one of these options:

Rerun with a different user

If you are running the interactive wizard you need to stop the installation program . Do this as follows:
1. Click OK to close the error popup. The Diagnose Failure window is opened.
2. Click Quit to close the wizard.
Log on as a different user with the Windows default Administrator privileges.
Rerun the installation without a restart. You cannot do a step restart of an installation if you have changed the user that is running it; you must rerun the installation from scratch.

Add the missing privileges to your user profile

If you are running the interactive wizard you need to stop the installation program . Do this as follows:
1. Click OK to close the error popup. The Diagnose Failure window is opened.
2. Click Quit to close the wizard.
Add the necessary privileges to the profile of the user running the installation, so that it has the default Administrator privileges (you might need to log on as an Administrator to do this).
Reboot the computer.
Restart the installation adding the parameter -resume. The wizard restarts in interactive mode at the Step List window showing the failed step.
Double-click the failed installation step and the Step Status window opens.
On the Status tab set the status to Ready
Click Apply. The Step List window is displayed again.
Click Run all to restart the installation from that step.

AWSJZI068E

The supplied "TWSUser" name incorrectly contains a period.

This message indicates that during the recovery operation of a previously failed installation, you modified the <TWSUser> name and included a period in the name. The <TWSUser ID> was validated on input, and the presence of a period would not have allowed the installation to go ahead.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

You must rerun the wizard, reinputting the <TWSUser ID> as follows:

- Interactive wizard

Click OK to close the error popup window.
Click Quit to exit from the installation.
Rerun the installation, resupplying the <TWSUser> ID and password.

- Silent wizard

Rerun the wizard.

AWSJZI069E

The supplied "TWSUser" ID is longer than the maximum length of maximum_length bytes.

See message.

maximum_length is the maximum permitted length in bytes of the "TWSUser" ID.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Proceed as follows:

- Interactive wizard

Click OK to close the error popup window.
Click Back to return to the previous panel and change the TWSUser to a value no longer than the maximum length.
Click Next to continue.

- Silent wizard

Edit the response file used by the silent wizard, changing the TWSUser to a value no longer than the maximum length.
Rerun the wizard.

AWSJZI070E

The supplied "TWSUser" "TWSUser_name" does not exist on the local computer, but the installation cannot create this user, because another object exists with the supplied name.

You have supplied a user name that does not exist. The installation has tried to create a user with the supplied name, but has found another object exists (such as a domain or a user group) with the supplied name.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Choose a different user ID that does not exist on this computer in any form and rerun the installation without a restart. You cannot do a step restart of an installation if you have changed the <TWSUser>, you must rerun the installation from scratch.

Interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
Rerun the wizard.

Silent wizard.

Rerun the silent wizard.

AWSJZI071E

The supplied "TWSUser" name incorrectly contains a period.

This message indicates that during the recovery operation of a previously failed installation, you modified the <TWSUser> name and included a period in the name. The <TWSUser ID> was validated on input, and the presence of a period would not have allowed the installation to go ahead.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

You must rerun the wizard, reinputting the <TWSUser ID> as follows:

- Interactive wizard

Click OK to close the error popup window.
Click Quit to exit from the installation.
Rerun the installation, resupplying the <TWSUser> ID and password.

- Silent wizard

Rerun the wizard.

AWSJZI072E

The supplied "TWSUser" does not exist. On UNIX platforms the user chosen for the "TWSUser" must exist with the correct permissions before starting the installation program.

See message text.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Choose an existing user or create an account expressly for the installation. You must rerun the wizard, changing the <TWSUser ID> as follows:

- Interactive wizard

Click OK to close the error popup window.
Click Quit to exit from the installation.
Rerun the installation, supplying a different <TWSUser> ID and its password.

- Silent wizard

Edit the response file, changing the <TWSUser ID> and its password.
Rerun the wizard.

AWSJZI073E

The supplied port: "port_number" is already in use.

See message.

port_number identifies the port that is already in use.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Supply a different port that is not in use.

Proceed as follows:

- Interactive wizard

Click OK to close the error popup window.
Change the port.
Click Next to continue.

- Silent wizard

Edit the response file used by the silent wizard, changing the value of the indicated port.
Rerun the wizard.

AWSJZI074E

The user running the installation is not in the "Administrator" group, or does not have Administrator rights.

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

The user performing the installation must be both in the "Administrator" group, and have Administrator rights. Either choose a different Administrator user, or modify the rights, and the group, (or both), of the user performing the installation. In the latter case you might have to reboot the computer. In either case rerun the installation.

- Interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
Log on as a user in the "Administrator" group, and with Administrator rights.
Rerun the wizard.

- Silent wizard.

Log on as a user in the "Administrator" group, and with Administrator rights.
Rerun the silent wizard.

AWSJZI075E

The user running the installation is not "root".

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

The user performing the installation must be "root". Rerun the installation as "root".

- Interactive wizard

Close the Step Status window
Select Quit installation. The wizard closes.
Log on as root.
Rerun the wizard.

- Silent wizard.

Logon as root.
Rerun the silent wizard.

AWSJZI076E

The supplied ports are not unique. Specify a different value for each port.

See message.

port_number identifies the port that is already in use.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Check the port numbers you have used. Make sure that a unique value has been supplied for each port and that the supplied ports are available.

Proceed as follows:

- Interactive wizard

Click OK to close the error popup window.
Change the port or ports.
Click Next to continue.

- Silent wizard

Edit the response file used by the silent wizard, changing the value of the indicated port or ports.
Rerun the wizard.

AWSJZI077E

The directory "directory" cannot be created.

See message.

directory identifies the directory that cannot be created.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Ensure the following in the path indicated:

Ensure that the directory does not already exist.
Ensure that there is sufficient space in the file set for the installation.
Ensure that the user running the installation has write permission for that path.
Ensure that the directory name is allowed in the system.

When you have located the problem, fix it either by making it possible to use the chosen directory, or by deciding to use a different directory, depending on the nature of the problem.

Proceed as follows:

- Interactive wizard

Click OK to close the error popup window.
If you have decided to use a different directory, change it on the wizard panel.
Click Next to continue.

- Silent wizard

If you have decided to use a different directory, edit the response file used by the silent wizard, changing the value of the directory.
Rerun the wizard.

AWSJZI078E

The directory "directory" does not have write permission.

See message.

directory identifies the directory that does not have write permission for the user running the installation.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Either give write permission in the directory to the user running the installation, or decide to choose a different directory.

Proceed as follows:

- Interactive wizard

Click OK to close the error popup window.
If you have decided to use a different directory, change it on the wizard panel.
Click Next to continue.

- Silent wizard

If you have decided to use a different directory, edit the response file used by the silent wizard, changing the value of the directory.
Rerun the wizard.

AWSJZI079E

The following fields "field1" and "field2" cannot contain the same value.

See message.

field1 and field2 identify two fields that cannot have the same value.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Change one or both of the fields so that they are unique.

Proceed as follows:

- Interactive wizard

Click OK to close the error popup window.
Change one or both of the fields on the wizard panel.
Click Next to continue.

- Silent wizard

Edit the response file used by the silent wizard, changing one or both of the fields.
Rerun the wizard.

AWSJZI080E

The directory "directory" is not a valid directory.

See message.

directory is the directory path you have supplied, which is not a valid directory.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Choose a different directory.

Proceed as follows:

- Interactive wizard

Click OK to close the error popup window.
Change the directory on the wizard panel.
Click Next to continue.

- Silent wizard

Edit the response file used by the silent wizard, changing the value of the directory.
Rerun the wizard.

AWSJZI082E

An error occurred while stopping the embedded WebSphere Application Server.

See message.

The uninstallation stops.

Check that the credentials supplied for accessing the embedded WebSphere Application Server are correct. If they are not, correct them and retry the uninstallation.

If the credentials are correct, stop the embedded WebSphere Application Server by using the appropriate command, and retry the operation.

AWSJZI085E

The uninstall wizard could not find any instances of the HCL Workload Automation for Z connector on this computer to uninstall.

See message. It is possible that the HCL Workload Automation for Z connector was not installed correctly, or has already been uninstalled.

The uninstallation stops.

Determine the original installation directory (the Planning and Installation Guide indicates the default directory) and check if it is present. If the installation directory is present on the computer, and contains data, the HCL Workload Automation for Z connector was not installed correctly. In this case, see the Planning and Installation for instructions on uninstalling the connector manually.

If the installation directory is not present, or contains no data, the HCL Workload Automation for Z connector has been uninstalled without removing the uninstaller. Locate the uninstaller and delete it.

AWSJZI090E

An internal error has occurred. A program has failed unexpectedly.

See message.

The installation stops.

Contact the Software Support.

AWSJZI091E

The installation cannot rename the file "file".

See message.

file identifies the file that could not be renamed.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Check that the user running the installation has permission to rename a file at that location. If not, change the user permissions or choose to rerun the installation from a different user. In either case you might need to exit from the installation (for example if you need to reboot your computer after changing user permissions), and rerun it from scratch.

Proceed as follows:

If you are running the interactive wizard, click OK to close the error popup window. Then click Cancel to exit from the wizard.
Either log on as a different user or change the user permissions.
Rerun the wizard, interactively or silently, with a different user.

If the problem persists, contact the Software Support for assistance.

AWSJZI093E

The installation cannot read the file "installation_program_files_list_file" that contains the names of the installation programs.

The installation needs to access and read a file containing a list of the installation program files. If it cannot be read, it might have been damaged in copying it to the hard disk.

installation_program_files_list_file is the name of the file that contains a list of the installation program files.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Check if the file exists. If it does not, or it seems to have been edited or damaged, you could attempt to replace it from the version on the product CD, after which you can continue the installation. However, if this file is missing or damaged, it is likely that other files are missing or damaged, as well. In this case you must rerun the installation, either directly from the CD, or by copying the installation files from the CD to hard disk again, ensuring that you use the binary option if the copy mode is ftp.

Proceed as follows:

If you are running the interactive wizard, click OK to close the error popup window. Than click Cancel to quit the wizard.
Rerun the wizard, interactively or silently.

If the problem persists, contact the Software Support for assistance.

AWSJZI094E

The installation was unable to access one or more Windows processes.

You are probably running the installation with a Windows system management application open. Possible applications which must be closed include: Task Manager, Services, Computer Management, and RegEdit.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Verify if the Windows Task Manager, Services, Computer Management, RegEdit or other system management processes are running. If so, close it or them and continue the installation. If none appear to be open, reboot the workstation and rerun the installation.

The following describes how to continue or to rerun the installation:

- Continue the installation

If you are running the interactive wizard, click OK to close the error popup, and click Next to continue.
If you were running the silent wizard, rerun the wizard.

- Rerun the installation

If you are running the interactive wizard, click OK to close the error popup window.
Reboot the computer.
Rerun the wizard, interactively or silently, with a different user.

AWSJZI095E

The installation cannot start the process "process_name".

The file containing the process might be missing or corrupt.

process_name identifies the process that cannot be run.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

If you are not running the installation from the original CD, delete the copy you have made of the installation directories and recopy the files from the original CD. If you have ftp'd the install files to the local computer, ensure that you specified the binary option. Now rerun the installation.

Proceed as follows:

If you are running the interactive wizard, click OK to close the error popup window. Than click Cancel to quit the wizard.
Rerun the wizard, interactively or silently.

If the problem persists, contact the Software Support for assistance.

AWSJZI096E

Either the "userdata" or the "userdata.KEY" file, required for the migration of the user information, was not found in the HCL Workload Automation instance to be upgraded.

In order to import the passwords of the users of the previous version, the upgrade needs to directly access the userdata and userdata.KEY files, which form part of the Mozart database of the instance being upgraded.

One, other, or both of these files could not be found.

These files are required for the correct running of the previous instance of HCL Workload Automation.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Check for the existence of these files in the previous instance of HCL Workload Automation. Ensure that the user running the installation has read access to them. If the files have been moved, renamed, or deleted, recover them from a backup of the previous HCL Workload Automation instance, and use the facilities in the instance to check that the data in them is complete.

When you have fixed the problem, continue the installation as follows:

If you are running the interactive wizard, click OK to close the error popup, and click Next to continue.
If you were running the silent wizard, rerun the wizard.

AWSJZI097W

The default port default_port used by the application server embedded in the instance of HCL Workload Automation for Z connector is already in use. Click "Next" and supply a different, available, port number.

See message.default_port is the default port used by the application server embedded in the instance of HCL Workload Automation for Z connector, which is not free.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Proceed as follows:

Interactive wizard

Click OK to close the error popup window.
Click Next.
Change the indicated port number on the wizard panel to a value that is not in use.
Click Next to continue.

Silent wizard

Edit the response file used by the silent wizard. Change the indicated port number from the default value to a value that is not in use.
Rerun the wizard.

AWSJZI098E

You have specified a "TWSUser" that already exists in the registry file "TWSZOSConnRegistry.dat" but an instance of HCL Workload Automation for Z connector has not been found.

See message.

The registry file TWSZOSConnRegistry.dat might not be updated. Possibly a previous uninstallation of the instance did not correctly delete the references to a previous instance of the HCL Workload Automation for Z connector in the registry file.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Check that an installation of the HCL Workload Automation for Z connector is present in the installation path. To determine the installation path in which the wizard could not find an installed instance, check the record for the <TWSUser> in the TWSZOSConnRegistry.dat file.

If the instance is not present, remove the entries for the selected user from the registry file. If it is, check that the path registered for the indicated user is correct, changing the path in the registry if it is not.

In the latter case, run the uninstallation again. Otherwise, the uninstallation is not needed.

If the problem persists, contact the Software Support for assistance.

AWSJZI099E

An instance of the HCL Workload Automation for Z connector, version 8.6 has not been found in the following path: installation_path.

The uninstallation process cannot find an instance of the HCL Workload Automation for Z connector in the path where is supposed to be installed, according to the information in the TWSZOSConnRegistry.dat registry file. It might have already been uninstalled or removed manually.

If you are running the interactive uninstallation, the wizard stops.

If you are running the silent uninstallation, the wizard fails.

Check whether an installation of the HCL Workload Automation for Z connector is present in the installation path. If it is not, remove the entries for the <TWSUser> from the registry file. If it is, repeat the uninstallation.

If the problem persists, contact the Software Support for assistance.

AWSJZI100E

The uninstall wizard could not find any instances of HCL Workload Automation for Z connector version 8.6 on this computer to uninstall.

See message. It is possible that HCL Workload Automation for Z connector was not installed correctly, or has already been uninstalled.

The uninstallation stops.

Determine the original installation directory (the Planning and Installation Guide indicates the default directory) and check if it is present. If the installation directory is present on the computer, and contains data, HCL Workload Automation for Z connector was not installed correctly. In this case, see Administration and Troubleshooting for instructions on uninstalling HCL Workload Automation for Z connector manually.

If the installation directory is not present, or contains no data, HCL Workload Automation for Z connector has been uninstalled without removing the uninstaller. Locate the uninstaller and delete it.

AWSJZI119W

The specified user is a domain user. Check that it has the required rights. See "Planning and Installation Guide" for details.

A domain user must have the following rights:

- On a computer that is a member of a domain

Only a domain user can start the application server process. It must have the following characteristics:

It is a member of the domain administrative groups in the domain controller
It has the "Act as part of the operating system" privilege in the Domain Security Policy on the domain controller
It has the "Act as part of the operating system" privilege in the Local Security Policy on the local computer
If the server is run as a service, it has the "Log on as a service" privilege on the local computer.

- On a computer that is a domain controller

It must have the following characteristics:

It is a member of the domain administrative groups in the domain controller
It has the "Act as part of the operating system" privilege in the Domain Security Policy on the domain controller
If the server is run as a service, it has the "Log on as a service" privilege on the domain controller

The installation panel flow waits for you to continue.

Check the rights of the domain user and click Next to continue.

AWSJZI125E

There is insufficient disk space available in the temporary directory "directory" to complete the installation. The installation requires required_space megabytes, but only available_space megabytes are available. Make more space available in the temporary installation directory.

See message.

directory is the temporary directory that has insufficient space.

required_space and available_space indicate how much space the installation requires and how much is available.

If you are running the interactive wizard, the wizard stops.

If you are running the silent installation, the installation fails.

Make space in the temporary directory. Or, on Windows systems, you can change the location of the temporary directory, by temporarily or permanently changing the value of the TMP environment variable.

Proceed as follows:

If you are running the interactive wizard, click OK to close the error pop-up window, and click Next to continue.
If you are running the silent installation, run the installation again.

AWSJZI128E

You have specified as the "TWSUser" a user that already owns an existing instance of HCL Workload Automation for Z connector. Click "Back" and specify a different user for the "TWSUser".

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Proceed as follows:

Interactive wizard

Click OK to close the error popup window.
Change the <TWSUser> ID on the wizard panel to a value that does not own an existing instance.
Click Next to continue.

Silent wizard

Edit the response file used by the silent wizard. Change the <TWSUser> ID to a value that does not own an existing instance.
Rerun the wizard.

AWSJZI129E

The field "field_name" is required.

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Proceed as follows:

Interactive wizard

Click OK to close the error popup window.
Provide a valid value for the indicated field.
Click Next to continue.

Silent wizard

Edit the response file used by the silent wizard. Provide a valid value for the indicated field.
Rerun the wizard.

AWSJZI131E

The character "character" is not valid.

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Proceed as follows:

Interactive wizard

Click OK to close the error popup window.
Change the indicated character to a valid one.
Click Next to continue.

Silent wizard

Edit the response file used by the silent wizard. Change the indicated character to a valid one.
Rerun the wizard.

AWSJZI132E

The field "field_name" must not contain blank characters.

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Proceed as follows:

Interactive wizard

Click OK to close the error popup window.
Remove the blank characters in the indicated field.
Click Next to continue.

Silent wizard

Edit the response file used by the silent wizard. Remove the blank characters in the indicated field.
Rerun the wizard.

AWSJZI133E

You have specified as the "TWSUser" a user that does not own an existing instance of HCL Workload Automation for Z connector. Click "Back" and specify a different user for the "TWSUser".

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Proceed as follows:

Interactive wizard

Click OK to close the error popup window.
Change the <TWSUser> ID on the wizard panel to that of a user who owns an existing instance of HCL Workload Automation for Z connector.
Click Next to continue.

Silent wizard

Edit the response file used by the silent wizard. Change the <TWSUser> ID to that of a user who owns an existing instance of HCL Workload Automation for Z connector.
Rerun the wizard.

AWSJZI134E

There is insufficient disk space available in the directory "directory" to complete the installation. The installation requires required_space megabytes, but only available_space megabytes are available. Either make more space available or change the instance of HCL Workload Automation for Z connector to which to apply the fix pack.

See message.

directory is the install directory that has insufficient space.

required_space and available_space indicate what space the installation requires and how much is available.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

- Make space in the original path

If you want to persist with the original installation path, use the operating system's commands and utilities to make more space available. When you have done this, proceed as follows:

Interactive wizard

Click OK to close the error popup.
Click Next to continue.

Silent wizard

Rerun the wizard.

- Choose another directory

If you cannot make sufficient space, you must change the installation path to one with sufficient available space. To do this, proceed as follows:

Interactive wizard

Click OK to close the error popup.
Re-enter the installation path, ensuring that the path is fully qualified and valid, and points to a directory with sufficient space. Click Next to continue.

Silent wizard

Edit the response file, and ensure that the installation path is fully qualified and valid, and points to a directory with sufficient space.
Rerun the wizard.

Proceed as follows:

AWSJZI135E

The fix pack cannot be applied to the selected instance because the instance is not at 8.6 level.

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent wizard, the wizard fails.

Check the level of the fix pack. Make sure you are applying the correct fix pack (a fix pack can only be applied to a product instance at a lower level).

If you are running the interactive wizard, click Cancel to exit from the wizard.
If you are running the silent wizard, the wizard has already stopped.

If you have tried to reapply a fix pack that has already been installed, or are trying to apply a fix pack that has never been installed on an instance which is at a higher level, take no further action.

Otherwise there may be a problem with the product registry, and you must contact the Software Support.

AWSJZI136E

The supplied password for the user "user" that the wizard must create does not match the security policy of the computer on which you are performing the installation.

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent installation, the installation fails.

Check the security policy on the computer where you are performing the installation.

Proceed as follows:

Interactive wizard

Click Back to return to the panel where you supplied the indicated user and password.
Change the password to one that matches the security policy and confirm it.
Click Next to continue.

Silent installation

Edit the response file used by the silent installation. Change the password for the indicated user to one that matches the security policy.
Run the silent installation again.

AWSJZI137E

There is not enough space in the directory "directory_name". The required space is required_space MB. The available space is available_space MB.

See message.

directory_name identifies the directory with insufficient space.

required_space and available_space tell you how much space is needed and how much is available.

If you are running the interactive wizard, the wizard stops

If you are running the silent installation, the installation fails.

Either make more space in the indicated directory or select a different directory.

Then proceed as follows:

Interactive wizard

Click OK to close the error pop-up window.
If you choose to select a different directory, enter the name of, or browse for, a directory with sufficient space.
Click Next to continue.

Silent installation

If you choose to select a different directory, edit the response file used by the silent installation and change the installation directory to one with sufficient space.
Run the silent installation again.

AWSJZI150E

The specified user does not exist.

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent installation, the installation fails.

Proceed as follows:

Interactive wizard

Click OK to close the error pop-up window.
Change the user name to a valid one.
Click Next to continue.

Silent installation

Edit the response file used by the silent installation. Change the user name to a valid one.
Run the silent installation again.

AWSJZI161E

The field "field" with value "value" contains national characters. National characters are not supported for this field.

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent installation, the installation fails.

Proceed as follows:

Interactive wizard

Click OK to close the error pop-up window.
Click Cancel to exit the wizard.

Silent installation

Edit the response file used by the silent installation. Change the field value to a valid one.
Run the silent installation again.

AWSJZI162E

The supplied password contains an unsupported character. The supported characters are as follows: characters

See message.

characters identifies the list of supported characters.

If you are running the interactive wizard, the wizard stops.

If you are running the silent installation, the installation fails.

Change the password of the specified user.

Proceed as follows:

- Interactive wizard

Click OK to close the error message window.
Modify the operating system password of the specified user.
Click Next to continue.

- Silent installation

Change the operating system password of the specified user
Edit the response file used by the silent installation and change the corresponding password field to match the operating system password.
Run the silent installation again.

AWSJZI163E

The supplied installation path is already being used by another instance of HCL Workload Automation. Choose another path.

A HCL Workload Automation instance can only have one instance of each of its constituent products and components installed in it. To install another instance of a product or component, install it in a different path, thereby creating a second instance of HCL Workload Automation.

For example, if you installed the HCL Workload Automation master domain manager with the default path, it will have been installed in a path that includes the token "TWA", which indicates that this is the first instance of a HCL Workload Automation product or component on the system. To install a second HCL Workload Automation component, choose a path that is not the same as, or within, the path of the first instance. Note that if the default path includes the token"TWA1", there are already two instances of HCL Workload Automation on the system on which you are trying to install the component. To install a third HCL Workload Automation component, choose any path that is not the same as, or within, the paths of the first two instances.

If you are running the interactive wizard, the wizard stops.

If you are running the silent installation, the installation fails.

Proceed as follows:

- Interactive wizard

Click OK to close the error message window.
Enter the installation path again, ensuring that the path is not that of an existing HCL Workload Automation instance, and click Next to continue.

- Silent installation

Edit the response file and ensure that the path is not that of an existing HCL Workload Automation instance.
Run the silent installation again.

AWSJZI164E

No valid instance of HCL Workload Automation for Z connector was found to upgrade. Select a valid instance or make a fresh installation.

Either no instance of HCL Workload Automation for Z connector was found at the indicated location, or the instance found is not at the correct version. Only version 8.3 and version 8.5 can be upgraded to version 8.6

If you are running the interactive wizard, the wizard stops.

If you are running the silent installation, the installation fails.

Proceed as follows:

- Interactive wizard

Click OK to close the error message window.
Click Back to return to the previous panel and change the HCL Workload Automation for Z connector instance definition to identify an instance of version 8.3 or version 8.5, or choose to make a fresh installation.
Click Next to continue.

- Silent installation

Look in the installation log to see if there is any additional information
Edit the response file used by the silent installation, changing the parameter that identifies the existing HCL Workload Automation for Z connector instance to an instance of version 8.3 or version 8.5, or choosing to make a fresh installation.
Run the silent installation again.

AWSJZI165E

No valid instance of HCL Workload Automation was specified. Specify a valid instance or install the component in a new instance.

A HCL Workload Automation instance can have only one instance of each of its constituent products and components installed in it. To install another instance of a product or component, install it in a different path, thereby creating a second instance of HCL Workload Automation.

For example, if you installed the HCL Workload Automation master domain manager with the default path, it will have been installed in a path that includes the token "TWA", which indicates that this is the first instance of a HCL Workload Automation product or component on the system. To install a second HCL Workload Automation component, choose a path that is not the same as, or within, the path of the first instance. Note that if the default path includes the token "TWA1", there are already two instances of HCL Workload Automation on the system on which you are trying to install the component. To install a third HCL Workload Automation component, choose a path that is not the same as, or within, the paths of the first two instances.

The silent installation fails.

Proceed as follows:

Edit the response file and ensure that the path does not identify an existing HCL Workload Automation instance.
Run the silent installation again.

AWSJZI166E

No valid action can be performed on the HCL Workload Automation instance that has been selected. Select another valid instance in which to install the product or component, or create a new instance.

A HCL Workload Automation instance can have only one instance of each of its constituent products and components installed in it. To install another instance of a product or component, install it in a different path, thereby creating a second instance of HCL Workload Automation.

For example, if installed the HCL Workload Automation master domain manager with the default path, it will have been installed in a path that includes the token "TWA", which indicates that this is the first instance of a HCL Workload Automation product or component on the system. To install a second HCL Workload Automation component, choose a path that is not the same as, or within, the path of the first instance. Note that if the default path includes the token"TWA1", there are already two instances of HCL Workload Automation on the system on which you are trying to install the component. To install a third HCL Workload Automation component, choose a path that is not the same as, or within, the paths of the first two instances.

If you are running the interactive wizard, the wizard stops.

If you are running the silent installation, the installation fails.

Proceed as follows:

- Interactive wizard

Click OK to close the error pop-up window.
Enter the installation path again, ensuring that the path is not that of an existing HCL Workload Automation instance. Click Next to continue.

- Silent installation

Edit the response file and ensure that the installation path is not that of an existing HCL Workload Automation instance.
Run the silent installation again.

AWSJZI167E

The embedded WebSphere Application Server user was not retrieved. Insert it manually.

You clicked the Retrieve button to retrieve the embedded WebSphere Application Server administration user name. The wizard was unable to retrieve the user name either because the user registry solution you chose does not allow user names to be kept in the embedded WebSphere Application Server configuration files, or because the embedded WebSphere Application Server did not respond correctly.

If the user registry solution you chose does not allow user names to be kept in the embedded WebSphere Application Server configuration files, the administration user field in the wizard is defaulted as "UNKNOWN". Otherwise, the administration user field is left blank.

Obtain the embedded WebSphere Application Server administration user name from the embedded WebSphere Application Server administrator or the person responsible for maintaining the embedded WebSphere Application Server. Enter the value in the administration user field, enter the password, and continue.

AWSJZI168E

You cannot upgrade HCL Workload Automation for Z connector when it is installed in the root directory.

You selected to upgrade an instance of a HCL Workload Automation for Z connector component that is installed in the root directory. The upgrade cannot be performed, for technical reasons.

If you are running the interactive wizard, the wizard stops.

If you are running the silent installation, the installation fails.

Proceed as follows:

- Interactive wizard

Click OK to close the error pop-up window message.
Do one of the following:
- Choose a different instance to upgrade, and click Next to continue.
- Exit from the wizard and run a fresh installation in another directory. See the Planning and Installationfor details.

- Silent installation

Do one of the following:
- Choose a different instance to upgrade, edit the response file to identify it, and run the upgrade again.
- Exit from the silent installation and specify a directory different from the root directory. See the Installation Guide for details.

AWSJZI170E

An error occurred while restoring the z/OS engine connections.

See message.

The upgrade stops.

Try to run the step again. If it continues to fail, set it to success and continue the upgrade.

At the end of the upgrade, manually set the connections on the upgraded instance.

AWSJZI172E

An internal error has occurred. The security configuration for the embedded WebSphere Application Server could not be restored.

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent installation, the upgrade fails.

Proceed as follows:

Interactive wizard

Click OK to close the error pop-up window.
Set the step to Ready.
Run the installation again. If the installation fails, set the step to Ready and perform the following steps:
1. Edit the <backup_directory>/TWS/config/SecurityProperties.backup file.
2. In the activeAuthMechanism=SWAM properties, substitute SWAN with LTPA.
3. In all the properties containing passwords, substitute the asterisks with the actual values.
4. Run the changeSecurityProperties.sh (.bat) <backup_directory>/TWS/config/SecurityProperties.backup command.

Silent installation

You cannot troubleshoot a failed installation with the silent installation. Instead, do as follows:

Resume the installation adding the parameter -resume. The interactive wizard resumes in interactive mode at the Step List window showing the failed step.
Restart the step that failed. If the installation fails, set the step to Ready and perform the following steps:
1. Edit the <backup_directory>/TWS/config/SecurityProperties.backup file.
2. In the activeAuthMechanism=SWAM properties, substitute SWAN with LTPA.
3. In all the properties containing passwords, substitute the asterisks with the actual values.
4. Run the changeSecurityProperties.sh (.bat) <backup_directory>/TWS/config/SecurityProperties.backup command.

AWSJZI174E

An internal error has occurred. An internal error occurred during embedded WebSphere Application Server realm configuration.

See message.

If you are running the interactive wizard, the wizard stops.

If you are running the silent installation, the upgrade fails.

Proceed as follows:

Interactive wizard

Click OK to close the error pop-up window.
Verify that your security system is up and running.
- If your security system is working properly, set the step to Ready and click Next to continue.
- If your security system is not working properly, make your system work, set the step to Ready, and click Next to continue.

Silent installation

You cannot troubleshoot a failed installation with the silent installation. Instead, do as follows:

Resume the installation adding the parameter -resume. The interactive wizard resumes in interactive mode at the Step List window showing the failed step.
Verify that your security system is up and running.
- If your security system is working properly, set the step to Ready and click Next to continue.
- If your security system is not working properly, make your system work, set the step to Ready, and click Next to continue.

AWSJZI175E

No instance of a HCL Workload Automation for Z connector was found on this system to upgrade. The wizard closes when you close the message window.

You selected an upgrade action for an instance of HCL Workload Automation for Z connector, but the wizard cannot find any instance to upgrade

If you are running the interactive wizard, the wizard stops.

If you are running the silent installation, the installation fails.

Proceed as follows:

If you are running the interactive wizard, click OK to close the error message. The wizard closes.
If an instance of HCL Workload Automation for Z connector is installed on the system, the registry might be damaged and not be reporting the presence of the instance. Contact the Software Support for assistance.

AWSJZI176W

The upgrade process cannot upgrade the embedded WebSphere Application Server security to Federated Repository. If you do not enable the embedded WebSphere Application Server Federated Repository security mechanism on the HCL Workload Automation instance, you cannot install a Dynamic Workload Console on the same HCL Workload Automation instance. See the message help in the "Messages" manual, or the "Administration Guide", for details.

See message.

See message. The upgrade was performed successfully.

Enable the embedded WebSphere Application Server Federated Repository security mechanism on the HCL Workload Automation instance, if you want to install a Dynamic Workload Console on the same HCL Workload Automation instance. See the IBM® Workload Scheduler: Administration Guide, for details.

AWSJZI177E

The eImage on your workstation is corrupt. You must use the UNZIP command to extract the eImage otherwise your fix pack installation fails.

See message text.

The installation cannot proceed.

You must use the UNZIP command to extract the eImage otherwise your fix pack installation fails. For details see the HCL Workload Automation for Z connector readme for the fix pack you are installing.

Rerun the installation.

AWSJZI002 - AWSJZI177

AWSJZI002E

See also

AWSJZI008E

AWSJZI009E

AWSJZI010E

AWSJZI011E

AWSJZI012E

AWSJZI017E

See also

AWSJZI019E

See also

AWSJZI021E

See also

AWSJZI022E

See also

AWSJZI023E

See also

AWSJZI024E

See also

AWSJZI025E

See also

AWSJZI029E

See also

AWSJZI030E

See also

AWSJZI031E

See also

AWSJZI032E

See also

AWSJZI036W

AWSJZI038E

See also

AWSJZI041E

See also

AWSJZI042E

See also

AWSJZI043E

See also

AWSJZI044E

See also

AWSJZI045E

See also

AWSJZI046E

See also

AWSJZI047E

See also

AWSJZI048E

See also

AWSJZI049E

See also

AWSJZI050E

See also

AWSJZI051E

See also

AWSJZI052E

See also

AWSJZI053E

AWSJZI054E

AWSJZI055E

AWSJZI056E

See also

AWSJZI057E

AWSJZI058W

AWSJZI060E

See also

AWSJZI061E

See also

AWSJZI062E

See also

See also

AWSJZI063E

See also

AWSJZI064E

See also

AWSJZI065E

See also

AWSJZI066E

AWSJZI067E

See also