Universal Data Mover Server for z/OS

Overview

This page provides information on the Universal Data Mover (UDM) Server, specific to the z/OS operating system.

Component Definition

All Universal Agent 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.7.x Reference Guide.)

The UDM Server for z/OS component definition is located in the component definition library #HLQ.UNV.UNVCOMP allocated to the Universal Broker ddname UNVCOMP. The UDM Server component definition member is UDSCMP00.

The following table identifies all of the options that comprise the UDM Server for z/OS 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

Member name of the UDM Server configuration file in the UNVCONF library allocated to the Broker ddname UNVCONF.

RUNNING_MAXIMUM

Maximum number of UDM Servers that can run simultaneously.

START_COMMAND

Member name of the UDM Server program.

WORKING_DIRECTORY

HMS directory used as the working directory of the UDM Server.

Configuration

Universal Data Mover Server configuration consists of defining runtime and default values.

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 Universal Data Mover Server component definition (see Universal Data Mover Component Definition Options). The default name is UDSCFG00. The name refers to a member in the PDS allocated to the Universal Broker ddname UNVCONF.

Configuration Options

The following table identifies all UDM Server for z/OS command options. Each Option Name is a link to detailed information about that option.

Option

Description

ACTIVITY_MONITORING

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

ALLOC_ABNORMAL_DISP

Abnormal disposition of a data set being allocated.

ALLOC_BLKSIZE

Block size used for newly allocated data sets.

ALLOC_DATACLAS

SMS data class used for newly allocated data sets.

ALLOC_DIR_BLOCKS

Number of directory blocks for newly allocated partitioned data sets.

ALLOC_DSORG

Data set organization used for newly allocated data sets.

ALLOC_INPUT_STATUS

Status of data sets being allocated for input.

ALLOC_LRECL

Logical record length used for newly allocated data sets.

ALLOC_MGMTCLAS

SMS management class used for newly allocated data sets.

ALLOC_NORMAL_DISP

Normal disposition of a data set being allocated.

ALLOC_OUTPUT_STATUS

Status of existing data sets being allocated for output.

ALLOC_PRIM_SPACE

Primary space allocation used for newly allocated data sets.

ALLOC_RECFM

Record format used for newly allocated data sets.

ALLOC_SEC_SPACE

Secondary space allocation used for newly allocated data sets.

ALLOC_SPACE_UNIT

Space unit in which space is allocated for newly allocated data sets.

ALLOC_STORCLAS

SMS storage class used for newly allocated data sets.

ALLOC_UNIT

Unit used for newly allocated data sets.

ALLOC_VOLSER

Volume serial number used for newly allocated data sets.

ALLOW_REPL_ON_RENAME

Specification for whether or not the UDM rename command will succeed if the new file name provided in that command matches the name of an existing file.

CODE_PAGE

Character code page used to translate text data.

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.

MSG_SUPPRESSION_LIST

List of message IDs representing Universal messages to be suppressed.

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.

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.

VERIFY_HOST_NAME

User security option.
Specification for whether or not the Universal Broker's X.509 certificate identity is verified.

Universal Access Control List

UDM Server uses the Universal Access Control List (UACL) file as an extra layer of security. The UACL file contains Universal Data Mover Server entries that contain Access Control List (ACL) rules that permit or deny access to the 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 z/OS 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.