IBM Workload Scheduler for z/OS, Version 9.3 SPE

Upgrading process

According to your operating system, to upgrade the IBM Workload Scheduler for z/OS Agent with twsinst perform the following steps:

Windows operating systems

Insert the DVD related to your operating system.
Log in as administrator on the workstation where you want to upgrade the agent.
From the DVD_root/TWS/operating_system directory of the DVD, run the twsinst script using the synopsis described in this section.
Note: twsinst for Windows is a Visual Basic Script (VBS) that you can run in CScript and WScript mode, for example:
```
cscript twsinst -update -uname username 
 -acceptlicense yes
```

UNIX and Linux operating systems

Insert the installation DVD related to your operating system.
From DVD_root/TWS/operating_system, run the twsinst script using the synopsis described in this section.

A successful upgrade using the twsinst script issues the return code RC = 0. If the installation fails to understand the cause of the error, see Analyzing return codes for agent installation, upgrade, restore, and uninstallation.

Synopsis:

On Windows operating systems:

Show command usage and version

twsinst -u | -v

Upgrade an instance

twsinst -update -uname user_name
  [-addjruntime true]
  [-backup_dir backup_directory]
  [-domain user_domain]
  [-inst_dir install_directory]
  [-lang lang_id]
  [-nobackup]
  [-recovInstReg true]
  [-skip_usercheck]
  [-wait minutes]
  [-work_dir working_directory]

UNIX and Linux operating systems:

Show command usage and version

twsinst -u | -v

Upgrade an instance

twsinst -update -uname user_name
 [-addjruntime true]
 [-backup_dir backup_directory]
 [-inst_dir install_directory]
 [-lang lang-id]
 [-nobackup]
 [-recovInstReg true]
 [-reset_perm]
 [-skip_usercheck]
 [-wait minutes]
 [-work_dir working_directory]

-addjruntime true

Adds the Java™ run time to run job types with advanced options, both those supplied with the product and the additional types implemented through the custom plug-ins. With the -update option, the only valid value for this parameter is true.

If you decided not to install Java run time when upgrading, you can still add this feature at a later time as it is described in Adding a feature.

-backup_dir backup_directory

An alternative directory (which must be created manually) as the destination for the backup copy of a previous version.

If you do not specify this option when running an upgrade, the following default value is used:

$BACKUP_DIR = $INST_DIR_backup_$TWS_USER

where:

$INST_DIR is the installation path (the user home directory on UNIX and Linux).
$TWS_USER is the user name.

For example:

$INST_DIR=/opt/TWS/TWS86
$TWS_USER=user86
$BACKUP_DIR=/opt/TWS/TWS86_backup_user86
$BACKUP_SUBDIR=/opt/TWS/TWS86_backup_user86/TWS86

In the backup directory you must also create a subdirectory to include as the latest directory of the installation path.

-domain user_domain

Windows operating systems only. The domain name of the IBM Workload Scheduler for z/OS Agent user. The default is the name of the workstation on which you are upgrading the agent.

-inst_dir install_directory

The directory of the IBM Workload Scheduler for z/OS Agent installation. On UNIX this path cannot contain blanks. On Windows operating systems, if you specify a path that contains blanks, enclose it in a double quotation marks. On any operating system, specify an absolute path. If not specified, On UNIX the path is set to the /opt/IBM/TWS directory, on Windows operating systems the path is set to %ProgramFiles%\IBM\TWA. End of change

-lang

The language in which the twsinst messages are displayed. If not specified, the system LANG is used. If the related catalog is missing, the default C language catalog is used.

Note: The -lang option does not relate to the supported language packs. By default, all supported language packs are installed when you install using the twsinst script.

-nobackup

The upgrade process does not back up the instance you are upgrading.

-uname user_name

The name of the user for which IBM Workload Scheduler for z/OS Agent is being upgraded. The software is updated in this user’s home directory. This user name is not to be confused with the user performing the upgrade. This user name is not to be confused with the user performing the installation logged on as root on UNIX and Linux and as administrator on Windows operating systems.

-update

Upgrades an existing agent that was installed using twsinst.

-recovInstReg true

To re-create the registry files. Specify it if you have tried to upgrade a stand-alone, fault-tolerant agent (an agent that is not shared with other components or does not have the connector feature) and you received an error message that states that an instance of IBM Workload Scheduler cannot be found, this can be caused by a corrupt registry file. See Upgrading when there are corrupt registry files in IBM® Workload Scheduler: Planning and Installation.

-reset_perm

UNIX and Linux only. Reset the permissions of the libatrc library.

-skip_usercheck

Enable this option if the authentication process within your organization is not standard, thereby disabling the default authentication option. On UNIX and Linux operating systems if you specify this parameter, the program skips the check of the user in the /etc/passwd file or the check you perform using the su command. On Windows operating systems if you specify this parameter, the program does not create the user you specified in the -uname username parameter. If you specify this parameter you must create the user manually before running the script.

-wait minutes

The number of minutes that the product waits for jobs that are running to complete before starting the upgrade. If the jobs do not complete during this interval the upgrade does not proceed and an error message is displayed. Valid values are integers or -1 for the product to wait indefinitely. The default is 60 minutes.

-work_dir working_directory

The temporary directory used by the installation process to store the files to deploy.

On Windows operating systems:: If you specify a path that contains blanks, enclose it in a double quotation marks. If you do not manually specify a path, the path is set to %temp%\TWA\tws93, where %temp% is the temporary directory of the operating system.
On UNIX and Linux operating systems:: The path cannot contain blanks. If you do not manually specify a path, the path is set to /tmp/TWA/tws93.