HCL Workload Automation, Version 9.4

AWSFAB - Installation messages (twsinst)

This section lists error and warning messages that might be issued when using the twsinst script to install the product.

The message component code is FAB.

AWSFAB003E   The twsinst script cannot run on this operating system: "operating_system".

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check in the HCL Workload Automation Release Notes for details of supported platforms.

HCL Workload Automation Release Notes and HCL Workload Automation: Planning and Installation Guide

AWSFAB004E   Only the user root can run the twsinst script.

Explanation

See message text

System action

The twsinst script cannot proceed.

Operator response

Login as the root user and rerun the twsinst script.

AWSFAB005E   No parameters have been specified for twsinst.

Explanation

The twsinst script needs to be supplied with at least one parameter.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB007E   The supplied installation type parameter is not correct. It must be one of the following: -new, -update, -uninst, -modify, -restore.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB008E   You supplied more than one installation type parameter. Supply only one of the following: -new, -update, -uninst, -modify, -restore.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB009E   A parameter to twsinst has been supplied that is not appropriate for the supplied installation type. Specify the "installation_parameter" parameter only when "installation_type" installation type is specified.

Explanation

The installation_parameter is a parameter that you supplied, that is not appropriate for the supplied installation type.

The installation_type is a list of the only installation types with which you can use the supplied installation_parameter.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB010E   An incorrect value has been supplied for a parameter. The parameter must be as follows: "installation_parameter".

Explanation

The parameter you have supplied is correct, and is valid for this installation type. However, the value supplied for the parameter is not correct.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter value.

HCL Workload Automation: Planning and Installation Guide

AWSFAB011E   The following parameter has been supplied more than once:"installation_parameter".

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB012E   The installation parameter specified, "installation_parameter", is not supported for the installation type "installation_type".

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB014E   The following is not a recognizable installation parameter "installation_parameter".

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB015E   The "parameter_name" option is missing.

Explanation

The indicated parameter is required for this installation type.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB016E   The following user account has been supplied that does not exist on the local computer: "user_account". You must create the user account before running twsinst.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check that the correct account name was supplied. If it was not, rerun the twsinst script, supplying the correct account name.

If the correct account name was supplied, create the account before rerunning the twsinst script.

AWSFAB017E   The script was unable to locate the home directory of the specified user: "user_account".

Explanation

HCL Workload Automation is installed in the home directory of the TWSUser. The installation script cannot locate the home directory of user you have nominated as the TWSUser.

System action

The twsinst script cannot proceed.

Operator response

Rerun the twsinst script, specifying the home directory of the TWSUser using the inst_dir parameter.

If in doubt, check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

HCL Workload Automation: Planning and Installation Guide

AWSFAB018E   The script was unable to locate the home directory of the specified user, and the installation directory has not been supplied. Supply the installation directory explicitly using the following parameter: "parameter_name".

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Rerun the twsinst script, specifying the home directory of the TWSUser using the indicated parameter.

If in doubt, check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

AWSFAB019E   The supplied target installation directory "directory_name" does not exist.

Explanation

The home directory of the TWSUser must exist before running the installation.

System action

The twsinst script cannot proceed.

Operator response

Create the home directory of the TWSUser and then rerun the twsinst script.

AWSFAB020E   You are upgrading HCL Workload Automation, but the twsinst script cannot locate the configuration file "configuration_file"of the version you are upgrading.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Locate the indicated configuration file and move it to the correct directory (see the documentation for the version you are upgrading for the exact location of the configuration file). Then rerun the twsinst script.

AWSFAB021E   You are trying to run an "installation_type" installation but the installation script has not found the HCL Workload Automation configuration files belonging to the existing instance.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

You can do one of the following:

  • Either locate the configuration files (localopts and globalopts) and move them into the TWSHome directory before rerunning the twsinst script.
  • Or, change the installation type to -new or -uninst, as appropriate, and rerun the installation.

AWSFAB022E   You are running a fresh installation but the installation script has found a previous instance of HCL Workload Automation, or at least one previously installed HCL Workload Automation configuration file, in the following directory: "directory_name".

Explanation

You cannot install more than one instance of HCL Workload Automation on the same directory. If you want to perform a fresh installation into a directory that previously contained HCL Workload Automation, you must first remove any existing HCL Workload Automation configuration files.

System action

The twsinst script cannot proceed.

Operator response

You can do one of the following:

  • Either uninstall the existing instance of HCL Workload Automation and then rerun the twsinst script as a fresh installation.
  • Or, change the installation type to -update, -uninst, or -restore, as appropriate, and rerun the installation.
  • Rename, backup, or delete all the old HCL Workload Automation configuration files.

AWSFAB023E   You are trying to run a fresh installation but the installation script has found one or both of the HCL Workload Automation configuration files in the following directory: "directory_name".

Explanation

This message might indicate that a previous uninstallation of HCL Workload Automation did not complete correctly.

System action

The twsinst script cannot proceed.

Operator response

You can do one of the following:

  • Either uninstall the existing instance of HCL Workload Automation and then rerun the twsinst script as a fresh installation. If you have already uninstalled the product, check the home directory of the TWSUser, and delete any files and directories there that belong to HCL Workload Automation.
  • Or, change the installation type to -update, -uninst, or -restore, as appropriate, and rerun the installation.

AWSFAB024E   You are performing a fresh installation, but the installation script has found a previous instance of HCL Workload Automation in the registry file. The instance belongs to the following user:"user_name" and is in the registry file: "registry_file_name".

Explanation

This message might indicate that a previous uninstallation of HCL Workload Automation did not complete correctly.

System action

The twsinst script cannot proceed.

Operator response

You can do one of the following:

  • Either uninstall the existing instance of HCL Workload Automation and then rerun the twsinst script as a fresh installation.
  • Or, change the installation type to -update, -uninst, or -restore, as appropriate, and rerun the installation.
  • Or, edit the indicated registry file to delete the previous registry keys. See the chapter on troubleshooting the installation for a description of the registry keys.
The chapter on troubleshooting the installation in this manual.

AWSFAB025E   You are updating or uninstalling, but the installation script cannot find an instance of the product in the HCL Workload Automation registry file. The registry file: "registry_file_name" must contain an entry belonging to the following user: "user_name". Try to regenerate the installation registry running the command with the -recovInstReg option.

Explanation

See message.

System action

The script does not proceed.

Operator response

Try to regenerate the installation registry running the command with the -recovInstReg option.

AWSFAB026E   The following parameter: "first_parameter" cannot be used with the following parameter: "second_parameter".

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB027E   The installation was unable to retrieve the following parameter: "parameter" from the following HCL Workload Automation configuration file: "configuration_file".

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check the indicated configuration file.

  • If the file is corrupt or unreadable, and you have no good backup of it, you must uninstall HCL Workload Automation and make a fresh installation of it.
  • If the file is readable but the indicated parameter is absent, you can add it, and rerun the twsinst script.
  • If you cannot resolve the problem, search the HCL Support database for a solution at https://hclpnpsupport.hcltech.com/csm.

AWSFAB029W   The supplied port number "port_number" is normally used by other services, such as ftp, or telnet, but will be used.

Explanation

See message text.

System action

The twsinst script proceeds using the port number you supplied.

Operator response

After the installation has completed, you might decide to change the port number to a different value by editing the localopts file. The default value for HCL Workload Automation is 31111, but you can use any value between 1 - 65535 that is not being used by another application or service.

AWSFAB030E   The supplied company name too long. The limit is 40 bytes.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Rerun the twsinst script, supplying a value for the company parameter which is not more than 40 bytes.

AWSFAB031E   You can not promote an agent from "original_agent_type" to "promoted_agent_type".

Explanation

You can only promote a lower type of agent to a higher type. For example, you can promote a standard agent to a fault-tolerant agent, but not a fault-tolerant agent to a standard agent. If you need to do the latter, uninstall the previous agent and make a fresh installation of the new agent.

System action

The twsinst script cannot proceed.

Operator response

Either promote a different agent or uninstall the previous agent and make a fresh installation of the new agent.

