Universal Data Mover 7.7.x Quick Reference Guide

Command Format

command [parameter[=value] ]...


*appenddata* _data_element_name_ [_value_1_]... [_value_n_]

Parameter

Description

data_element_name

Name of a data element.

value_1

First value in the line of text to be appended.

value_n

Last value in the line of text to be appended.


*attrib* _logical-name_=[ {*dd* | *dsn* | *hfs* | *lib*} ] [attribute-name=attribute-value]...

Parameter

Description

logical-name

Logical name of the transfer server to which the attribute(s) applies.

dd | dsn | hfs | lib

File system for which the attribute(s) applies.

attribute-name

Name of an attribute.

attribute-value

Value to be set for the attribute.


break

(There are no parameters used with this command.)


*call* script-file [parameter-name=parameter-value]...

Parameter

Description

script-file

Name of the script file to execute.

parameter-name

Name of a parameter to pass to the script.

parameter-value

Value to be set for the parameter.



*cd* _logical-name_[=_directory_]

Parameter

Description

logical-name

Logical name of the transfer server to execute the cd command.

directory

Working directory to change to on the server.


close

(There are no parameters used with this command.)


closelog

(There are no parameters used with this command.)



*compare* STRING_1 STRING_2 [case=*yes* | *no*] [length=_length_]

Parameter

Description

STRING_1

String to be compared to STRING_1.

STRING_2

String to be compared to STRING_2.

case = yes | no

Specification for whether or not the comparison is case-sensitive

  • If set to yes, comparison is case-sensitive.
  • If set to no, comparison is not case-sensitive.

(If the case parameter is not used, the comparison is case insensitive.)

length=length

First n characters to be compared.



copy source-logical-name=file-specification [destination-logical-name=file specification]

Parameter

Description

source-logical-name

Logical name of the source transfer server in the copy operation.

file-specification

File specification for the source file.

destination-logical-name

Logical name of the destination transfer server in the copy operation.

file-specification

File specification for the destination file.



copydir source-logical-name=file-specification [destination-logical-name=file-specification]

Parameter

Description

source-logical-name

Logical name of the source transfer server in the copy operation.

file-specification

File specification for the source file directory.

destination-logical-name

Logical name of the destination transfer server in the copy operation.

file-specification

File specification for the destination file or directory.



data [name | print=name] [resolve={all | defined | no} ] [data-element] [end=end-sequence]

Parameter

Description

name | print=name

Specifies either the name of the in-stream data element being defined (name) or a request to print the lines of that data element.

resolve={all | defined | no}

Variable resolution method:

  • all: Resolve all variable references in the data.
  • defined: Resolve only defined variable references in the data.
  • no: Do not resolve any variable references in the data.

data-element

Contents of the in-stream data element being defined.

end=end-sequence

Sequence indicating the end of the data.



debug [EXPRESSION_SHOW_POSTFIX=yes | no] [EXPRESSION_SHOW_EVALUATION=yes | no] [COMMAND_SHOW_STRUCTURE=yes | no]

Parameter

Description

EXPRESSION_SHOW_POSTFIX=yes | no

Postfix version of an expression after it has been converted from infix notation.

EXPRESSION_SHOW_EVALUATION=yes | no

Evaluation of an expression.

COMMAND_SHOW_STRUCTURE=yes | no

Different elements of a command after it has been parsed.


delete logical-name=file-specification

Parameter

Description

logical-name

Logical name of the server on which to delete the file(s).

file-specification

File(s) to be deleted; single filename or a complete path to a file or directory.

The filename (or filename portion of the path) can contain wildcard characters:

  • Wildcard * represents zero or more characters.
  • Wildcard ? indicates a single character.



deletestring variable_name {pos=position} | {startseq=sequence [startseqnum=number] } {length=length} | {endseq=sequence [endseqnum=number] } [case=yes | no]

Parameter

Description

variable-name

Name of an existing variable.

pos=position

Starting position of sequence to be deleted (one-based index).

startseq=sequence

Starting position of sequence to be deleted (following a specific character sequence).

startseqnum=number

Occurrence number of starting position of sequence to be deleted (following a specific character sequence).

length=length

Length of the substring to be deleted.

endseq=sequence

Ending position of sequence to be deleted (preceding a specific character sequence).

endseqnum=number

Occurrence number of ending position of sequence to be deleted (preceding a specific character sequence).

case=yes | no

Indicates whether or not the comparisons of the sequence are case-insensitive.



diskspace logical_name [=path] | [qty=nnn{b|k|m|g}] [cond=GT | LT]

Parameter

Description

logical-name

Name of the system where UDM checks available space.

If path is specified, diskspace checks the volume or file system where that directory resides. Otherwise, the current working directory is used..

qty=nnn{b|k|m|g}

Amount of space that diskspace should look for.

To specify a unit for the quantity, add one of the following letters to the quantity amount:

  • b - bytes
  • k - kilobytes (1,024 bytes)
  • m - megabytes (1,048,576 bytes)
  • g - gigabytes (1,073,741,824 bytes)

If no unit is specified, the default (b - bytes) is used.

If no quantity is specified, diskspace displays the amount of available space.

