/
Universal Data Mover Manager for z/OS

Universal Data Mover Manager for z/OS

Feb 27, 2023

Overview

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

UDM Manager transfers files between any computers running UDM Server. Using a UDM command script, you indicate to the UDM Manager the actions to take. The UDM Manager connects to the UDM Server (or Servers) and processes your request.

The z/OS Batch Manager provides a batch job interface to remote computers running the UDM Server component.

Usage

UDM Manager for z/OS executes as a batch job.

JCL Procedure

The following figure illustrates the UDM for z/OS JCL procedure (UDMPRC, located in the SUNVSAMP library) that is provided to simplify the execution JCL and future maintenance.

For this JCL procedure:

  • UPARM parameter is used to specify EXEC PARM keyword values.

  • UNVPRE parameter specifies the data set name prefix of Universal Agent installation data sets.

  • UNVPRD parameter specifies the data set name prefix of Universal Agent production data sets.

DD Statements in JCL

The following table describes the DD statements used in the UDM for z/OS JCL procedure, above.

ddname

DCB Attributes

Mode

Description

ddname

DCB Attributes

Mode

Description

STEPLIB

DSORG=PO,
RECFM=U

input

Universal Agent load library containing the program being executed.

UNVNLS

DSORG=PO,
RECFM=(F, FB, V, VB)

input

Universal Agent national language support library. Contains message catalogs and code page translation tables.

UNVUSRC

DSORG=PS,
RECFM=(F, FB, V, VB)

input

Universal SAP connector RFC member.

UNVCLIB

DSORG=PO,
RECFM=(F, FB, V, VB)

input

UDM call library: UDM searches for script files specified on the call command in this library.

UNVTRACE

DSORG=PS,
RECFM=(F, FB, V, VB)

Output

UDM trace output.

UNVTRMDL

DSORG=PS,
RECFM=(F, FB, V, FB)

input

Data set used as a model for creating UCMD and USAP trace files when they are called by UDM using the exec and execsap commands.

SYSPRINT

DSORG=PS,
RECFM=(F, FB, V, VB)

output

Standard output file for the UDM program.

SYSOUT

DSORG=PS,
RECFM=(F, FB, V, VB)

output

Standard error file for the UDM program.

SYSIN

DSORG=PS,
RECFM=(F, FB, V, VB)

input

Standard input file for the UDM program. UDM reads its command options from SYSIN.

UNVSCR

DSORG=PS,
RECFM=(F, FB, V, VB)

input

UDM command script: UDM executes the script allocated to this ddname.

 

The C runtime library determines the default DCB attributes. Refer to the IBM manual OS/390 C/C++ Programming Guide for details on default DCB attributes for stream I/O.

JCL

The following figure illustrates the UDM for z/OS JCL using the UDMPRC JCL procedure, above.

Job step STEP1 executes the procedure UDMPRC.

The UDM script commands are specified on the UNVSCR DD.

Configuration

Configuration consists of:

  • Setting default options and preferences for all executions of UDM Manager.

  • Setting options and preferences for a single execution of UDM Manager.

Configuration options are read from the following sources:

  1. PARM keyword

  2. SYSIN ddname

  3. Configuration file

The order of precedence is the same as the list above; PARM keyword options being the highest and configuration file being the lowest. That is, options specified via a PARM keyword override options specified via a SYSIN ddname, and so on.

See Configuration Management for detailed information on these methods of configuration.

Configuration File

The configuration file provides the simplest method of specifying configuration options whose values will not change with each command invocation. These default values are used if the options are not read from one or more other sources.

Some options only can be specified in the configuration file; they have no corresponding command line equivalent. Other options cannot be specified in the configuration file; they must be specified via one or more other sources for a single execution of UDM Manager.

Configuration Options

The following table describes the configuration options used to execute UDM Manager for z/OS. Each Option Name is a link to detailed information about that configuration option.

Command Line Syntax

The following figure illustrates the command line syntax of UDM Manager for z/OS.

udm [-alloc_abnormal_disp {keep|delete|catlg|uncatlg}] [-alloc_blksizesize] [-alloc_dataclasclass] [-alloc_dir_blocksnumber] [-alloc_dsorg {po|ps}] [-alloc_input_status {old|shr}] [-alloc_lrecllength] [-alloc_mgmtclasclass] [-alloc_normal_disp {keep|delete|catlg|uncatlg}] [-alloc_output_status {old|shr}] [-alloc_prim_spacespace] [-alloc_recfmformat] [-alloc_sec_spacespace] [-alloc_space_unit {cyl|trk|number}] [-alloc_storclasclass] [-alloc_unitunit] [-alloc_volsernumber] [-allow_repl_on_rename {yes|no}] [-system_idID] [-ssl_implementation {openssl|system}] [-ca_certsddname] [-certddname] [-private_keyddname [-private_key_pwdpassword] ] [-proxy_certificates {yes|no}] [-daysnumber] [-crlddname] [-scriptddname] [-optionsoptions] [-codepagecodepage] [-ctl_ssl_cipher_listlist] [-data_ssl_cipher_listlist] [-encrypt {yes|no|cipher} ] [-compress {yes|no}[,{zlib|hasp}] ] [-delayseconds] [-idle_timeoutseconds] [-keep_alive_intervalseconds] [-langlanguage] [-level {trace|audit|info|warn|error}[,{time|notime}] ] [-msg_suppression_listlist ] [-min_ssl_protocoloption] [-network_fault_tolerant {yes|no} [-frame_intervalnumber] ] [-mode_type {binary|text}] [-umasknumber] [-outboundiphost] [-portport] [-recvbuffersizesize] [-open_retry {yes|no}] [-open_retry_countnumber] [-open_retry_intervalnumber] [-retry_countnumber] [-retry_intervalseconds] [-sendbuffersizesize] [-saf_key_ringname] [-saf_key_ring_labellabel] [-server_stop_conditionscodes] [-tcp_no_delayoption] [-tcp_window_sizesize] [-tracefilelinesnumber] [-trace_tablesize,{error|always|never}] [-verify_host_name {yes|no}|host name] [-commenttext] udm { -help | -version }