AWSFAB032E   The installation script was unable to obtain the name of the TWSuser group from the following component file of the existing instance of HCL Workload Automation: "component_file_name".

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check the indicated component file.

  • If the file is corrupt or unreadable, and you have no good backup of it, you must uninstall HCL Workload Automation and make a fresh installation of it.
  • If the file is readable but the indicated TWSUser group name is absent, you can add it, and rerun the twsinst script.
  • If you cannot resolve the problem, search the HCL Support database for a solution at https://hclpnpsupport.hcltech.com/csm.

AWSFAB035E   The installation has failed. For more details see the log file: "log_file_name".

Explanation

An internal error has occurred that has caused the installation to fail.

System action

The twsinst script cannot proceed.

Operator response

Look in the log file for messages that indicate the cause of the failure. If you are able to identify and resolve the problem, rerun the installation.

If you cannot resolve the problem, search the HCL Support database for a solution at https://hclpnpsupport.hcltech.com/csm.

AWSFAB036E   The uninstallation has failed. For more details see the log file: "log_file_name".

Explanation

An internal error has occurred that has caused the uninstallation to fail.

System action

The twsinst script cannot proceed.

Operator response

Look in the log file for messages that indicate the cause of the failure. If you are able to identify and resolve the problem, rerun the uninstallation.

If you cannot resolve the problem, search the HCL Support database for a solution at https://hclpnpsupport.hcltech.com/csm.

AWSFAB037E   The twsinst script is being run from the wrong directory.

Explanation

You are attempting to install HCL Workload Automation on a UNIX platform using the twsinst utility copied from the installation CD to the home directory of the user that you have nominated as the TWSuser during the installation. This is not allowed.

You can run twsinst from any of the following places:

  • The HCL Workload Automation CD
  • A disk image of the CD
  • A copy of the twsinst utility and its associated files placed in any local directory other than the home directory of the user that you have nominating as the TWSuser in the twsinst parameters.

System action

The twsinst script cannot proceed.

Operator response

Rerun the installation from a permitted directory.

AWSFAB039E   The installation script was not able to locate the following file needed set up the installation environment: "file_name."

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

If you cannot resolve the problem, search the HCL Support database for a solution at https://hclpnpsupport.hcltech.com/csm.

AWSFAB040E   The installation script has been run from the wrong directory. Rerun the script from the following directory:"directory_name".

Explanation

You have run the twsinst script from the home directory of a different user than that identified in the -uname parameter. If you wanted that the user identified in the -uname parameter is the TWSUser, run the installation from that user's home directory.

directory_name is the home directory of the user identified in the -uname parameter.

System action

The twsinst script cannot proceed.

Operator response

Rerun the twsinst installation script from the indicated directory.

AWSFAB041E   The installation script has detected that at least one HCL Workload Automation process is running. No processes can be running when you perform an installation, upgrade, promotion, restore or uninstallation.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Follow the instructions in HCL Workload Automation: Administration and Troubleshooting to shut down all HCL Workload Automation processes.

HCL Workload Automation: Administration and Troubleshooting

AWSFAB042E   The installation script has detected that at least one HCL Workload Automation process is running. No processes can be running when you perform an installation, upgrade, promotion, restore or uninstallation.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Follow the instructions in HCL Workload Automation: Administration and Troubleshooting to shut down all HCL Workload Automation processes.

AWSFAB043W   At least one warning message has been issued during the installation.

Explanation

See message text.

System action

The twsinst script proceeds.

Operator response

Check the install log file and read the warning message or messages.

AWSFAB044W   At least one warning message has been issued during the uninstallation.

Explanation

See message text.

System action

The twsinst script proceeds.

Operator response

Check the install log file and read the warning message or messages.

AWSFAB046E   An inconsistent parameter has been used. You cannot specify the "parameter1" parameter when the "parameter2" parameter has been specified.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB047E   An inconsistent parameter has been used. When the parameter -cputype "agent_type" is specified, the <cpuname> provided with the -thiscpu and the -master parameters must be different.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB048E   The company name cannot contain blank characters (spaces).

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Rerun the twsinst script, supplying a company name that does not contain blank characters (spaces).

AWSFAB049E   The installation directory cannot contain blank characters (spaces).

Explanation

If you did not specify the installation directory explicitly, it means that the home directory of the TWSuser contains blank characters (spaces).

System action

The twsinst script cannot proceed.

Operator response

If you have explicitly supplied the installation directory, rerun the twsinst script, supplying an installation directory that does not contain blank characters (spaces).

If the home directory of the TWSuser contains blank characters (spaces), choose another user as the TWSuser, or change the name of the home directory of the TWSuser to not contain blank characters (spaces).

AWSFAB050E   The following parameter: "parameter" cannot contain more than "number"bytes.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Rerun the twsinst script, supplying the indicated parameter with a value not more than that indicated.

AWSFAB055E   The supplied installation type parameter is not correct. It must be one of the following: -new, -uninst, -update.

Explanation

See message text.

System action

The installAgent script cannot proceed.

Operator response

Check the usage of the installAgent script by referring to the installation instructions,, or use the command installAgent -u to the see a list of the available parameters and their values.

Rerun the installAgent script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB094E   The -restore parameter cannot be used either because the previous instance of HCL Workload Automation has not yet been modified or because the new installation has completed successfully.

Explanation

The -restore parameter is only used to restore a backed-up version of a previous instance of HCL Workload Automation where an upgrade or promotion has failed, and you want to return to that previous instance.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB095E   A parameter is missing. Rerun the installation script, adding the following parameter: "parameter_name".

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, adding the missing parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB098E   The values specified for -master and -thiscpu cannot be the same.

Explanation

If you are trying to install a master domain manager you do not supply the -master parameter. If you are trying to install a different type of agent, the -thiscpu parameter must identify the computer where you are installing the agent, and the -master parameter must identify the workstation that is its master domain manager.

System action

The twsinst script cannot proceed.

Operator response

Rerun the twsinst script, supplying different values for the -master and -thiscpu parameters.

AWSFAB099E   You have identified an instance of HCL Workload Automation that is a master domain manager, a backup master domain manager, a dynamic domain manager, a backup dynamic domain manager, an agent with a distributed connector, an agent integrated with a Dynamic Workload Console or a HCL Workload Automation for z/OS connector. You cannot upgrade or install any of these using twsinst.

Explanation

Using twsinst you can upgrade or uninstall only the following components:
  • A standard agent to a fault-tolerant agent.
  • A fault-tolerant agent to a fault-tolerant agent
  • A fault-tolerant agent to a domain manager or a backup domain manager
  • A domain manager or backup domain manager to a domain manager or a backup domain manager
  • A dynamic agent to a dynamic agent.
  • A HCL Workload Automation for z/OS agent to a HCL Workload Automation for z/OS agent.

System action

The twsinst script cannot proceed.

Operator response

If you want to upgrade or uninstall a master domain manager, a backup master domain manager, a dynamic domain manager, or a backup dynamic domain manager use the installation wizard or a silent installation.

If you want to upgrade an agent with a distributed connector installed using twsinst, you must first uninstall the distributed connector using the installation wizard or a silent installation and than run twsinst again.

If you want to upgrade an agent integrated with a Dynamic Workload Console you must first uninstall the Dynamic Workload Console using the installation wizard or a silent installation or upgrade the Dynamic Workload Console to the version 9.4, uninstall the old version of the Dynamic Workload Console and upgrade the agent using twsinst.

If you want to upgrade an agent integrated with a HCL Workload Automation for z/OS connector installed using twsinst script, you must first uninstall the HCL Workload Automation for z/OS connector using the installation wizard or a silent installation and run twsinst again.

If you want to upgrade or uninstall one of the agents listed above, choose an instance on which you installed one of them and rerun the twsinst script again.

HCL Workload Automation: Planning and Installation Guide

AWSFAB100E   The script was unable to copy the file maestro.tar.gz to the HCL Workload Automation home directory (TWSHome).

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check that there is sufficient space available on the file system of the HCL Workload Automation home directory (TWSHome). Check that the user performing the installation has write access to TWSHome. Resolve any problem you find and rerun the script.