cond=GT | LT

Instructs diskspace to check for an amount that is greater than (GT) or less than (LT) the specified quantity.

This parameter is optional. If no condition is specified, GT is used.



echo [parm_1]... [parm_n]

Parameter

Description

parm_1

First parameter to echo.

parm_n

Other parameter(s) to echo.



echolog [value_1]... [value_n]

Parameter

Description

value_1

First parameter to echo.

value_n

Other parameter(s) to echo.



exec logical-name | host-name {cmd=command | cmdref=command-ref | stc=started-task} [user=user-id] [pwd=password] [port=port] [codepage=codepage] [file=filename | xfile=filename [key=key] ] [option=option] [mergelog=yes | no] [trace=yes | no] [input=data-element] [svropt=server-options] [stdout=data-element] [stderr=data-element]

Parameter

Description

logical-name

Logical name of the server on which to execute the command.

host-name

Host name of the server on which to execute the command.

cmd=command

Name of command to execute of command type cmd.

cmdref=command-ref

Name of command reference to execute of command type cmdref.

stc=started-task

Name of started task to execute of command type stc.

user=user-id

User ID with which the command is to be executed.

pwd=password

Password for the specified user ID.

port=port

Port that the broker is listening on for the machine the command is to be executed on.

codepage=codepage

Codepage used for executing the command.

file=filename

Plain text file containing the options for the remote execution server. These options include: port, user, pwd, and codepage.

Note

The options in this file override any corresponding options specified for the transfer server in the open command.

xfile=filename

Universal Encrypted text file containing the options for the remote execution server. These options include: port, user, pwd, and codepage.

Note

The options in this file override any corresponding options specified for the transfer server in the open command.

key=key

Key used to decrypt an encrypted option file.

option=option

Options to be passed to the UCMD Server.

mergelog=yes | no

Specification for whether or not to merge standard out and standard error output streams from a remote command to the UDM transaction log:

  • yes: Merge data streams in UDM transaction log.
  • no: Do not merge data; keep as separate data streams.

trace=yes | no

Specification for whether or not trace functionality is used:

  • yes: Tracing turned on in the call to UCMD.
  • no: Tracing turned off in the call to UCMD.

input=data-element

Name of the data element that is used as input to the command being executed.

svropt=server-options

Options used to override Universal Command Server options.

stdout=data-element

Data element to be used as standard out from the remote command.

stderr=data-element

Data element to be used as standard error from the remote command.



