Universal Data Mover Server for IBM i

Currently, IBM i runs Workload Automation 5.1.1.   These pages provide information for that version.

Overview

This page provides the following information on the Universal Data Mover (UDM) Server, specific to the IBM i operating system.

Component Definition

All Workload Automation 5 components managed by Universal Broker have a component definition. The component definition is a text file of options containing component-specific information required by Universal Broker. (For details on how Universal Broker manages components, see the Universal Broker 7.2.x Reference Guide.)

The syntax of a component definition file is the same as a configuration file.

The UDM Server for IBM i component definition is located in the component definition directory of the Universal Broker.

Component Definition Options

The following table identifies all of the options that comprise the UDM Server for IBM i component definition. Each Option Name is a link to detailed information about that component definition option.

Option Name

Description

AUTOMATICALLY_START

Specification for whether or not UDM Server starts automatically when Universal Broker is started.

COMPONENT_NAME

Name by which the clients know the UDM Server.

CONFIGURATION_FILE

Full path name of the UDM Server configuration file.

RUNNING_MAXIMUM

Maximum number of UDM Servers that can run simultaneously.

START_COMMAND

Full path name of the UDM Server program.

WORKING_DIRECTORY

Full path name of the UDM Server working directory.

Configuration

UDM Server configuration consists of defining runtime and default values. This section describes the Server configuration options.

Configuration File

The configuration file provides the simplest method of specifying configuration values that will not change with each command invocation.

The UDM Server configuration file name is specified in the UDM Server component definition (see Universal Data Mover Component Definition Options). The default name is UNVPRD511/UNVCONF(UDMS).

This file can be edited manually with any text editor.


Configuration Options

The following table identifies all Universal Data Mover Server for IBM i configuration options. Each Option Name is a link to detailed information about that configuration option.

Option

Description

ACTIVITY_MONITORING

Specification for whether or not product activity monitoring events are generated.

CODE_PAGE

Character code page used to translate text data.

CODEPAGE_TO_CCSID_MAP

Specification to use either the internal or external table for code page to CCSID mapping.

DATA_COMPRESSION

Specification for whether or not data is compressed on all standard I/O files.

DATA_SSL_CIPHER_LIST

SSL/TLS cipher suites to use for data session between UDM primary and secondary servers.

EVENT_GENERATION

Events to be generated as persistent events.

FRAME_INTERVAL

Number of UDM transfer blocks transferred before a frame-sync message is sent with network fault tolerance turned on.

MESSAGE_LEVEL

Level of messages that UDM will write to the Universal message Catalog (UMC) file.

MIN_SSL_PROTOCOL

Minimum SSL/TLS protocol level that will be negotiated and used for communications channels.

Note

This option was introduced to IBM i in version 5.1.1.0.

NETWORK_DELAY

Expected network latency (in seconds).

OUTBOUND_IP

Host or IP address that UDM binds to when initiating outgoing connections to another UDM server.

RECONNECT_RETRY_COUNT

Number of attempts that the UDM Manager will make to re-establish a transfer session when a network fault occurs.

RECONNECT_RETRY_INTERVAL

Number of seconds that UDM will wait between each successive attempt to re-establish a transfer session when a network fault occurs.

RECV_BUFFER_SIZE

Size (in bytes) of the application's incoming buffer for UDM.

SEND_BUFFER_SIZE

Size (in bytes) of the application's outgoing buffer for UDM.

SIZE_ATTRIB

Default size for file creation of physical files for both data and source file types.

TCP_NO_DELAY

Specification for whether or not to use TCP packet coalescing.

TCP_WINDOW_SIZE

TCP/IP buffer size of a secondary UDM Server that receives a file from a primary Server in a three-party transfer.

TMP_DIRECTORY

Directory that UDM Server uses for temporary files.

TRACE_FILE_LINES

Maximum number of lines to write to the trace file.

TRACE_TABLE

Size of a wrap-around trace table maintained in memory.

UMASK

File mode creation mask.

USER_SECURITY

User security option.

Universal Access Control List

UDM Server uses the Universal Access Control List (UACL) file as an extra layer of security. The UACL file contains UDM Server entries that contain Access Control List (ACL) rules that permit or deny access to the UDM Server.

UACL Entries

The syntax of a UACL entry file is the same as the UDM configuration file.

The following table identifies all UDM Server for IBM i UACL entries. Each UACL Entry Name is a link to detailed information about that UACL entry.

UACL Entry Name

Description

UDM_ACCESS

Allows or denies access to Universal Data Mover Server services

UDM_MGR_ACCESS

Allows or denies access based on the host name and/or user of the Manager trying to initiate a UDM session