AWSFAB101E   The script was unable to copy the file maestro.tar.z to the HCL Workload Automation home directory (TWSHome).

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check that there is sufficient space available on the file system of the HCL Workload Automation home directory (TWSHome). Check that the user performing the installation has write access to TWSHome. Resolve any problem you find and rerun the script.

AWSFAB102E   The script was unable to expand the file maestro.tar.gz in the HCL Workload Automation home directory (TWSHome).

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check that there is sufficient space available on the file system of the HCL Workload Automation home directory (TWSHome). Resolve any problem you find and rerun the script.

AWSFAB103E   The script was unable to expand the file maestro.tar.z in the HCL Workload Automation home directory (TWSHome).

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check that there is sufficient space available on the file system of the HCL Workload Automation home directory (TWSHome). Resolve any problem you find and rerun the script.

AWSFAB104E   The script was unable to untar the file maestro.tar.gz in the HCL Workload Automation home directory (TWSHome).

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check that there is sufficient space available on the file system of the HCL Workload Automation home directory (TWSHome). Resolve any problem you find and rerun the script.

AWSFAB105E   The script was unable to untar the file maestro.tar.z in the HCL Workload Automation home directory (TWSHome).

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check that there is sufficient space available on the file system of the HCL Workload Automation home directory (TWSHome). Resolve any problem you find and rerun the script.

AWSFAB106E   An incorrect value has been supplied for the parameter -thiscpu.

Explanation

See message.

System action

The twsinst script cannot proceed.

Operator response

Rerun the twsinst script, supplying a correct value for the -thiscpu parameter.

The Planning and Installation guide for full details of the syntax of the twsinst script.

AWSFAB107E   An incorrect value has been supplied for the parameter -master.

Explanation

See message.

System action

The twsinst script cannot proceed.

Operator response

Rerun the twsinst script, supplying a correct value for the -master parameter.

The Planning and Installation guide for full details of the syntax of the twsinst script.

AWSFAB108E   The option -restore is not allowed on operating system "operating_system".

Explanation

The -restore operation is not allowed as a parameter to an installation performed on the indicated operating system (for example, IRIX64, OSF1 DYNIX-ptx).

System action

The twsinst script cannot proceed.

Operator response

If you need to restore the original installation, uninstall the upgraded installation, and then perform a manual restore of the backup image stored in the backup directory: twsuserdir_BACKUP.

AWSFAB109E   You are performing an upgrade to version "version", but the installation script has found a previous instance of HCL Workload Automation, with the same version in the registry file "registry_file", belonging to the same TWSUser: "TWSUser_name".

Explanation

A TWSUuser cannot own more than one instance of HCL Workload Automation, version version, on the same workstation.

System action

The twsinst script cannot proceed.

Operator response

Firstly, check that the TWSUser has been typed correctly. If it is not, retry the command.

Check if you are performing the upgrade on the correct computer. If you are not, retry the upgrade from the correct computer.

If the supplied TWSUser is the one you intended, on the correct computer, you must be in one of the following scenarios:

You are trying to upgrade an instance of HCL Workload Automation that has already been upgraded to version version
Verify if this has happened as follows:
  1. Check the instance of HCL Workload Automation, version version on this computer:
    1. Go to the <TWSHome> directory
    2. Run the environment enabling script tws_env
    3. Run a command such as conman or composer to display the product version.
  2. If the version is version you have already upgraded the product and can quit the wizard.
You want to have two instances of the product, one of which is upgraded from a previous instance
To have two instances of the product on the same computer you must have them installed under different TWSUsers. Because you cannot change the TWSUser ID during an upgrade, you must do the following:
  1. Quit this installation.
  2. Uninstall the other fresh installation that you made.
  3. Upgrade the old version of HCL Workload Automation
  4. Install the other fresh instance using a different TWSUser.
Your environment contains traces of a previous installation of HCL Workload Automation that you thought had been completely uninstalled.
  1. Look in the registry_file for the supplied TWSUser and determine the installation directory
  2. Check if there is a valid installation in that directory.
    • If there is a valid installation of version version that you do not want, uninstall it. If it will not uninstall using the uninstaller, follow the instructions in this manual for uninstalling the product manually.
    • If there is no installation, remove the entries in the registry_file relating to version version.
  3. Rerun the upgrade.

AWSFAB111W   The supplied Job Manager port number "port_number" is normally used by other services, such as FTP or Telnet. The twsinst script proceeds using the Job Manager port number that you supplied.

Explanation

See message text.

System action

The twsinst script proceeds using the Job Manager port number that you supplied.

Operator response

After the installation completes, you can change the Job Manager port number to a different value by editing the JobManager.ini file. The default value for the HCL Workload Automation agent is 31114. You can use any value in the range from 1 to 65535 that is not being used by another application or service.

AWSFAB112E   The supplied Job Manager port number is equal to the same as the netman port number. Specify a different value.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Specify a different value for the Job Manager port number. Run the twsinst installation again. The default value for HCL Workload Automation is 31114, but you can use any value in the range from1 to 65535 that is not being used by another application or service.

AWSFAB121W   The supplied DWB port number "port_number" is normally used by other services, such as FTP or Telnet. The twsinst script proceeds using the DWB port number that you supplied.

Explanation

See message text.

System action

The twsinst script proceeds using the DWB port number that you supplied.

Operator response

After the installation completes, you can change the DWB port number to a different value by editing the JobManager.ini file.

AWSFAB122E   The supplied DWB port number is the same as the netman port number. Specify a different value.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Specify a different value for the TDWB port number. Run the twsinst installation again.

AWSFAB123E   The supplied TDWB port number is the same as the jmport number. Specify a different value.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Specify a different value for the DWB port number. Run the twsinst installation again.

AWSFAB124E   The value you specified for the "parameter" is incorrect. Valid values are true and false.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Specify true or false. Run the twsinst installation again.

AWSFAB128E   The value you specified for the -addjruntime is incorrect for the agent that you are installing.You can add the runtime for Java job plug-ins only to HCL Workload Automation for z/OS agents (z-centric) or to dynamic agents.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

If you are installing the fault-tolerant agent, specify false for the -addjruntime parameter or install the HCL Workload Automation for z/OS agent (z-centric) or the dynamic agent. Run the twsinst installation again.

AWSFAB132E   The uninstallation process failed for one of these reasons:\n You logged into the system with an incorrect user\n You specified an incorrect username\n You are running the twsinst script from the wrong directory.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Either change the value of the username to the same username used during installation, or run the twsinst script from the installation folder. For details see the HCL Workload Automation: Planning and Installation Guide

Rerun the twsinst script, supplying the correct parameter.

AWSFAB133E   Either the -password parameter is missing, or an incorrect value has been supplied for a parameter. The parameter must be as follows: "installation_parameter".

Explanation

The indicated parameter is required for this type of installation.

System action

The twsinst script cannot proceed.

Operator response

Verify the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to see a list of the parameters.

Run the twsinst script again, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB134E   You specified an incorrect password for the user "username".

Explanation

The indicated parameter is incorrect.

System action

The twsinst script cannot proceed.

Operator response

Run the twsinst script again, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB135E   The "user_account" user account you supplied does not exist on the local computer. The operation cannot proceed.

Explanation

The indicated parameter is incorrect.

System action

The twsinst script cannot proceed.

Operator response

Run the twsinst script again, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB136E   An error occurred when creating the "user_account" user on the local computer. The twsinst installation cannot proceed.

Explanation

The indicated parameter is incorrect.

System action

The twsinst script cannot proceed.

Operator response

Run the twsinst script again, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB141E   An instance of HCL Workload Automation is already installed for another user in the "directory" directory you specified as installation directory.

Explanation

See message.

System action

The twsinst script cannot proceed.

Operator response

Specify a different installation directory and launch the installation again.

HCL Workload Automation: Planning and Installation Guide

AWSFAB142E   The directory "directory" you specified is incorrect or is not a fully qualified path.

Explanation

See text.

System action

The twsinst script cannot proceed.

