Defining a z/OS engine in the Z connector
To define a z/OS engine, perform the following steps.
- Browse to the connectionFactory.xml template, which is located in:
- On Windows operating systems
- <DWC_home>\usr\servers\dwcServer\configDropins\templates\zconnectors
- On UNIX operating systems
- <DWC_home>/usr/servers/dwcServer/configDropins/templates/zconnectors
- On z/OS operating systems
- <DWC_home>/usr/servers/dwcServer/configDropins/templates/zconnectors
- Copy the connectionFactory.xml template to a temporary directory.
On z/OS system, it is required that you copy the file on your local workstation in binary mode.
- Edit the file as necessary, specifying the connection details.
- Optionally, create a backup copy of the configuration file in a different directory, if the file is already present.
- Copy the edited connectionFactory.xml file to the following path:
- On Windows operating systems
- <DWC_home>\usr\servers\dwcServer\configDropins\overrides
- On UNIX operating systems
- <DWC_DATA_dir>/DWC_DATA/usr/servers/dwcServer/configDropins/overrides
- On z/OS operating system
- Ensure that you copy the file in binary mode. <DWC_DATA_dir>/DWC_DATA/usr/servers/dwcServer/configDropins/overrides.
- Replicate the change on all Dynamic Workload Console instances in the domain.
The contents of the connectionFactory.xml file, as it is created in the
zconnectors folder at installation time, is as follows:
<server description="zonnector_configuration">
<connectionFactory id="$(zconnName)"
jndiName="eis/tws/zconn/$(zconnName)">
<properties.ZOSConnectorAdapter hostName="$(zconnHostName)"
portNumber="$(zconnPortNumber)"
useSsl="$(zConnUseSsl)"
connectionTimeoutCleanup="10"/>
</connectionFactory>
</server>
where you specify:
- hostName
- The host name or TCP/IP address of the remote z/OS system where the HCL Workload Automation for Z controller is installed.
- portNumber
- The number of the TCP/IP port of the z/OS system that is used to communicate with the HCL Workload Automation for Z controller.
- useSsl
- Set true to enable the SSL communication between the Z connector and the remote z/OS system, or false to disable the property. This property is optional. The default is false.
- connectionTimeoutCleanup
- The connection timeout cleanup for the z/OS connection.
Note: In the
TWSZOSConnConfig.properties
file located in
<INSTALL_DIR>\usr\servers\dwcServer\resources\properties
, set the name of the
host where you installed the Dynamic Workload Console as
follows:com.ibm.tws.zconn.usr.mapping.hostName=DWC_hostname