...
If no file system name is specified, the attributes will be applied for the currently selected file system. If no attributes are specified, the transfer server returns its current set of attributes and their values.
Parameters
...
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
...
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
...
- Values dd and dsn are valid only on z/OS file systems.
- Value hfs is valid only on z/OS and IBM i file systems.
- Value lib is valid only on IBM i file systems.
...
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
...
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
...
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
...
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
...
The following attributes are common to UDM on most platforms.
Attribute Name
Values
Description
yes, no
Note | ||
---|---|---|
| ||
This attribute is used only for UDM for z/OS, when using the dd or dsn file system. |
Specifies whether American Standards Association (ASA) print control characters are translated for data sets whose record format includes an A (for example: FA, FBA, VBA).
For more information regarding UDM handling of ASA text files, see UDM - Copying ASA Text Files - z/OS.
default, yes, no
Controls byte order mark (BOM) processing for UTF16-encoded output files.
When a file is written using one of the UTF-16 encodings - UTF-16, UTF-16LE, or UTF-16BE - the bom attribute specifies whether or not a byte order mark (BOM) should be included at the start of the output file.
If the value of bom is default, then the conversion routines decide whether or not a BOM is included in the output file. This value is provided for compatibility with the UDM 6.2.0 release, which introduced UTF-16 conversions, but did not provide BOM handling.
The behavior when bom=default is:
The default value is default.
casesensitive
yes, no
Controls how forfiles wildcard variable expansion is processed. The value should match how the forfiles file list was generated on the target UDM server; in most cases, that will be true. However, Windows has some unique casing scenarios; for example, it is possible for the file system to be mostly case insensitive while one or more specific directories are case sensitive.
The casesensitive attribute is associated with the file system; its default value is set based on the file system type:
- UNIX: yes
- WINDOWS: no
- DD: no
- DSN: no
- HFS: yes
createop
append, new, or replace
Specification for how the file is to be created:
Default is new.
defext
Any sequence of characters valid for the destination file system.
Sequence of characters appended to the end of the filename used to write the destination file, if the source filename is being used implicitly as the destination filename. This occurs after the file extension has been truncated (if truncext is set to yes).
By default, no default extension is defined.
Note | ||
---|---|---|
| ||
The sequence of characters is appended verbatim. UDM does not add a dot character before the sequence, so if one is desired, it must be specified explicitly. |
eol
Any sequence of valid text data.
End-of-line sequence used in text transfers.
For the source side of a copy operation, excepting those from the z/OS dd and dsn file systems and the IBM i lib file system, the end-of-line sequence is used to determine the end of each line of data. When the specified sequence occurs in the data, UDM considers all data read up to that point (starting from the previous line) as a single line. Each line is transferred without the end-of-line sequence.
On the destination side of a text transfer, the end-of-line sequence is appended to the end of each line before it is written.
Two special character sequences can be used in any end of line sequence:
Default depends on the platform and the file system:
- Under Windows, the default is \r\n.
- For UNIX platforms and the HFS file system under USS, the default value is \n.
- Under z/OS (for the dd and dsn file systems) and IBM i (for the lib file system), the eol attribute is undefined.
- Under IBM i (for the hfs file system), the default is FILE, which makes end-of-line terminator consistent with file ccsid.
linelen
A positive integer
Maximum length of each line of data (record under the z/OS dd and dsn file systems) written. It applies only to the destination side of a transfer and is used in conjunction with the lineop and padline attributes.
Default is 0.
- Under Windows, UNIX, and the hfs file system, this means no line operation takes place.
- Under z/OS (for the dd and dsn file systems), the value linelen will be set equal to the logical record size used in allocating the destination file.
lineop
none, stream, wrap, or trunc
Line operation for transferred lines (records under the z/OS dd and dsn file systems).
For the line operation to be in play in the transfer, the value of linelen must not be zero (linelen is set automatically for the z/OS dd and dsn file systems to the logical record size if it is zero).
Note | ||
---|---|---|
| ||
If an end of line sequence is specified, the length of the sequence is not considered by UDM when determining the length of a line on the destination side. UDM only looks at the raw data that is transferred. |
(By default, the lineop attribute is not defined.)
Set of three numbers (0-7) or nothing.
Note | ||
---|---|---|
| ||
This attribute is used only for UDM for UNIX. |
Specification for the mode (in UNIX parlance), or file permissions, of a file created by UDM in a copy operation. Existing files do not have their modes modified by UDM. They retain the file mode that they had before the copy operation was initiated.
Each number in the set corresponds to one or more individuals for whom access is granted for the file:
The value of each number is the sum of values representing file permissions:
(By default, the mode attribute is not set. The default mode of a newly created file by UDM is dependent upon the user's umask or the mode of the source file in a UDM transfer.)
ostype
AIX, HP, Linux, Solaris, USS, Windows, or z/OS
Type of operating system. This attribute is associated with UDM server. Its default value is set based on the platform that the UDM component was compiled for.
padline
none, null, or space
Specification for whether or not data is padded. (Used in conjunction with linelen, when linelen is not zero.)
Default is none.
yes or no
Specifies how to manage files whose records may start with a 4-byte Record Descriptor Word (RDW). This RDW contains the record length for variable-length record data that originates from z/OS, and is structured as follows:
The role that the rdw attribute plays varies depending on context.For files transferred from z/OS:For files transferred to z/OS:The default is no.
Note | ||
---|---|---|
| ||
The RDW is stored in binary format. To prevent conversion of the record length to a text value, transfer the file as binary using the mode type=binary command. |
yes or no
Allows regular expression pattern matching to select which files are chosen for the copy, delete, dir, and move commands, and the forfiles.
If the value of this attribute is yes, file names specified for the corresponding session are processed in a grep-like fashion. Care must be taken when crafting the expression to ensure that only the files desired are processed.
For example, given the script commands:
Any files in d:\rootdir\datadir
that contain the substring 123.txt
- including the file named 123.txt
- will be copied.
Use regular expression control characters such as ^ and $ to limit the substring to match the beginning and ending of file names. For example, use ^123.txt$
to copy just the file named 123.txt
. Additional information on regular expressions, including the different matching patterns that are available, can be found in a number of online resources and UNIX man pages.
Also, remember that wildcards are treated as special control characters in regular expressions. Set this attribute to no or omit it entirely to have UDM process wildcard characters as a "true" wildcard.
Default is no.
Note | ||
---|---|---|
| ||
Regular expression pattern searches are case-insensitive on Windows systems. For Unix and z/OS sessions, they are case-sensitive. |
Parameter |
---|
...
cellspacing | 0 |
---|---|
style | text-align: left; width: 100%; |
class | Table_with_Header |
...
style | background-color: #F0F0F0; border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: middle; width: 144pt; |
---|
...
style | background-color: #F0F0F0; border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: middle; width: 360pt; |
---|
...
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
...
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
Description | |
---|---|
logical-name | Logical name of the transfer server for which to set the attributes (or from which to retrieve the attributes). |
dd|dsn|hfs|lib | File system for which the attribute is to be set:
If no file system is specified, the attribute is set for the current file system on the specified server. |
attribute-name | Name of an attribute. |
attribute-value | Value to be set for the attribute. |
Anchor | ||||
---|---|---|---|---|
|
The following attributes are common to UDM on most platforms.
Attribute Name | Values | Description | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| yes, no |
| |||||||||||||
| default, yes, no | Controls byte order mark (BOM) processing for UTF16-encoded output files.
| |||||||||||||
casesensitive | yes, no | Controls how forfiles wildcard variable expansion is processed. The value should match how the forfiles file list was generated on the target UDM server; in most cases, that will be true. However, Windows has some unique casing scenarios; for example, it is possible for the file system to be mostly case insensitive while one or more specific directories are case sensitive.
| |||||||||||||
createop | append, new, or replace | Specification for how the file is to be created:
Default is new. | |||||||||||||
defext | Any sequence of characters valid for the destination file system. | Sequence of characters appended to the end of the filename used to write the destination file, if the source filename is being used implicitly as the destination filename. This occurs after the file extension has been truncated (if truncext is set to yes).
| |||||||||||||
eol | Any sequence of valid text data. | End-of-line sequence used in text transfers.
| |||||||||||||
linelen | A positive integer | Maximum length of each line of data (record under the z/OS dd and dsn file systems) written. It applies only to the destination side of a transfer and is used in conjunction with the lineop and padline attributes.
| |||||||||||||
lineop | none, stream, wrap, or trunc | Line operation for transferred lines (records under the z/OS dd and dsn file systems).
| |||||||||||||
| Set of three numbers (0-7) or nothing. |
| |||||||||||||
ostype | AIX, HP, Linux, Solaris, USS, Windows, or z/OS | Type of operating system. This attribute is associated with UDM server. Its default value is set based on the platform that the UDM component was compiled for. | |||||||||||||
padline | none, null, or space | Specification for whether or not data is padded. (Used in conjunction with linelen, when linelen is not zero.)
| |||||||||||||
| yes or no | Specifies how to manage files whose records may start with a 4-byte Record Descriptor Word (RDW). This RDW contains the record length for variable-length record data that originates from z/OS, and is structured as follows:
| |||||||||||||
| yes or no | Allows regular expression pattern matching to select which files are chosen for the copy, delete, dir, and move commands, and the forfiles.
| |||||||||||||
srccreatetime | yes or no |
| |||||||||||||
srcmodtime | yes or no |
| |||||||||||||
srcmodtimesrcaccesstime | yes or no |
| |||||||||||||
srcaccesstimetrans | yes or no
Default is no. | trans | yes or no | Specification for whether or not a transactional file copy is to be performed:Specification for whether or not a transactional file copy is to be performed:
| |||||||||||
truncext | yes or no | Specification for whether or not the source filename's extension should be truncated if it is being used as the destination filename (no filename was explicitly specified on the destination side of the transfer operation)the transfer operation).
| |||||||||||||
| Three-digit octal value. | File permissions mask used to create the destination file or directory. When the source file comes from an HFS file system and the source UDM component version is 3.2 or greater, the file permission mode is set based upon the source file permission mode. Directory permission modes are always set based on the UMASK attribute or option.
| |||||||||||||
usefqn | yes or no | Specification, when copying a data set under the dsn file system, whether or not the fully qualified data set name is sent over as the source file name to be used by the destination if an explicit destination filename is not given.
|
...
To set the line length, line operation, and line padding sequence:
Panel |
---|
attrib ntmachine linelen=80 lineop=wrap padline=none |