Operator response

Specify a correct fully qualified path for the installation directory and run the installation again.

HCL Workload Automation: Planning and Installation Guide

AWSFAB143W   The user "user" is a domain user. Verify if he has all the required permissions to perform the installation.

Explanation

See text.

System action

The twsinst script proceeds.

Operator response

The domain user must have the following permissions:

  • Act as part of the operating system
  • Allow logon locally
  • Impersonate a client after authentication right
  • Logon:
    • Locally
    • As batch job
    • As service
  • Replace process level token
HCL Workload Automation: Planning and Installation Guide

AWSFAB151E   The specified parameter "parameter" must have an integer value or -1.

Explanation

See text.

System action

The twsinst script cannot proceeds.

Operator response

Run the twsinst script again, supplying another directory.

HCL Workload Automation: Planning and Installation Guide

AWSFAB154E   The following processes are still running "processes". Close them before running the operation again.

Explanation

See text.

System action

The twsinst script cannot proceeds.

Operator response

Perform the following steps:
  1. Verify which processes are still running by performing the following actions:
    - On Windows:
    1. Open Task Manager->Processes.
    2. Select Show processes from all users.
    - On UNIX
    1. Run the ps -ef command.
  2. Wait for processes completion or stop them.
  3. Run the twsinst script again.
HCL Workload Automation: Planning and Installation Guide

AWSFAB155E   The following processes are still running "processes". Either close them or wait for their completion before running the operation again.

Explanation

See text.

System action

The twsinst script cannot proceeds.

Operator response

Perform the following steps:
  1. Verify which processes are still running by performing the following actions:
    - On Windows:
    1. Open Task Manager->Processes.
    2. Select Show processes from all users.
    - On UNIX
    1. Run the ps -ef command.
  2. Wait for processes completion or stop them.
  3. Run the twsinst script again.
HCL Workload Automation: Planning and Installation Guide

AWSFAB161E   There are still jobs running. The twsinst operation cannot continue. Use the coman sj @#@.@ command to verify which jobs are still running.

Explanation

See text.

System action

The twsinst script cannot proceeds.

Operator response

  1. >Use the coman sj @#@.@ command to verify which jobs are still running.
  2. Wait for job completion.
  3. Run the twsinst script again.
HCL Workload Automation: Planning and Installation Guide

AWSFAB162E   The following processes are still running. Close them before running the operation again.

Explanation

See text.

System action

The twsinst script cannot proceeds.

Operator response

Perform the following steps:
  1. Verify which processes are still running by performing the following actions:
    - On Windows:
    1. Open Task Manager->Processes.
    2. Select Show processes from all users.
    - On UNIX
    1. Run the ps -ef command.
  2. Wait for processes completion or stop them.
  3. Run the twsinst script again.
HCL Workload Automation: Planning and Installation Guide

AWSFAB163E   The following processes are still running. Either close them or wait for their completion before running the operation again.

Explanation

See text.

System action

The twsinst script cannot proceeds.

Operator response

Perform the following steps:
  1. Verify which processes are still running by performing the following actions:
    - On Windows:
    1. Open Task Manager->Processes.
    2. Select Show processes from all users.
    - On UNIX
    1. Run the ps -ef command.
  2. Wait for processes completion or stop them.
  3. Run the twsinst script again.
HCL Workload Automation: Planning and Installation Guide

AWSFAB164E   The values specified for "parameter1" and "parameter2" cannot be the same.

Explanation

See message.

parameter1 and parameter2 identify two parameters that cannot have the same value.

System action

The twsinst script cannot proceed.

Operator response

Rerun the twsinst script, supplying different values for the parameter1 and parameter2 parameters.

AWSFAB165E   You are trying to install the standard agent or the fault-tolerant agent, from the wrong eImage.

Explanation

See message.

The eImage you downloaded does not contain the images to install the files for the standard agent or the fault-tolerant agent.

System action

The twsinst script cannot proceed.

Operator response

Download the correct eImage using the Passport Advantage Online website and run the twsinst script again.

AWSFAB166E   You are trying to add the runtime for Java job plugins, but the eImage you downloaded does not contain the appropriate installation files.

Explanation

See message.

It is not possible to add the runtime for Java job plugins using the current eImage.

System action

The twsinst script cannot proceed.

Operator response

Download the Java extensions eImage using the Passport Advantage Online website and run the twsinst script again.

AWSFAB167E   You are trying to upgrade or modify a standard agent or a fault-tolerant agent, but the eImage you downloaded does not contain the related installation files.

Explanation

See message.

The eImage you downloaded does not contain the images to install the files for the standard agent or the fault-tolerant agent.

System action

The twsinst script cannot proceed.

Operator response

Download the correct eImage using the Passport Advantage Online website and run the twsinst script again.

AWSFAB168E   You are trying to upgrade or modify the runtime for Java job plugins, but the eImage you downloaded does not contain the related installation files.

Explanation

See message.

The eImage you downloaded does not contain the images to update the runtime for Java job plugins.

System action

The twsinst script cannot proceed.

Operator response

Download the Java extensions eImage using the Passport Advantage Online website and run the twsinst script again.

AWSFAB169E   Operating system not supported.

Explanation

It is not possible to run the installation process on the operating system running on this machine.

System action

The installation process cannot proceed.

Operator response

Run the installation process on one of the operating systems supported by HCL Workload Automation.

AWSFAB170E   Linux distribution is not supported.

Explanation

It is not possible to run the installation process on the Linux distribution running on this machine.

System action

The installation process cannot proceed.

Operator response

Run the installation process on one of the Linux distributions supported by HCL Workload Automation.

AWSFAB171E   The Linux version: "operating_system" "major_version" "minor_version"; is not supported.

Explanation

It is not possible to run the installation process on the Linux version running on this machine.

System action

The installation process cannot proceed.

Operator response

Run the installation on one of the Linux versions supported by HCL Workload Automation.

AWSFAB172E   The Linux service pack: "operating_system" "major_version" "minor_version"; is not supported.Update the Operating system to service pack: "operating_system" "major_version" "correct_minor_version".

Explanation

It is not possible to run the installation process on the Linux service pack running on this machine.

System action

The installation process cannot proceed.

Operator response

Run the installation process on one of the Linux service packs supported.

AWSFAB173E   Operating system version is not supported.

Explanation

It is not possible to run the installation process on the operating system version running on this machine.

System action

The installation process cannot proceed.

Operator response

Run the installation process on one of the Operating System versions supported.

AWSFAB174E   AIX operating system maintanance package is not supported.

Explanation

It is not possible to run the installation process on the operating system maintanance package running on this machine.

System action

The installation process cannot proceed.

Operator response

Run the installation on one of the operating system maintanance packages supported.

AWSFAB175E   Found library "library" but not "softlink". Softlink "softlink" to "library".

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Create the softlink to the required library.

AWSFAB176E   Library libXp.so.6 and libXmu.so.6 are not found.The graphical installation process cannot work.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Install the required libraries libXp.so.6 and libXmu.so.6.

AWSFAB177E   Required libraries are not installed on the running system.

Explanation

SEE TEXT

System action

The install process cannot proceed.

Operator response

Install the required libraries on the running system.

AWSFAB178E   32-bit AIX operating system is not supported.Only AIX 64-bit system are supported by HCL Workload Automation.

Explanation

It is not possible to run the installation process on the 32-bit AIX operating system running on this machine.

System action

The installation process cannot proceed.

Operator response

Run the installation on a 64-bit AIX operating system supported by HCL Workload Automation.

AWSFAB179E   The AIX maintanance package "maintanance_package" is not supported.Update the running operating system to the manteinance package "maintanance_package".

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Run the installation process on one of the AIX maintanance packages supported by HCL Workload Automation.

AWSFAB180E   The AIX fix "fix" was not found on the running system.

Explanation

It is not possible to run the installation process on the running AIX machine because the required fix is not installed.

System action

The installation process cannot proceed.

Operator response

Run the installation on an AIX system containing the required fixes.

