/
Universal Data Mover Manager for z/OS

Universal Data Mover Manager for z/OS

Jul 15, 2024

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.

//UDMPRC PROC UPARM=, -- UDM options // USPRFC=USPRFC00, -- USAP SAP RFC member // UNVPRE=#SHLQ.UNV, // UNVPRD=#PHLQ.UNV //\* //PS1 EXEC PGM=UDM,REGION=256M,PARM='ENVAR(TZ=EST5EDT)/&UPARM' //STEPLIB DD DISP=SHR,DSN=&UNVPRE..SUNVLOAD //* //UNVNLS DD DISP=SHR,DSN=&UNVPRE..SUNVNLS //UNVUSRC DD DISP=SHR,DSN=&UNVPRD..UNVCONF(&USPRFC) //UNVCLIB DD DISP=SHR,DSN=&UNVPRE..SUNVSAMP //* //UNVTRACE DD SYSOUT=* //UNVTRMDL DD DISP=SHR,DSN=&UNVPRD..MDL //* //SYSPRINT DD SYSOUT=* //SYSOUT DD SYSOUT=* //CEEDUMP DD SYSOUT=* //SYSUDUMP DD SYSOUT=* //* //SYSIN DD DUMMY -- UDM command options //UNVSCR DD DUMMY -- UDM script

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.

//jobname JOB CLASS=A,MSGCLASS=X //STEP1 EXEC UDMPRC //UNVSCR DD * open srv=sol7 user=id001 pwd=pwd001 copy local='uid.data' srv=data quit /*

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.