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 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:
|
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:
|
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:
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:
|
trace=yes | no | Specification for whether or not trace functionality is used:
|
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:
|
trace=yes | no | Specification for whether or not trace functionality is used:
|
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:
|
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:
[Default is binary when a new session is opened.] |
trim=yes | no | Trim trailing spaces during a text transfer:
[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:
|
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:
|
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:
|
compress= yes | no | hasp | zlib | Data compression method for the transfer session:
|