AWSFAB181E   C++ runtime level "runtime_level" not supported.Update the C++ runtime level to "required_runtime_level".

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Run the installation on a system having the required C++ runtime level.

AWSFAB193E   The library "library" must be installed on the running system.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Install the required libraries on the running system.

AWSFAB194E   The 64 bit library "library" must be installed on the running system.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Install the required libraries on the running system.

AWSFAB196E   The patch "patch" must be installed on the running system.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Install the required patches on the running system.

AWSFAB197E   Upgrade patch "patch" "bundle" to version "version".

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Install the required patch on the running system.

AWSFAB198E   Operating system required patches are missing.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Install the required patches on the running system.

AWSFAB199E   Required cluster patch "patch" is missing.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Install the required cluster patch on the running system.

AWSFAB200E   Required security patch is missing.

Explanation

A required security patch is missing.

System action

The installation process cannot proceed.

Operator response

Install the required security patch on the running system.

AWSFAB201W   WebSphere recommended patches are missing.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Install the recommended WebSphere patches on the running system.

AWSFAB203E   Unsupported quality pack.Update the quality pack to "var1" "var2" or December 2004.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Install the required quality pack on the running system.

AWSFAB205E   The operating system release level is not supported.Update the release level "release_level" to "required_release_level".

Explanation

SEE TEXT

System action

The installation process cannot proceed.

Operator response

Update the operating system to a release level supported by HCL Workload Automation

AWSFAB211W   The minimum required patch "patch" was not found on the running system.

Explanation

SEE TEXT.

System action

The installation process proceeds, but some errors might occur.

Operator response

Install the 19964-05 patch on the running system.

AWSFAB212E   Operating system release "os_release" not supported.

Explanation

The operating system release is not supported

System action

The installation process cannot proceed.

Operator response

Install an operating system release supported by HCL Workload Automation.

AWSFAB213E   Not enogh free disk space on file system "fs". "disk_space" "ds_measure_unit" are required.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Free some space on the specified file system

AWSFAB214E   Not enough free disk space on swap file system.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Free some space on the swap file system

AWSFAB215E   The directory "dir" is not found.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Create the required directory

AWSFAB216E   You specified a non existing installation path.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Specify an existing installation path.

AWSFAB218E   Hardware "hw" not supported.The required hardware is "hw_required".

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Install HCL Workload Automation on required hardware.

AWSFAB219E   Hardware model "model" not supported.The required hardware model is "model_required".

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Install HCL Workload Automation on required hardware model.

AWSFAB220W   Recommended memory requirements are not satisfied.

Explanation

SEE TEXT.

System action

The installation process continues, but some problems might occur.

Operator response

Increase the quantity of memory to satisfy the recommended requirements.

AWSFAB221E   The Memory requirements are not satisfied.The minimum requirement is "min_mem" Kbytes and recommended is "rec_mem" Kbytes.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Increase the quantity of memory to satisfy the minimum or the recommended memory requirements.

AWSFAB224W   Kernel parameter "kparam" not defined.

Explanation

The kernel parameter is not defined.

System action

The installation process continues, but some problems might occur.

Operator response

Specify the requested kernel parameter.

AWSFAB225E   Kernel parameter "kparam" not defined.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Specify the required kernel parameter.

AWSFAB228E   Required kernel parameter(s) not defined.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Specify the required kernel parameters.

AWSFAB229W   Recommended kernel parameters are not defined.

Explanation

SEE TEXT.

System action

The installation process continues, but some problems might occur.

Operator response

Specify the recommended kernel parameters.

AWSFAB230W   Some prerequisites were not satisfyed during the check, look at the log for more details.

Explanation

SEE TEXT.

System action

The installation process continues, but some problems might occur.

Operator response

Look at the log for more details.

AWSFAB231E   The prerequisites scan detected missing prerequisites. Check the prerequisites scan logs, precheck_result.txt and result.txt, located in the "installation_log" folder, for details. Install the missing prerequisites and rerun the installation command. If no prerequisites are missing, rerun the installation command with the -skipcheckprereq option.

Explanation

SEE TEXT.

System action

If you specified the -skipcheckprereq flag, the installation continues, otherwise it stops.

Operator response

Consult the result.txt file for any missing prerequisites. Install the missing prerequisites and then run the installation procedure again with the -skipcheckprereq flag.

AWSFAB233W   The free disk space available on the swap file system does not meet the recommended requirements.

Explanation

SEE TEXT.

System action

The installation process continues, but some problems might occur.

Operator response

Free some space on the swap file system

AWSFAB236E   You are trying to install or upgrade a HCL Workload Automation instance from the wrong eImage for the target operating system.

Explanation

See message.

The current eImage is not the appropriate one for your operating system.

System action

The twsinst script cannot proceed.

Operator response

Download the correct eImage and run the twsinst script again.

AWSFAB237E   You are trying to upgrade or modify the HCL Workload Automation for z/OS agent (z-centric), but the images on the workstation do not contain the related installation files.

Explanation

See message.

The images on the workstation do not contain the files, needed to upgrade the HCL Workload Automation for z/OS agent.

System action

The twsinst script cannot proceed.

Operator response

Download the HCL Workload Automation for z/OS agent eImage using the Passport Advantage Online website or copy the images from the HCL Workload Automation for z/OS agent DVD and run the twsinst script again.

AWSFAB238E   You are trying to install the HCL Workload Automation dynamic agent, but you did not specify the -tdwbport <port_number> installation parameter with a <port_number> value different from 0.

Explanation

See message.

You have not specified the installation parameter -tdwbport <port_number> to install the HCL Workload Automation dynamic agent.

System action

The twsinst script cannot proceed.

Operator response

Specify the installation parameter -tdwbport <port_number> with a <port_number> value different from 0 and run the twsinst script again.

AWSFAB239W   You are installing a dynamic agent but you provided some parameters that are not necessary for the dynamic agent installation. These parameters are ignored.

Explanation

SEE TEXT.

System action

The installation process continues and the unnecessary parameters are ignored.

Operator response

None.

AWSFAB240W   You are installing a fault-tolerant agent but you provided some parameters that are not necessary for a fault-tolerant agent installation. These parameters are ignored.

Explanation

SEE TEXT.

System action

The installation process continues and the unnecessary parameters are ignored.

Operator response

None.

AWSFAB243E   An error occurred running the option that recreates the HCL Workload Automation installation on the specified path "twa_path". Check the installation log for details.

Explanation

SEE TEXT.

System action

The installation process cannot proceed.

Operator response

Specify an existing installation path.

AWSFAB246E   The value you specified for the -addjruntime is incorrect for the fault-tolerant agent that you are upgrading.You can add the runtime for Java job plug-ins only to dynamic agents.To install and configure a dynamic agent during upgrade you must specify the -tdwbport <port_number> parameter with a <port_number> value different from 0.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

If you are upgrading the fault-tolerant agent, specify false for the -addjruntime parameter or install the dynamic agent specifying the -tdwbport <port_number> parameter with a <port_number> value different from 0. Run the twsinst installation again.

AWSFAB247E   The user account you specified: "user_account" is a reserved IBM i User Profile. You cannot use a reserved account. Specify an existing user account different from the following reserved accounts: QDBSHR, QDFTOWN, QDOC, QLPAUTO, QLPINSTALL, QRJE, QSECOFR, QSPL, QSYS, QTSTRQS.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check that the correct account name was supplied. If it was not, rerun the twsinst script, supplying the correct account name.

Check that the supplied account name is not a reserved IBM i User Profile. You cannot use a reserved account. Run the twsinst script again, specifying an existing user account different from the following reserved accounts: QDBSHR, QDFTOWN, QDOC, QLPAUTO, QLPINSTALL, QRJE, QSECOFR, QSPL, QSYS, QTSTRQS.

The account must exist before rerunning the twsinst script.

AWSFAB248E   There is already the IBM i "user_account" library in the system. You must rename or remove the library, or you must specify a different user account.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Specify a library that does not exists or supply a different account name.

AWSFAB249E   32-bit "os" operating system is not supported.Only "os" 64-bit system are supported by HCL Workload Automation.

Explanation

See message text.

System action

