Appendix F. z/OS connector response file properties

This section describes the properties used in the Tivoli Workload Scheduler for z/OS connector response files.

The provided files are template files, so you are recommended to edit the properties appropriately, and then save a copy of the file with a file name which identifies the component to be installed and the system on which it is to be installed.

The properties described in the following table have unique names and uses. Many of them contain default values that you can use.

The response file properties are shown in alphabetical order.

Notes:
  1. All values must be written between double quotation marks ("), for example: ZOSInstanceConfiguration.ZOSToConfigure="true".
  2. Properties are written in mixed case for ease of reading, but are not case-sensitive.
  3. Keywords (for example, "true") used in values, are not case-sensitive.
  4. If you are installing a z/OS® connector in an existing Tivoli Workload Automation instance, the WebSphere® Application Server port definitions are commented. You must uncomment these properties only if your existing Tivoli Workload Automation instance does not have a WebSphere Application Server installed. Follow the instructions provided in the response file as commented text.
Table 57. Tivoli Workload Scheduler for z/OS connector response file properties
Name Description Permitted values 
InstallationActions.
   TWA_INSTANCE_PATH
 Tivoli Workload Automation instance path

Identifies the path where an instance of Tivoli Workload Automation has already been installed. The z/OS connector will be installed in this instance.

 The fully qualified path of the existing Tivoli Workload Automation instance. You cannot use national characters in the installation path. 
licenseAccepted
 Accept license agreement

To install a component using a response file you must explicitly accept the license agreement, a copy of which is in the License directory of the product install media (DVD or downloaded image).
true
To accept the license agreement.
false
To not accept the license agreement. In this event the component is not installed. This is the default value. 
twsPortsPanel.
   portAdmin
 Administration HTTP transport port The default value is 31223. 
twsPortsPanel.
   portAdminSec
 Administration HTTPS transport port The default value is 31224. 
twsPortsPanel.
   portHTTP
 HTTP transport port The default value is 31215. 
twsPortsPanel.
   portHTTPS
 HTTPS transport port The default value is 31216. 
twsPortsPanel.
   portMtlAuth
 CSIV2 Client Authentication Listener port The default value is 31221. 
twsPortsPanel.
   portORB
 ORB Listener port The default value is 31222. 
twsPortsPanel.
   portRMI
 Bootstrap port The default value is 31217. 
twsPortsPanel.
   portSAS
 SAS Server Authentication Listener port The default value is 31219. 
twsPortsPanel.
   portSOAP
 SOAP connector port The default value is 31218. 
twsPortsPanel.
   portSrvAuth
 CSIV2 Server Authentication Listener port The default value is 31220. 
upgradePanel.
   bckpDirectory
 The backup path for the profile used by the embedded version of WebSphere Application Server. The profile is backed up by the installation procedure into the path you supply with this property. Any valid fully qualified path outside the path of any existing Tivoli Workload Scheduler component. 
userUnixCfgPanel.
   inputUserName
 The user ID of the TWS_user (on UNIX). The ID must already exist on the system where the silent wizard will be run. This user will own the instance of the z/OS connector. 
userUnixCfgPanel.
   twsPassword
 The password of the TWS_user (on UNIX). 
userWinCfgPanel.
   inputUserName
 The ID of the TWS_user - the user that will "own" the instance of the z/OS connector on the agent workstation (on Windows). If this user does not already exist, it will be created. In this case, the format of the ID must follow the rules for User IDs on the computer where it is to be created. 
userWinCfgPanel.
   twsPassword
 The password of the TWS_user (on Windows). If the user is to be created, the format of the password must follow the rules for passwords on the computer where it is to be created. 
ZOSInstanceConfiguration.
   ZOSToConfigure
 Specify if you want to configure a connection to a Tivoli Workload Scheduler for z/OS controller.
true
To configure a connection to a Tivoli Workload Scheduler for z/OS controller.
false
To skip the configuration of a connection to a Tivoli Workload Scheduler for z/OS controller. After the installation, you can create connections using WebSphere Application Server tools (wastools). 
ZOSInstanceConfiguration.
   engineName
 The name of the Tivoli Workload Scheduler for z/OS controller. It is a label that identifies the z/OS connector instance. 
ZOSInstanceConfiguration.
   remoteHost
 The host name or TCP/IP address of the Tivoli Workload Scheduler for z/OS controller. A valid hostname or TCP/IP address. 
ZOSInstanceConfiguration.
   remotePort
 The host name or TCP/IP port number used to communicate with the Tivoli Workload Scheduler for z/OS controller. This value must correspond to the value specified in the SERVOPTS member on the controller. The default value is 11111.