|

twsinst

|
|

|

During the installation process, twsinst creates |a file in the following directories for each of the installation steps:

|
|
On UNIX and Linux operating systems:
|
/user’s_home/TWS |
|
On Windows operating |systems:
|
%ProgramFiles%\IBM\TWA\TWS |
|

If you stop and restart the installation, the installation process |starts from the installation step where it was stopped.

|

To install |the Tivoli Workload Scheduler for z/OS Agent and all the supported language packs, perform the following |steps:

|
|
On UNIX and Linux operating systems:
|
|
    |
  1. Insert the DVD for your operating system or download the agent |eImage.
    2. |
  2. Create the Tivoli Workload Scheduler for z/OS user. The software is installed by default |in the user’s home directory, referred to as /installation_dir/TWS |
    |
    User:
    |
    TWS_user |
    |
    Home:
    |
    /installation_dir/TWS (for |example: /home/user1/TWS where user1 is the |name of the Tivoli Workload Scheduler for z/OS user.) |
    |
    3. |
  3. Log in as root on the workstation where you want to install the |product.
    4. |
  4. From the DVD_root/TWS/operating_system directory, run twsinst using |the synopsis described in the following section.
|
|
On Windows operating |systems:
|
|
    |
  1. Insert the DVD for your operating system or download the agent |eImage.
    2. |
  2. Log in as administrator on the workstation where you want to install |the product.
    3. |
  3. From DVD_root/TWS/operating_system, |run twsinst using the synopsis described in |the following section. |
    |
    Note:
    |
    twsinst for Windows is a Visual Basic Script |(VBS) that you can run in CScript and WScript mode.
    |

    The Tivoli Workload Scheduler for z/OS user |is automatically created. The software is installed by default in |the Tivoli Workload Scheduler for z/OS installation directory. The default value is %ProgramFiles%\IBM\TWA.

|
|
On IBM i operating systems:
|
|
    |
  1. On the IBM i system, sign on as QSECOFR user.
    2. |
  2. Create the IBM i user profile for which the Tivoli Workload Scheduler for z/OS Agent |is installed. This user profile is not to be confused with the user |performing the installation logged on as QSECOFR, |but instead is the user that you specify in the -uname username parameter when running the twsinst script. |For descriptions of the syntax parameters, see twsinst. |You cannot use an existing IBM i system user profile, an application |supplied user profile, or any of the following reserved IBM i user |profiles: |
    QDBSHR, QDFTOWN, QDOC, QLPAUTO, QLPINSTALL,
|QRJE, QSECOFR, QSPL, QSYS, QTSTRQS
    3. |
  3. On the IBM i system, verify that no library exists with the same |name as the user profile supplied for the Tivoli Workload Scheduler for z/OS Agent.
    4. |
  4. Use the DVD or download the eImage from the Passport Advantage® Online |website.
    5. |
  5. Open a QSH command entry running the qsh command.
    6. |
  6. Run the twsinst script as described in twsinst. During the installation the product creates an IBM i library |and a job description with the same name as the user profile created |in the Step 2. The installation procedure adds |this library to the user profile library list of the Tivoli Workload Scheduler for z/OS Agent |user profile and sets this job description as the job description |of the Tivoli Workload Scheduler for z/OS Agent user profile. By default, the software is installed |in the user’s home directory.
|
|

A successful installation using twsinst issues |the return code RC = 0. A failed installation issues the return code |RC = 1. In case of a failed installation, refer to the installation |messages documented in Tivoli Workload Automation: Messages and Codes.

|
|

Synopsis

|
|

|
|
On UNIX and Linux operating systems:
|
|
|
Show command usage and version
|
|
twsinst -u | -v
|
|
Install a new instance
|
|
twsinst -new -uname username
|    [-addjruntime true|false]
|    [-displayname agent_name]
|    [-hostname host_name]
|    [-inst_dir install_dir]
|    [-jmport port_number]
|    [-jmportssl true|false]
|    [-lang lang_id]
|    [-reset_perm]
|    [-skip_usercheck]
|    [-tdwbport tdwbport_number]
|    [-tdwbhostname host_name]
|
|
|
|
On Windows operating |systems:
|
|
|
Show command usage and version
|
|
twsinst -u | -v
|
|
Install a new instance
|
|
twsinst -new -uname username
|    -password user_password
|    [-addjruntime true|false]
|    [-displayname agent_name]
|    [-domain user_domain]
|    [-hostname host_name]
|    [-inst_dir install_dir]
|    [-jmport port_number]
|    [-jmportssl true|false]
|    [-lang lang_id]
|    [-skip_usercheck]
|    [-tdwbport tdwbport_number]
|    [-tdwbhostname host_name]
|
|
|
|
|
|

Parameters