The installation process cannot proceed.

Operator response

Run the installation on a 64-bit operating system supported by HCL Workload Automation. See the Detailed System requirement for a complete list of the supported operating systems and the H/W and S/W requirements.

AWSFAB284E   The Linux "operating_system" service pack "minor_version" is not supported. Update the Operating system to service pack "correct_minor_version".

Explanation

It is not possible to run the installation process on the Linux service pack running on this machine.

System action

The installation process cannot proceed.

Operator response

Run the installation process on one of the Linux service packs supported.

AWSFAB286E   The eImage on your workstation is corrupt. You must run the TAR command on QP2TERM or AIXTERM shell to untar the eImage otherwise your "script_name" script fails.

Explanation

See message text.

System action

The installation process cannot proceed.

Operator response

You must run the TAR command on QP2TERM or AIXTERM shell to untar the eImage otherwise your installation fails.

AWSFAB287E   The current shell is not supported for "script_name" script. Use QSH shell to run the "script_name" script.

Explanation

See message text.

System action

The installation process cannot proceed.

Operator response

Use QSH shell to run the installation process.

AWSFAB289W   The Java extension is already installed for the user "user_name" that you specified.

Explanation

See message.

System action

The installation process proceeds and it does not install the java extension.

Operator response

Check the install log file and read the warning message or messages.

AWSFAB290E   You are modifying a product version different from "version". The modify action can be applied only to a HCL Workload Automation, version "version" instance.

Explanation

See message.

System action

The installation process cannot proceed.

Operator response

Specify another user or another instance and rerun the operation.

AWSFAB294E   The value you specified for -addjruntime is incorrect for the agent that you are modifying.You can add the runtime for Java job plug-ins only to dynamic agents or HCL Workload Automation for z/OS agents with dynamic capabilities.For fault-tolerant agents and HCL Workload Automation for z/OS agents you must enable the dynamic capabilities before performing a modify.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

To solve the problem, specify false for the -addjruntime parameter or enable the dynamic capabilities. Run the twsinst script again.

For more information about how to enable dynamic scheduling, see the Planning and Installation Guide.

HCL Workload Automation: Planning and Installation Guide

AWSFAB295W   You can add the runtime for Java job plug-ins only to dynamic agents or HCL Workload Automation for z/OS agents with dynamic capabilities.For fault-tolerant agents and HCL Workload Automation for z/OS agents you must enable the dynamic capabilities before running the upgrade. The step to add the runtime for Java job plug-ins is ignored.

Explanation

See message text.

System action

The installation process proceeds without installing the java extension.

Operator response

To add the runtime for Java job plug-ins, enable the dynamic capabilities. Run the twsinst script after the upgrade with the -modify and -addjruntime parameters.

For more information about how to enable dynamic scheduling, see the Planning and Installation Guide.

HCL Workload Automation: Planning and Installation Guide

AWSFAB296E   The operation -restore for the user "user_name" cannot be performed, because the instance you want to restore is not at version "version" or later.

Explanation

The -restore operation can be performed only if the instance is at version 9.1 or later.

System action

The installation process cannot proceed.

Operator response

Install version 9.1 or later.

HCL Workload Automation: Planning and Installation Guide

AWSFAB303E   The parameter "parameter_name" is invalid.

Explanation

See message.

parameter_name identifies the parameter that is invalid.

System action

The twsClusterUpg script cannot proceed.

Operator response

Run the twsClusterUpg script again, supplying a different value for the parameter_name parameter.

AWSFAB304E   You cannot specify the -passwords parameter if you do not specify the -groups parameter.

Explanation

See message.

System action

The twsClusterUpg script cannot proceed.

Operator response

Run the twsClusterUpg script again, supplying both the parameters.

AWSFAB305E   You specified an invalid path. The specified path "path_name" is not valid either because it does not exist or because it does not contain the file twsinst.vbs.

Explanation

See message.

path_name identify the path that is not valid.

System action

The twsClusterUpg script cannot proceed.

Operator response

Rrun the twsClusterUpg script again, supplying the path that contains the file twsinst.vbs..

AWSFAB306E   If you specify the "par1_name" parameter, you must also specify the "par2_name".

Explanation

See message.

par1_name and par2_name identify the two parameters that must be specified together.

System action

The twsClusterUpg script cannot proceed.

Operator response

Run the twsClusterUpg script again, supplying both the parameters.

AWSFAB307E   You cannot specify the "par1_name" parameter, because this image is the General Availability version image.

Explanation

See message.

par1_name is the parameter that you cannot specify.

System action

The twsClusterUpg script cannot proceed.

Operator response

Run the twsClusterUpg script again, removing the parameter.

AWSFAB308E   This is the General Availability image, you must specify the "par1_name" parameter.

Explanation

See message.

par1_name is the parameter that you must specify.

System action

The twsClusterUpg script cannot proceed.

Operator response

Run the twsClusterUpg script again, supplying the missing parameter.

AWSFAB309E   You supplied the parameter "par1_name" more than once.

Explanation

See message.

par1_name is the parameter specified more than once.

System action

The twsClusterUpg script cannot proceed.

Operator response

Run the twsClusterUpg script again, supplying the parameter only once.

AWSFAB310E   You did not specify any values for the parameter "par1_name". Specify a value for the parameter "par1_name".

Explanation

See message.

par1_name is the parameter for which you did not specify a value.

System action

The twsClusterUpg script cannot proceed.

Operator response

Run the twsClusterUpg script again, supplying a value for the parameter.

AWSFAB311E   The syntax you specified for the parameter "par1_name" value is incorrect.

Explanation

See message.

par1_name is the parameter whose value contains errors.

System action

The twsClusterUpg script cannot proceed.

Operator response

Run the twsClusterUpg script again, specifying a valid value for the parameter.

AWSFAB312E   An error occurred while using the Windows Management Instrumentation (WMI) service. Error code: "err_code".

Explanation

See message.

error_code is the Microsoft error code that the script received.

System action

The twsClusterUpg script cannot proceed.

Operator response

See in the Microsoft documentation for the solution to solve the error.

AWSFAB314W   The group named "group_name" is not upgraded because it contains more than one HCL Workload Automation resource.

Explanation

See message.

group_name is the group that is not upgraded.

System action

The twsClusterUpg script continues with the next group.

Operator response

Upgrade manually the group that the script could not upgrade automatically when the procedure completes the automatic upgrade.

AWSFAB315E   The group named "group_name" is not upgraded because it does not contain a HCL Workload Automation resource.

Explanation

See message.

group_name is the group that does not contain any HCL Workload Automation resource.

System action

The twsClusterUpg script cannot proceed.

Operator response

Rrun the twsClusterUpg script again, removing the group that does not contain any HCL Workload Automation resources.

AWSFAB316E   The group named "group_name" is not upgraded because it contains more than one HCL Workload Automation resource.

Explanation

See message.

group_name is the group that you specified for upgrade that contains more than one HCL Workload Automation resource.

System action

The twsClusterUpg script cannot proceed.

Operator response

From the list of the groups to upgrade, remove the group that contains more than one HCL Workload Automation resource, then upgrade manually when the procedure completes the automatic upgrade.

AWSFAB317E   An error occurred while running the cluster.exe command.

Explanation

See message.

System action

The twsClusterUpg script cannot proceed.

Operator response

For further information, see the TWSClusterMainLog.txt log. The twsClusterUpg command launches the twsinst.vbs, twspatch.vbs, and the twsClusterAdm.exe commands. If the TWSClusterMainLog.txt indicated that one of these commands failed, analyze its corresponding log for further details.

AWSFAB318E   An internal error occurred while parsing the node names.

Explanation

See message.

System action

The twsClusterUpg script cannot proceed.

Operator response

For further information, see the TWSClusterMainLog.txt log. The twsClusterUpg command launches the twsinst.vbs, twspatch.vbs, and the twsClusterAdm.exe commands. If the TWSClusterMainLog.txt indicated that one of these commands failed, analyze its corresponding log for further details.

AWSFAB320E   The product cannot pause the node "node_name" because it is in the incorrect status "status".

