Software packages and parameters

The Tivoli Workload Scheduler for z/OS Agent can be installed by distributing |a software package block (SPB), using the Software Distribution component |of Tivoli® Configuration Manager, |Versions 4.1, 4.2, 4.2.1, 4.2.2, or 4.2.3. You can distribute the |SPB, by using either the command line interface or from the Tivoli desktop.

Note:

Do |not modify the SPB supplied with the product.

An SPB exists for each supported operating system located |on the installation disks under the directory of the operating system. |The SPBs are named according to the operating system: Tivoli_LWA_operating_system.SPB. For the packages to |be distributed, they must be imported in software package profiles. |The software package profiles must be named according to the operating |system and user: TWS_LWA_operating_system_TWS_user.8.6.0.00. Possible values for operating |system are:

AIX®

SOLARIS

WINDOWS

LINUX_I386

LINUX_PPC

LINUX_S390

SOLARIS_I386

HPIA64

LINUX_X86_64

WINDOWS_X86_64

The Tivoli Workload Scheduler for z/OS Agent installation parameters are defined as default variables |in the software package. Following is the list of installation parameters.

backup

||Optional. Indicates a backup. For a fresh install, specify false. The default value is false. |

display_name

||The name of the agent, as shown by the Dynamic Workload Console. |

domain

||Optional unless the user is a domain user. Windows operating systems only. The domain name of |the user. The default value is computer_name. |

fresh_install

||Required. Indicates if this is a first time install. To perform |a fresh installation, specify true. To |perform an upgrade, specify false. The |default value is true. |

group

||The group, at operating system level, to which the user belongs. |

host_name

||The fully qualified host name or IP address on which the agent |will be contacted by the Dynamic Workload Broker. |

installer

||Windows only. The user |ID of the installer of the Tivoli Workload Scheduler for z/OS Agent. The default value is Administrator. |

install_dir

||Required. The fully qualified path to the location of the Tivoli Workload Scheduler for z/OS Agent installation. This |path must be a fully qualified path and cannot contain blanks. On Windows workstations, the path |is created if it does not already exist. On UNIX, Linux and IBM i, |the path is the same as the user's home directory. The default values |are: |

UNIX, Linux and IBM i, operating systems: user_home

Windows operating systems: $(system_drive)\win32app1TWS\TWS_user

jm_port

||Specify the value of the HTTP port that is used for communication |between the Tivoli Workload |Scheduler server and the Tivoli Workload |Scheduler agent with dynamic capabilities enabled or the communication |between the Tivoli Workload |Scheduler for z/OS® server and |the Tivoli Workload Scheduler |agent with z-centric capabilities. |

To communicate in HTTP you must |also set the following parameters: -D jm_port=nnnnn where nnnnn is the port number and -D jm_sec_port=0. |The default number of jm_port is 31114.

jm_sec_port

||Specify the value of the HTTPS port that is used for communication |between the Tivoli Workload |Scheduler server and the Tivoli Workload |Scheduler agent with dynamic capabilities enabled or the communication |between the Tivoli Workload |Scheduler for z/OS server and |the Tivoli Workload Scheduler |agent with z-centric capabilities. |

To communicate in HTTPS, you |must also set the following parameters: -D jm_port=0 -D jm_sec_port=nnnnn where nnnnn is the |port number. The default number of jm_sec_port is 31114.

password (for Windows only)

||Required for Windows operating |systems when performing a first time install. The password associated |with TWS_user. |

tdwb_hostname

||Optional. The Dynamic Workload Broker fully qualified host name. Used together |with the -tdwbport tdwbport_number parameter. |Adds to the Tivoli Workload Scheduler agent the capability to run dynamic workload. If |not specified, the default value is localhost. |This value is registered in the ResourceAdvisorUrl property in the JobManager.ini file. |

tdwb_port

||Optional. The Dynamic Workload Broker HTTP or HTTPS port number. Used together |with the -tdwb_hostname host_name parameter. |Adds to the Tivoli Workload Scheduler agent the capability to run dynamic workload. 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. |

tws_user

||Required. The user name for which Tivoli Workload Scheduler instance is being installed. |On Windows systems, if this |user account does not already exist, it is automatically created. |If you specify a domain user or domain controller, you must specify |the domain in the domain variable. If you |specify a local user with the same name as a domain user, the local |user must first be created manually by an administrator and then identified |as system_name\user_name. |

On UNIX and Linux, this user account must be created manually |before running the installation.

upgrade

||Required. Indicates if the install is an upgrade. To perform |an upgrade, specify true. To perform a |fresh installation, specify false. The |default value is false. |

| |

Notes:

fresh_install and upgrade are mutually exclusive.

The variables that are not documented here are for debugging purposes |only. See Tivoli Workload Scheduler: Administration Guide.