|
|
|
-addjruntime true|false
|
Adds the Java runtime |to run job types with advanced options, both those supplied with the |product and the additional types implemented through the custom plug-ins. |Valid values are true and false. |The default is true. |
|
-domain user_domain
|
Windows only. The domain |name of the Tivoli® Workload |Scheduler user. The default is the name of the workstation on which |you are installing the Tivoli Workload Scheduler for z/OS Agent. |
|
-displayname agent_name
|
The name to be assigned to the Tivoli Workload Scheduler for z/OS Agent. The default is the host |name. |
|
-hostname host_name
|
The fully qualified host name or IP address on which the agent |will be contacted by the Dynamic Workload Broker. |
|
-inst_dir installation_dir
|
The directory where to install the Tivoli Workload Scheduler for z/OS Agent. On UNIX and Linux, |this path cannot contain blanks. On Windows, |if you specify a path that contains blanks, enclose it in double quotes. |If you do not manually specify a path, the path is set to the default |home directory. On UNIX and Linux, the path is set to the user_name home directory, and on Windows it is set to %ProgramFiles%\IBM\TWA. |
|
-jmport port_number
|
|

The port used by the Tivoli Workload Scheduler for z/OS controller or the Dynamic Workload Broker to |connect to the Tivoli Workload Scheduler for z/OS Agent. The default value is 31114. |The valid range is from 1 to 65535.

|
|
-jmportssl true|false
|
The port used by the Tivoli Workload |Scheduler for z/OS® controller, |or by the dynamic workload broker to connect to the Tivoli Workload Scheduler for z/OS Agent. This |number is registered in the ita.ini file, located in ITA\cpa\ita on Windows and ITA/cpa/ita on UNIX, Linux, |and IBM i. |
|
For communication using SSL or HTTPS
|
Set jmportssl = true. To communicate with |the Dynamic Workload Broker, it is recommended that you set the value to true. |In this case, the port specified in jmport communicates |in HTTPS. If you specify true, ensure that you |also configure the HTTPS communication on the z/OS master. |
|
For communication without using SSL, or through HTTP
|
Set jmportssl = false. In this case the |port specified in jmport communicates in HTTP. |
|
The default value is true. |

To increase |the performance of the Tivoli Workload Scheduler for z/OS server, it is recommended that you |set this value to false.

|
|
-lang lang_id
|
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:
|
This is the language in which the installation log is recorded, |and not the language of the installed engine instance. twsinst installs all languages as default.
|
|
-new
|
A fresh installation of the agent. Installs an agent and all |supported language packs. |
|
-password user_password
|
Windows only. The password |of the user for which you are installing Tivoli Workload Scheduler for z/OS Agent. |
|
-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, skip the check of the user |in the /etc/password file or using the su command. On Windows, 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. |
|
-tdwbhostname host_name
|
The fully qualified host name of the dynamic domain manager of backup dynamic domain manager used |to connect to the Tivoli Workload Scheduler for z/OS Agent. It is used together with the -tdwbport tdwbport_number parameter. It adds the capability |to run dynamic workload to the Tivoli Workload Scheduler for z/OS Agent. If not specified, the default |value is localhost. This value is registered |in the ResourceAdvisorUrl property in the JobManager.ini file. |
|
-tdwbport tdwbport_number
|
The dynamic domain manager of backup dynamic domain manager HTTP or HTTPS port number used to |connect to the Tivoli Workload Scheduler for z/OS Agent. It is used together with the -tdwbhostname host_name parameter to add the capability to run |dynamic workload to the Tivoli Workload Scheduler for z/OS Agent. This number is registered in the |ResourceAdvisorUrl property in the JobManager.ini file. |The default value is 0, meaning that the capability |to run dynamic workload to the agent is not added. The valid range |is from 0 to 65535. |
|
-u
|
Displays command usage information and exits. |
|
-uname username
|
The name of the user for which the Tivoli Workload Scheduler for z/OS Agent is installed. This |user name is not to be confused with the user performing the installation |logged on as root on UNIX and Linux, |as administrator on Windows, and as QSECOFR on IBM i. |

On UNIX, Linux and IBM i, |this user account must be created manually before running the installation. |Create a user with a home directory. By default, Tivoli Workload Scheduler for z/OS Agent is installed |in the home directory of the specified user.

|
|
-v
|
Displays the command version and exits. |
|
|
|

Examples

|
|

This example describes how to install the Tivoli Workload Scheduler for z/OS Agent and accept the |default value to add the runtime environment for Java. The runtime environment is used to run jobs |supplied with the product or implemented through the custom plug-ins, |it also enables the capability to remotely run, from the agent, the Dynamic Workload Broker resource |command on the server.

|
|
On UNIX and Linux operating systems:
|
|
./twsinst -new 
|-uname TWS_user 
|-jmportssl false
|-jmport 31114 
|-inst_dir /home/user1/TWA
|
|
On Windows operating |systems:
|
|
twsinst -new 
|-uname TWS_user 
|-password qaz12qaz 
|-jmportssl false 
|-jmport 31114 
|-inst_dir "c:\Program Files\IBM\TWA"
|
|
|