Explanation

See message.

node_name is the node that cannot be paused.

status is the incorrect status.

System action

The twsClusterUpg script cannot proceed.

Operator response

Verify with the Cluster Administrator the status of the node.

AWSFAB321W   The resume of the node "node_name" is not performed because it is in the status "status".

Explanation

See message.

node_name is the node that cannot be resumed.

status is the incorrect status.

System action

The twsClusterUpg script cannot proceed.

Operator response

Verify with the Cluster Administrator the status of the node.

AWSFAB322W   The resume of the nodes is not performed, because some groups were not upgraded successfully.

Explanation

See message.

System action

The twsClusterUpg script completed.

Operator response

Verify the message above for details about the failures, and correct them. Then resume the nodes.

AWSFAB324E   An error occurred while pausing the node "node_name"

Explanation

See message.

node_name is the node that cannot be paused.

System action

The twsClusterUpg script cannot proceed.

Operator response

Verify the status of the node. Put it in pause status and run the command again.

AWSFAB326E   The product cannot retrieve the status of the node "node_name".

Explanation

See message.

node_name is the node whose status cannot be retrieved.

System action

The twsClusterUpg script cannot proceed.

Operator response

Verify with the Cluster Administrator the status of the node.

AWSFAB327E   The node "node_name" was not paused within the timeout period.

Explanation

See message.

node_name is the node that cannot be paused within the timeout period.

System action

The twsClusterUpg script cannot proceed.

Operator response

Pause the node manually and rrun the script again.

AWSFAB329E   An error occurred while resuming node "node_name"

Explanation

See message.

node_name is the node that cannot be resumed.

System action

The twsClusterUpg script cannot proceed.

Operator response

Check with the Cluster Administrator the status of the node.

AWSFAB330E   The node "node_name" was not resumed within the timeout period.

Explanation

See message.

node_name is the node that cannot be resumed within the timeout period.

System action

The twsClusterUpg script cannot proceed.

Operator response

Check with the Cluster Administrator the status of the node.

AWSFAB331E   An internal error occurred while parsing the nodes and the group lists.

Explanation

See message.

System action

The twsClusterUpg script cannot proceed.

Operator response

For further information, see the TWSClusterMainLog.txt log. The twsClusterUpg command launches the twsinst.vbs, twspatch.vbs, and the twsClusterAdm.exe commands. If the TWSClusterMainLog.txt indicated that one of these commands failed, analyze its corresponding log for further details.

AWSFAB332E   An internal error occurred while parsing the nodes and the resource lists.

Explanation

See message.

System action

The twsClusterUpg script cannot proceed.

Operator response

For further information, see the TWSClusterMainLog.txt log. The twsClusterUpg command launches the twsinst.vbs, twspatch.vbs, and the twsClusterAdm.exe commands. If the TWSClusterMainLog.txt indicated that one of these commands failed, analyze its corresponding log for further details.

AWSFAB333E   The product cannot find the HCL Workload Automation resource DLL path.

Explanation

See message.

System action

The twsClusterUpg script cannot proceed.

Operator response

For further information, see the TWSClusterMainLog.txt log. The twsClusterUpg command launches the twsinst.vbs, twspatch.vbs, and the twsClusterAdm.exe commands. If the TWSClusterMainLog.txt indicated that one of these commands failed, analyze the corresponding log for further details.

AWSFAB337E   An error occurred while setting the resource "resource_name" to offline.

Explanation

See message.

resource_name is the resource that cannot be taken offline.

System action

The twsClusterUpg script cannot proceed.

Operator response

For further information, see the TWSClusterMainLog.txt log. The twsClusterUpg command launches the twsinst.vbs, twspatch.vbs, and the twsClusterAdm.exe commands. If the TWSClusterMainLog.txt indicated that one of these commands failed, analyze its corresponding log for further details.

AWSFAB338E   The product cannot retrieve the status of the resource "resource_name".

Explanation

See message.

resource_name is the resource whose status cannot be retrieved.

System action

The twsClusterUpg script cannot proceed.

Operator response

For further information, see the TWSClusterMainLog.txt log. The twsClusterUpg command launches the twsinst.vbs, twspatch.vbs, and the twsClusterAdm.exe commands. If the TWSClusterMainLog.txt indicated that one of these commands failed, analyze its corresponding log for further details.

AWSFAB339E   The resource "resource_name" was not set to offline within the timeout period.

Explanation

See message.

resource_name is the resource that cannot be taken offline within the timeout period.

System action

The twsClusterUpg script cannot proceed.

Operator response

Check with the Cluster Administrator the status of the resource.

AWSFAB341E   An error occurred while setting the resource "resource_name" to online.

Explanation

See message.

resource_name is the resource that cannot be taken online.

System action

The twsClusterUpg completed, but the specified resource was not set to online.

Operator response

Check with the Cluster Administrator the status of the resource.

AWSFAB342E   The resource "resource_name" was not set to online within the timeout period.

Explanation

See message.

resource_name is the resource that cannot be taken online within the timeout period.

System action

The twsClusterUpg completed, but the specified resource was not set to online.

Operator response

Check with the Cluster Administrator the status of the resource.

AWSFAB343E   An internal error occurred while parsing resources and group lists.

Explanation

See message.

System action

The twsClusterUpg script cannot proceed.

Operator response

For further information, see the TWSClusterMainLog.txt log. The twsClusterUpg command launches the twsinst.vbs, twspatch.vbs, and the twsClusterAdm.exe commands. If the TWSClusterMainLog.txt indicated that one of these commands failed, analyze its corresponding log for further details.

AWSFAB346E   The cluster group "group_name" was not upgraded successfully.

Explanation

See message.

group_name is the group that was not upgraded successfully.

System action

The twsClusterUpg script continues with the remaining groups.

Operator response

For further information, see the TWSClusterMainLog.txt log. The twsClusterUpg command launches the twsinst.vbs, twspatch.vbs, and the twsClusterAdm.exe commands. If the TWSClusterMainLog.txt indicated that one of these commands failed, analyze its corresponding log for further details.

AWSFAB349E   The file "file_name" does not exist, the tool cannot upgrade the resource "resource_name".

Explanation

See message.

file_name is the file that cannot be accessed.

resource_name is the resource that is not upgraded.

System action

The twsClusterUpg script continues with the remaining groups.

Operator response

For further information, see the TWSClusterMainLog.txt log. The twsClusterUpg command launches the twsinst.vbs, twspatch.vbs, and the twsClusterAdm.exe commands. If the TWSClusterMainLog.txt indicated that one of these commands failed, analyze its corresponding log for further details.

AWSFAB350E   The product cannot find the version of the HCL Workload Automation resource DLL "file_name".

Explanation

See message.

file_name is the HCL Workload Automation DLL file name.

System action

The twsClusterUpg script continues with the remaining groups.

Operator response

For further information, see the TWSClusterMainLog.txt log. The twsClusterUpg command launches the twsinst.vbs, twspatch.vbs, and the twsClusterAdm.exe commands. If the TWSClusterMainLog.txt indicated that one of these commands failed, analyze its corresponding log for further details.

AWSFAB352E   The upgrade to version "version" is impossible because the version of the product present in the instance is incorrect.

Explanation

See message.

version is the version to which the upgrade is being attempted.

System action

The twsClusterUpg script continues with the remaining groups.

Operator response

For further information, see the TWSClusterMainLog.txt log. The twsClusterUpg command launches the twsinst.vbs, twspatch.vbs, and the twsClusterAdm.exe commands. If the TWSClusterMainLog.txt indicated that one of these commands failed, analyze its corresponding log for further details.

AWSFAB356E   The number of passwords ("pws_num") that you specified, is not equal to the number of groups ("grp_num") that must be upgraded. Check the -groups and -passwords parameters.

Explanation

See message.

pws_num is the number of provided passwords.

grp_num is the number of provided groups.

System action

The twsClusterUpg script cannot proceed.

Operator response

Run the twsClusterUpg script again, supplying an equal number of passwords and groups.

AWSFAB357E   None of the groups you specified contain HCL Workload Automation resources.

