Defining a z/OS engine in the Z connector

To define a z/OS engine, perform the following steps.

This picture describes the steps required for installing the Dynamic Workload Console. You are now at step 5: defining a z/OS engine in Z connector.
  1. Depending on your operating system, browse to the connectionFactory.xml template:
    Windows operating systems
    <DWC_home>\usr\servers\dwcServer\configDropins\templates\zconnectors
    UNIX operating systems
    <DWC_home>/usr/servers/dwcServer/configDropins/templates/zconnectors
    z/OS operating systems
    <DWC_home>/usr/servers/dwcServer/configDropins/templates/zconnectors
  2. Copy the connectionFactory.xml template to a temporary directory.

    On z/OS system, it is required that you copy the file on your workstation in binary mode.

  3. Edit the file by specifying the required connection details.
    The following example shows the connectionFactory.xml file, as it is created in the zconnectors folder at installation time: 
    <server description="zonnector_configuration">
    
        <connectionFactory id="$(zServerConnectionName)"
        jndiName="eis/tws/zconn/$(zServerConnectionName)">
        <properties.ZOSConnectorAdapter hostName="$(zServerHostName)"
                                        portNumber="$(zServerPortNumber)"
                                        useSsl="$(zConnUseSsl)"
                                        connectionTimeoutCleanup="10"/>
                                        </connectionFactory>
                                        </server>
    Set the following values:
    zServerConnectionName
    Name of the connection between the Z connector and z/OS server started task.

    Starting from the Dynamic Workload Console V10.2.3, if you enabled the mirroring of data to a database, this value must be coincident with the value set in the CONNECTIONFACTORYID parameter of the MIRROPTS statement.

    zServerHostName
    The host name or TCP/IP address of the remote z/OS system where the Z controller is installed.
    Note: If the Dynamic Workload Consoleand Z controller are installed on the same z/OS system, you must specify the TCP/IP address of the z/OS system.
    zServerPortNumber
    The TCP/IP port that is used to communicate with the z/OS server started task, hence with the Z controller. This is the value specified in the SRVPORTNUMBER parameter of the TCPOPTS statement in the server started task.
    zConnUseSsl
    Set true to enable the SSL communication between the Z connector and the remote z/OS system, or false to disable this 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
  4. Optionally, create a backup copy of the configuration file in a different directory, if the file is already present.
  5. Depending on your operating system, copy the edited connectionFactory.xml file to the following path. Changes are immediately effective.
    Windows operating systems
    <DWC_home>\usr\servers\dwcServer\configDropins\overrides
    UNIX operating systems
    <DWC_DATA_dir>/DWC_DATA/usr/servers/dwcServer/configDropins/overrides
    z/OS operating systems
    Ensure that you copy the file in binary mode. <DWC_DATA_dir>/usr/servers/dwcServer/configDropins/overrides.
  6. Replicate the change on all the Dynamic Workload Console instances in the domain.