execsap [host=host-name | destination type=event | generic [eventid=event-id] [parm=event-parm] [client=client] [user=user-id] [pwd=password] [codepage=codepage] [file=filename | xfile=filename [key=key] ] [mergelog=yes | no] [trace=yes | no]

Parameter

Description

host

SAP destination entry.

destination

Destination in the SAP RFC file.

type=event

Type of SAP operation to perform (event is the only valid type).

eventid

ID of the SAP event to trigger.

parm

Parameter to the SAP operation.

client

Name of the SAP client.

user=user-id

User ID with which the command is to be executed.

pwd=password

Password for the specified user ID.

codepage=codepage

Codepage used for executing the command.

file=filename

Plain text file containing the options for the remote execution server. These options include: port, user, pwd, and codepage.

Note

The options in this file override any corresponding options specified for the transfer server in the open command.

xfile=filename

Universal Encrypted text file containing the options for the remote execution server. These options include: port, user, pwd, and codepage.

Note

The options in this file override any corresponding options specified for the transfer server in the open command.

key=key

Key used to decrypt an encrypted option file.

mergelog=yes | no

Specification for whether or not to merge standard out and standard error output streams from a remote command to the UDM transaction log:

  • yes: Merge data streams in UDM transaction log.
  • no: Do not merge data; keep as separate data streams.

trace=yes | no

Specification for whether or not trace functionality is used:

  • yes: Tracing turned on in the call to UCMD.
  • no: Tracing turned off in the call to UCMD.


exit

(There are no parameters used with this command.)





filesys logical-name=[ {dd | dsn | hfs | lib} ]

Parameter

Description

logical-name

Logical name of the transfer server on which to change the file system.

dd | dsn | hfs | lib

File system to set for the specified server:

  • dd: ddnames defined with JCL DD statements (z/OS only)
  • dsn: data set name (z/OS only)
  • hfs: UNIX System Services file system (z/OS and IBM i only)
  • lib: LIB file system (IBM i only)



filetype [binary | text=filemask_1]...[binary | text=filemask_n] [remove=filemask_1]...[remove=filemask_n] [resetall]

Parameter

Description

binary | text = filemask_1

Sets the specified file mask (filemask_1) so that source file names matching this mask will be transferred as binary files.

binary | text = filemask_n

Sets the specified file mask (filemask_n) so that source file names matching this mask will be transferred as text files.

remove=filemask_1

Removes an entry that matches the specified file mask (filemask_1).

remove=filemask_n

Removes an entry that matches the specified file mask (filemask_n).

resetall

Removes all file mask entries.



find string seq=sequence [pos=index] [case=yes | no] [num=number | last]

Parameter

Description

string

String in which to search for the sequence.

seq=sequence

Sequence for which the search is being made.

pos=index

One-based index of the string where the find operation begins.

case=yes | no

Specification of whether the search is case-sensitive (yes) or case-insensitive (no).

[Default is no.]

num=number | last

Instance of the sequence for which the search is being made.



format variable_name [ {string_1 | expression_1} [align={center | left | right | justify} ] [pad=sequence] [trunc=yes | no] [length=length] ]...[ {string_n | expression_n} [align=center | left | right | justify] [pad=sequence] [trunc=yes | no] [length=length] ]

Parameter

Description

variable_name

Variable or list element in which the newly formatted string is stored

string_1 | expression_1

First section of the string

align=center | left | right | justify

Method of how the value is aligned within the given space.

[Default alignment is left.]

pad=sequence

Character(s) used to pad out the formatted value.

[Default is space character.]

trunc=yes | no

Truncates the value to the length given by length if it is longer than that value.

[Default is to not truncate.]

length=length

Length of the formatted field.

[Default is length of the value specified.]



insertstring variable_name sequence {pos=position | startseq=sequence startseqnum=number} [case=yes | no]

Parameter

Description

variable_name

Name of the existing variable or list element into which to insert the sequence.

sequence

Sequence to be inserted.

pos=position

Position at which sequence is inserted.

startseq=sequence

Sequence after which specified sequence is inserted.

startseqnum=number

Instance of sequence after which specified sequence is inserted.

case=yes | no

Specification of whether or not the comparison used to find the start sequence is case\-insensitive.

[Default is no.]


loaddata data-element-name=file-path

Parameter

Description

data-element_name

Data element into which the file contents is loaded.

file_path

File from which contents is loaded into the data element.


logdata data_element_name

Parameter

Description

data_element_name

Name of the data element to write to the open log.


lower variable_name

Parameter

Description

variable_name

Variable or list element in which to force alphabetic characters to lower case.



mode [type={text | binary} ] [trim={ yes | no} ]

Parameter

Description

type=text | binary

Type of transfer mode to be used:

  • text: UDM sends source data as is.
  • binary: UDM performs text translation on data.

[Default is binary when a new session is opened.]

trim=yes | no

Trim trailing spaces during a text transfer:

  • yes: Spaces at the end of each line (record) are removed from the data when it is written.
  • no: Spaces at the end of each line (record) are not removed.

[Default is no when a transfer session is initiated.]



move source-logical-name=source-file-specification [destination-logical-name=destination-file-specification]

Parameter

Description

source-logical-name

Logical name of the server acting as the source of the move operation.

file-specification

File(s) to be copied. It can be a single file name or a complete path.

The file name (or file name portion of the path) can contain wildcard characters:

  • Wildcard * represents for zero or more characters.
  • Wildcard ? indicates a single character.

destination-logical-name

Logical name of the destination server in the move operation.

file-specification

Complete path or file name for the destination file.



open [ [primary ={* | local | hostname} [port=port] [user=username [pwd=password] ] [codepage=codepage] [ {file=filename | xfile=filename [key=key] } ] secondary =hostname [port=port] [user=username [pwd=password] ] [codepage=codepage] [file=filename] [xfile=filename [key=key] ] [encrypt={yes | no | cipher} ] [compress={yes | no | hasp | zlib} ] [nft=yes | no] [comment=text] [tt=direct | deferred]

Parameter

Description

primary=* | local | hostname

Logical name of the primary transfer server:

  • * or local: Manager is the primary server in a two-party transfer
  • hostname: Host name or IP address of a transfer server

port=port

Port that the Universal Broker is listening on that will initiate the primary transfer server.

user=username

Name of the user to authenticate on the primary transfer server.

pwd=password

Password used to authenticate the specified user.

codepage=codepage

Codepage to use for text translation by the primary transfer server.

file=filename

Plain text file that can contain open options for the primary transfer server.

xfile=filename

Universal Encrypted file that can contain open options for the primary transfer server.

key=key

Encryption key used to decrypt the specified encrypted open options file.

secondary=hostname

Logical name of the secondary transfer server. hostname is the Host name or IP address of the machine on which the server will be running.

Note

Host name must be given from the perspective of the primary transfer server, not the UDM Manager.

port=port

Port that the Universal Broker is listening on that will initiate the secondary transfer server.

user=username

Name of the user to authenticate on the secondary transfer server.

pwd=password

Password used to authenticate the specified user.

codepage=codepage

Codepage to use for text translation by the secondary transfer server.

file=filename

Plain text file that can contain open options for the secondary transfer server.

xfile=filename

Universal Encrypted file that can contain open options for the secondary transfer server.

key=key

Encryption key used to decrypt the specified encrypted open options file.

encrypt=yes | no | cipher

Encryption method for the transfer session:

  • yes: Use cipher based on list in the -data_ssl_cipher_list option.
  • no: Use NULL-MD5 cipher.
  • cipher: Specific cipher to use.

compress= yes | no | hasp | zlib

Data compression method for the transfer session:

  • yes: Use method as specified in the -compress option.
  • no: Do not use data compression.
  • hasp: Use HASP compression.
  • zlib: Use ZLIB compression.