Explanation

See message.

System action

The twsClusterUpg script cannot proceed.

Operator response

Run the twsClusterUpg script again, supplying at least one group containin a HCL Workload Automation resource.

AWSFAB374E   JM port is already used in some other instance. Please specify some other port value.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Rerun the twsinst script, supplying a value for the port number parameter in the indicated range.

AWSFAB375E   An error occurred when creating the "directory" folder on the local computer. The operating system error is: "error". The twsinst installation cannot proceed.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Analyze the cause of the failure in the output of the script. Solve the problem and rerun the script. A possible cause of failure is that you do not have the correct permission to create the directory.

HCL Workload Automation: Planning and Installation Guide

AWSFAB379E   The "user_account" user account you supplied does not have the right security policies. The operation cannot proceed.

Explanation

The indicated parameter is incorrect.

System action

The twsinst script cannot proceed.

Operator response

Run the twsinst script again, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB380E   A parameter to twsinst has not been supplied. The "installation_parameter" parameter must be specified when "installation_parameter2" parameter is supplied.

Explanation

The installation_parameter is a parameter that you did not supplied, that is required when installation_parameter2 parameter is supplied.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the required parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB381E   An instance of HCL Workload Automation is already installed for same user in the "directory" directory you specified as installation directory.

Explanation

See message.

System action

The twsinst script cannot proceed.

Operator response

Specify a different user and launch the installation again.

HCL Workload Automation: Planning and Installation Guide

AWSFAB382E   Accept the license and terms conditions before proceeding with the installation.

Explanation

See message.

System action

The twsinst script cannot proceed.

Operator response

Accept the license and terms conditions specifying the parameter -acceptlicense yes.

HCL Workload Automation: Planning and Installation Guide

AWSFAB383E   An incorrect value has been supplied for the parameter gwid. The accepted values must start with either a letter or underscore (_) and may contain only letters, digits, underscores (_), hyphens (-), and periods (.).

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter value.

HCL Workload Automation: Planning and Installation Guide

AWSFAB384E   It is not possible to retrieve the domain name for the user "user". Check user rights and permissions.

Explanation

See message.

System action

The twsinst script cannot proceed.

Operator response

Check user rights and permissions.

HCL Workload Automation: Planning and Installation Guide

AWSFAB385E   If you specify the -domain parameter you cannot specify the username in the format domain\\username.

Explanation

See message.

System action

The twsinst script cannot proceed.

Operator response

Verify the syntax of the script, make the necessary changes and run the script again.

HCL Workload Automation: Planning and Installation Guide

AWSFAB386E   It is not possible to retrieve the domain name for the user "user". Check user rights and permissions.

Explanation

See message.

System action

The twsinst script cannot proceed.

Operator response

Verify the user rights and permissions, make the necessary changes, and run the script again.

HCL Workload Automation: Planning and Installation Guide

AWSFAB389E   You can specify the "parameter1" parameter only when the "parameter2" parameter has been specified.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB403W   You upgraded PeopleSoft method. In order to continue schedule PeopleSoft jobs you have to copy psjoa.jar file under "parameter1" folder.

Explanation

See message text.

System action

Copy psjoa.jar file under methods folder in the installation directory.

Operator response

Copy psjoa.jar file under methods folder in the installation directory.

HCL Workload Automation: Planning and Installation Guide

AWSFAB404E   The installation cannot run because the user running the twsinst installation script must either be the root user or the same user specified for the uname parameter.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Login as the root user and rerun the twsinst script specifying the correct account name in the uname parameter.

The account must exist before rerunning the twsinst script.

Login as the the correct account name and rerun the twsinst script without specifying the uname parameter.

AWSFAB405E   No root installation is supported only for dynamic agent installation.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

If you need to install a HCL Workload Automation fault-tolerant agent or both HCL Workload Automation fault-tolerant agent and HCL Workload Automation dynamic agent, login as the root user and rerun the twsinst script specifying the account name in the uname parameter.

The account must exist before rerunning the twsinst script.

AWSFAB406E   HCL Workload Automation dynamic agent instance can be updated only by the same user who previously installed it.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

If you need to update or uninstall a HCL Workload Automation dynamic agent, login as the InstallationLoginUser user and rerun the twsinst script.

The InstallationLoginUser is logged into the JobManager.ini file.

AWSFAB407W   You are proceeding with the installation process in spite of missing prerequisites being detected by the prerequisites scan.

Explanation

SEE TEXT.

System action

If you specified the -skipcheckprereq flag the installation continue, otherwise it stops.

Operator response

Consult the result.txt file for the missing prerequisites. Install the missing prerequisites and then run the installation procedure again with the -skipcheckprereq flag.

AWSFAB408W   The prerequisites scan detected missing prerequisites. Check the prerequisite scan logs, precheck_result.txt and result.txt, located in the installation log folder, for details. Installation will continue because the missing prerequisites do not affect the installation process.

Explanation

SEE TEXT.

System action

If you specified the -skipcheckprereq flag the installation continue, otherwise it stops.

Operator response

Consult the result.txt file for the missing prerequisites. Install the missing prerequisites and then run the installation procedure again with the -skipcheckprereq flag.

AWSFAB409E   Home directory for the user "user" does not exist. Please create it and then run the installation procedure again.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Create the home directory for the installing user or run the installation procedure with the -inst_dir option for specifying a different installation folder.

AWSFAB411E   gateway_eif_port port is already used by another process. Please specify some other port value.

Explanation

See message text.

System action

The twsinst script cannot proceed.

Operator response

Rerun the twsinst script, supplying a value for the port number parameter in the indicated range.

AWSFAB416E   A parameter to twsinst has been supplied that is not appropriate for the supplied installation type. Specify the -password parameter only when new installation type is specified, or when upgrading from 8.5.1.

Explanation

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script by referring to the HCL Workload Automation: Planning and Installation Guide, or use the command twsinst -u to the see a list of the available parameters.

Rerun the twsinst script, supplying the correct parameter.

HCL Workload Automation: Planning and Installation Guide

AWSFAB417E   An incorrect value has been supplied for the parameter -password.

Explanation

See message.

System action

The twsinst script cannot proceed.

Operator response

Rerun the twsinst script, supplying a correct value for the -password parameter.

The Planning and Installation guide for full details of the syntax of the twsinst script.

AWSFAB418E   The value specified for the port number by parameter "installation_parameter" is not valid. The value must be numeric and in the range 1 - 65535.

Explanation

See message text.

System action

The script cannot proceed.

Operator response

Rerun the script, supplying a valid value for the port number parameter.

AWSFAB419E   This script must be run from a command prompt that is running as Administrator. Open the command prompt window as administrator, and run the script again.

Explanation

See message text.

System action

The script cannot proceed.

Operator response

Open the command prompt window as administrator, and run the script again.

AWSFAB436E   The agent update failed. The files of the previous version will be restored. After restoring the previous version, the agent will continue to work normally.

AWSFAB437E   The restore operation of the previous version completed with errors: rc.

AWSFAB441E   The specified value is incorrect. The value for the "installation_parameter" parameter cannot start with a number.

Explanation

The value must start with an alphabetic character.

System action

The twsinst script cannot proceed.

Operator response

Check the usage of the twsinst script in the HCL Workload Automation: Planning and Installation Guide, or use the twsinst -u command option to obtain a list of supported parameters and values.

Rerun the twsinst script, supplying the correct value for the parameter in error.

HCL Workload Automation: Planning and Installation Guide

AWSFAB442E   The agent version is "agent_version". This patch can be installed only on agents at the following level: "expected_version" .

Explanation

The patch can be installed only on agents at the level listed in the message.

System action

The twsinst script cannot proceed.

Operator response

None

HCL Workload Automation: Planning and Installation Guide

AWSFAB443E   The file "file" is not found.

Explanation

SEE TEXT.

System action

The patch installation process cannot proceed.

Operator response

None

AWSFAB444E   Missing property "property" in file "file".

Explanation

SEE TEXT.

System action

The patch installation process cannot proceed.

Operator response

None