Panel
Table of Contents

Anchor
1155407 1155407

Syntax

Wiki Markup
*move* _source\-logical\-name_=_source\-file\-specification_ \[_destination\-logical\-name_=_destination\-file\-specification_\]

Anchor
1155410 1155410

Description

Anchor
1155411 1155411

The move command initiates a move operation.

Anchor
1155412 1155412

A move operation is similar to a copy operation. The only difference between a move command and a copy command is that after you move a file, it is deleted from the source server from which it was moved.

Anchor
1155416 1155416

If the move command cannot delete the source file after the move, the move operation has failed; move deletes the destination file.

Info
title z/OS
If the source side of the move is in the DD file system, or if the source is a GDG, an error will be issued specifying that the move command is not supported.

Anchor
1155422 1155422

source-logical-name specifies the logical name of the source server (logical name of either the primary or secondary transfer server specified in the open command).

Anchor
1155426 1155426

source-file-specification specifies the complete path or single file name of the file or files to be copied.

Anchor
1155427 1155427

Optionally, destination-logical-name and destination-file-specification can be used to specify the logical name of the destination server and the complete path or single file name for the destination file.

Anchor
1155428 1155428

If destination-file-specification identifies only a file name, the current directory (or high-level qualifier) is used for the destination server. If destination-file-specification identifies only a directory, the file name specified in source-file-specification is used.

Anchor
1155429 1155429

If destination-logical-name and destination-file-specification are not specified, the other server in the transfer session (that is, the server not specified in source-logical- name) is assumed to be the destination server and source-file-specification is used for the destination file name.

Note
title Note
As with a copy command, if an error is encountered, a move operation will halt, and control will be returned to the script.

Anchor
1155435 1155435

Parameters

HTML Table
cellspacing 0 style text-align: left; width: 100%; class Table_with_Header
Table Row (tr) Table Cell (td) 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; Anchor 1155439 1155439 Parameter Table Cell (td) 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; Anchor 1155441 1155441 Description Table Row (tr) Table Cell (td) 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; Anchor 1155443 1155443 source-logical-name Table Cell (td) 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; Anchor 1155445 1155445 Logical name of the server acting as the source of the move operation. Table Row (tr) Table Cell (td) 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; Anchor 1155447 1155447 file-specification Table Cell (td) 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; Anchor 1155449 1155449 File or files to be copied. It can be a single filename or a complete path. Anchor 1155450 1155450 The filename (or filename portion of the path) can contain wildcard characters: Wildcard * represents for zero or more characters. Wildcard ? indicates a single character. Table Row (tr) Table Cell (td) 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; Anchor 1155454 1155454 destination-logical-name Table Cell (td) 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; Anchor 1155456 1155456 Logical name of the destination server in the move operation. Table Row (tr) Table Cell (td) 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; Anchor 1155458 1155458 file-specification Table Cell (td) 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; Anchor 1155460 1155460 Complete path or file name for the destination file.

Anchor
1155462 1155462

Examples

Anchor
1155463 1155463

To move file test.txt - from a machine with logical name src to a machine with logical name dst - as test.bak:

Panel

Anchor
1155466 1155466

To move all files in the current directory from a machine with logical name src to the other machine in the transfer session:

Panel

Anchor
1154381 1154381